RELEASES.md

   1 Version 1.52.0 (2021-05-06)
   2 ============================
   3
   4 Language
   5 --------
   6 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
   7   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
   8   is allowed by default, and may become a warning or hard error in a
   9   future edition.
  10 - [You can now cast mutable references to arrays to a pointer of the same type as
  11   the element.][81479]
  12
  13 Compiler
  14 --------
  15 - [Upgraded the default LLVM to LLVM 12.][81451]
  16
  17 Added tier 3\* support for the following targets.
  18
  19 - [`s390x-unknown-linux-musl`][82166]
  20 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
  21 - [`powerpc-unknown-openbsd`][82733]
  22
  23 \* Refer to Rust's [platform support page][platform-support-doc] for more
  24 information on Rust's tiered platform support.
  25
  26 Libraries
  27 ---------
  28 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
  29 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
  30 - [`Arc<impl Error>` now implements `error::Error`.][80553]
  31 - [All integer division and remainder operations are now `const`.][80962]
  32
  33 Stabilised APIs
  34 -------------
  35 - [`Arguments::as_str`]
  36 - [`char::MAX`]
  37 - [`char::REPLACEMENT_CHARACTER`]
  38 - [`char::UNICODE_VERSION`]
  39 - [`char::decode_utf16`]
  40 - [`char::from_digit`]
  41 - [`char::from_u32_unchecked`]
  42 - [`char::from_u32`]
  43 - [`slice::partition_point`]
  44 - [`str::rsplit_once`]
  45 - [`str::split_once`]
  46
  47 The following previously stable APIs are now `const`.
  48
  49 - [`char::len_utf8`]
  50 - [`char::len_utf16`]
  51 - [`char::to_ascii_uppercase`]
  52 - [`char::to_ascii_lowercase`]
  53 - [`char::eq_ignore_ascii_case`]
  54 - [`u8::to_ascii_uppercase`]
  55 - [`u8::to_ascii_lowercase`]
  56 - [`u8::eq_ignore_ascii_case`]
  57
  58 Rustdoc
  59 -------
  60 - [Rustdoc lints are now treated as a tool lint, meaning that
  61   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
  62   Using the old style is still allowed, and will become a warning in
  63   a future release.
  64 - [Rustdoc now supports argument files.][82261]
  65 - [Rustdoc now generates smart punctuation for documentation.][79423]
  66 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
  67   ```markdown
  68   - [x] Complete
  69   - [ ] Todo
  70   ```
  71
  72 Misc
  73 ----
  74 - [You can now pass multiple filters to tests.][81356] E.g.
  75   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
  76 - [Rustup now distributes PDB symbols for the `std` library on Windows,
  77   allowing you to see `std` symbols when debugging.][82218]
  78
  79 Internal Only
  80 -------------
  81 These changes provide no direct user facing benefits, but represent significant
  82 improvements to the internals and overall performance of rustc and
  83 related tools.
  84
  85 - [Check the result cache before the DepGraph when ensuring queries][81855]
  86 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
  87 - [Only store a LocalDefId in some HIR nodes][81611]
  88 - [Store HIR attributes in a side table][79519]
  89
  90 Compatibility Notes
  91 -------------------
  92 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
  93 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
  94 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
  95 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
  96   languages in code blocks.][78429]
  97 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
  98 - [Changes in how proc macros handle whitespace may lead to panics when used
  99   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
 100
 101 [84136]: https://github.com/rust-lang/rust/issues/84136
 102 [80763]: https://github.com/rust-lang/rust/pull/80763
 103 [82166]: https://github.com/rust-lang/rust/pull/82166
 104 [82121]: https://github.com/rust-lang/rust/pull/82121
 105 [81879]: https://github.com/rust-lang/rust/pull/81879
 106 [82261]: https://github.com/rust-lang/rust/pull/82261
 107 [82218]: https://github.com/rust-lang/rust/pull/82218
 108 [82216]: https://github.com/rust-lang/rust/pull/82216
 109 [82202]: https://github.com/rust-lang/rust/pull/82202
 110 [81855]: https://github.com/rust-lang/rust/pull/81855
 111 [81766]: https://github.com/rust-lang/rust/pull/81766
 112 [81744]: https://github.com/rust-lang/rust/pull/81744
 113 [81611]: https://github.com/rust-lang/rust/pull/81611
 114 [81479]: https://github.com/rust-lang/rust/pull/81479
 115 [81451]: https://github.com/rust-lang/rust/pull/81451
 116 [81356]: https://github.com/rust-lang/rust/pull/81356
 117 [80962]: https://github.com/rust-lang/rust/pull/80962
 118 [80553]: https://github.com/rust-lang/rust/pull/80553
 119 [80527]: https://github.com/rust-lang/rust/pull/80527
 120 [79519]: https://github.com/rust-lang/rust/pull/79519
 121 [79423]: https://github.com/rust-lang/rust/pull/79423
 122 [79208]: https://github.com/rust-lang/rust/pull/79208
 123 [78429]: https://github.com/rust-lang/rust/pull/78429
 124 [82733]: https://github.com/rust-lang/rust/pull/82733
 125 [82594]: https://github.com/rust-lang/rust/pull/82594
 126 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
 127 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
 128 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
 129 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
 130 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
 131 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
 132 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
 133 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
 134 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
 135 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
 136 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
 137 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
 138 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
 139 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
 140 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
 141 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
 142 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
 143 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
 144 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
 145 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
 146 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
 147 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
 148
 149 Version 1.51.0 (2021-03-25)
 150 ============================
 151
 152 Language
 153 --------
 154 - [You can now parameterize items such as functions, traits, and `struct`s by constant
 155   values in addition to by types and lifetimes.][79135] Also known as "const generics"
 156   E.g. you can now write the following. Note: Only values of primitive integers,
 157   `bool`, or `char` types are currently permitted.
 158   ```rust
 159   struct GenericArray<T, const LENGTH: usize> {
 160       inner: [T; LENGTH]
 161   }
 162
 163   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
 164       const fn last(&self) -> Option<&T> {
 165           if LENGTH == 0 {
 166               None
 167           } else {
 168               Some(&self.inner[LENGTH - 1])
 169           }
 170       }
 171   }
 172   ```
 173
 174
 175 Compiler
 176 --------
 177
 178 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
 179   This option controls whether debug information is split across multiple files
 180   or packed into a single file. **Note** This option is unstable on other platforms.
 181 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
 182   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
 183 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
 184 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
 185
 186 \* Refer to Rust's [platform support page][platform-support-doc] for more
 187 information on Rust's tiered platform support.
 188
 189 Libraries
 190 ---------
 191
 192 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
 193 - [`str` now implements `AsMut<str>`.][80279]
 194 - [`u64` and `u128` now implement `From<char>`.][79502]
 195 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
 196 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
 197 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
 198 - [`io::Empty` now implements `io::Seek`.][78044]
 199 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
 200   `T: ?Sized` types.][80764]
 201 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
 202
 203
 204 Stabilized APIs
 205 ---------------
 206
 207 - [`Arc::decrement_strong_count`]
 208 - [`Arc::increment_strong_count`]
 209 - [`Once::call_once_force`]
 210 - [`Peekable::next_if_eq`]
 211 - [`Peekable::next_if`]
 212 - [`Seek::stream_position`]
 213 - [`array::IntoIter`]
 214 - [`panic::panic_any`]
 215 - [`ptr::addr_of!`]
 216 - [`ptr::addr_of_mut!`]
 217 - [`slice::fill_with`]
 218 - [`slice::split_inclusive_mut`]
 219 - [`slice::split_inclusive`]
 220 - [`slice::strip_prefix`]
 221 - [`slice::strip_suffix`]
 222 - [`str::split_inclusive`]
 223 - [`sync::OnceState`]
 224 - [`task::Wake`]
 225 - [`VecDeque::range`]
 226 - [`VecDeque::range_mut`]
 227
 228 Cargo
 229 -----
 230 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
 231   codegen option.][cargo/9112]
 232 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
 233   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
 234   to avoid unifying features of dependencies where that unification could be unwanted.
 235   Such as using the same dependency with a `std` feature in a build scripts and
 236   proc-macros, while using the `no-std` feature in the final binary. See the
 237   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
 238
 239 Rustdoc
 240 -------
 241
 242 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
 243 - [You can now provide a `--default-theme` flag which sets the default theme to use for
 244   documentation.][79642]
 245
 246 Various improvements to intra-doc links:
 247
 248 - [You can link to non-path primitives such as `slice`.][80181]
 249 - [You can link to associated items.][74489]
 250 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
 251
 252 Misc
 253 ----
 254 - [You can now pass `--include-ignored` to tests (e.g. with
 255   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
 256
 257 Compatibility Notes
 258 -------------------
 259
 260 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
 261 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
 262   could fail.][80579]
 263 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
 264   for the distributed artifacts.][81521]
 265     - `armv5te-unknown-linux-gnueabi`
 266     - `sparc64-unknown-linux-gnu`
 267     - `thumbv7neon-unknown-linux-gnueabihf`
 268     - `armv7-unknown-linux-gnueabi`
 269     - `x86_64-unknown-linux-gnux32`
 270 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
 271
 272 Internal Only
 273 -------------
 274
 275 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
 276
 277 [79135]: https://github.com/rust-lang/rust/pull/79135
 278 [74489]: https://github.com/rust-lang/rust/pull/74489
 279 [76934]: https://github.com/rust-lang/rust/pull/76934
 280 [79570]: https://github.com/rust-lang/rust/pull/79570
 281 [80181]: https://github.com/rust-lang/rust/pull/80181
 282 [79642]: https://github.com/rust-lang/rust/pull/79642
 283 [80945]: https://github.com/rust-lang/rust/pull/80945
 284 [80279]: https://github.com/rust-lang/rust/pull/80279
 285 [80053]: https://github.com/rust-lang/rust/pull/80053
 286 [79502]: https://github.com/rust-lang/rust/pull/79502
 287 [75180]: https://github.com/rust-lang/rust/pull/75180
 288 [79135]: https://github.com/rust-lang/rust/pull/79135
 289 [81521]: https://github.com/rust-lang/rust/pull/81521
 290 [80968]: https://github.com/rust-lang/rust/pull/80968
 291 [80959]: https://github.com/rust-lang/rust/pull/80959
 292 [80718]: https://github.com/rust-lang/rust/pull/80718
 293 [80653]: https://github.com/rust-lang/rust/pull/80653
 294 [80579]: https://github.com/rust-lang/rust/pull/80579
 295 [79998]: https://github.com/rust-lang/rust/pull/79998
 296 [78044]: https://github.com/rust-lang/rust/pull/78044
 297 [81455]: https://github.com/rust-lang/rust/pull/81455
 298 [80764]: https://github.com/rust-lang/rust/pull/80764
 299 [80749]: https://github.com/rust-lang/rust/pull/80749
 300 [80662]: https://github.com/rust-lang/rust/pull/80662
 301 [79134]: https://github.com/rust-lang/rust/pull/79134
 302 [80966]: https://github.com/rust-lang/rust/pull/80966
 303 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
 304 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
 305 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
 306 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
 307 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
 308 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
 309 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
 310 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
 311 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
 312 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
 313 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
 314 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
 315 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
 316 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
 317 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
 318 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
 319 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
 320 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
 321 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
 322 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
 323 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
 324 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
 325 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
 326
 327 Version 1.50.0 (2021-02-11)
 328 ============================
 329
 330 Language
 331 -----------------------
 332 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
 333   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
 334 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
 335
 336 Compiler
 337 -----------------------
 338 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
 339 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
 340 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
 341 - [Dropped support for all cloudabi targets.][78439]
 342
 343 \* Refer to Rust's [platform support page][platform-support-doc] for more
 344 information on Rust's tiered platform support.
 345
 346 Libraries
 347 -----------------------
 348
 349 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
 350 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
 351 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
 352   This value cannot be a valid file descriptor, and now means `Option<File>` takes
 353   up the same amount of space as `File`.
 354
 355 Stabilized APIs
 356 ---------------
 357
 358 - [`bool::then`]
 359 - [`btree_map::Entry::or_insert_with_key`]
 360 - [`f32::clamp`]
 361 - [`f64::clamp`]
 362 - [`hash_map::Entry::or_insert_with_key`]
 363 - [`Ord::clamp`]
 364 - [`RefCell::take`]
 365 - [`slice::fill`]
 366 - [`UnsafeCell::get_mut`]
 367
 368 The following previously stable methods are now `const`.
 369
 370 - [`IpAddr::is_ipv4`]
 371 - [`IpAddr::is_ipv6`]
 372 - [`IpAddr::is_unspecified`]
 373 - [`IpAddr::is_loopback`]
 374 - [`IpAddr::is_multicast`]
 375 - [`Ipv4Addr::octets`]
 376 - [`Ipv4Addr::is_loopback`]
 377 - [`Ipv4Addr::is_private`]
 378 - [`Ipv4Addr::is_link_local`]
 379 - [`Ipv4Addr::is_multicast`]
 380 - [`Ipv4Addr::is_broadcast`]
 381 - [`Ipv4Addr::is_documentation`]
 382 - [`Ipv4Addr::to_ipv6_compatible`]
 383 - [`Ipv4Addr::to_ipv6_mapped`]
 384 - [`Ipv6Addr::segments`]
 385 - [`Ipv6Addr::is_unspecified`]
 386 - [`Ipv6Addr::is_loopback`]
 387 - [`Ipv6Addr::is_multicast`]
 388 - [`Ipv6Addr::to_ipv4`]
 389 - [`Layout::size`]
 390 - [`Layout::align`]
 391 - [`Layout::from_size_align`]
 392 - `pow` for all integer types.
 393 - `checked_pow` for all integer types.
 394 - `saturating_pow` for all integer types.
 395 - `wrapping_pow` for all integer types.
 396 - `next_power_of_two` for all unsigned integer types.
 397 - `checked_next_power_of_two` for all unsigned integer types.
 398
 399 Cargo
 400 -----------------------
 401
 402 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
 403   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
 404 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
 405   contents of that directory for changes.][cargo/8973]
 406 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
 407
 408 Misc
 409 ----
 410
 411 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
 412 - [Running tests will now print the total time taken to execute.][75752]
 413
 414 Compatibility Notes
 415 -------------------
 416
 417 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
 418   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
 419 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
 420   unhygenic `macro_rules!` macros.][79472]
 421 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
 422   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
 423 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
 424 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
 425   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
 426 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
 427
 428 [74989]: https://github.com/rust-lang/rust/pull/74989
 429 [79261]: https://github.com/rust-lang/rust/pull/79261
 430 [79896]: https://github.com/rust-lang/rust/pull/79896
 431 [79484]: https://github.com/rust-lang/rust/pull/79484
 432 [79472]: https://github.com/rust-lang/rust/pull/79472
 433 [79270]: https://github.com/rust-lang/rust/pull/79270
 434 [79003]: https://github.com/rust-lang/rust/pull/79003
 435 [78864]: https://github.com/rust-lang/rust/pull/78864
 436 [78636]: https://github.com/rust-lang/rust/pull/78636
 437 [78439]: https://github.com/rust-lang/rust/pull/78439
 438 [78343]: https://github.com/rust-lang/rust/pull/78343
 439 [78296]: https://github.com/rust-lang/rust/pull/78296
 440 [78068]: https://github.com/rust-lang/rust/pull/78068
 441 [75752]: https://github.com/rust-lang/rust/pull/75752
 442 [74699]: https://github.com/rust-lang/rust/pull/74699
 443 [78142]: https://github.com/rust-lang/rust/pull/78142
 444 [77484]: https://github.com/rust-lang/rust/pull/77484
 445 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
 446 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
 447 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
 448 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
 449 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
 450 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
 451 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
 452 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
 453 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
 454 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
 455 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
 456 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
 457 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
 458 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
 459 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
 460 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
 461 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
 462 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
 463 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
 464 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
 465 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
 466 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
 467 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
 468 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
 469 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
 470 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
 471 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
 472 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
 473 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
 474 [`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
 475 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
 476 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
 477 [`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
 478 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
 479
 480
 481 Version 1.49.0 (2020-12-31)
 482 ============================
 483
 484 Language
 485 -----------------------
 486
 487 - [Unions can now implement `Drop`, and you can now have a field in a union
 488   with `ManuallyDrop<T>`.][77547]
 489 - [You can now cast uninhabited enums to integers.][76199]
 490 - [You can now bind by reference and by move in patterns.][76119] This
 491   allows you to selectively borrow individual components of a type. E.g.
 492   ```rust
 493   #[derive(Debug)]
 494   struct Person {
 495       name: String,
 496       age: u8,
 497   }
 498
 499   let person = Person {
 500       name: String::from("Alice"),
 501       age: 20,
 502   };
 503
 504   // `name` is moved out of person, but `age` is referenced.
 505   let Person { name, ref age } = person;
 506   println!("{} {}", name, age);
 507   ```
 508
 509 Compiler
 510 -----------------------
 511
 512 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
 513 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
 514 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
 515 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
 516 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
 517 - [Output from threads spawned in tests is now captured.][78227]
 518 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
 519
 520 \* Refer to Rust's [platform support page][platform-support-doc] for more
 521 information on Rust's tiered platform support.
 522
 523 Libraries
 524 -----------------------
 525
 526 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
 527 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
 528
 529 Stabilized APIs
 530 ---------------
 531
 532 - [`slice::select_nth_unstable`]
 533 - [`slice::select_nth_unstable_by`]
 534 - [`slice::select_nth_unstable_by_key`]
 535
 536 The following previously stable methods are now `const`.
 537
 538 - [`Poll::is_ready`]
 539 - [`Poll::is_pending`]
 540
 541 Cargo
 542 -----------------------
 543 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
 544 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
 545 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
 546   variable will be set if the crate being built is one the user selected to build, either
 547   with `-p` or through defaults.
 548 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
 549
 550
 551 Compatibility Notes
 552 -------------------
 553
 554 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
 555 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
 556 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
 557   Previously such invalid or unused attributes could be ignored.
 558 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
 559   read [this post about the changes][rustdoc-ws-post] for more details.
 560 - [Trait bounds are no longer inferred for associated types.][79904]
 561
 562 Internal Only
 563 -------------
 564 These changes provide no direct user facing benefits, but represent significant
 565 improvements to the internals and overall performance of rustc and
 566 related tools.
 567
 568 - [rustc's internal crates are now compiled using the `initial-exec` Thread
 569   Local Storage model.][78201]
 570 - [Calculate visibilities once in resolve.][78077]
 571 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
 572 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
 573
 574
 575 [75991]: https://github.com/rust-lang/rust/pull/75991
 576 [78951]: https://github.com/rust-lang/rust/pull/78951
 577 [78848]: https://github.com/rust-lang/rust/pull/78848
 578 [78746]: https://github.com/rust-lang/rust/pull/78746
 579 [78376]: https://github.com/rust-lang/rust/pull/78376
 580 [78228]: https://github.com/rust-lang/rust/pull/78228
 581 [78227]: https://github.com/rust-lang/rust/pull/78227
 582 [78201]: https://github.com/rust-lang/rust/pull/78201
 583 [78109]: https://github.com/rust-lang/rust/pull/78109
 584 [78077]: https://github.com/rust-lang/rust/pull/78077
 585 [77997]: https://github.com/rust-lang/rust/pull/77997
 586 [77703]: https://github.com/rust-lang/rust/pull/77703
 587 [77547]: https://github.com/rust-lang/rust/pull/77547
 588 [77015]: https://github.com/rust-lang/rust/pull/77015
 589 [76199]: https://github.com/rust-lang/rust/pull/76199
 590 [76119]: https://github.com/rust-lang/rust/pull/76119
 591 [75914]: https://github.com/rust-lang/rust/pull/75914
 592 [79004]: https://github.com/rust-lang/rust/pull/79004
 593 [78676]: https://github.com/rust-lang/rust/pull/78676
 594 [79904]: https://github.com/rust-lang/rust/issues/79904
 595 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
 596 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
 597 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
 598 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
 599 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
 600 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
 601 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
 602 [`hint::spin_loop`]: https://doc.rust-lang.org/stable/std/hint/fn.spin_loop.html
 603 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
 604 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
 605 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
 606
 607 Version 1.48.0 (2020-11-19)
 608 ==========================
 609
 610 Language
 611 --------
 612
 613 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
 614   is still rejected *semantically*, but can now be parsed by procedural macros.
 615
 616 Compiler
 617 --------
 618 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
 619   `rustc` whether to link its own C runtime and libraries or to rely on a external
 620   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
 621 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
 622   Note: If you're using cargo you must explicitly pass the `--target` flag.
 623 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
 624
 625 \* Refer to Rust's [platform support page][platform-support-doc] for more
 626 information on Rust's tiered platform support.
 627
 628 Libraries
 629 ---------
 630 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
 631   and `&Stderr`.][76275]
 632 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
 633 - [The `matches!` macro now supports having a trailing comma.][74880]
 634 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
 635 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
 636
 637 Stabilized APIs
 638 ---------------
 639 - [`slice::as_ptr_range`]
 640 - [`slice::as_mut_ptr_range`]
 641 - [`VecDeque::make_contiguous`]
 642 - [`future::pending`]
 643 - [`future::ready`]
 644
 645 The following previously stable methods are now `const fn`'s:
 646
 647 - [`Option::is_some`]
 648 - [`Option::is_none`]
 649 - [`Option::as_ref`]
 650 - [`Result::is_ok`]
 651 - [`Result::is_err`]
 652 - [`Result::as_ref`]
 653 - [`Ordering::reverse`]
 654 - [`Ordering::then`]
 655
 656 Cargo
 657 -----
 658
 659 Rustdoc
 660 -------
 661 - [You can now link to items in `rustdoc` using the intra-doc link
 662   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
 663   a link to `std::future`'s documentation. See ["Linking to items by
 664   name"][intradoc-links] for more information.
 665 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
 666   when searching through `rustdoc`'s UI.][75740]
 667
 668 Compatibility Notes
 669 -------------------
 670 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
 671   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
 672   promoted to `'static` lifetime any more inside `const fn`s.
 673 - [Associated type bindings on trait objects are now verified to meet the bounds
 674   declared on the trait when checking that they implement the trait.][27675]
 675 - [When trait bounds on associated types or opaque types are ambiguous, the
 676   compiler no longer makes an arbitrary choice on which bound to use.][54121]
 677 - [Fixed recursive nonterminals not being expanded in macros during
 678   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
 679   correctly handling recursive nonterminal tokens.
 680 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
 681 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
 682   in places where they have no effect.][73461]
 683 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
 684   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
 685 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
 686   disallow zero-initialization.][71274]
 687 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
 688 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
 689   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
 690   see the [`catch_unwind`] documentation for further information.
 691
 692
 693
 694 Internal Only
 695 -------------
 696 These changes provide no direct user facing benefits, but represent significant
 697 improvements to the internals and overall performance of rustc and
 698 related tools.
 699
 700 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
 701   You can continue building with `make` by setting `ninja=false` in
 702   your `config.toml`.
 703 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
 704 - [Made `ensure_sufficient_stack()` non-generic][76680]
 705
 706 [78143]: https://github.com/rust-lang/rust/issues/78143
 707 [76680]: https://github.com/rust-lang/rust/pull/76680/
 708 [76030]: https://github.com/rust-lang/rust/pull/76030/
 709 [70212]: https://github.com/rust-lang/rust/pull/70212/
 710 [27675]: https://github.com/rust-lang/rust/issues/27675/
 711 [54121]: https://github.com/rust-lang/rust/issues/54121/
 712 [71274]: https://github.com/rust-lang/rust/pull/71274/
 713 [77386]: https://github.com/rust-lang/rust/pull/77386/
 714 [77153]: https://github.com/rust-lang/rust/pull/77153/
 715 [77055]: https://github.com/rust-lang/rust/pull/77055/
 716 [76275]: https://github.com/rust-lang/rust/pull/76275/
 717 [76310]: https://github.com/rust-lang/rust/pull/76310/
 718 [76420]: https://github.com/rust-lang/rust/pull/76420/
 719 [76158]: https://github.com/rust-lang/rust/pull/76158/
 720 [75857]: https://github.com/rust-lang/rust/pull/75857/
 721 [75585]: https://github.com/rust-lang/rust/pull/75585/
 722 [75740]: https://github.com/rust-lang/rust/pull/75740/
 723 [75502]: https://github.com/rust-lang/rust/pull/75502/
 724 [74880]: https://github.com/rust-lang/rust/pull/74880/
 725 [74922]: https://github.com/rust-lang/rust/pull/74922/
 726 [74430]: https://github.com/rust-lang/rust/pull/74430/
 727 [74194]: https://github.com/rust-lang/rust/pull/74194/
 728 [73461]: https://github.com/rust-lang/rust/pull/73461/
 729 [73166]: https://github.com/rust-lang/rust/pull/73166/
 730 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
 731 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
 732 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
 733 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
 734 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
 735 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
 736 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
 737 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
 738 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
 739 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
 740 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
 741 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
 742 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
 743 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
 744 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
 745
 746
 747 Version 1.47.0 (2020-10-08)
 748 ==========================
 749
 750 Language
 751 --------
 752 - [Closures will now warn when not used.][74869]
 753
 754 Compiler
 755 --------
 756 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
 757   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
 758   platforms.
 759 - [Upgraded to LLVM 11.][73526]
 760 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
 761 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
 762 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
 763
 764 \* Refer to Rust's [platform support page][platform-support-doc] for more
 765 information on Rust's tiered platform support.
 766
 767 Libraries
 768 ---------
 769 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
 770 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
 771   those of length less than 33.][74060]
 772 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
 773 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
 774   `PartialEq`, and `PartialOrd`.][73583]
 775
 776 Stabilized APIs
 777 ---------------
 778 - [`Ident::new_raw`]
 779 - [`Range::is_empty`]
 780 - [`RangeInclusive::is_empty`]
 781 - [`Result::as_deref`]
 782 - [`Result::as_deref_mut`]
 783 - [`Vec::leak`]
 784 - [`pointer::offset_from`]
 785 - [`f32::TAU`]
 786 - [`f64::TAU`]
 787
 788 The following previously stable APIs have now been made const.
 789
 790 - [The `new` method for all `NonZero` integers.][73858]
 791 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
 792   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
 793   methods for all integers.][73858]
 794 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
 795   signed integers.][73858]
 796 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
 797   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
 798   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
 799   `is_ascii_control` methods for `char` and `u8`.][73858]
 800
 801 Cargo
 802 -----
 803 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
 804   You can override this by setting the following in your `Cargo.toml`.
 805   ```toml
 806   [profile.release.build-override]
 807   opt-level = 3
 808   ```
 809 - [`cargo-help` will now display man pages for commands rather just the
 810   `--help` text.][cargo/8456]
 811 - [`cargo-metadata` now emits a `test` field indicating if a target has
 812   tests enabled.][cargo/8478]
 813 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
 814 - [`cargo-publish` will now use an alternative registry by default if it's the
 815   only registry specified in `package.publish`.][cargo/8571]
 816
 817 Misc
 818 ----
 819 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
 820   type based search.][75366]
 821 - [Added the Ayu theme to rustdoc.][71237]
 822
 823 Compatibility Notes
 824 -------------------
 825 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
 826 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
 827 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
 828   help to preserve more span information.][73084] These changes may cause
 829   compiliation errors if your macro was unhygenic or didn't correctly handle
 830   `Delimiter::None`.
 831 - [Moved support for the CloudABI target to tier 3.][75568]
 832 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
 833 - [Added the `rustc-docs` component.][75560] This allows you to install
 834   and read the documentation for the compiler internal APIs. (Currently only
 835   available for `x86_64-unknown-linux-gnu`.)
 836
 837 Internal Only
 838 --------
 839
 840 - [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.
 841
 842 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
 843 [75048]: https://github.com/rust-lang/rust/pull/75048/
 844 [74163]: https://github.com/rust-lang/rust/pull/74163/
 845 [71237]: https://github.com/rust-lang/rust/pull/71237/
 846 [74869]: https://github.com/rust-lang/rust/pull/74869/
 847 [73858]: https://github.com/rust-lang/rust/pull/73858/
 848 [75716]: https://github.com/rust-lang/rust/pull/75716/
 849 [75908]: https://github.com/rust-lang/rust/pull/75908/
 850 [75516]: https://github.com/rust-lang/rust/pull/75516/
 851 [75560]: https://github.com/rust-lang/rust/pull/75560/
 852 [75568]: https://github.com/rust-lang/rust/pull/75568/
 853 [75366]: https://github.com/rust-lang/rust/pull/75366/
 854 [75204]: https://github.com/rust-lang/rust/pull/75204/
 855 [74650]: https://github.com/rust-lang/rust/pull/74650/
 856 [74419]: https://github.com/rust-lang/rust/pull/74419/
 857 [73964]: https://github.com/rust-lang/rust/pull/73964/
 858 [74021]: https://github.com/rust-lang/rust/pull/74021/
 859 [74060]: https://github.com/rust-lang/rust/pull/74060/
 860 [73893]: https://github.com/rust-lang/rust/pull/73893/
 861 [73526]: https://github.com/rust-lang/rust/pull/73526/
 862 [73583]: https://github.com/rust-lang/rust/pull/73583/
 863 [73084]: https://github.com/rust-lang/rust/pull/73084/
 864 [73197]: https://github.com/rust-lang/rust/pull/73197/
 865 [72488]: https://github.com/rust-lang/rust/pull/72488/
 866 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
 867 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
 868 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
 869 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
 870 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
 871 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
 872 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
 873 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
 874 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
 875 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
 876 [`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
 877 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
 878 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
 879 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
 880 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
 881
 882
 883 Version 1.46.0 (2020-08-27)
 884 ==========================
 885
 886 Language
 887 --------
 888 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
 889 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
 890   const functions.][73862]
 891 - [The `#[track_caller]` attribute can now be added to functions to use the
 892   function's caller's location information for panic messages.][72445]
 893 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
 894   `x.0.0` over `(x.0).0`.
 895 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
 896   You currently can't use `mem::transmute` in constant functions.
 897
 898 Compiler
 899 --------
 900 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
 901 - [Enabled static "Position Independent Executables" by default
 902   for `x86_64-unknown-linux-musl`.][70740]
 903
 904 Libraries
 905 ---------
 906 - [`mem::forget` is now a `const fn`.][73887]
 907 - [`String` now implements `From<char>`.][73466]
 908 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
 909   integer types.][73032]
 910 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
 911 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
 912   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
 913 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
 914 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
 915 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
 916
 917 Stabilized APIs
 918 ---------------
 919 - [`Option::zip`]
 920 - [`vec::Drain::as_slice`]
 921
 922 Cargo
 923 -----
 924 Added a number of new environment variables that are now available when
 925 compiling your crate.
 926
 927 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
 928   the specific binary being compiled and the name of the crate.
 929 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
 930 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
 931
 932 Compatibility Notes
 933 -------------------
 934 - [The target configuration option `abi_blacklist` has been renamed
 935   to `unsupported_abis`.][74150] The old name will still continue to work.
 936 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
 937   This was previously accepted but will become a hard error in a future release.
 938 - [Rustc will fail to compile if you have a struct with
 939   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
 940   allowed on `enum`s.
 941 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
 942   ensure that spans have the correct information, and may cause breakage if you
 943   were relying on receiving spans with dummy information.
 944 - [The InnoSetup installer for Windows is no longer available.][72569] This was
 945   a legacy installer that was replaced by a MSI installer a few years ago but
 946   was still being built.
 947 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
 948 - [Rustc will no longer accept overlapping trait implementations that only
 949   differ in how the lifetime was bound.][72493]
 950 - [Rustc now correctly relates the lifetime of an existential associated
 951   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
 952   you to pass a shorter lifetime than expected.
 953 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
 954   The library will need to be installed for `rustc` to work, even though we
 955   expect it to be already available on most systems.
 956 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
 957   under QEMU.][74820]
 958 - [Pretty printing of some tokens in procedural macros changed.][75453] The
 959   exact output returned by rustc's pretty printing is an unstable
 960   implementation detail: we recommend any macro relying on it to switch to a
 961   more robust parsing system.
 962
 963 [75453]: https://github.com/rust-lang/rust/issues/75453/
 964 [74820]: https://github.com/rust-lang/rust/issues/74820/
 965 [74420]: https://github.com/rust-lang/rust/issues/74420/
 966 [74109]: https://github.com/rust-lang/rust/pull/74109/
 967 [74150]: https://github.com/rust-lang/rust/pull/74150/
 968 [73862]: https://github.com/rust-lang/rust/pull/73862/
 969 [73887]: https://github.com/rust-lang/rust/pull/73887/
 970 [73466]: https://github.com/rust-lang/rust/pull/73466/
 971 [73516]: https://github.com/rust-lang/rust/pull/73516/
 972 [73293]: https://github.com/rust-lang/rust/pull/73293/
 973 [73007]: https://github.com/rust-lang/rust/pull/73007/
 974 [73032]: https://github.com/rust-lang/rust/pull/73032/
 975 [72920]: https://github.com/rust-lang/rust/pull/72920/
 976 [72569]: https://github.com/rust-lang/rust/pull/72569/
 977 [72583]: https://github.com/rust-lang/rust/pull/72583/
 978 [72584]: https://github.com/rust-lang/rust/pull/72584/
 979 [72717]: https://github.com/rust-lang/rust/pull/72717/
 980 [72437]: https://github.com/rust-lang/rust/pull/72437/
 981 [72445]: https://github.com/rust-lang/rust/pull/72445/
 982 [72486]: https://github.com/rust-lang/rust/pull/72486/
 983 [72493]: https://github.com/rust-lang/rust/pull/72493/
 984 [72331]: https://github.com/rust-lang/rust/pull/72331/
 985 [71896]: https://github.com/rust-lang/rust/pull/71896/
 986 [71660]: https://github.com/rust-lang/rust/pull/71660/
 987 [71322]: https://github.com/rust-lang/rust/pull/71322/
 988 [70740]: https://github.com/rust-lang/rust/pull/70740/
 989 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
 990 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
 991 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
 992 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
 993 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
 994
 995
 996 Version 1.45.2 (2020-08-03)
 997 ==========================
 998
 999 * [Fix bindings in tuple struct patterns][74954]
1000 * [Fix track_caller integration with trait objects][74784]
1001
1002 [74954]: https://github.com/rust-lang/rust/issues/74954
1003 [74784]: https://github.com/rust-lang/rust/issues/74784
1004
1005
1006 Version 1.45.1 (2020-07-30)
1007 ==========================
1008
1009 * [Fix const propagation with references.][73613]
1010 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1011 * [Avoid spurious implicit region bound.][74509]
1012 * [Install clippy on x.py install][74457]
1013
1014 [73613]: https://github.com/rust-lang/rust/pull/73613
1015 [73078]: https://github.com/rust-lang/rust/issues/73078
1016 [74509]: https://github.com/rust-lang/rust/pull/74509
1017 [74457]: https://github.com/rust-lang/rust/pull/74457
1018
1019
1020 Version 1.45.0 (2020-07-16)
1021 ==========================
1022
1023 Language
1024 --------
1025 - [Out of range float to int conversions using `as` has been defined as a saturating
1026   conversion.][71269] This was previously undefined behaviour, but you can use the
1027    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
1028    may be desirable in rare performance sensitive situations.
1029 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
1030   using `u64`.][70705]
1031 - [Function like procedural macros can now be used in expression, pattern, and  statement
1032   positions.][68717] This means you can now use a function-like procedural macro
1033   anywhere you can use a declarative (`macro_rules!`) macro.
1034
1035 Compiler
1036 --------
1037 - [You can now override individual target features through the `target-feature`
1038   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
1039   equivalent to `-C target-feature=+avx2,+fma`.
1040 - [Added the `force-unwind-tables` flag.][69984] This option allows
1041   rustc to always generate unwind tables regardless of panic strategy.
1042 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
1043   to include LLVM bitcode into generated `rlib`s (this is on by default).
1044 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
1045 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
1046 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
1047 - [Upgraded to LLVM 10.][67759]
1048
1049 \* Refer to Rust's [platform support page][platform-support-doc] for more
1050 information on Rust's tiered platform support.
1051
1052
1053 Libraries
1054 ---------
1055 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
1056   and `Ord`.][72239]
1057 - [`proc_macro::TokenStream` now implements `Default`.][72234]
1058 - [You can now use `char` with
1059   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
1060   a range of codepoints.][72413] E.g.
1061   you can now write the following;
1062   ```rust
1063   for ch in 'a'..='z' {
1064       print!("{}", ch);
1065   }
1066   println!();
1067   // Prints "abcdefghijklmnopqrstuvwxyz"
1068   ```
1069 - [`OsString` now implements `FromStr`.][71662]
1070 - [The `saturating_neg` method has been added to all signed integer primitive
1071   types, and the `saturating_abs` method has been added for all integer
1072   primitive types.][71886]
1073 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
1074   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
1075   or `Path`.][71447]
1076 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
1077 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
1078   integer types.][69813]
1079 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
1080   integer types.][72324]
1081 - [The `fetch_update` method has been added to all atomic integer types.][71843]
1082
1083 Stabilized APIs
1084 ---------------
1085 - [`Arc::as_ptr`]
1086 - [`BTreeMap::remove_entry`]
1087 - [`Rc::as_ptr`]
1088 - [`rc::Weak::as_ptr`]
1089 - [`rc::Weak::from_raw`]
1090 - [`rc::Weak::into_raw`]
1091 - [`str::strip_prefix`]
1092 - [`str::strip_suffix`]
1093 - [`sync::Weak::as_ptr`]
1094 - [`sync::Weak::from_raw`]
1095 - [`sync::Weak::into_raw`]
1096 - [`char::UNICODE_VERSION`]
1097 - [`Span::resolved_at`]
1098 - [`Span::located_at`]
1099 - [`Span::mixed_site`]
1100 - [`unix::process::CommandExt::arg0`]
1101
1102 Cargo
1103 -----
1104
1105 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
1106   time.][cargo/8066]
1107
1108 Misc
1109 ----
1110 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
1111   `~~outdated information~~` becomes "~~outdated information~~".
1112 - [Added an emoji to Rustdoc's deprecated API message.][72014]
1113
1114 Compatibility Notes
1115 -------------------
1116 - [Trying to self initialize a static value (that is creating a value using
1117   itself) is unsound and now causes a compile error.][71140]
1118 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
1119   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
1120 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
1121   previously undocumented and not intended for public use. Rustdoc still provides
1122   a non-zero exit code on errors.
1123 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
1124   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
1125   flags while cargo is adding `embed-bitcode` itself. The recommended way to
1126   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
1127   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
1128
1129 Internals Only
1130 --------------
1131 - [Make clippy a git subtree instead of a git submodule][70655]
1132 - [Unify the undo log of all snapshot types][69464]
1133
1134 [71848]: https://github.com/rust-lang/rust/issues/71848/
1135 [73420]: https://github.com/rust-lang/rust/issues/73420/
1136 [72324]: https://github.com/rust-lang/rust/pull/72324/
1137 [71843]: https://github.com/rust-lang/rust/pull/71843/
1138 [71886]: https://github.com/rust-lang/rust/pull/71886/
1139 [72234]: https://github.com/rust-lang/rust/pull/72234/
1140 [72239]: https://github.com/rust-lang/rust/pull/72239/
1141 [72397]: https://github.com/rust-lang/rust/pull/72397/
1142 [72413]: https://github.com/rust-lang/rust/pull/72413/
1143 [72014]: https://github.com/rust-lang/rust/pull/72014/
1144 [72062]: https://github.com/rust-lang/rust/pull/72062/
1145 [72094]: https://github.com/rust-lang/rust/pull/72094/
1146 [72133]: https://github.com/rust-lang/rust/pull/72133/
1147 [67759]: https://github.com/rust-lang/rust/pull/67759/
1148 [71900]: https://github.com/rust-lang/rust/pull/71900/
1149 [71928]: https://github.com/rust-lang/rust/pull/71928/
1150 [71662]: https://github.com/rust-lang/rust/pull/71662/
1151 [71716]: https://github.com/rust-lang/rust/pull/71716/
1152 [71447]: https://github.com/rust-lang/rust/pull/71447/
1153 [71269]: https://github.com/rust-lang/rust/pull/71269/
1154 [71095]: https://github.com/rust-lang/rust/pull/71095/
1155 [71140]: https://github.com/rust-lang/rust/pull/71140/
1156 [70655]: https://github.com/rust-lang/rust/pull/70655/
1157 [70705]: https://github.com/rust-lang/rust/pull/70705/
1158 [69984]: https://github.com/rust-lang/rust/pull/69984/
1159 [69813]: https://github.com/rust-lang/rust/pull/69813/
1160 [69464]: https://github.com/rust-lang/rust/pull/69464/
1161 [68717]: https://github.com/rust-lang/rust/pull/68717/
1162 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
1163 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
1164 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
1165 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
1166 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
1167 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
1168 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
1169 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
1170 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
1171 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
1172 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
1173 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
1174 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
1175 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
1176 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
1177 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
1178 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
1179
1180
1181 Version 1.44.1 (2020-06-18)
1182 ===========================
1183
1184 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1185 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
1186 * [Fix crashes when finding backtrace on macOS.][71397]
1187 * [Clippy applies lint levels into different files.][clippy/5356]
1188
1189 [71397]: https://github.com/rust-lang/rust/issues/71397
1190 [73078]: https://github.com/rust-lang/rust/issues/73078
1191 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
1192 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
1193
1194
1195 Version 1.44.0 (2020-06-04)
1196 ==========================
1197
1198 Language
1199 --------
1200 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
1201 - [Added the `unused_braces` lint.][70081]
1202
1203 **Syntax-only changes**
1204
1205 - [Expansion-driven outline module parsing][69838]
1206 ```rust
1207 #[cfg(FALSE)]
1208 mod foo {
1209     mod bar {
1210         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
1211     }
1212 }
1213 ```
1214
1215 These are still rejected semantically, so you will likely receive an error but
1216 these changes can be seen and parsed by macros and conditional compilation.
1217
1218 Compiler
1219 --------
1220 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
1221   Additionally when in incremental mode rustc defaults to 256 codegen units.
1222 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
1223   a panic is thrown.][67502]
1224 - [Added tier 3\* support for the `aarch64-unknown-none` and
1225   `aarch64-unknown-none-softfloat` targets.][68334]
1226 - [Added tier 3 support for `arm64-apple-tvos` and
1227   `x86_64-apple-tvos` targets.][68191]
1228
1229
1230 Libraries
1231 ---------
1232 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
1233   `vec![]` to be able to be used in `const` contexts.
1234 - [`convert::Infallible` now implements `Hash`.][70281]
1235 - [`OsString` now implements `DerefMut` and `IndexMut` returning
1236   a `&mut OsStr`.][70048]
1237 - [Unicode 13 is now supported.][69929]
1238 - [`String` now implements `From<&mut str>`.][69661]
1239 - [`IoSlice` now implements `Copy`.][69403]
1240 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
1241 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
1242 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
1243   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
1244   integer types.][69373]
1245
1246 Stabilized APIs
1247 ---------------
1248 - [`PathBuf::with_capacity`]
1249 - [`PathBuf::capacity`]
1250 - [`PathBuf::clear`]
1251 - [`PathBuf::reserve`]
1252 - [`PathBuf::reserve_exact`]
1253 - [`PathBuf::shrink_to_fit`]
1254 - [`f32::to_int_unchecked`]
1255 - [`f64::to_int_unchecked`]
1256 - [`Layout::align_to`]
1257 - [`Layout::pad_to_align`]
1258 - [`Layout::array`]
1259 - [`Layout::extend`]
1260
1261 Cargo
1262 -----
1263 - [Added the `cargo tree` command which will print a tree graph of
1264   your dependencies.][cargo/8062] E.g.
1265   ```
1266     mdbook v0.3.2 (/Users/src/rust/mdbook)
1267   ├── ammonia v3.0.0
1268   │   ├── html5ever v0.24.0
1269   │   │   ├── log v0.4.8
1270   │   │   │   └── cfg-if v0.1.9
1271   │   │   ├── mac v0.1.1
1272   │   │   └── markup5ever v0.9.0
1273   │   │       ├── log v0.4.8 (*)
1274   │   │       ├── phf v0.7.24
1275   │   │       │   └── phf_shared v0.7.24
1276   │   │       │       ├── siphasher v0.2.3
1277   │   │       │       └── unicase v1.4.2
1278   │   │       │           [build-dependencies]
1279   │   │       │           └── version_check v0.1.5
1280   ...
1281   ```
1282   You can also display dependencies on multiple versions of the same crate with
1283   `cargo tree -d` (short for `cargo tree --duplicates`).
1284
1285 Misc
1286 ----
1287 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
1288   the version in the sidebar.][69494]
1289
1290 Compatibility Notes
1291 -------------------
1292 - [Rustc now correctly generates static libraries on Windows GNU targets with
1293   the `.a` extension, rather than the previous `.lib`.][70937]
1294 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
1295 - [The `file_name` property in JSON output of macro errors now points the actual
1296   source file rather than the previous format of `<NAME macros>`.][70969]
1297   **Note:** this may not point to a file that actually exists on the user's system.
1298 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
1299 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
1300   not allow zero initialization such as `NonZeroU8`.][66059] This was
1301   previously a warning.
1302 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
1303   operator has been defined as a saturating operation.][71269] This was previously
1304   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
1305   continue using the current behaviour, which may be desirable in rare performance
1306   sensitive situations.
1307
1308 Internal Only
1309 -------------
1310 These changes provide no direct user facing benefits, but represent significant
1311 improvements to the internals and overall performance of rustc and
1312 related tools.
1313
1314 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
1315 - [Replace big JS dict with JSON parsing.][71250]
1316
1317 [69373]: https://github.com/rust-lang/rust/pull/69373/
1318 [66059]: https://github.com/rust-lang/rust/pull/66059/
1319 [68191]: https://github.com/rust-lang/rust/pull/68191/
1320 [68899]: https://github.com/rust-lang/rust/pull/68899/
1321 [71147]: https://github.com/rust-lang/rust/pull/71147/
1322 [71250]: https://github.com/rust-lang/rust/pull/71250/
1323 [70937]: https://github.com/rust-lang/rust/pull/70937/
1324 [70969]: https://github.com/rust-lang/rust/pull/70969/
1325 [70632]: https://github.com/rust-lang/rust/pull/70632/
1326 [70281]: https://github.com/rust-lang/rust/pull/70281/
1327 [70345]: https://github.com/rust-lang/rust/pull/70345/
1328 [70048]: https://github.com/rust-lang/rust/pull/70048/
1329 [70081]: https://github.com/rust-lang/rust/pull/70081/
1330 [70156]: https://github.com/rust-lang/rust/pull/70156/
1331 [71269]: https://github.com/rust-lang/rust/pull/71269/
1332 [69838]: https://github.com/rust-lang/rust/pull/69838/
1333 [69929]: https://github.com/rust-lang/rust/pull/69929/
1334 [69661]: https://github.com/rust-lang/rust/pull/69661/
1335 [69778]: https://github.com/rust-lang/rust/pull/69778/
1336 [69494]: https://github.com/rust-lang/rust/pull/69494/
1337 [69403]: https://github.com/rust-lang/rust/pull/69403/
1338 [69033]: https://github.com/rust-lang/rust/pull/69033/
1339 [68692]: https://github.com/rust-lang/rust/pull/68692/
1340 [68334]: https://github.com/rust-lang/rust/pull/68334/
1341 [67502]: https://github.com/rust-lang/rust/pull/67502/
1342 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
1343 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
1344 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
1345 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
1346 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
1347 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
1348 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
1349 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
1350 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
1351 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
1352 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
1353 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
1354 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
1355
1356
1357 Version 1.43.1 (2020-05-07)
1358 ===========================
1359
1360 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
1361 * [Fixed the stabilization of AVX-512 features.][71473]
1362 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
1363
1364 [71430]: https://github.com/rust-lang/rust/pull/71430
1365 [71473]: https://github.com/rust-lang/rust/issues/71473
1366 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
1367
1368
1369 Version 1.43.0 (2020-04-23)
1370 ==========================
1371
1372 Language
1373 --------
1374 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
1375   the type inferred correctly.][68129]
1376 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
1377
1378 **Syntax only changes**
1379 - [Allow `type Foo: Ord` syntactically.][69361]
1380 - [Fuse associated and extern items up to defaultness.][69194]
1381 - [Syntactically allow `self` in all `fn` contexts.][68764]
1382 - [Merge `fn` syntax + cleanup item parsing.][68728]
1383 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
1384   For example, you may now write:
1385   ```rust
1386   macro_rules! mac_trait {
1387       ($i:item) => {
1388           trait T { $i }
1389       }
1390   }
1391   mac_trait! {
1392       fn foo() {}
1393   }
1394   ```
1395
1396 These are still rejected *semantically*, so you will likely receive an error but
1397 these changes can be seen and parsed by macros and
1398 conditional compilation.
1399
1400
1401 Compiler
1402 --------
1403 - [You can now pass multiple lint flags to rustc to override the previous
1404   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
1405   everything in the `unused` lint group except `unused-variables` which
1406   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
1407   everything in the `unused` lint group **including** `unused-variables` since
1408   the allow flag is specified before the deny flag (and therefore overridden).
1409 - [rustc will now prefer your system MinGW libraries over its bundled libraries
1410   if they are available on `windows-gnu`.][67429]
1411 - [rustc now buffers errors/warnings printed in JSON.][69227]
1412
1413 Libraries
1414 ---------
1415 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
1416   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
1417   respectively.][69538] **Note** These conversions are only available when `N`
1418   is `0..=32`.
1419 - [You can now use associated constants on floats and integers directly, rather
1420   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
1421   `f32::NAN` with no imports.
1422 - [`u8::is_ascii` is now `const`.][68984]
1423 - [`String` now implements `AsMut<str>`.][68742]
1424 - [Added the `primitive` module to `std` and `core`.][67637] This module
1425   reexports Rust's primitive types. This is mainly useful in macros
1426   where you want avoid these types being shadowed.
1427 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
1428 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
1429
1430 Stabilized APIs
1431 ---------------
1432 - [`Once::is_completed`]
1433 - [`f32::LOG10_2`]
1434 - [`f32::LOG2_10`]
1435 - [`f64::LOG10_2`]
1436 - [`f64::LOG2_10`]
1437 - [`iter::once_with`]
1438
1439 Cargo
1440 -----
1441 - [You can now set config `[profile]`s in your `.cargo/config`, or through
1442   your environment.][cargo/7823]
1443 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
1444   executable path when running integration tests or benchmarks.][cargo/7697]
1445   `<name>` is the name of your binary as-is e.g. If you wanted the executable
1446   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
1447
1448 Misc
1449 ----
1450 - [Certain checks in the `const_err` lint were deemed unrelated to const
1451   evaluation][69185], and have been moved to the `unconditional_panic` and
1452   `arithmetic_overflow` lints.
1453
1454 Compatibility Notes
1455 -------------------
1456
1457 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
1458   has been a warning since 1.36.0.
1459 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
1460   led to some instances being accepted, and now correctly emits a hard error.
1461
1462 [69340]: https://github.com/rust-lang/rust/pull/69340
1463
1464 Internal Only
1465 -------------
1466 These changes provide no direct user facing benefits, but represent significant
1467 improvements to the internals and overall performance of `rustc` and
1468 related tools.
1469
1470 - [All components are now built with `opt-level=3` instead of `2`.][67878]
1471 - [Improved how rustc generates drop code.][67332]
1472 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
1473 - [traits: preallocate 2 Vecs of known initial size][69022]
1474 - [Avoid exponential behaviour when relating types][68772]
1475 - [Skip `Drop` terminators for enum variants without drop glue][68943]
1476 - [Improve performance of coherence checks][68966]
1477 - [Deduplicate types in the generator witness][68672]
1478 - [Invert control in struct_lint_level.][68725]
1479
1480 [67332]: https://github.com/rust-lang/rust/pull/67332/
1481 [67429]: https://github.com/rust-lang/rust/pull/67429/
1482 [67637]: https://github.com/rust-lang/rust/pull/67637/
1483 [67642]: https://github.com/rust-lang/rust/pull/67642/
1484 [67878]: https://github.com/rust-lang/rust/pull/67878/
1485 [67885]: https://github.com/rust-lang/rust/pull/67885/
1486 [68129]: https://github.com/rust-lang/rust/pull/68129/
1487 [68672]: https://github.com/rust-lang/rust/pull/68672/
1488 [68725]: https://github.com/rust-lang/rust/pull/68725/
1489 [68728]: https://github.com/rust-lang/rust/pull/68728/
1490 [68738]: https://github.com/rust-lang/rust/pull/68738/
1491 [68742]: https://github.com/rust-lang/rust/pull/68742/
1492 [68764]: https://github.com/rust-lang/rust/pull/68764/
1493 [68772]: https://github.com/rust-lang/rust/pull/68772/
1494 [68943]: https://github.com/rust-lang/rust/pull/68943/
1495 [68952]: https://github.com/rust-lang/rust/pull/68952/
1496 [68966]: https://github.com/rust-lang/rust/pull/68966/
1497 [68984]: https://github.com/rust-lang/rust/pull/68984/
1498 [69022]: https://github.com/rust-lang/rust/pull/69022/
1499 [69185]: https://github.com/rust-lang/rust/pull/69185/
1500 [69194]: https://github.com/rust-lang/rust/pull/69194/
1501 [69201]: https://github.com/rust-lang/rust/pull/69201/
1502 [69227]: https://github.com/rust-lang/rust/pull/69227/
1503 [69548]: https://github.com/rust-lang/rust/pull/69548/
1504 [69256]: https://github.com/rust-lang/rust/pull/69256/
1505 [69361]: https://github.com/rust-lang/rust/pull/69361/
1506 [69366]: https://github.com/rust-lang/rust/pull/69366/
1507 [69538]: https://github.com/rust-lang/rust/pull/69538/
1508 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
1509 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
1510 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
1511 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
1512 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
1513 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
1514 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
1515 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
1516
1517
1518 Version 1.42.0 (2020-03-12)
1519 ==========================
1520
1521 Language
1522 --------
1523 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
1524   ```rust
1525   fn foo(words: &[&str]) {
1526       match words {
1527           ["Hello", "World", "!", ..] => println!("Hello World!"),
1528           ["Foo", "Bar", ..] => println!("Baz"),
1529           rest => println!("{:?}", rest),
1530       }
1531   }
1532   ```
1533 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
1534   that you can create an enum that has the exact layout and ABI of the type
1535   it contains.
1536 - [There are some *syntax-only* changes:][67131]
1537    - `default` is syntactically allowed before items in `trait` definitions.
1538    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
1539      leave out their bodies in favor of `;`.
1540    - Bounds on associated types in `impl`s are now syntactically allowed
1541      (e.g. `type Foo: Ord;`).
1542    - `...` (the C-variadic type) may occur syntactically directly as the type of
1543       any function parameter.
1544
1545   These are still rejected *semantically*, so you will likely receive an error
1546   but these changes can be seen and parsed by procedural macros and
1547   conditional compilation.
1548
1549 Compiler
1550 --------
1551 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
1552 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
1553 - [`Option::{expect,unwrap}` and
1554    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
1555    pointing to the location where they were called, rather than
1556    `core`'s internals. ][67887]
1557
1558 \* Refer to Rust's [platform support page][platform-support-doc] for more
1559 information on Rust's tiered platform support.
1560
1561 Libraries
1562 ---------
1563 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
1564 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
1565    to implement `Sized`.][67935]
1566 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
1567 - [`Layout::new` is now `const`.][66254]
1568 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
1569
1570
1571 Stabilized APIs
1572 ---------------
1573 - [`CondVar::wait_while`]
1574 - [`CondVar::wait_timeout_while`]
1575 - [`DebugMap::key`]
1576 - [`DebugMap::value`]
1577 - [`ManuallyDrop::take`]
1578 - [`matches!`]
1579 - [`ptr::slice_from_raw_parts_mut`]
1580 - [`ptr::slice_from_raw_parts`]
1581
1582 Cargo
1583 -----
1584 - [You no longer need to include `extern crate proc_macro;` to be able to
1585   `use proc_macro;` in the `2018` edition.][cargo/7700]
1586
1587 Compatibility Notes
1588 -------------------
1589 - [`Error::description` has been deprecated, and its use will now produce a
1590   warning.][66919] It's recommended to use `Display`/`to_string` instead.
1591
1592 [68253]: https://github.com/rust-lang/rust/pull/68253/
1593 [68348]: https://github.com/rust-lang/rust/pull/68348/
1594 [67935]: https://github.com/rust-lang/rust/pull/67935/
1595 [68339]: https://github.com/rust-lang/rust/pull/68339/
1596 [68122]: https://github.com/rust-lang/rust/pull/68122/
1597 [67712]: https://github.com/rust-lang/rust/pull/67712/
1598 [67887]: https://github.com/rust-lang/rust/pull/67887/
1599 [67131]: https://github.com/rust-lang/rust/pull/67131/
1600 [67233]: https://github.com/rust-lang/rust/pull/67233/
1601 [66899]: https://github.com/rust-lang/rust/pull/66899/
1602 [66919]: https://github.com/rust-lang/rust/pull/66919/
1603 [66254]: https://github.com/rust-lang/rust/pull/66254/
1604 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
1605 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
1606 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
1607 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
1608 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
1609 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
1610 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
1611 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
1612 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
1613
1614
1615 Version 1.41.1 (2020-02-27)
1616 ===========================
1617
1618 * [Always check types of static items][69145]
1619 * [Always check lifetime bounds of `Copy` impls][69145]
1620 * [Fix miscompilation in callers of `Layout::repeat`][69225]
1621
1622 [69225]: https://github.com/rust-lang/rust/issues/69225
1623 [69145]: https://github.com/rust-lang/rust/pull/69145
1624
1625
1626 Version 1.41.0 (2020-01-30)
1627 ===========================
1628
1629 Language
1630 --------
1631
1632 - [You can now pass type parameters to foreign items when implementing
1633   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
1634 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
1635   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
1636   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
1637 - [You can now use any valid identifier in a `format_args` macro.][66847]
1638   Previously identifiers starting with an underscore were not allowed.
1639 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
1640   enum variants.][66183] These are still rejected semantically, but
1641   can be seen and parsed by procedural macros and conditional compilation.
1642
1643 Compiler
1644 --------
1645
1646 - [Rustc will now warn if you have unused loop `'label`s.][66325]
1647 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
1648 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
1649 - [You can now pass an arguments file passing the `@path` syntax
1650   to rustc.][66172] Note that the format differs somewhat from what is
1651   found in other tooling; please see [the documentation][argfile-docs] for
1652   more information.
1653 - [You can now provide `--extern` flag without a path, indicating that it is
1654   available from the search path or specified with an `-L` flag.][64882]
1655
1656 \* Refer to Rust's [platform support page][platform-support-doc] for more
1657 information on Rust's tiered platform support.
1658
1659 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
1660
1661 Libraries
1662 ---------
1663
1664 - [The `core::panic` module is now stable.][66771] It was already stable
1665   through `std`.
1666 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
1667   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
1668 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
1669
1670 Stabilized APIs
1671 ---------------
1672
1673 - [`Result::map_or`]
1674 - [`Result::map_or_else`]
1675 - [`std::rc::Weak::weak_count`]
1676 - [`std::rc::Weak::strong_count`]
1677 - [`std::sync::Weak::weak_count`]
1678 - [`std::sync::Weak::strong_count`]
1679
1680 Cargo
1681 -----
1682
1683 - [Cargo will now document all the private items for binary crates
1684   by default.][cargo/7593]
1685 - [`cargo-install` will now reinstall the package if it detects that it is out
1686   of date.][cargo/7560]
1687 - [Cargo.lock now uses a more git friendly format that should help to reduce
1688   merge conflicts.][cargo/7579]
1689 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
1690   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
1691   optimisation level to `2` for debug builds. You can also use
1692   `[profile.<profile>.build-override]` to override build scripts and
1693   their dependencies.
1694
1695 Misc
1696 ----
1697
1698 - [You can now specify `edition` in documentation code blocks to compile the block
1699   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
1700   should be compiled the 2018 edition of Rust.
1701 - [You can now provide custom themes to rustdoc with `--theme`, and check the
1702   current theme with `--check-theme`.][54733]
1703 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
1704
1705 Compatibility Notes
1706 -------------------
1707
1708 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
1709   Apple targets.][apple-32bit-drop] This means that the source code is still
1710   available to build, but the targets are no longer being tested and release
1711   binaries for those platforms will no longer be distributed by the Rust project.
1712   Please refer to the linked blog post for more information.
1713
1714 [54733]: https://github.com/rust-lang/rust/pull/54733/
1715 [61351]: https://github.com/rust-lang/rust/pull/61351/
1716 [67255]: https://github.com/rust-lang/rust/pull/67255/
1717 [66661]: https://github.com/rust-lang/rust/pull/66661/
1718 [66771]: https://github.com/rust-lang/rust/pull/66771/
1719 [66847]: https://github.com/rust-lang/rust/pull/66847/
1720 [66238]: https://github.com/rust-lang/rust/pull/66238/
1721 [66277]: https://github.com/rust-lang/rust/pull/66277/
1722 [66325]: https://github.com/rust-lang/rust/pull/66325/
1723 [66172]: https://github.com/rust-lang/rust/pull/66172/
1724 [66183]: https://github.com/rust-lang/rust/pull/66183/
1725 [65879]: https://github.com/rust-lang/rust/pull/65879/
1726 [65013]: https://github.com/rust-lang/rust/pull/65013/
1727 [64882]: https://github.com/rust-lang/rust/pull/64882/
1728 [64325]: https://github.com/rust-lang/rust/pull/64325/
1729 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
1730 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
1731 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
1732 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
1733 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
1734 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
1735 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
1736 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
1737 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
1738 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
1739 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
1740
1741 Version 1.40.0 (2019-12-19)
1742 ===========================
1743
1744 Language
1745 --------
1746 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
1747   `const` contexts.][65188] e.g.
1748
1749   ```rust
1750   pub struct Point(i32, i32);
1751
1752   const ORIGIN: Point = {
1753       let constructor = Point;
1754
1755       constructor(0, 0)
1756   };
1757   ```
1758
1759 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
1760   indicate that there may be variants or fields added in the future.][64639]
1761   For example this requires adding a wild-card branch (`_ => {}`) to any match
1762   statements on a non-exhaustive `enum`. [(RFC 2008)]
1763 - [You can now use function-like procedural macros in `extern` blocks and in
1764   type positions.][63931] e.g. `type Generated = macro!();`
1765 - [Function-like and attribute procedural macros can now emit
1766   `macro_rules!` items, so you can now have your macros generate macros.][64035]
1767 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
1768   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
1769   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
1770
1771 Compiler
1772 --------
1773 - [Added tier 3 support\* for the
1774   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
1775 - [Added tier 3 support for the
1776   `aarch64-unknown-none-softfloat` target.][64589]
1777 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
1778   `mips64el-unknown-linux-muslabi64` targets.][65843]
1779
1780 \* Refer to Rust's [platform support page][platform-support-doc] for more
1781   information on Rust's tiered platform support.
1782
1783 Libraries
1784 ---------
1785 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
1786
1787 Stabilized APIs
1788 ---------------
1789 - [`BTreeMap::get_key_value`]
1790 - [`HashMap::get_key_value`]
1791 - [`Option::as_deref_mut`]
1792 - [`Option::as_deref`]
1793 - [`Option::flatten`]
1794 - [`UdpSocket::peer_addr`]
1795 - [`f32::to_be_bytes`]
1796 - [`f32::to_le_bytes`]
1797 - [`f32::to_ne_bytes`]
1798 - [`f64::to_be_bytes`]
1799 - [`f64::to_le_bytes`]
1800 - [`f64::to_ne_bytes`]
1801 - [`f32::from_be_bytes`]
1802 - [`f32::from_le_bytes`]
1803 - [`f32::from_ne_bytes`]
1804 - [`f64::from_be_bytes`]
1805 - [`f64::from_le_bytes`]
1806 - [`f64::from_ne_bytes`]
1807 - [`mem::take`]
1808 - [`slice::repeat`]
1809 - [`todo!`]
1810
1811 Cargo
1812 -----
1813 - [Cargo will now always display warnings, rather than only on
1814   fresh builds.][cargo/7450]
1815 - [Feature flags (except `--all-features`) passed to a virtual workspace will
1816   now produce an error.][cargo/7507] Previously these flags were ignored.
1817 - [You can now publish `dev-dependencies` without including
1818   a `version`.][cargo/7333]
1819
1820 Misc
1821 ----
1822 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
1823   when running documentation tests with `rustdoc`.][63803]
1824
1825 Compatibility Notes
1826 -------------------
1827 - [As previously announced, any previous NLL warnings in the 2015 edition are
1828   now hard errors.][64221]
1829 - [The `include!` macro will now warn if it failed to include the
1830   entire file.][64284] The `include!` macro unintentionally only includes the
1831   first _expression_ in a file, and this can be unintuitive. This will become
1832   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
1833 - [Using `#[inline]` on function prototypes and consts now emits a warning under
1834   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
1835   or `extern` blocks now correctly emits a hard error.
1836
1837 [65294]: https://github.com/rust-lang/rust/pull/65294/
1838 [66103]: https://github.com/rust-lang/rust/pull/66103/
1839 [65843]: https://github.com/rust-lang/rust/pull/65843/
1840 [65188]: https://github.com/rust-lang/rust/pull/65188/
1841 [65092]: https://github.com/rust-lang/rust/pull/65092/
1842 [64589]: https://github.com/rust-lang/rust/pull/64589/
1843 [64639]: https://github.com/rust-lang/rust/pull/64639/
1844 [64221]: https://github.com/rust-lang/rust/pull/64221/
1845 [64284]: https://github.com/rust-lang/rust/pull/64284/
1846 [63931]: https://github.com/rust-lang/rust/pull/63931/
1847 [64035]: https://github.com/rust-lang/rust/pull/64035/
1848 [63674]: https://github.com/rust-lang/rust/pull/63674/
1849 [63803]: https://github.com/rust-lang/rust/pull/63803/
1850 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
1851 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
1852 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
1853 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
1854 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
1855 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
1856 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
1857 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
1858 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
1859 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
1860 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
1861 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
1862 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
1863 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
1864 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
1865 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
1866 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
1867 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
1868 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
1869 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
1870 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
1871 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
1872 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
1873 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
1874 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
1875 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
1876
1877
1878 Version 1.39.0 (2019-11-07)
1879 ===========================
1880
1881 Language
1882 --------
1883 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
1884   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
1885 - [You can now use certain attributes on function, closure, and function pointer
1886   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
1887   `deny`, `forbid` as well as inert helper attributes used by procedural macro
1888   attributes applied to items. e.g.
1889   ```rust
1890   fn len(
1891       #[cfg(windows)] slice: &[u16],
1892       #[cfg(not(windows))] slice: &[u8],
1893   ) -> usize {
1894       slice.len()
1895   }
1896   ```
1897 - [You can now take shared references to bind-by-move patterns in the `if` guards
1898   of `match` arms.][63118] e.g.
1899   ```rust
1900   fn main() {
1901       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
1902
1903       match array {
1904           nums
1905   //      ---- `nums` is bound by move.
1906               if nums.iter().sum::<u8>() == 10
1907   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
1908           => {
1909               drop(nums);
1910   //          ----------- Legal as `nums` was bound by move and so we have ownership.
1911           }
1912           _ => unreachable!(),
1913       }
1914   }
1915   ```
1916
1917
1918
1919 Compiler
1920 --------
1921 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
1922 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
1923 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
1924   **Note** Cargo currently doesn't use this feature. Refer to
1925   [cargo#7315][cargo/7315] to track this feature's progress.
1926 - [You can now pass `--show-output` argument to test binaries to print the
1927   output of successful tests.][62600]
1928
1929
1930 \* Refer to Rust's [platform support page][platform-support-doc] for more
1931 information on Rust's tiered platform support.
1932
1933 Libraries
1934 ---------
1935 - [`Vec::new` and `String::new` are now `const` functions.][64028]
1936 - [`LinkedList::new` is now a `const` function.][63684]
1937 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
1938 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
1939   now `const`.][63786]
1940
1941 Stabilized APIs
1942 ---------------
1943 - [`Pin::into_inner`]
1944 - [`Instant::checked_duration_since`]
1945 - [`Instant::saturating_duration_since`]
1946
1947 Cargo
1948 -----
1949 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
1950 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
1951   `--all` is now deprecated.
1952
1953 Misc
1954 ----
1955 - [You can now pass `-Clinker` to rustdoc to control the linker used
1956   for compiling doctests.][63834]
1957
1958 Compatibility Notes
1959 -------------------
1960 - [Code that was previously accepted by the old borrow checker, but rejected by
1961   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
1962   previously a warning, and will also become a hard error in the Rust 2015
1963   edition in the 1.40.0 release.
1964 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
1965   run tests.][63827] This should improve performance when running a large
1966   amount of doctests.
1967 - [The `try!` macro will now issue a deprecation warning.][62672] It is
1968   recommended to use the `?` operator instead.
1969 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
1970   returned `0.0`.
1971
1972 [62600]: https://github.com/rust-lang/rust/pull/62600/
1973 [62672]: https://github.com/rust-lang/rust/pull/62672/
1974 [63118]: https://github.com/rust-lang/rust/pull/63118/
1975 [63209]: https://github.com/rust-lang/rust/pull/63209/
1976 [63402]: https://github.com/rust-lang/rust/pull/63402/
1977 [63565]: https://github.com/rust-lang/rust/pull/63565/
1978 [63595]: https://github.com/rust-lang/rust/pull/63595/
1979 [63684]: https://github.com/rust-lang/rust/pull/63684/
1980 [63698]: https://github.com/rust-lang/rust/pull/63698/
1981 [63770]: https://github.com/rust-lang/rust/pull/63770/
1982 [63786]: https://github.com/rust-lang/rust/pull/63786/
1983 [63827]: https://github.com/rust-lang/rust/pull/63827/
1984 [63834]: https://github.com/rust-lang/rust/pull/63834/
1985 [63927]: https://github.com/rust-lang/rust/pull/63927/
1986 [63933]: https://github.com/rust-lang/rust/pull/63933/
1987 [63934]: https://github.com/rust-lang/rust/pull/63934/
1988 [63938]: https://github.com/rust-lang/rust/pull/63938/
1989 [63940]: https://github.com/rust-lang/rust/pull/63940/
1990 [63941]: https://github.com/rust-lang/rust/pull/63941/
1991 [63945]: https://github.com/rust-lang/rust/pull/63945/
1992 [64010]: https://github.com/rust-lang/rust/pull/64010/
1993 [64028]: https://github.com/rust-lang/rust/pull/64028/
1994 [64334]: https://github.com/rust-lang/rust/pull/64334/
1995 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
1996 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
1997 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
1998 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
1999 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
2000 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
2001
2002 Version 1.38.0 (2019-09-26)
2003 ==========================
2004
2005 Language
2006 --------
2007 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
2008 - [The `#[deprecated]` attribute can now be used on macros.][62042]
2009
2010 Compiler
2011 --------
2012 - [Added pipelined compilation support to `rustc`.][62766] This will
2013   improve compilation times in some cases. For further information please refer
2014   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
2015 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
2016   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
2017   `x86_64-uwp-windows-msvc` targets.][60260]
2018 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
2019   `armv7-unknown-linux-musleabi` targets.][63107]
2020 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
2021 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
2022 - [Upgraded to LLVM 9.][62592]
2023
2024 \* Refer to Rust's [platform support page][platform-support-doc] for more
2025 information on Rust's tiered platform support.
2026
2027 Libraries
2028 ---------
2029 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
2030 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
2031   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
2032   is available at `std::clone::Clone`). This also makes all built-in macros
2033   available in `std`/`core` root. e.g. `std::include_bytes!`.
2034 - [`str::Chars` now implements `Debug`.][63000]
2035 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
2036 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
2037 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
2038 - [Added euclidean remainder and division operations (`div_euclid`,
2039   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
2040   `overflowing`, and `wrapping` versions are available for all
2041   integer primitives.
2042 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
2043   `PartialEq`.][61491]
2044 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
2045
2046 Stabilized APIs
2047 ---------------
2048 - [`<*const T>::cast`]
2049 - [`<*mut T>::cast`]
2050 - [`Duration::as_secs_f32`]
2051 - [`Duration::as_secs_f64`]
2052 - [`Duration::div_f32`]
2053 - [`Duration::div_f64`]
2054 - [`Duration::from_secs_f32`]
2055 - [`Duration::from_secs_f64`]
2056 - [`Duration::mul_f32`]
2057 - [`Duration::mul_f64`]
2058 - [`any::type_name`]
2059
2060 Cargo
2061 -----
2062 - [Added pipelined compilation support to `cargo`.][cargo/7143]
2063 - [You can now pass the `--features` option multiple times to enable
2064   multiple features.][cargo/7084]
2065
2066 Rustdoc
2067 -------
2068
2069 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
2070
2071 Misc
2072 ----
2073 - [`rustc` will now warn about some incorrect uses of
2074   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
2075
2076 Compatibility Notes
2077 -------------------
2078 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
2079   1.38.0.
2080 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
2081   issues][62896] with certain crates such as libc.
2082
2083 [60260]: https://github.com/rust-lang/rust/pull/60260/
2084 [61457]: https://github.com/rust-lang/rust/pull/61457/
2085 [61491]: https://github.com/rust-lang/rust/pull/61491/
2086 [61884]: https://github.com/rust-lang/rust/pull/61884/
2087 [61953]: https://github.com/rust-lang/rust/pull/61953/
2088 [62042]: https://github.com/rust-lang/rust/pull/62042/
2089 [62528]: https://github.com/rust-lang/rust/pull/62528/
2090 [62583]: https://github.com/rust-lang/rust/pull/62583/
2091 [62735]: https://github.com/rust-lang/rust/pull/62735/
2092 [62766]: https://github.com/rust-lang/rust/pull/62766/
2093 [62784]: https://github.com/rust-lang/rust/pull/62784/
2094 [62592]: https://github.com/rust-lang/rust/pull/62592/
2095 [62785]: https://github.com/rust-lang/rust/issues/62785/
2096 [62814]: https://github.com/rust-lang/rust/pull/62814/
2097 [62896]: https://github.com/rust-lang/rust/issues/62896/
2098 [63000]: https://github.com/rust-lang/rust/pull/63000/
2099 [63056]: https://github.com/rust-lang/rust/pull/63056/
2100 [63107]: https://github.com/rust-lang/rust/pull/63107/
2101 [63346]: https://github.com/rust-lang/rust/pull/63346/
2102 [63421]: https://github.com/rust-lang/rust/pull/63421/
2103 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
2104 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
2105 [63048]: https://github.com/rust-lang/rust/pull/63048
2106 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2107 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2108 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
2109 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
2110 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
2111 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
2112 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
2113 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
2114 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
2115 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
2116 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
2117 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
2118 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
2119
2120 Version 1.37.0 (2019-08-15)
2121 ==========================
2122
2123 Language
2124 --------
2125 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
2126   [`Box`][62228], or an [array][62235] and unused.
2127 - [You can now use the `cfg` and `cfg_attr` attributes on
2128   generic parameters.][61547]
2129 - [You can now use enum variants through type alias.][61682] e.g. You can
2130   write the following:
2131   ```rust
2132   type MyOption = Option<u8>;
2133
2134   fn increment_or_zero(x: MyOption) -> u8 {
2135       match x {
2136           MyOption::Some(y) => y + 1,
2137           MyOption::None => 0,
2138       }
2139   }
2140   ```
2141 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
2142   `const _: u32 = 5;`.
2143 - [You can now use `#[repr(align(X)]` on enums.][61229]
2144 - [The  `?` Kleene macro operator is now available in the
2145   2015 edition.][60932]
2146
2147 Compiler
2148 --------
2149 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
2150   and `-C profile-use` flags.][61268] For more information on how to use profile
2151   guided optimization, please refer to the [rustc book][rustc-book-pgo].
2152 - [The `rust-lldb` wrapper script should now work again.][61827]
2153
2154 Libraries
2155 ---------
2156 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
2157
2158 Stabilized APIs
2159 ---------------
2160 - [`BufReader::buffer`]
2161 - [`BufWriter::buffer`]
2162 - [`Cell::from_mut`]
2163 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
2164 - [`DoubleEndedIterator::nth_back`]
2165 - [`Option::xor`]
2166 - [`Wrapping::reverse_bits`]
2167 - [`i128::reverse_bits`]
2168 - [`i16::reverse_bits`]
2169 - [`i32::reverse_bits`]
2170 - [`i64::reverse_bits`]
2171 - [`i8::reverse_bits`]
2172 - [`isize::reverse_bits`]
2173 - [`slice::copy_within`]
2174 - [`u128::reverse_bits`]
2175 - [`u16::reverse_bits`]
2176 - [`u32::reverse_bits`]
2177 - [`u64::reverse_bits`]
2178 - [`u8::reverse_bits`]
2179 - [`usize::reverse_bits`]
2180
2181 Cargo
2182 -----
2183 - [`Cargo.lock` files are now included by default when publishing executable crates
2184   with executables.][cargo/7026]
2185 - [You can now specify `default-run="foo"` in `[package]` to specify the
2186   default executable to use for `cargo run`.][cargo/7056]
2187
2188 Misc
2189 ----
2190
2191 Compatibility Notes
2192 -------------------
2193 - [Using `...` for inclusive range patterns will now warn by default.][61342]
2194   Please transition your code to using the `..=` syntax for inclusive
2195   ranges instead.
2196 - [Using a trait object without the `dyn` will now warn by default.][61203]
2197   Please transition your code to use `dyn Trait` for trait objects instead.
2198
2199 [62228]: https://github.com/rust-lang/rust/pull/62228/
2200 [62235]: https://github.com/rust-lang/rust/pull/62235/
2201 [61802]: https://github.com/rust-lang/rust/pull/61802/
2202 [61827]: https://github.com/rust-lang/rust/pull/61827/
2203 [61547]: https://github.com/rust-lang/rust/pull/61547/
2204 [61682]: https://github.com/rust-lang/rust/pull/61682/
2205 [61268]: https://github.com/rust-lang/rust/pull/61268/
2206 [61342]: https://github.com/rust-lang/rust/pull/61342/
2207 [61347]: https://github.com/rust-lang/rust/pull/61347/
2208 [61100]: https://github.com/rust-lang/rust/pull/61100/
2209 [61203]: https://github.com/rust-lang/rust/pull/61203/
2210 [61229]: https://github.com/rust-lang/rust/pull/61229/
2211 [60932]: https://github.com/rust-lang/rust/pull/60932/
2212 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
2213 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
2214 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
2215 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
2216 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
2217 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
2218 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
2219 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
2220 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
2221 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
2222 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
2223 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
2224 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
2225 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
2226 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
2227 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
2228 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
2229 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
2230 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
2231 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
2232 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
2233 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
2234 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
2235 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
2236
2237
2238 Version 1.36.0 (2019-07-04)
2239 ==========================
2240
2241 Language
2242 --------
2243 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
2244 - [The order of traits in trait objects no longer affects the semantics of that
2245   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
2246   `dyn fmt::Debug + Send`, where this was previously not the case.
2247
2248 Libraries
2249 ---------
2250 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
2251 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
2252 - [`mem::needs_drop` is now available as a const fn.][60364]
2253 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
2254 - [`String` now implements `BorrowMut<str>`.][60404]
2255 - [`io::Cursor` now implements `Default`.][60234]
2256 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
2257 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
2258   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
2259   environment has access to heap memory allocation.
2260 - [`String` now implements `From<&String>`.][59825]
2261 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
2262   return a tuple of each argument when there is multiple arguments.
2263 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
2264   not used.][59648]
2265
2266 Stabilized APIs
2267 ---------------
2268 - [`VecDeque::rotate_left`]
2269 - [`VecDeque::rotate_right`]
2270 - [`Iterator::copied`]
2271 - [`io::IoSlice`]
2272 - [`io::IoSliceMut`]
2273 - [`Read::read_vectored`]
2274 - [`Write::write_vectored`]
2275 - [`str::as_mut_ptr`]
2276 - [`mem::MaybeUninit`]
2277 - [`pointer::align_offset`]
2278 - [`future::Future`]
2279 - [`task::Context`]
2280 - [`task::RawWaker`]
2281 - [`task::RawWakerVTable`]
2282 - [`task::Waker`]
2283 - [`task::Poll`]
2284
2285 Cargo
2286 -----
2287 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
2288 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
2289
2290 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
2291
2292 Clippy
2293 ------
2294 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
2295
2296 Misc
2297 ----
2298
2299 Compatibility Notes
2300 -------------------
2301 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
2302   longer recommended, and will be deprecated in 1.39.0.
2303
2304 [60318]: https://github.com/rust-lang/rust/pull/60318/
2305 [60364]: https://github.com/rust-lang/rust/pull/60364/
2306 [60370]: https://github.com/rust-lang/rust/pull/60370/
2307 [60404]: https://github.com/rust-lang/rust/pull/60404/
2308 [60234]: https://github.com/rust-lang/rust/pull/60234/
2309 [60244]: https://github.com/rust-lang/rust/pull/60244/
2310 [58623]: https://github.com/rust-lang/rust/pull/58623/
2311 [59648]: https://github.com/rust-lang/rust/pull/59648/
2312 [59675]: https://github.com/rust-lang/rust/pull/59675/
2313 [59825]: https://github.com/rust-lang/rust/pull/59825/
2314 [59826]: https://github.com/rust-lang/rust/pull/59826/
2315 [59445]: https://github.com/rust-lang/rust/pull/59445/
2316 [59114]: https://github.com/rust-lang/rust/pull/59114/
2317 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
2318 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
2319 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
2320 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
2321 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
2322 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
2323 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
2324 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
2325 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
2326 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
2327 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
2328 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
2329 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
2330 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
2331 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
2332 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
2333 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
2334 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
2335 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
2336 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
2337
2338
2339 Version 1.35.0 (2019-05-23)
2340 ==========================
2341
2342 Language
2343 --------
2344 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
2345   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
2346 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
2347   ```rust
2348   unsafe fn call_unsafe(func: unsafe fn()) {
2349       func()
2350   }
2351
2352   pub fn main() {
2353       unsafe { call_unsafe(|| {}); }
2354   }
2355   ```
2356
2357
2358 Compiler
2359 --------
2360 - [Added the `armv6-unknown-freebsd-gnueabihf` and
2361   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
2362 - [Added the `wasm32-unknown-wasi` target.][59464]
2363
2364
2365 Libraries
2366 ---------
2367 - [`Thread` will now show its ID in `Debug` output.][59460]
2368 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
2369 - [`alloc::System` now implements `Default`.][59451]
2370 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
2371   last field.][59076]
2372 - [`char::{ToLowercase, ToUppercase}` now
2373   implement `ExactSizeIterator`.][58778]
2374 - [All `NonZero` numeric types now implement `FromStr`.][58717]
2375 - [Removed the `Read` trait bounds
2376   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
2377 - [You can now call the `dbg!` macro without any parameters to print the file
2378   and line where it is called.][57847]
2379 - [In place ASCII case conversions are now up to 4× faster.][59283]
2380   e.g. `str::make_ascii_lowercase`
2381 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
2382   and `Send`.][58369]
2383
2384 Stabilized APIs
2385 ---------------
2386 - [`f32::copysign`]
2387 - [`f64::copysign`]
2388 - [`RefCell::replace_with`]
2389 - [`RefCell::map_split`]
2390 - [`ptr::hash`]
2391 - [`Range::contains`]
2392 - [`RangeFrom::contains`]
2393 - [`RangeTo::contains`]
2394 - [`RangeInclusive::contains`]
2395 - [`RangeToInclusive::contains`]
2396 - [`Option::copied`]
2397
2398 Cargo
2399 -----
2400 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
2401   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
2402   platform specific.
2403
2404 Misc
2405 ----
2406 - [The Rust toolchain is now available natively for musl based distros.][58575]
2407
2408 [59460]: https://github.com/rust-lang/rust/pull/59460/
2409 [59464]: https://github.com/rust-lang/rust/pull/59464/
2410 [59500]: https://github.com/rust-lang/rust/pull/59500/
2411 [59512]: https://github.com/rust-lang/rust/pull/59512/
2412 [59580]: https://github.com/rust-lang/rust/pull/59580/
2413 [59283]: https://github.com/rust-lang/rust/pull/59283/
2414 [59451]: https://github.com/rust-lang/rust/pull/59451/
2415 [59076]: https://github.com/rust-lang/rust/pull/59076/
2416 [58778]: https://github.com/rust-lang/rust/pull/58778/
2417 [58717]: https://github.com/rust-lang/rust/pull/58717/
2418 [58369]: https://github.com/rust-lang/rust/pull/58369/
2419 [58423]: https://github.com/rust-lang/rust/pull/58423/
2420 [58080]: https://github.com/rust-lang/rust/pull/58080/
2421 [57847]: https://github.com/rust-lang/rust/pull/57847/
2422 [58575]: https://github.com/rust-lang/rust/pull/58575
2423 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
2424 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
2425 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
2426 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
2427 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
2428 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
2429 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
2430 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
2431 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
2432 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
2433 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
2434 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
2435
2436 Version 1.34.2 (2019-05-14)
2437 ===========================
2438
2439 * [Destabilize the `Error::type_id` function due to a security
2440    vulnerability][60785] ([CVE-2019-12083])
2441
2442 [60785]: https://github.com/rust-lang/rust/pull/60785
2443 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
2444
2445 Version 1.34.1 (2019-04-25)
2446 ===========================
2447
2448 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
2449 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
2450 * [Fix Clippy panic when checking some macros][clippy/3805]
2451
2452 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
2453 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
2454 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
2455
2456 Version 1.34.0 (2019-04-11)
2457 ==========================
2458
2459 Language
2460 --------
2461 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
2462   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
2463   but had no effect.
2464 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
2465   `#[attr{}]` procedural macros.][57367]
2466 - [You can now write `extern crate self as foo;`][57407] to import your
2467   crate's root into the extern prelude.
2468
2469
2470 Compiler
2471 --------
2472 - [You can now target `riscv64imac-unknown-none-elf` and
2473   `riscv64gc-unknown-none-elf`.][58406]
2474 - [You can now enable linker plugin LTO optimisations with
2475   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
2476   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
2477   boundaries.
2478 - [You can now target `powerpc64-unknown-freebsd`.][57809]
2479
2480
2481 Libraries
2482 ---------
2483 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
2484   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
2485   the `Hash` trait to create an iterator.
2486 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
2487   methods.][58421] Most notably you no longer require the `Ord` trait to create
2488   an iterator.
2489 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
2490   for all numeric types.][58044]
2491 - [Indexing a `str` is now generic over all types that
2492   implement `SliceIndex<str>`.][57604]
2493 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
2494   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
2495   produce a warning if their returning type is unused.
2496 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
2497   `overflowing_pow` are now available for all numeric types.][57873] These are
2498   equivalent to methods such as `wrapping_add` for the `pow` operation.
2499
2500
2501 Stabilized APIs
2502 ---------------
2503
2504 #### std & core
2505 * [`Any::type_id`]
2506 * [`Error::type_id`]
2507 * [`atomic::AtomicI16`]
2508 * [`atomic::AtomicI32`]
2509 * [`atomic::AtomicI64`]
2510 * [`atomic::AtomicI8`]
2511 * [`atomic::AtomicU16`]
2512 * [`atomic::AtomicU32`]
2513 * [`atomic::AtomicU64`]
2514 * [`atomic::AtomicU8`]
2515 * [`convert::Infallible`]
2516 * [`convert::TryFrom`]
2517 * [`convert::TryInto`]
2518 * [`iter::from_fn`]
2519 * [`iter::successors`]
2520 * [`num::NonZeroI128`]
2521 * [`num::NonZeroI16`]
2522 * [`num::NonZeroI32`]
2523 * [`num::NonZeroI64`]
2524 * [`num::NonZeroI8`]
2525 * [`num::NonZeroIsize`]
2526 * [`slice::sort_by_cached_key`]
2527 * [`str::escape_debug`]
2528 * [`str::escape_default`]
2529 * [`str::escape_unicode`]
2530 * [`str::split_ascii_whitespace`]
2531
2532 #### std
2533 * [`Instant::checked_add`]
2534 * [`Instant::checked_sub`]
2535 * [`SystemTime::checked_add`]
2536 * [`SystemTime::checked_sub`]
2537
2538 Cargo
2539 -----
2540 - [You can now use alternative registries to crates.io.][cargo/6654]
2541
2542 Misc
2543 ----
2544 - [You can now use the `?` operator in your documentation tests without manually
2545   adding `fn main() -> Result<(), _> {}`.][56470]
2546
2547 Compatibility Notes
2548 -------------------
2549 - [`Command::before_exec` is being replaced by the unsafe method
2550   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
2551 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
2552   can now use `const` functions in `static` variables.
2553
2554 [58370]: https://github.com/rust-lang/rust/pull/58370/
2555 [58406]: https://github.com/rust-lang/rust/pull/58406/
2556 [58421]: https://github.com/rust-lang/rust/pull/58421/
2557 [58166]: https://github.com/rust-lang/rust/pull/58166/
2558 [58044]: https://github.com/rust-lang/rust/pull/58044/
2559 [58057]: https://github.com/rust-lang/rust/pull/58057/
2560 [58059]: https://github.com/rust-lang/rust/pull/58059/
2561 [57809]: https://github.com/rust-lang/rust/pull/57809/
2562 [57873]: https://github.com/rust-lang/rust/pull/57873/
2563 [57604]: https://github.com/rust-lang/rust/pull/57604/
2564 [57367]: https://github.com/rust-lang/rust/pull/57367/
2565 [57407]: https://github.com/rust-lang/rust/pull/57407/
2566 [57425]: https://github.com/rust-lang/rust/pull/57425/
2567 [57106]: https://github.com/rust-lang/rust/pull/57106/
2568 [56470]: https://github.com/rust-lang/rust/pull/56470/
2569 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
2570 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
2571 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
2572 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
2573 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
2574 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
2575 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
2576 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
2577 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
2578 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
2579 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
2580 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
2581 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
2582 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
2583 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
2584 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
2585 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
2586 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
2587 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
2588 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
2589 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
2590 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
2591 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
2592 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
2593 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
2594 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
2595 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
2596 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
2597 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
2598 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
2599 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
2600
2601
2602 Version 1.33.0 (2019-02-28)
2603 ==========================
2604
2605 Language
2606 --------
2607 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
2608   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
2609 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
2610   E.g. You can have match statement on a `u8` that covers `0..=255` and
2611   you would no longer be required to have a `_ => unreachable!()` case.
2612 - [You can now have multiple patterns in `if let` and `while let`
2613   expressions.][57532] You can do this with the same syntax as a `match`
2614   expression. E.g.
2615   ```rust
2616   enum Creature {
2617       Crab(String),
2618       Lobster(String),
2619       Person(String),
2620   }
2621
2622   fn main() {
2623       let state = Creature::Crab("Ferris");
2624
2625       if let Creature::Crab(name) | Creature::Person(name) = state {
2626           println!("This creature's name is: {}", name);
2627       }
2628   }
2629   ```
2630 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
2631   this feature will by default produce a warning as this behaviour can be
2632   unintuitive. E.g. `if let _ = 5 {}`
2633 - [You can now use `let` bindings, assignments, expression statements,
2634   and irrefutable pattern destructuring in const functions.][57175]
2635 - [You can now call unsafe const functions.][57067] E.g.
2636   ```rust
2637   const unsafe fn foo() -> i32 { 5 }
2638   const fn bar() -> i32 {
2639       unsafe { foo() }
2640   }
2641   ```
2642 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
2643   E.g. `#[cfg_attr(all(), must_use, optimize)]`
2644 - [You can now specify a specific alignment with the `#[repr(packed)]`
2645   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
2646   with an alignment of 2 bytes and a size of 6 bytes.
2647 - [You can now import an item from a module as an `_`.][56303] This allows you to
2648   import a trait's impls, and not have the name in the namespace. E.g.
2649   ```rust
2650   use std::io::Read as _;
2651
2652   // Allowed as there is only one `Read` in the module.
2653   pub trait Read {}
2654   ```
2655 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
2656
2657 Compiler
2658 --------
2659 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
2660   command line argument.][56351]
2661 - [The minimum required LLVM version has been bumped to 6.0.][56642]
2662 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
2663 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
2664   tier 2 support.][57130] Visit the [platform support][platform-support] page for
2665   information on Rust's platform support.
2666 - [Added support for the `thumbv7neon-linux-androideabi` and
2667   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
2668 - [Added support for the `x86_64-unknown-uefi` target.][56769]
2669
2670 Libraries
2671 ---------
2672 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
2673   functions for all numeric types.][57566]
2674 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
2675   are now `const` functions for all numeric types.][57105]
2676 - [The methods `is_positive` and `is_negative` are now `const` functions for
2677   all signed numeric types.][57105]
2678 - [The `get` method for all `NonZero` types is now `const`.][57167]
2679 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
2680   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
2681   numeric types.][57234]
2682 - [`Ipv4Addr::new` is now a `const` function][57234]
2683
2684 Stabilized APIs
2685 ---------------
2686 - [`unix::FileExt::read_exact_at`]
2687 - [`unix::FileExt::write_all_at`]
2688 - [`Option::transpose`]
2689 - [`Result::transpose`]
2690 - [`convert::identity`]
2691 - [`pin::Pin`]
2692 - [`marker::Unpin`]
2693 - [`marker::PhantomPinned`]
2694 - [`Vec::resize_with`]
2695 - [`VecDeque::resize_with`]
2696 - [`Duration::as_millis`]
2697 - [`Duration::as_micros`]
2698 - [`Duration::as_nanos`]
2699
2700
2701 Cargo
2702 -----
2703 - [You can now publish crates that require a feature flag to compile with
2704   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
2705 - [Cargo should now rebuild a crate if a file was modified during the initial
2706   build.][cargo/6484]
2707
2708 Compatibility Notes
2709 -------------------
2710 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
2711   are now deprecated in the standard library, and their usage will now produce a warning.
2712   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
2713   methods instead.
2714 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
2715   downcasting.
2716 - [Libtest no longer creates a new thread for each test when
2717   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
2718
2719 [55982]: https://github.com/rust-lang/rust/pull/55982/
2720 [56243]: https://github.com/rust-lang/rust/pull/56243
2721 [56303]: https://github.com/rust-lang/rust/pull/56303/
2722 [56351]: https://github.com/rust-lang/rust/pull/56351/
2723 [56362]: https://github.com/rust-lang/rust/pull/56362
2724 [56642]: https://github.com/rust-lang/rust/pull/56642/
2725 [56769]: https://github.com/rust-lang/rust/pull/56769/
2726 [56805]: https://github.com/rust-lang/rust/pull/56805
2727 [56947]: https://github.com/rust-lang/rust/pull/56947/
2728 [57049]: https://github.com/rust-lang/rust/pull/57049/
2729 [57067]: https://github.com/rust-lang/rust/pull/57067/
2730 [57105]: https://github.com/rust-lang/rust/pull/57105
2731 [57130]: https://github.com/rust-lang/rust/pull/57130/
2732 [57167]: https://github.com/rust-lang/rust/pull/57167/
2733 [57175]: https://github.com/rust-lang/rust/pull/57175/
2734 [57234]: https://github.com/rust-lang/rust/pull/57234/
2735 [57332]: https://github.com/rust-lang/rust/pull/57332/
2736 [57465]: https://github.com/rust-lang/rust/pull/57465/
2737 [57532]: https://github.com/rust-lang/rust/pull/57532/
2738 [57535]: https://github.com/rust-lang/rust/pull/57535/
2739 [57566]: https://github.com/rust-lang/rust/pull/57566/
2740 [57615]: https://github.com/rust-lang/rust/pull/57615/
2741 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
2742 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
2743 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
2744 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
2745 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
2746 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
2747 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
2748 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
2749 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
2750 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
2751 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
2752 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
2753 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
2754 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
2755 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
2756 [platform-support]: https://forge.rust-lang.org/platform-support.html
2757
2758 Version 1.32.0 (2019-01-17)
2759 ==========================
2760
2761 Language
2762 --------
2763 #### 2018 edition
2764 - [You can now use the `?` operator in macro definitions.][56245] The `?`
2765   operator allows you to specify zero or one repetitions similar to the `*` and
2766   `+` operators.
2767 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
2768   now always resolve to the item (`enum`, `struct`, etc.) available in the
2769   module if present, before resolving to a external crate or an item the prelude.][56759]
2770   E.g.
2771   ```rust
2772   enum Color { Red, Green, Blue }
2773
2774   use Color::*;
2775   ```
2776
2777 #### All editions
2778 - [You can now match against `PhantomData<T>` types.][55837]
2779 - [You can now match against literals in macros with the `literal`
2780   specifier.][56072] This will match against a literal of any type.
2781   E.g. `1`, `'A'`, `"Hello World"`
2782 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
2783   ```rust
2784   struct Point(i32, i32);
2785
2786   impl Point {
2787       pub fn new(x: i32, y: i32) -> Self {
2788           Self(x, y)
2789       }
2790
2791       pub fn is_origin(&self) -> bool {
2792           match self {
2793               Self(0, 0) => true,
2794               _ => false,
2795           }
2796       }
2797   }
2798   ```
2799 - [Self can also now be used in type definitions.][56366] E.g.
2800   ```rust
2801   enum List<T>
2802   where
2803       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
2804   {
2805       Nil,
2806       Cons(T, Box<Self>) // likewise here
2807   }
2808   ```
2809 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
2810   a `impl Trait` or `dyn Trait` is returned and unused in the program.
2811
2812 Compiler
2813 --------
2814 - [The default allocator has changed from jemalloc to the default allocator on
2815   your system.][55238] The compiler itself on Linux & macOS will still use
2816   jemalloc, but programs compiled with it will use the system allocator.
2817 - [Added the `aarch64-pc-windows-msvc` target.][55702]
2818
2819 Libraries
2820 ---------
2821 - [`PathBuf` now implements `FromStr`.][55148]
2822 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
2823 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
2824   easily debug expressions in your rust program. E.g.
2825   ```rust
2826   let a = 2;
2827   let b = dbg!(a * 2) + 1;
2828   //      ^-- prints: [src/main.rs:4] a * 2 = 4
2829   assert_eq!(b, 5);
2830   ```
2831
2832 The following APIs are now `const` functions and can be used in a
2833 `const` context.
2834
2835 - [`Cell::as_ptr`]
2836 - [`UnsafeCell::get`]
2837 - [`char::is_ascii`]
2838 - [`iter::empty`]
2839 - [`ManuallyDrop::new`]
2840 - [`ManuallyDrop::into_inner`]
2841 - [`RangeInclusive::start`]
2842 - [`RangeInclusive::end`]
2843 - [`NonNull::as_ptr`]
2844 - [`slice::as_ptr`]
2845 - [`str::as_ptr`]
2846 - [`Duration::as_secs`]
2847 - [`Duration::subsec_millis`]
2848 - [`Duration::subsec_micros`]
2849 - [`Duration::subsec_nanos`]
2850 - [`CStr::as_ptr`]
2851 - [`Ipv4Addr::is_unspecified`]
2852 - [`Ipv6Addr::new`]
2853 - [`Ipv6Addr::octets`]
2854
2855 Stabilized APIs
2856 ---------------
2857 - [`i8::to_be_bytes`]
2858 - [`i8::to_le_bytes`]
2859 - [`i8::to_ne_bytes`]
2860 - [`i8::from_be_bytes`]
2861 - [`i8::from_le_bytes`]
2862 - [`i8::from_ne_bytes`]
2863 - [`i16::to_be_bytes`]
2864 - [`i16::to_le_bytes`]
2865 - [`i16::to_ne_bytes`]
2866 - [`i16::from_be_bytes`]
2867 - [`i16::from_le_bytes`]
2868 - [`i16::from_ne_bytes`]
2869 - [`i32::to_be_bytes`]
2870 - [`i32::to_le_bytes`]
2871 - [`i32::to_ne_bytes`]
2872 - [`i32::from_be_bytes`]
2873 - [`i32::from_le_bytes`]
2874 - [`i32::from_ne_bytes`]
2875 - [`i64::to_be_bytes`]
2876 - [`i64::to_le_bytes`]
2877 - [`i64::to_ne_bytes`]
2878 - [`i64::from_be_bytes`]
2879 - [`i64::from_le_bytes`]
2880 - [`i64::from_ne_bytes`]
2881 - [`i128::to_be_bytes`]
2882 - [`i128::to_le_bytes`]
2883 - [`i128::to_ne_bytes`]
2884 - [`i128::from_be_bytes`]
2885 - [`i128::from_le_bytes`]
2886 - [`i128::from_ne_bytes`]
2887 - [`isize::to_be_bytes`]
2888 - [`isize::to_le_bytes`]
2889 - [`isize::to_ne_bytes`]
2890 - [`isize::from_be_bytes`]
2891 - [`isize::from_le_bytes`]
2892 - [`isize::from_ne_bytes`]
2893 - [`u8::to_be_bytes`]
2894 - [`u8::to_le_bytes`]
2895 - [`u8::to_ne_bytes`]
2896 - [`u8::from_be_bytes`]
2897 - [`u8::from_le_bytes`]
2898 - [`u8::from_ne_bytes`]
2899 - [`u16::to_be_bytes`]
2900 - [`u16::to_le_bytes`]
2901 - [`u16::to_ne_bytes`]
2902 - [`u16::from_be_bytes`]
2903 - [`u16::from_le_bytes`]
2904 - [`u16::from_ne_bytes`]
2905 - [`u32::to_be_bytes`]
2906 - [`u32::to_le_bytes`]
2907 - [`u32::to_ne_bytes`]
2908 - [`u32::from_be_bytes`]
2909 - [`u32::from_le_bytes`]
2910 - [`u32::from_ne_bytes`]
2911 - [`u64::to_be_bytes`]
2912 - [`u64::to_le_bytes`]
2913 - [`u64::to_ne_bytes`]
2914 - [`u64::from_be_bytes`]
2915 - [`u64::from_le_bytes`]
2916 - [`u64::from_ne_bytes`]
2917 - [`u128::to_be_bytes`]
2918 - [`u128::to_le_bytes`]
2919 - [`u128::to_ne_bytes`]
2920 - [`u128::from_be_bytes`]
2921 - [`u128::from_le_bytes`]
2922 - [`u128::from_ne_bytes`]
2923 - [`usize::to_be_bytes`]
2924 - [`usize::to_le_bytes`]
2925 - [`usize::to_ne_bytes`]
2926 - [`usize::from_be_bytes`]
2927 - [`usize::from_le_bytes`]
2928 - [`usize::from_ne_bytes`]
2929
2930 Cargo
2931 -----
2932 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
2933 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
2934
2935 Misc
2936 ----
2937 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
2938
2939 Compatibility Notes
2940 -------------------
2941 - [The argument types for AVX's
2942   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
2943   been changed from `*const` to `*mut` as the previous implementation
2944   was unsound.
2945
2946
2947 [55148]: https://github.com/rust-lang/rust/pull/55148/
2948 [55238]: https://github.com/rust-lang/rust/pull/55238/
2949 [55280]: https://github.com/rust-lang/rust/pull/55280/
2950 [55610]: https://github.com/rust-lang/rust/pull/55610/
2951 [55663]: https://github.com/rust-lang/rust/pull/55663/
2952 [55702]: https://github.com/rust-lang/rust/pull/55702/
2953 [55837]: https://github.com/rust-lang/rust/pull/55837/
2954 [55843]: https://github.com/rust-lang/rust/pull/55843/
2955 [56072]: https://github.com/rust-lang/rust/pull/56072/
2956 [56245]: https://github.com/rust-lang/rust/pull/56245/
2957 [56365]: https://github.com/rust-lang/rust/pull/56365/
2958 [56366]: https://github.com/rust-lang/rust/pull/56366/
2959 [56395]: https://github.com/rust-lang/rust/pull/56395/
2960 [56759]: https://github.com/rust-lang/rust/pull/56759/
2961 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
2962 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
2963 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
2964 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
2965 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
2966 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
2967 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
2968 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
2969 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
2970 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
2971 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
2972 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
2973 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
2974 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
2975 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
2976 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
2977 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
2978 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
2979 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
2980 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
2981 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
2982 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
2983 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
2984 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
2985 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
2986 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
2987 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
2988 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
2989 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
2990 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
2991 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
2992 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
2993 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
2994 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
2995 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
2996 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
2997 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
2998 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
2999 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
3000 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
3001 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
3002 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
3003 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
3004 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
3005 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
3006 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
3007 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
3008 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
3009 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
3010 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
3011 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
3012 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
3013 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
3014 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
3015 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
3016 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
3017 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
3018 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
3019 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
3020 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
3021 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
3022 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
3023 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
3024 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
3025 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
3026 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
3027 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
3028 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
3029 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
3030 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
3031 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
3032 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
3033 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
3034 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
3035 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
3036 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
3037 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
3038 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
3039 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
3040 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
3041 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
3042 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
3043 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
3044 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
3045 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
3046 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
3047 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
3048 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
3049 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
3050 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
3051 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
3052 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
3053 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
3054
3055
3056 Version 1.31.1 (2018-12-20)
3057 ===========================
3058
3059 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
3060 - [Fix broken go-to-definition in RLS][rls/1171]
3061 - [Fix infinite loop on hover in RLS][rls/1170]
3062
3063 [56562]: https://github.com/rust-lang/rust/pull/56562
3064 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
3065 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
3066
3067 Version 1.31.0 (2018-12-06)
3068 ==========================
3069
3070 Language
3071 --------
3072 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
3073 - [New lifetime elision rules now allow for eliding lifetimes in functions and
3074   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
3075   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
3076   in structs.
3077 - [You can now define and use `const` functions.][54835] These are currently
3078   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
3079   [language reference][const-reference] for what exactly is available.
3080 - [You can now use tool lints, which allow you to scope lints from external
3081   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
3082 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
3083   a crate, not just in exported functions.][54451]
3084 - [You can now use parentheses in pattern matches.][54497]
3085
3086 Compiler
3087 --------
3088 - [Updated musl to 1.1.20][54430]
3089
3090 Libraries
3091 ---------
3092 - [You can now convert `num::NonZero*` types to their raw equivalents using the
3093   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
3094 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
3095   into `Option<&mut T>` using the `From` trait.][53218]
3096 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
3097
3098
3099 Stabilized APIs
3100 ---------------
3101 - [`slice::align_to`]
3102 - [`slice::align_to_mut`]
3103 - [`slice::chunks_exact`]
3104 - [`slice::chunks_exact_mut`]
3105 - [`slice::rchunks`]
3106 - [`slice::rchunks_mut`]
3107 - [`slice::rchunks_exact`]
3108 - [`slice::rchunks_exact_mut`]
3109 - [`Option::replace`]
3110
3111 Cargo
3112 -----
3113 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
3114 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
3115   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
3116
3117 [52813]: https://github.com/rust-lang/rust/pull/52813/
3118 [53218]: https://github.com/rust-lang/rust/pull/53218/
3119 [53555]: https://github.com/rust-lang/rust/issues/53555/
3120 [54057]: https://github.com/rust-lang/rust/pull/54057/
3121 [54240]: https://github.com/rust-lang/rust/pull/54240/
3122 [54430]: https://github.com/rust-lang/rust/pull/54430/
3123 [54451]: https://github.com/rust-lang/rust/pull/54451/
3124 [54497]: https://github.com/rust-lang/rust/pull/54497/
3125 [54778]: https://github.com/rust-lang/rust/pull/54778/
3126 [54835]: https://github.com/rust-lang/rust/pull/54835/
3127 [54870]: https://github.com/rust-lang/rust/pull/54870/
3128 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
3129 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
3130 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
3131 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
3132 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
3133 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
3134 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3135 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
3136 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3137 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
3138 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
3139 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
3140 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
3141 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
3142
3143 Version 1.30.1 (2018-11-08)
3144 ===========================
3145
3146 - [Fixed overflow ICE in rustdoc][54199]
3147 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
3148
3149 [54199]: https://github.com/rust-lang/rust/pull/54199
3150 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
3151
3152 Version 1.30.0 (2018-10-25)
3153 ==========================
3154
3155 Language
3156 --------
3157 - [Procedural macros are now available.][52081] These kinds of macros allow for
3158   more powerful code generation. There is a [new chapter available][proc-macros]
3159   in the Rust Programming Language book that goes further in depth.
3160 - [You can now use keywords as identifiers using the raw identifiers
3161   syntax (`r#`),][53236] e.g. `let r#for = true;`
3162 - [Using anonymous parameters in traits is now deprecated with a warning and
3163   will be a hard error in the 2018 edition.][53272]
3164 - [You can now use `crate` in paths.][54404] This allows you to refer to the
3165   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
3166 - [Using a external crate no longer requires being prefixed with `::`.][54404]
3167   Previously, using a external crate in a module without a use statement
3168   required `let json = ::serde_json::from_str(foo);` but can now be written
3169   as `let json = serde_json::from_str(foo);`.
3170 - [You can now apply the `#[used]` attribute to static items to prevent the
3171   compiler from optimising them away, even if they appear to be unused,][51363]
3172   e.g. `#[used] static FOO: u32 = 1;`
3173 - [You can now import and reexport macros from other crates with the `use`
3174   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
3175   the root module of the crate. If your macro relies on calling other local
3176   macros, it is recommended to export with the
3177   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
3178   those macros.
3179 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
3180   using the `vis` specifier.][53370]
3181 - [Non-macro attributes now allow all forms of literals, not just
3182   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
3183   write `#[attr(true)]`.
3184 - [You can now specify a function to handle a panic in the Rust runtime with the
3185   `#[panic_handler]` attribute.][51366]
3186
3187 Compiler
3188 --------
3189 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
3190 - [Added the `aarch64-unknown-netbsd` target][53165]
3191 - [Upgraded to LLVM 8.][53611]
3192
3193 Libraries
3194 ---------
3195 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
3196
3197 Stabilized APIs
3198 ---------------
3199 - [`Ipv4Addr::BROADCAST`]
3200 - [`Ipv4Addr::LOCALHOST`]
3201 - [`Ipv4Addr::UNSPECIFIED`]
3202 - [`Ipv6Addr::LOCALHOST`]
3203 - [`Ipv6Addr::UNSPECIFIED`]
3204 - [`Iterator::find_map`]
3205
3206   The following methods are replacement methods for `trim_left`, `trim_right`,
3207   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
3208   in 1.33.0:
3209 - [`str::trim_end_matches`]
3210 - [`str::trim_end`]
3211 - [`str::trim_start_matches`]
3212 - [`str::trim_start`]
3213
3214 Cargo
3215 ----
3216 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
3217 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
3218   equivalent to calling `rustdoc --error-format=json`.
3219 - [Cargo will now provide a progress bar for builds.][cargo/5995]
3220
3221 Misc
3222 ----
3223 - [`rustdoc` allows you to specify what edition to treat your code as with the
3224   `--edition` option.][54057]
3225 - [`rustdoc` now has the `--color` (specify whether to output color) and
3226   `--error-format` (specify error format, e.g. `json`) options.][53003]
3227 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
3228   debug symbols.][53774]
3229 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
3230   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
3231
3232 [50911]: https://github.com/rust-lang/rust/pull/50911/
3233 [51363]: https://github.com/rust-lang/rust/pull/51363/
3234 [51366]: https://github.com/rust-lang/rust/pull/51366/
3235 [52081]: https://github.com/rust-lang/rust/pull/52081/
3236 [53003]: https://github.com/rust-lang/rust/pull/53003/
3237 [53033]: https://github.com/rust-lang/rust/pull/53033/
3238 [53044]: https://github.com/rust-lang/rust/pull/53044/
3239 [53165]: https://github.com/rust-lang/rust/pull/53165/
3240 [53611]: https://github.com/rust-lang/rust/pull/53611/
3241 [53213]: https://github.com/rust-lang/rust/pull/53213/
3242 [53236]: https://github.com/rust-lang/rust/pull/53236/
3243 [53272]: https://github.com/rust-lang/rust/pull/53272/
3244 [53370]: https://github.com/rust-lang/rust/pull/53370/
3245 [53459]: https://github.com/rust-lang/rust/pull/53459/
3246 [53774]: https://github.com/rust-lang/rust/pull/53774/
3247 [53822]: https://github.com/rust-lang/rust/pull/53822/
3248 [54057]: https://github.com/rust-lang/rust/pull/54057/
3249 [54146]: https://github.com/rust-lang/rust/pull/54146/
3250 [54404]: https://github.com/rust-lang/rust/pull/54404/
3251 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
3252 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
3253 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
3254 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
3255
3256 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
3257 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
3258 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
3259 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
3260 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
3261 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
3262 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
3263 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
3264 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
3265 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
3266
3267
3268 Version 1.29.2 (2018-10-11)
3269 ===========================
3270
3271 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
3272 - The `rls-preview` component on the windows-gnu targets has been restored.
3273
3274 [54639]: https://github.com/rust-lang/rust/pull/54639
3275
3276
3277 Version 1.29.1 (2018-09-25)
3278 ===========================
3279
3280 Security Notes
3281 --------------
3282
3283 - The standard library's `str::repeat` function contained an out of bounds write
3284   caused by an integer overflow. This has been fixed by deterministically
3285   panicking when an overflow happens.
3286
3287   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
3288   us.
3289
3290
3291 Version 1.29.0 (2018-09-13)
3292 ==========================
3293
3294 Compiler
3295 --------
3296 - [Bumped minimum LLVM version to 5.0.][51899]
3297 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
3298 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
3299 - [Upgraded to LLVM 7.][51966]
3300
3301 Libraries
3302 ---------
3303 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
3304 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
3305 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
3306 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
3307   for `&str`.][51178]
3308 - [`Cell<T>` now allows `T` to be unsized.][50494]
3309 - [`SocketAddr` is now stable on Redox.][52656]
3310
3311 Stabilized APIs
3312 ---------------
3313 - [`Arc::downcast`]
3314 - [`Iterator::flatten`]
3315 - [`Rc::downcast`]
3316
3317 Cargo
3318 -----
3319 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
3320   `--locked` to disable this behavior.
3321 - [`cargo-install` will now allow you to cross compile an install
3322   using `--target`.][cargo/5614]
3323 - [Added the `cargo-fix` subcommand to automatically move project code from
3324   2015 edition to 2018.][cargo/5723]
3325 - [`cargo doc` can now optionally document private types using the
3326   `--document-private-items` flag.][cargo/5543]
3327
3328 Misc
3329 ----
3330 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
3331   the specified level to that level.][52354] For example `--cap-lints warn`
3332   will demote `deny` and `forbid` lints to `warn`.
3333 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
3334   fails and `101` if there is a panic.][52197]
3335 - [A preview of clippy has been made available through rustup.][51122]
3336   You can install the preview with `rustup component add clippy-preview`.
3337
3338 Compatibility Notes
3339 -------------------
3340 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
3341   Use `str::get_unchecked(begin..end)` instead.
3342 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
3343   Consider using the `home_dir` function from
3344   https://crates.io/crates/dirs instead.
3345 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
3346 - [`cfg` attributes and `--cfg` command line flags are now more
3347   strictly validated.][53893]
3348
3349 [53893]: https://github.com/rust-lang/rust/pull/53893/
3350 [52861]: https://github.com/rust-lang/rust/pull/52861/
3351 [51966]: https://github.com/rust-lang/rust/pull/51966/
3352 [52656]: https://github.com/rust-lang/rust/pull/52656/
3353 [52239]: https://github.com/rust-lang/rust/pull/52239/
3354 [52330]: https://github.com/rust-lang/rust/pull/52330/
3355 [52354]: https://github.com/rust-lang/rust/pull/52354/
3356 [52402]: https://github.com/rust-lang/rust/pull/52402/
3357 [52103]: https://github.com/rust-lang/rust/pull/52103/
3358 [52197]: https://github.com/rust-lang/rust/pull/52197/
3359 [51807]: https://github.com/rust-lang/rust/pull/51807/
3360 [51899]: https://github.com/rust-lang/rust/pull/51899/
3361 [51912]: https://github.com/rust-lang/rust/pull/51912/
3362 [51511]: https://github.com/rust-lang/rust/pull/51511/
3363 [51619]: https://github.com/rust-lang/rust/pull/51619/
3364 [51656]: https://github.com/rust-lang/rust/pull/51656/
3365 [51178]: https://github.com/rust-lang/rust/pull/51178/
3366 [51122]: https://github.com/rust-lang/rust/pull/51122
3367 [50494]: https://github.com/rust-lang/rust/pull/50494/
3368 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
3369 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
3370 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
3371 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
3372 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
3373 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
3374 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
3375
3376
3377 Version 1.28.0 (2018-08-02)
3378 ===========================
3379
3380 Language
3381 --------
3382 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
3383   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
3384   the inner type across Foreign Function Interface (FFI) boundaries.
3385 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
3386   and can now be used as identifiers.][51196]
3387 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
3388   stable.][51241] This will allow users to specify a global allocator for
3389   their program.
3390 - [Unit test functions marked with the `#[test]` attribute can now return
3391   `Result<(), E: Debug>` in addition to `()`.][51298]
3392 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
3393   allows macros to easily target lifetimes.
3394
3395 Compiler
3396 --------
3397 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
3398   prioritise making smaller binary sizes. `z` is the same as `s` with the
3399   exception that it does not vectorise loops, which typically results in an even
3400   smaller binary.
3401 - [The short error format is now stable.][49546] Specified with
3402   `--error-format=short` this option will provide a more compressed output of
3403   rust error messages.
3404 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
3405 - [Reduced the number of allocations in the macro parser.][50855] This can
3406   improve compile times of macro heavy crates on average by 5%.
3407
3408 Libraries
3409 ---------
3410 - [Implemented `Default` for `&mut str`.][51306]
3411 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
3412 - [Implemented `Extend` for `()`.][50234]
3413 - [The `Debug` implementation of `time::Duration` should now be more easily
3414   human readable.][50364] Previously a `Duration` of one second would printed as
3415   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
3416 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
3417   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
3418   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
3419   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
3420   for `PathBuf`.][50170]
3421 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
3422   and `Wrapping<i128>`.][50465]
3423 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
3424   possible.][51050] This can provide up to a 40% speed increase.
3425 - [Improved error messages when using `format!`.][50610]
3426
3427 Stabilized APIs
3428 ---------------
3429 - [`Iterator::step_by`]
3430 - [`Path::ancestors`]
3431 - [`SystemTime::UNIX_EPOCH`]
3432 - [`alloc::GlobalAlloc`]
3433 - [`alloc::Layout`]
3434 - [`alloc::LayoutErr`]
3435 - [`alloc::System`]
3436 - [`alloc::alloc`]
3437 - [`alloc::alloc_zeroed`]
3438 - [`alloc::dealloc`]
3439 - [`alloc::realloc`]
3440 - [`alloc::handle_alloc_error`]
3441 - [`btree_map::Entry::or_default`]
3442 - [`fmt::Alignment`]
3443 - [`hash_map::Entry::or_default`]
3444 - [`iter::repeat_with`]
3445 - [`num::NonZeroUsize`]
3446 - [`num::NonZeroU128`]
3447 - [`num::NonZeroU16`]
3448 - [`num::NonZeroU32`]
3449 - [`num::NonZeroU64`]
3450 - [`num::NonZeroU8`]
3451 - [`ops::RangeBounds`]
3452 - [`slice::SliceIndex`]
3453 - [`slice::from_mut`]
3454 - [`slice::from_ref`]
3455 - [`{Any + Send + Sync}::downcast_mut`]
3456 - [`{Any + Send + Sync}::downcast_ref`]
3457 - [`{Any + Send + Sync}::is`]
3458
3459 Cargo
3460 -----
3461 - [Cargo will now no longer allow you to publish crates with build scripts that
3462   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
3463   considered to be immutable.
3464
3465 Misc
3466 ----
3467 - [The `suggestion_applicability` field in `rustc`'s json output is now
3468   stable.][50486] This will allow dev tools to check whether a code suggestion
3469   would apply to them.
3470
3471 Compatibility Notes
3472 -------------------
3473 - [Rust will consider trait objects with duplicated constraints to be the same
3474   type as without the duplicated constraint.][51276] For example the below code will
3475   now fail to compile.
3476   ```rust
3477   trait Trait {}
3478
3479   impl Trait + Send {
3480       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
3481   }
3482
3483   impl Trait + Send + Send {
3484       fn test(&self) { println!("two"); }
3485   }
3486   ```
3487
3488 [49546]: https://github.com/rust-lang/rust/pull/49546/
3489 [50143]: https://github.com/rust-lang/rust/pull/50143/
3490 [50170]: https://github.com/rust-lang/rust/pull/50170/
3491 [50234]: https://github.com/rust-lang/rust/pull/50234/
3492 [50265]: https://github.com/rust-lang/rust/pull/50265/
3493 [50364]: https://github.com/rust-lang/rust/pull/50364/
3494 [50385]: https://github.com/rust-lang/rust/pull/50385/
3495 [50465]: https://github.com/rust-lang/rust/pull/50465/
3496 [50486]: https://github.com/rust-lang/rust/pull/50486/
3497 [50554]: https://github.com/rust-lang/rust/pull/50554/
3498 [50610]: https://github.com/rust-lang/rust/pull/50610/
3499 [50855]: https://github.com/rust-lang/rust/pull/50855/
3500 [51050]: https://github.com/rust-lang/rust/pull/51050/
3501 [51196]: https://github.com/rust-lang/rust/pull/51196/
3502 [51200]: https://github.com/rust-lang/rust/pull/51200/
3503 [51241]: https://github.com/rust-lang/rust/pull/51241/
3504 [51276]: https://github.com/rust-lang/rust/pull/51276/
3505 [51298]: https://github.com/rust-lang/rust/pull/51298/
3506 [51306]: https://github.com/rust-lang/rust/pull/51306/
3507 [51562]: https://github.com/rust-lang/rust/pull/51562/
3508 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
3509 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
3510 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
3511 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
3512 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
3513 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
3514 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
3515 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
3516 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
3517 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
3518 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
3519 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
3520 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
3521 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
3522 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
3523 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
3524 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
3525 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
3526 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
3527 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
3528 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
3529 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
3530 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
3531 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
3532 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
3533 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
3534 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
3535 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
3536 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
3537 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
3538
3539 Version 1.27.2 (2018-07-20)
3540 ===========================
3541
3542 Compatibility Notes
3543 -------------------
3544
3545 - The borrow checker was fixed to avoid potential unsoundness when using
3546   match ergonomics: [#52213][52213].
3547
3548 [52213]: https://github.com/rust-lang/rust/issues/52213
3549
3550 Version 1.27.1 (2018-07-10)
3551 ===========================
3552
3553 Security Notes
3554 --------------
3555
3556 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
3557   when running, which enabled executing code as some other user on a
3558   given machine. This release fixes that vulnerability; you can read
3559   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
3560
3561   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
3562
3563 Compatibility Notes
3564 -------------------
3565
3566 - The borrow checker was fixed to avoid an additional potential unsoundness when using
3567   match ergonomics: [#51415][51415], [#49534][49534].
3568
3569 [51415]: https://github.com/rust-lang/rust/issues/51415
3570 [49534]: https://github.com/rust-lang/rust/issues/49534
3571 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
3572 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
3573
3574 Version 1.27.0 (2018-06-21)
3575 ==========================
3576
3577 Language
3578 --------
3579 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
3580   be used as an identifier.
3581 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
3582   bare `Trait` syntax, and should make it clearer when being used in tandem with
3583   `impl Trait` because it is equivalent to the following syntax:
3584   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
3585   `Box<Trait> == Box<dyn Trait>`.
3586 - [Attributes on generic parameters such as types and lifetimes are
3587   now stable.][48851] e.g.
3588   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
3589 - [The `#[must_use]` attribute can now also be used on functions as well as
3590   types.][48925] It provides a lint that by default warns users when the
3591   value returned by a function has not been used.
3592
3593 Compiler
3594 --------
3595 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
3596
3597 Libraries
3598 ---------
3599 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
3600   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
3601   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
3602   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
3603   the `cfg` attribute.
3604 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
3605   std are now available in core.][49896]
3606 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
3607   to `Self`.][49630]
3608 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
3609   that the operation isn't done in place.
3610 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
3611   the `#[must_use]` attribute][49533] to warn about unused potentially
3612   expensive allocations.
3613
3614 Stabilized APIs
3615 ---------------
3616 - [`DoubleEndedIterator::rfind`]
3617 - [`DoubleEndedIterator::rfold`]
3618 - [`DoubleEndedIterator::try_rfold`]
3619 - [`Duration::from_micros`]
3620 - [`Duration::from_nanos`]
3621 - [`Duration::subsec_micros`]
3622 - [`Duration::subsec_millis`]
3623 - [`HashMap::remove_entry`]
3624 - [`Iterator::try_fold`]
3625 - [`Iterator::try_for_each`]
3626 - [`NonNull::cast`]
3627 - [`Option::filter`]
3628 - [`String::replace_range`]
3629 - [`Take::set_limit`]
3630 - [`hint::unreachable_unchecked`]
3631 - [`os::unix::process::parent_id`]
3632 - [`ptr::swap_nonoverlapping`]
3633 - [`slice::rsplit_mut`]
3634 - [`slice::rsplit`]
3635 - [`slice::swap_with_slice`]
3636
3637 Cargo
3638 -----
3639 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
3640   `readme`, and `repository` fields.][cargo/5386]
3641 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
3642 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
3643   a different directory than `target` for placing compilation artifacts.
3644 - [Cargo will be adding automatic target inference for binaries, benchmarks,
3645   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
3646   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
3647   where cargo would infer a binary, Cargo will produce a warning. You can
3648   disable this feature ahead of time by setting any of the following to false:
3649   `autobins`, `autobenches`, `autoexamples`, `autotests`.
3650 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
3651   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
3652
3653 Misc
3654 ----
3655 - [Added “The Rustc book” into the official documentation.][49707]
3656   [“The Rustc book”] documents and teaches how to use the rustc compiler.
3657 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
3658
3659 Compatibility Notes
3660 -------------------
3661 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
3662   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
3663   compile, `"".is_empty()` will still compile.
3664 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
3665   will only print the inner type.][48553] E.g.
3666   `print!("{:?}", AtomicBool::new(true))` will print `true`,
3667   not `AtomicBool(true)`.
3668 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
3669   could enter higher numbers but they were not supported by LLVM. Up to 512MB
3670   alignment should cover all use cases.
3671 - The `.description()` method on the `std::error::Error` trait
3672   [has been soft-deprecated][50163]. It is no longer required to implement it.
3673
3674 [48553]: https://github.com/rust-lang/rust/pull/48553/
3675 [48851]: https://github.com/rust-lang/rust/pull/48851/
3676 [48925]: https://github.com/rust-lang/rust/pull/48925/
3677 [49533]: https://github.com/rust-lang/rust/pull/49533/
3678 [49623]: https://github.com/rust-lang/rust/pull/49623/
3679 [49630]: https://github.com/rust-lang/rust/pull/49630/
3680 [49664]: https://github.com/rust-lang/rust/pull/49664/
3681 [49699]: https://github.com/rust-lang/rust/pull/49699/
3682 [49707]: https://github.com/rust-lang/rust/pull/49707/
3683 [49719]: https://github.com/rust-lang/rust/pull/49719/
3684 [49896]: https://github.com/rust-lang/rust/pull/49896/
3685 [49968]: https://github.com/rust-lang/rust/pull/49968/
3686 [50163]: https://github.com/rust-lang/rust/pull/50163
3687 [50177]: https://github.com/rust-lang/rust/pull/50177/
3688 [50378]: https://github.com/rust-lang/rust/pull/50378/
3689 [50398]: https://github.com/rust-lang/rust/pull/50398/
3690 [50423]: https://github.com/rust-lang/rust/pull/50423/
3691 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
3692 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
3693 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
3694 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
3695 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
3696 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
3697 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
3698 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
3699 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
3700 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
3701 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
3702 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3703 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3704 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
3705 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
3706 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
3707 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
3708 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
3709 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
3710 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
3711 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
3712 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
3713 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
3714 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
3715 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
3716 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
3717 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
3718 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
3719 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
3720 [“The Rustc book”]: https://doc.rust-lang.org/rustc
3721
3722
3723 Version 1.26.2 (2018-06-05)
3724 ==========================
3725
3726 Compatibility Notes
3727 -------------------
3728
3729 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
3730
3731 [51117]: https://github.com/rust-lang/rust/issues/51117
3732
3733
3734 Version 1.26.1 (2018-05-29)
3735 ==========================
3736
3737 Tools
3738 -----
3739
3740 - [RLS now works on Windows.][50646]
3741 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
3742
3743
3744 Compatibility Notes
3745 --------
3746
3747 - [`fn main() -> impl Trait` no longer works for non-Termination
3748   trait.][50656]
3749   This reverts an accidental stabilization.
3750 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
3751 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
3752
3753 [50646]: https://github.com/rust-lang/rust/issues/50646
3754 [50656]: https://github.com/rust-lang/rust/pull/50656
3755 [50812]: https://github.com/rust-lang/rust/pull/50812
3756 [50950]: https://github.com/rust-lang/rust/issues/50950
3757 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
3758
3759 Version 1.26.0 (2018-05-10)
3760 ==========================
3761
3762 Language
3763 --------
3764 - [Closures now implement `Copy` and/or `Clone` if all captured variables
3765   implement either or both traits.][49299]
3766 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
3767 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
3768   lifetime can be elided.][49458]
3769 - [`impl Trait` is now stable allowing you to have abstract types in returns
3770    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
3771   `fn open(path: impl AsRef<Path>)`.
3772 - [Pattern matching will now automatically apply dereferences.][49394]
3773 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
3774 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
3775 - [A lot of operations are now available in a const context.][46882] E.g. You
3776   can now index into constant arrays, reference and dereference into constants,
3777   and use tuple struct constructors.
3778 - [Fixed entry slice patterns are now stable.][48516] E.g.
3779   ```rust
3780   let points = [1, 2, 3, 4];
3781   match points {
3782       [1, 2, 3, 4] => println!("All points were sequential."),
3783       _ => println!("Not all points were sequential."),
3784   }
3785   ```
3786
3787
3788 Compiler
3789 --------
3790 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
3791 - [Fixed exponential projection complexity on nested types.][48296]
3792   This can provide up to a ~12% reduction in compile times for certain crates.
3793 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
3794   to remap path prefixes outputted by the compiler.
3795 - [Added `powerpc-unknown-netbsd` target.][48281]
3796
3797 Libraries
3798 ---------
3799 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
3800 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
3801   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
3802 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
3803 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
3804 - [`ascii::escape_default` is now available in libcore.][48735]
3805 - [Trailing commas are now supported in std and core macros.][48056]
3806 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
3807 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
3808
3809 Stabilized APIs
3810 ---------------
3811 - [`*const T::add`]
3812 - [`*const T::copy_to_nonoverlapping`]
3813 - [`*const T::copy_to`]
3814 - [`*const T::read_unaligned`]
3815 - [`*const T::read_volatile`]
3816 - [`*const T::read`]
3817 - [`*const T::sub`]
3818 - [`*const T::wrapping_add`]
3819 - [`*const T::wrapping_sub`]
3820 - [`*mut T::add`]
3821 - [`*mut T::copy_to_nonoverlapping`]
3822 - [`*mut T::copy_to`]
3823 - [`*mut T::read_unaligned`]
3824 - [`*mut T::read_volatile`]
3825 - [`*mut T::read`]
3826 - [`*mut T::replace`]
3827 - [`*mut T::sub`]
3828 - [`*mut T::swap`]
3829 - [`*mut T::wrapping_add`]
3830 - [`*mut T::wrapping_sub`]
3831 - [`*mut T::write_bytes`]
3832 - [`*mut T::write_unaligned`]
3833 - [`*mut T::write_volatile`]
3834 - [`*mut T::write`]
3835 - [`Box::leak`]
3836 - [`FromUtf8Error::as_bytes`]
3837 - [`LocalKey::try_with`]
3838 - [`Option::cloned`]
3839 - [`btree_map::Entry::and_modify`]
3840 - [`fs::read_to_string`]
3841 - [`fs::read`]
3842 - [`fs::write`]
3843 - [`hash_map::Entry::and_modify`]
3844 - [`iter::FusedIterator`]
3845 - [`ops::RangeInclusive`]
3846 - [`ops::RangeToInclusive`]
3847 - [`process::id`]
3848 - [`slice::rotate_left`]
3849 - [`slice::rotate_right`]
3850 - [`String::retain`]
3851
3852
3853 Cargo
3854 -----
3855 - [Cargo will now output path to custom commands when `-v` is
3856   passed with `--list`][cargo/5041]
3857 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
3858
3859 Misc
3860 ----
3861 - [The second edition of "The Rust Programming Language" book is now recommended
3862   over the first.][48404]
3863
3864 Compatibility Notes
3865 -------------------
3866
3867 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
3868   syntax is now invalid.
3869   ```
3870   use std::ops::Fn as dyn;
3871   fn g(_: Box<dyn(std::fmt::Debug)>) {}
3872   ```
3873 - [The result of dereferences are no longer promoted to `'static`.][47408]
3874   e.g.
3875   ```rust
3876   fn main() {
3877       const PAIR: &(i32, i32) = &(0, 1);
3878       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
3879   }
3880   ```
3881 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
3882 - [`".e0"` will now no longer parse as `0.0` and will instead cause
3883   an error.][48235]
3884 - [Removed hoedown from rustdoc.][48274]
3885 - [Bounds on higher-kinded lifetimes a hard error.][48326]
3886
3887 [46882]: https://github.com/rust-lang/rust/pull/46882
3888 [47379]: https://github.com/rust-lang/rust/pull/47379
3889 [47408]: https://github.com/rust-lang/rust/pull/47408
3890 [47813]: https://github.com/rust-lang/rust/pull/47813
3891 [48056]: https://github.com/rust-lang/rust/pull/48056
3892 [48125]: https://github.com/rust-lang/rust/pull/48125
3893 [48166]: https://github.com/rust-lang/rust/pull/48166
3894 [48235]: https://github.com/rust-lang/rust/pull/48235
3895 [48274]: https://github.com/rust-lang/rust/pull/48274
3896 [48281]: https://github.com/rust-lang/rust/pull/48281
3897 [48296]: https://github.com/rust-lang/rust/pull/48296
3898 [48326]: https://github.com/rust-lang/rust/pull/48326
3899 [48359]: https://github.com/rust-lang/rust/pull/48359
3900 [48404]: https://github.com/rust-lang/rust/pull/48404
3901 [48481]: https://github.com/rust-lang/rust/pull/48481
3902 [48516]: https://github.com/rust-lang/rust/pull/48516
3903 [48628]: https://github.com/rust-lang/rust/pull/48628
3904 [48629]: https://github.com/rust-lang/rust/pull/48629
3905 [48657]: https://github.com/rust-lang/rust/pull/48657
3906 [48735]: https://github.com/rust-lang/rust/pull/48735
3907 [48978]: https://github.com/rust-lang/rust/pull/48978
3908 [49101]: https://github.com/rust-lang/rust/pull/49101
3909 [49109]: https://github.com/rust-lang/rust/pull/49109
3910 [49121]: https://github.com/rust-lang/rust/pull/49121
3911 [49162]: https://github.com/rust-lang/rust/pull/49162
3912 [49184]: https://github.com/rust-lang/rust/pull/49184
3913 [49234]: https://github.com/rust-lang/rust/pull/49234
3914 [49255]: https://github.com/rust-lang/rust/pull/49255
3915 [49299]: https://github.com/rust-lang/rust/pull/49299
3916 [49305]: https://github.com/rust-lang/rust/pull/49305
3917 [49394]: https://github.com/rust-lang/rust/pull/49394
3918 [49458]: https://github.com/rust-lang/rust/pull/49458
3919 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
3920 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
3921 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
3922 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
3923 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
3924 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
3925 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
3926 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
3927 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
3928 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
3929 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
3930 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
3931 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
3932 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
3933 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
3934 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
3935 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
3936 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
3937 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
3938 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
3939 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
3940 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
3941 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
3942 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
3943 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
3944 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
3945 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
3946 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
3947 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
3948 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
3949 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
3950 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
3951 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
3952 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
3953 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
3954 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
3955 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
3956 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
3957 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
3958 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
3959 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
3960 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
3961
3962
3963 Version 1.25.0 (2018-03-29)
3964 ==========================
3965
3966 Language
3967 --------
3968 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
3969 - [You can now use nested groups of imports.][47948]
3970   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
3971 - [You can now have `|` at the start of a match arm.][47947] e.g.
3972 ```rust
3973 enum Foo { A, B, C }
3974
3975 fn main() {
3976     let x = Foo::A;
3977     match x {
3978         | Foo::A
3979         | Foo::B => println!("AB"),
3980         | Foo::C => println!("C"),
3981     }
3982 }
3983 ```
3984
3985 Compiler
3986 --------
3987 - [Upgraded to LLVM 6.][47828]
3988 - [Added `-C lto=val` option.][47521]
3989 - [Added `i586-unknown-linux-musl` target][47282]
3990
3991 Libraries
3992 ---------
3993 - [Impl Send for `process::Command` on Unix.][47760]
3994 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
3995 - [`UnsafeCell::into_inner` is now safe.][47204]
3996 - [Implement libstd for CloudABI.][47268]
3997 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
3998 - [Implement `AsRef<Path>` for Component][46985]
3999 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
4000 - [Moved `Duration` to libcore.][46666]
4001
4002 Stabilized APIs
4003 ---------------
4004 - [`Location::column`]
4005 - [`ptr::NonNull`]
4006
4007 The following functions can now be used in a constant expression.
4008 eg. `static MINUTE: Duration = Duration::from_secs(60);`
4009 - [`Duration::new`][47300]
4010 - [`Duration::from_secs`][47300]
4011 - [`Duration::from_millis`][47300]
4012
4013 Cargo
4014 -----
4015 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
4016 - [`cargo new` now defaults to creating a binary crate, instead of a
4017   library crate.][cargo/5029]
4018
4019 Misc
4020 ----
4021 - [Rust by example is now shipped with new releases][46196]
4022
4023 Compatibility Notes
4024 -------------------
4025 - [Deprecated `net::lookup_host`.][47510]
4026 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
4027 - The borrow checker was sometimes incorrectly permitting overlapping borrows
4028   around indexing operations (see [#47349][47349]). This has been fixed (which also
4029   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
4030 - [Removed deprecated unstable attribute `#[simd]`.][47251]
4031
4032 [33903]: https://github.com/rust-lang/rust/pull/33903
4033 [47947]: https://github.com/rust-lang/rust/pull/47947
4034 [47948]: https://github.com/rust-lang/rust/pull/47948
4035 [47760]: https://github.com/rust-lang/rust/pull/47760
4036 [47790]: https://github.com/rust-lang/rust/pull/47790
4037 [47828]: https://github.com/rust-lang/rust/pull/47828
4038 [47398]: https://github.com/rust-lang/rust/pull/47398
4039 [47510]: https://github.com/rust-lang/rust/pull/47510
4040 [47521]: https://github.com/rust-lang/rust/pull/47521
4041 [47204]: https://github.com/rust-lang/rust/pull/47204
4042 [47251]: https://github.com/rust-lang/rust/pull/47251
4043 [47268]: https://github.com/rust-lang/rust/pull/47268
4044 [47282]: https://github.com/rust-lang/rust/pull/47282
4045 [47300]: https://github.com/rust-lang/rust/pull/47300
4046 [47349]: https://github.com/rust-lang/rust/pull/47349
4047 [46931]: https://github.com/rust-lang/rust/pull/46931
4048 [46985]: https://github.com/rust-lang/rust/pull/46985
4049 [47006]: https://github.com/rust-lang/rust/pull/47006
4050 [46830]: https://github.com/rust-lang/rust/pull/46830
4051 [46095]: https://github.com/rust-lang/rust/pull/46095
4052 [46666]: https://github.com/rust-lang/rust/pull/46666
4053 [46196]: https://github.com/rust-lang/rust/pull/46196
4054 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
4055 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
4056 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
4057 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
4058 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
4059
4060
4061 Version 1.24.1 (2018-03-01)
4062 ==========================
4063
4064  - [Do not abort when unwinding through FFI][48251]
4065  - [Emit UTF-16 files for linker arguments on Windows][48318]
4066  - [Make the error index generator work again][48308]
4067  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
4068
4069 [48251]: https://github.com/rust-lang/rust/issues/48251
4070 [48308]: https://github.com/rust-lang/rust/issues/48308
4071 [48318]: https://github.com/rust-lang/rust/issues/48318
4072 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
4073
4074
4075 Version 1.24.0 (2018-02-15)
4076 ==========================
4077
4078 Language
4079 --------
4080 - [External `sysv64` ffi is now available.][46528]
4081   eg. `extern "sysv64" fn foo () {}`
4082
4083 Compiler
4084 --------
4085 - [rustc now uses 16 codegen units by default for release builds.][46910]
4086   For the fastest builds, utilize `codegen-units=1`.
4087 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
4088 - [Add `aarch64-unknown-openbsd` support][46760]
4089
4090 Libraries
4091 ---------
4092 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
4093   improvement in performance in the majority of cases.
4094 - [`OsStr`'s `Debug` implementation is now lossless and consistent
4095   with Windows.][46798]
4096 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
4097 - [impl `From<bool>` for `AtomicBool`][46293]
4098 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
4099 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
4100 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
4101 - [float::from_bits now just uses transmute.][46012] This provides
4102   some optimisations from LLVM.
4103 - [Copied `AsciiExt` methods onto `char`][46077]
4104 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
4105 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
4106 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
4107 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
4108
4109 Stabilized APIs
4110 ---------------
4111 - [`RefCell::replace`]
4112 - [`RefCell::swap`]
4113 - [`atomic::spin_loop_hint`]
4114
4115 The following functions can now be used in a constant expression.
4116 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
4117
4118 - [`AtomicBool::new`][46287]
4119 - [`AtomicUsize::new`][46287]
4120 - [`AtomicIsize::new`][46287]
4121 - [`AtomicPtr::new`][46287]
4122 - [`Cell::new`][46287]
4123 - [`{integer}::min_value`][46287]
4124 - [`{integer}::max_value`][46287]
4125 - [`mem::size_of`][46287]
4126 - [`mem::align_of`][46287]
4127 - [`ptr::null`][46287]
4128 - [`ptr::null_mut`][46287]
4129 - [`RefCell::new`][46287]
4130 - [`UnsafeCell::new`][46287]
4131
4132 Cargo
4133 -----
4134 - [Added a `workspace.default-members` config that
4135   overrides implied `--all` in virtual workspaces.][cargo/4743]
4136 - [Enable incremental by default on development builds.][cargo/4817] Also added
4137   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
4138   per-project or global basis respectively.
4139
4140 Misc
4141 ----
4142
4143 Compatibility Notes
4144 -------------------
4145 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
4146 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
4147   in accordance with IETF RFC 4291 §2.2.
4148 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
4149 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
4150   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
4151 - [Leading zeros in tuple struct members is now an error][47084]
4152 - [`column!()` macro is one-based instead of zero-based][46977]
4153 - [`fmt::Arguments` can no longer be shared across threads][45198]
4154 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
4155 - [Cargo sets a different working directory for the compiler][cargo/4788]
4156
4157 [44884]: https://github.com/rust-lang/rust/pull/44884
4158 [45198]: https://github.com/rust-lang/rust/pull/45198
4159 [45506]: https://github.com/rust-lang/rust/pull/45506
4160 [45904]: https://github.com/rust-lang/rust/pull/45904
4161 [45990]: https://github.com/rust-lang/rust/pull/45990
4162 [46012]: https://github.com/rust-lang/rust/pull/46012
4163 [46077]: https://github.com/rust-lang/rust/pull/46077
4164 [46094]: https://github.com/rust-lang/rust/pull/46094
4165 [46284]: https://github.com/rust-lang/rust/pull/46284
4166 [46287]: https://github.com/rust-lang/rust/pull/46287
4167 [46293]: https://github.com/rust-lang/rust/pull/46293
4168 [46528]: https://github.com/rust-lang/rust/pull/46528
4169 [46671]: https://github.com/rust-lang/rust/pull/46671
4170 [46713]: https://github.com/rust-lang/rust/pull/46713
4171 [46735]: https://github.com/rust-lang/rust/pull/46735
4172 [46749]: https://github.com/rust-lang/rust/pull/46749
4173 [46760]: https://github.com/rust-lang/rust/pull/46760
4174 [46798]: https://github.com/rust-lang/rust/pull/46798
4175 [46828]: https://github.com/rust-lang/rust/pull/46828
4176 [46831]: https://github.com/rust-lang/rust/pull/46831
4177 [46833]: https://github.com/rust-lang/rust/pull/46833
4178 [46910]: https://github.com/rust-lang/rust/pull/46910
4179 [46977]: https://github.com/rust-lang/rust/pull/46977
4180 [47018]: https://github.com/rust-lang/rust/pull/47018
4181 [47080]: https://github.com/rust-lang/rust/pull/47080
4182 [47084]: https://github.com/rust-lang/rust/pull/47084
4183 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
4184 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
4185 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
4186 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
4187 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
4188 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
4189
4190
4191 Version 1.23.0 (2018-01-04)
4192 ==========================
4193
4194 Language
4195 --------
4196 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
4197 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
4198   Which should fix some confusing errors in some operations.
4199
4200 Compiler
4201 --------
4202 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
4203   undefined behavior.][45920]
4204 - [rustc now suggests renaming import if names clash.][45660]
4205 - [Display errors/warnings correctly when there are zero-width or
4206   wide characters.][45711]
4207 - [rustc now avoids unnecessary copies of arguments that are
4208   simple bindings][45380] This should improve memory usage on average by 5-10%.
4209 - [Updated musl used to build musl rustc to 1.1.17][45393]
4210
4211 Libraries
4212 ---------
4213 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
4214 - [Implement Hash for raw pointers to unsized types][45483]
4215 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
4216 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
4217 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
4218 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
4219   and `<*mut T>::as_mut`][44932]
4220 - [Optimized `Thread::{park, unpark}` implementation][45524]
4221 - [Improved `SliceExt::binary_search` performance.][45333]
4222 - [impl `FromIterator<()>` for `()`][45379]
4223 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
4224   is now deprecated.
4225
4226 Stabilized APIs
4227 ---------------
4228
4229 Cargo
4230 -----
4231 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
4232   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
4233 - [Added unit test checking to `cargo check`][cargo/4592]
4234 - [Cargo now lets you install a specific version
4235   using `cargo install --version`][cargo/4637]
4236
4237 Misc
4238 ----
4239 - [Releases now ship with the Cargo book documentation.][45692]
4240 - [rustdoc now prints rendering warnings on every run.][45324]
4241
4242 Compatibility Notes
4243 -------------------
4244 - [Changes have been made to type equality to make it more correct,
4245   in rare cases this could break some code.][45853] [Tracking issue for
4246   further information][45852]
4247 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
4248 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
4249   Android 9, the minimum supported version is Android 14.
4250 - [Bumped the minimum LLVM to 3.9][45326]
4251
4252 [44042]: https://github.com/rust-lang/rust/pull/44042
4253 [44932]: https://github.com/rust-lang/rust/pull/44932
4254 [45267]: https://github.com/rust-lang/rust/pull/45267
4255 [45324]: https://github.com/rust-lang/rust/pull/45324
4256 [45326]: https://github.com/rust-lang/rust/pull/45326
4257 [45333]: https://github.com/rust-lang/rust/pull/45333
4258 [45379]: https://github.com/rust-lang/rust/pull/45379
4259 [45380]: https://github.com/rust-lang/rust/pull/45380
4260 [45393]: https://github.com/rust-lang/rust/pull/45393
4261 [45435]: https://github.com/rust-lang/rust/pull/45435
4262 [45483]: https://github.com/rust-lang/rust/pull/45483
4263 [45524]: https://github.com/rust-lang/rust/pull/45524
4264 [45571]: https://github.com/rust-lang/rust/pull/45571
4265 [45580]: https://github.com/rust-lang/rust/pull/45580
4266 [45610]: https://github.com/rust-lang/rust/pull/45610
4267 [45660]: https://github.com/rust-lang/rust/pull/45660
4268 [45692]: https://github.com/rust-lang/rust/pull/45692
4269 [45711]: https://github.com/rust-lang/rust/pull/45711
4270 [45772]: https://github.com/rust-lang/rust/pull/45772
4271 [45852]: https://github.com/rust-lang/rust/issues/45852
4272 [45853]: https://github.com/rust-lang/rust/pull/45853
4273 [45887]: https://github.com/rust-lang/rust/pull/45887
4274 [45920]: https://github.com/rust-lang/rust/pull/45920
4275 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
4276 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
4277 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
4278
4279
4280 Version 1.22.1 (2017-11-22)
4281 ==========================
4282
4283 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
4284
4285 [46183]: https://github.com/rust-lang/rust/pull/46183
4286
4287 Version 1.22.0 (2017-11-22)
4288 ==========================
4289
4290 Language
4291 --------
4292 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
4293 - [Now accepts underscores in unicode escapes][43716]
4294 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
4295 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
4296
4297 Compiler
4298 --------
4299 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
4300 - [rustc will no longer inline in codegen units when compiling for debug][45075]
4301   This should decrease compile times for debug builds.
4302 - [strict memory alignment now enabled on ARMv6][45094]
4303 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
4304
4305 Libraries
4306 ---------
4307 - [Allow atomic operations up to 32 bits
4308   on `armv5te_unknown_linux_gnueabi`][44978]
4309 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
4310 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
4311 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
4312 - [Properly detect overflow in `Instant += Duration`.][44220]
4313 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
4314 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
4315 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
4316
4317 Stabilized APIs
4318 ---------------
4319
4320 Cargo
4321 -----
4322 - [Cargo will now build multi file examples in subdirectories of the `examples`
4323   folder that have a `main.rs` file.][cargo/4496]
4324 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
4325   the old format will continue to work and can be updated with `cargo update`.
4326 - [Now supports vendoring git repositories][cargo/3992]
4327
4328 Misc
4329 ----
4330 - [`libbacktrace` is now available on Apple platforms.][44251]
4331 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
4332   This now lets you specify that a given code example will fail to compile.
4333
4334 Compatibility Notes
4335 -------------------
4336 - [The minimum Android version that rustc can build for has been bumped
4337   to `4.0` from `2.3`][45656]
4338 - [Allowing `T op= &T` for numeric types has broken some type
4339   inference cases][45480]
4340
4341
4342 [42526]: https://github.com/rust-lang/rust/pull/42526
4343 [43017]: https://github.com/rust-lang/rust/pull/43017
4344 [43716]: https://github.com/rust-lang/rust/pull/43716
4345 [43949]: https://github.com/rust-lang/rust/pull/43949
4346 [44015]: https://github.com/rust-lang/rust/pull/44015
4347 [44220]: https://github.com/rust-lang/rust/pull/44220
4348 [44251]: https://github.com/rust-lang/rust/pull/44251
4349 [44287]: https://github.com/rust-lang/rust/pull/44287
4350 [44303]: https://github.com/rust-lang/rust/pull/44303
4351 [44456]: https://github.com/rust-lang/rust/pull/44456
4352 [44466]: https://github.com/rust-lang/rust/pull/44466
4353 [44895]: https://github.com/rust-lang/rust/pull/44895
4354 [44966]: https://github.com/rust-lang/rust/pull/44966
4355 [44978]: https://github.com/rust-lang/rust/pull/44978
4356 [45041]: https://github.com/rust-lang/rust/pull/45041
4357 [45064]: https://github.com/rust-lang/rust/pull/45064
4358 [45075]: https://github.com/rust-lang/rust/pull/45075
4359 [45094]: https://github.com/rust-lang/rust/pull/45094
4360 [45095]: https://github.com/rust-lang/rust/pull/45095
4361 [45480]: https://github.com/rust-lang/rust/issues/45480
4362 [45656]: https://github.com/rust-lang/rust/pull/45656
4363 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
4364 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
4365 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
4366
4367
4368
4369
4370
4371
4372 Version 1.21.0 (2017-10-12)
4373 ==========================
4374
4375 Language
4376 --------
4377 - [You can now use static references for literals.][43838]
4378   Example:
4379   ```rust
4380   fn main() {
4381       let x: &'static u32 = &0;
4382   }
4383   ```
4384 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
4385   Example:
4386   ```rust
4387   my_macro!(Vec<i32>::new); // Always worked
4388   my_macro!(Vec::<i32>::new); // Now works
4389   ```
4390
4391 Compiler
4392 --------
4393 - [Upgraded jemalloc to 4.5.0][43911]
4394 - [Enabled unwinding panics on Redox][43917]
4395 - [Now runs LLVM in parallel during translation phase.][43506]
4396   This should reduce peak memory usage.
4397
4398 Libraries
4399 ---------
4400 - [Generate builtin impls for `Clone` for all arrays and tuples that
4401   are `T: Clone`][43690]
4402 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
4403 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
4404   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
4405
4406 Stabilized APIs
4407 ---------------
4408
4409 [`std::mem::discriminant`]
4410
4411 Cargo
4412 -----
4413 - [You can now call `cargo install` with multiple package names][cargo/4216]
4414 - [Cargo commands inside a virtual workspace will now implicitly
4415   pass `--all`][cargo/4335]
4416 - [Added a `[patch]` section to `Cargo.toml` to handle
4417   prepublication dependencies][cargo/4123] [RFC 1969]
4418 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
4419   like patterns][cargo/4270]
4420 - [Added the `--all-targets` option][cargo/4400]
4421 - [Using required dependencies as a feature is now deprecated and emits
4422   a warning][cargo/4364]
4423
4424
4425 Misc
4426 ----
4427 - [Cargo docs are moving][43916]
4428   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
4429 - [The rustdoc book is now available][43863]
4430   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
4431 - [Added a preview of RLS has been made available through rustup][44204]
4432   Install with `rustup component add rls-preview`
4433 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
4434   Previously only showed `std::os::unix`.
4435
4436 Compatibility Notes
4437 -------------------
4438 - [Changes in method matching against higher-ranked types][43880] This may cause
4439   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
4440 - [rustc's JSON error output's byte position start at top of file.][42973]
4441   Was previously relative to the rustc's internal `CodeMap` struct which
4442   required the unstable library `libsyntax` to correctly use.
4443 - [`unused_results` lint no longer ignores booleans][43728]
4444
4445 [42565]: https://github.com/rust-lang/rust/pull/42565
4446 [42973]: https://github.com/rust-lang/rust/pull/42973
4447 [43348]: https://github.com/rust-lang/rust/pull/43348
4448 [43459]: https://github.com/rust-lang/rust/pull/43459
4449 [43506]: https://github.com/rust-lang/rust/pull/43506
4450 [43540]: https://github.com/rust-lang/rust/pull/43540
4451 [43690]: https://github.com/rust-lang/rust/pull/43690
4452 [43728]: https://github.com/rust-lang/rust/pull/43728
4453 [43838]: https://github.com/rust-lang/rust/pull/43838
4454 [43863]: https://github.com/rust-lang/rust/pull/43863
4455 [43880]: https://github.com/rust-lang/rust/pull/43880
4456 [43911]: https://github.com/rust-lang/rust/pull/43911
4457 [43916]: https://github.com/rust-lang/rust/pull/43916
4458 [43917]: https://github.com/rust-lang/rust/pull/43917
4459 [44204]: https://github.com/rust-lang/rust/pull/44204
4460 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
4461 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
4462 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
4463 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
4464 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
4465 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
4466 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
4467 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
4468 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
4469
4470 Version 1.20.0 (2017-08-31)
4471 ===========================
4472
4473 Language
4474 --------
4475 - [Associated constants are now stabilised.][42809]
4476 - [A lot of macro bugs are now fixed.][42913]
4477
4478 Compiler
4479 --------
4480
4481 - [Struct fields are now properly coerced to the expected field type.][42807]
4482 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
4483   `wasm32-experimental-emscripten` target.
4484 - [Changed some of the error messages to be more helpful.][42033]
4485 - [Add support for RELRO(RELocation Read-Only) for platforms that support
4486   it.][43170]
4487 - [rustc now reports the total number of errors on compilation failure][43015]
4488   previously this was only the number of errors in the pass that failed.
4489 - [Expansion in rustc has been sped up 29x.][42533]
4490 - [added `msp430-none-elf` target.][43099]
4491 - [rustc will now suggest one-argument enum variant to fix type mismatch when
4492   applicable][43178]
4493 - [Fixes backtraces on Redox][43228]
4494 - [rustc now identifies different versions of same crate when absolute paths of
4495   different types match in an error message.][42826]
4496
4497 Libraries
4498 ---------
4499
4500
4501 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
4502 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
4503   tuples.][43011]
4504 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
4505   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
4506 - [Impl `Clone` for `DefaultHasher`.][42799]
4507 - [Impl `Sync` for `SyncSender`.][42397]
4508 - [Impl `FromStr` for `char`][42271]
4509 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
4510   NaN.][42431]
4511 - [allow messages in the `unimplemented!()` macro.][42155]
4512   ie. `unimplemented!("Waiting for 1.21 to be stable")`
4513 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
4514 - [Upgrade to Unicode 10.0.0][42999]
4515 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
4516 - [Skip the main thread's manual stack guard on Linux][43072]
4517 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
4518 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
4519   previously 2^15.
4520 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
4521
4522 Stabilized APIs
4523 ---------------
4524
4525 - [`CStr::into_c_string`]
4526 - [`CString::as_c_str`]
4527 - [`CString::into_boxed_c_str`]
4528 - [`Chain::get_mut`]
4529 - [`Chain::get_ref`]
4530 - [`Chain::into_inner`]
4531 - [`Option::get_or_insert_with`]
4532 - [`Option::get_or_insert`]
4533 - [`OsStr::into_os_string`]
4534 - [`OsString::into_boxed_os_str`]
4535 - [`Take::get_mut`]
4536 - [`Take::get_ref`]
4537 - [`Utf8Error::error_len`]
4538 - [`char::EscapeDebug`]
4539 - [`char::escape_debug`]
4540 - [`compile_error!`]
4541 - [`f32::from_bits`]
4542 - [`f32::to_bits`]
4543 - [`f64::from_bits`]
4544 - [`f64::to_bits`]
4545 - [`mem::ManuallyDrop`]
4546 - [`slice::sort_unstable_by_key`]
4547 - [`slice::sort_unstable_by`]
4548 - [`slice::sort_unstable`]
4549 - [`str::from_boxed_utf8_unchecked`]
4550 - [`str::as_bytes_mut`]
4551 - [`str::as_bytes_mut`]
4552 - [`str::from_utf8_mut`]
4553 - [`str::from_utf8_unchecked_mut`]
4554 - [`str::get_mut`]
4555 - [`str::get_unchecked_mut`]
4556 - [`str::get_unchecked`]
4557 - [`str::get`]
4558 - [`str::into_boxed_bytes`]
4559
4560
4561 Cargo
4562 -----
4563 - [Cargo API token location moved from `~/.cargo/config` to
4564   `~/.cargo/credentials`.][cargo/3978]
4565 - [Cargo will now build `main.rs` binaries that are in sub-directories of
4566   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
4567   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
4568 - [You can now specify version of a binary when installed through
4569   `cargo install` using `--vers`.][cargo/4229]
4570 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
4571   failure.][cargo/4248]
4572 - [Changed the convention around which file is the crate root.][cargo/4259]
4573 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
4574   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
4575
4576 Compatibility Notes
4577 -------------------
4578
4579 - [Functions with `'static` in their return types will now not be as usable as
4580   if they were using lifetime parameters instead.][42417]
4581 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
4582   takes the sign of NaN into account where previously didn't.][42430]
4583
4584 [42033]: https://github.com/rust-lang/rust/pull/42033
4585 [42155]: https://github.com/rust-lang/rust/pull/42155
4586 [42271]: https://github.com/rust-lang/rust/pull/42271
4587 [42397]: https://github.com/rust-lang/rust/pull/42397
4588 [42417]: https://github.com/rust-lang/rust/pull/42417
4589 [42430]: https://github.com/rust-lang/rust/pull/42430
4590 [42431]: https://github.com/rust-lang/rust/pull/42431
4591 [42533]: https://github.com/rust-lang/rust/pull/42533
4592 [42571]: https://github.com/rust-lang/rust/pull/42571
4593 [42613]: https://github.com/rust-lang/rust/pull/42613
4594 [42799]: https://github.com/rust-lang/rust/pull/42799
4595 [42807]: https://github.com/rust-lang/rust/pull/42807
4596 [42809]: https://github.com/rust-lang/rust/pull/42809
4597 [42822]: https://github.com/rust-lang/rust/pull/42822
4598 [42826]: https://github.com/rust-lang/rust/pull/42826
4599 [42854]: https://github.com/rust-lang/rust/pull/42854
4600 [42913]: https://github.com/rust-lang/rust/pull/42913
4601 [42999]: https://github.com/rust-lang/rust/pull/42999
4602 [43011]: https://github.com/rust-lang/rust/pull/43011
4603 [43015]: https://github.com/rust-lang/rust/pull/43015
4604 [43072]: https://github.com/rust-lang/rust/pull/43072
4605 [43077]: https://github.com/rust-lang/rust/pull/43077
4606 [43097]: https://github.com/rust-lang/rust/pull/43097
4607 [43099]: https://github.com/rust-lang/rust/pull/43099
4608 [43170]: https://github.com/rust-lang/rust/pull/43170
4609 [43178]: https://github.com/rust-lang/rust/pull/43178
4610 [43185]: https://github.com/rust-lang/rust/pull/43185
4611 [43228]: https://github.com/rust-lang/rust/pull/43228
4612 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
4613 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
4614 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
4615 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
4616 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
4617 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
4618 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
4619 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
4620 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
4621 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
4622 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
4623 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
4624 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
4625 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
4626 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
4627 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
4628 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
4629 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
4630 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
4631 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
4632 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
4633 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
4634 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
4635 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
4636 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
4637 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
4638 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
4639 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
4640 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
4641 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
4642 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
4643 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
4644 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
4645 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
4646 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
4647 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
4648 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
4649 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
4650 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
4651
4652
4653 Version 1.19.0 (2017-07-20)
4654 ===========================
4655
4656 Language
4657 --------
4658
4659 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
4660   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
4661 - [Macro recursion limit increased to 1024 from 64.][41676]
4662 - [Added lint for detecting unused macros.][41907]
4663 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
4664   For example: `let x = loop { break 7; };`
4665 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
4666   contain `Copy` types and cannot have a `Drop` implementation.
4667   Example: `union Foo { bar: u8, baz: usize }`
4668 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
4669   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
4670
4671 Compiler
4672 --------
4673
4674 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
4675 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
4676   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
4677   you should use `--target armv7-linux-androideabi`.
4678 - [Fixed ICE when removing a source file between compilation sessions.][41873]
4679 - [Minor optimisation of string operations.][42037]
4680 - [Compiler error message is now `aborting due to previous error(s)` instead of
4681   `aborting due to N previous errors`][42150] This was previously inaccurate and
4682   would only count certain kinds of errors.
4683 - [The compiler now supports Visual Studio 2017][42225]
4684 - [The compiler is now built against LLVM 4.0.1 by default][42948]
4685 - [Added a lot][42264] of [new error codes][42302]
4686 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
4687   libraries with C Run-time Libraries(CRT) to be statically linked.
4688 - [Fixed various ARM codegen bugs][42740]
4689
4690 Libraries
4691 ---------
4692
4693 - [`String` now implements `FromIterator<Cow<'a, str>>` and
4694   `Extend<Cow<'a, str>>`][41449]
4695 - [`Vec` now implements `From<&mut [T]>`][41530]
4696 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
4697 - [`SplitWhitespace` now implements `Clone`][41659]
4698 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
4699   1.5x faster][41764]
4700 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
4701   macros, but for printing to stderr.
4702
4703 Stabilized APIs
4704 ---------------
4705
4706 - [`OsString::shrink_to_fit`]
4707 - [`cmp::Reverse`]
4708 - [`Command::envs`]
4709 - [`thread::ThreadId`]
4710
4711 Cargo
4712 -----
4713
4714 - [Build scripts can now add environment variables to the environment
4715   the crate is being compiled in.
4716   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
4717 - [Subcommands now replace the current process rather than spawning a new
4718   child process][cargo/3970]
4719 - [Workspace members can now accept glob file patterns][cargo/3979]
4720 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
4721   the members in a given workspace.][cargo/3988]
4722 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
4723 - [Target directory path is now in the cargo metadata][cargo/4022]
4724 - [Cargo no longer checks out a local working directory for the
4725   crates.io index][cargo/4026] This should provide smaller file size for the
4726   registry, and improve cloning times, especially on Windows machines.
4727 - [Added an `--exclude` option for excluding certain packages when using the
4728   `--all` option][cargo/4031]
4729 - [Cargo will now automatically retry when receiving a 5xx error
4730   from crates.io][cargo/4032]
4731 - [The `--features` option now accepts multiple comma or space
4732   delimited values.][cargo/4084]
4733 - [Added support for custom target specific runners][cargo/3954]
4734
4735 Misc
4736 ----
4737
4738 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
4739   Windows Debugger.
4740 - [Rust will now release XZ compressed packages][rust-installer/57]
4741 - [rustup will now prefer to download rust packages with
4742   XZ compression][rustup/1100] over GZip packages.
4743 - [Added the ability to escape `#` in rust documentation][41785] By adding
4744   additional `#`'s ie. `##` is now `#`
4745
4746 Compatibility Notes
4747 -------------------
4748
4749 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
4750 - [`-Z` flags are now no longer allowed to be used on the stable
4751   compiler.][41751] This has been a warning for a year previous to this.
4752 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
4753   longer works][42844]. Users should migrate to the built-in `check`
4754   command, which has been available since 1.16.
4755 - [Ending a float literal with `._` is now a hard error.
4756   Example: `42._` .][41946]
4757 - [Any use of a private `extern crate` outside of its module is now a
4758   hard error.][36886] This was previously a warning.
4759 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
4760   relative while the `::` prefix makes a path absolute, but was ignored and the
4761   path was relative regardless.
4762 - [Floating point constants in match patterns is now a hard error][36890]
4763   This was previously a warning.
4764 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
4765   match patterns is now a hard error][36891] This was previously a warning.
4766 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
4767   a warning.
4768 - [From the pound escape, lines consisting of multiple `#`s are
4769   now visible][41785]
4770 - [It is an error to re-export private enum variants][42460]. This is
4771   known to break a number of crates that depend on an older version of
4772   mustache.
4773 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
4774   to use it to find the linker, and the build will fail where it did
4775   not previously][42607]
4776
4777 [36886]: https://github.com/rust-lang/rust/issues/36886
4778 [36888]: https://github.com/rust-lang/rust/issues/36888
4779 [36890]: https://github.com/rust-lang/rust/issues/36890
4780 [36891]: https://github.com/rust-lang/rust/issues/36891
4781 [36892]: https://github.com/rust-lang/rust/issues/36892
4782 [37406]: https://github.com/rust-lang/rust/issues/37406
4783 [39983]: https://github.com/rust-lang/rust/pull/39983
4784 [41145]: https://github.com/rust-lang/rust/pull/41145
4785 [41192]: https://github.com/rust-lang/rust/pull/41192
4786 [41258]: https://github.com/rust-lang/rust/pull/41258
4787 [41370]: https://github.com/rust-lang/rust/pull/41370
4788 [41449]: https://github.com/rust-lang/rust/pull/41449
4789 [41530]: https://github.com/rust-lang/rust/pull/41530
4790 [41624]: https://github.com/rust-lang/rust/pull/41624
4791 [41656]: https://github.com/rust-lang/rust/pull/41656
4792 [41659]: https://github.com/rust-lang/rust/pull/41659
4793 [41676]: https://github.com/rust-lang/rust/pull/41676
4794 [41751]: https://github.com/rust-lang/rust/pull/41751
4795 [41764]: https://github.com/rust-lang/rust/pull/41764
4796 [41785]: https://github.com/rust-lang/rust/pull/41785
4797 [41873]: https://github.com/rust-lang/rust/pull/41873
4798 [41907]: https://github.com/rust-lang/rust/pull/41907
4799 [41946]: https://github.com/rust-lang/rust/pull/41946
4800 [42016]: https://github.com/rust-lang/rust/pull/42016
4801 [42037]: https://github.com/rust-lang/rust/pull/42037
4802 [42068]: https://github.com/rust-lang/rust/pull/42068
4803 [42150]: https://github.com/rust-lang/rust/pull/42150
4804 [42162]: https://github.com/rust-lang/rust/pull/42162
4805 [42225]: https://github.com/rust-lang/rust/pull/42225
4806 [42264]: https://github.com/rust-lang/rust/pull/42264
4807 [42302]: https://github.com/rust-lang/rust/pull/42302
4808 [42460]: https://github.com/rust-lang/rust/issues/42460
4809 [42607]: https://github.com/rust-lang/rust/issues/42607
4810 [42740]: https://github.com/rust-lang/rust/pull/42740
4811 [42844]: https://github.com/rust-lang/rust/issues/42844
4812 [42948]: https://github.com/rust-lang/rust/pull/42948
4813 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
4814 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
4815 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
4816 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
4817 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
4818 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
4819 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
4820 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
4821 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
4822 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
4823 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
4824 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
4825 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
4826 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
4827 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
4828 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
4829 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
4830 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
4831 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
4832 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
4833 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
4834 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
4835
4836
4837 Version 1.18.0 (2017-06-08)
4838 ===========================
4839
4840 Language
4841 --------
4842
4843 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
4844   make the item visible to just that module tree. Also accepts the keyword
4845   `crate` to make something public to the whole crate but not users of the
4846   library. Example: `pub(crate) mod utils;`. [RFC 1422].
4847 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
4848   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
4849 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
4850   types like `Write + Send`, trailing `+` are now supported in trait objects,
4851   and better error reporting for trait objects starting with `?Sized`.
4852 - [0e+10 is now a valid floating point literal][40589]
4853 - [Now warns if you bind a lifetime parameter to 'static][40734]
4854 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
4855   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
4856   representation in some cases.][40377]
4857
4858 Compiler
4859 --------
4860
4861 - [rustc can now emit mir with `--emit mir`][39891]
4862 - [Improved LLVM IR for trivial functions][40367]
4863 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
4864 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
4865   opportunities found through profiling
4866 - [Improved backtrace formatting when panicking][38165]
4867
4868 Libraries
4869 ---------
4870
4871 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
4872   iterator hasn't been advanced the original `Vec` is reassembled with no actual
4873   iteration or reallocation.
4874 - [Simplified HashMap Bucket interface][40561] provides performance
4875   improvements for iterating and cloning.
4876 - [Specialize Vec::from_elem to use calloc][40409]
4877 - [Fixed Race condition in fs::create_dir_all][39799]
4878 - [No longer caching stdio on Windows][40516]
4879 - [Optimized insertion sort in slice][40807] insertion sort in some cases
4880   2.50%~ faster and in one case now 12.50% faster.
4881 - [Optimized `AtomicBool::fetch_nand`][41143]
4882
4883 Stabilized APIs
4884 ---------------
4885
4886 - [`Child::try_wait`]
4887 - [`HashMap::retain`]
4888 - [`HashSet::retain`]
4889 - [`PeekMut::pop`]
4890 - [`TcpStream::peek`]
4891 - [`UdpSocket::peek`]
4892 - [`UdpSocket::peek_from`]
4893
4894 Cargo
4895 -----
4896
4897 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
4898   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
4899 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
4900 - [Added Android build support][cargo/3885]
4901 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
4902   of a certain type, for example `cargo build --bins` will build all
4903   binaries.
4904 - [Added support for haiku][cargo/3952]
4905
4906 Misc
4907 ----
4908
4909 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
4910 - [Added rust-windbg script for better debugging on Windows][39983]
4911 - [Rust now uses the official cross compiler for NetBSD][40612]
4912 - [rustdoc now accepts `#` at the start of files][40828]
4913 - [Fixed jemalloc support for musl][41168]
4914
4915 Compatibility Notes
4916 -------------------
4917
4918 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
4919   always placed after the sign if it exists and before the digits. With the `#`
4920   flag the zeroes are placed after the prefix and before the digits.
4921 - [Due to the struct field optimisation][40377], using `transmute` on structs
4922   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
4923   always been undefined behavior, but is now more likely to break in practice.
4924 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
4925   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
4926   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
4927 - [Overlapping inherent `impl`s are now a hard error][40728]
4928 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
4929 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
4930   `out.asm` and `out.ll` instead of only one of the filetypes.
4931 - [ calling a function that returns `Self` will no longer work][41805] when
4932   the size of `Self` cannot be statically determined.
4933 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
4934   this has caused a few regressions namely:
4935
4936   - Changed the link order of local static/dynamic libraries (respecting the
4937     order on given rather than having the compiler reorder).
4938   - Changed how MinGW is linked, native code linked to dynamic libraries
4939     may require manually linking to the gcc support library (for the native
4940     code itself)
4941
4942 [38165]: https://github.com/rust-lang/rust/pull/38165
4943 [39799]: https://github.com/rust-lang/rust/pull/39799
4944 [39891]: https://github.com/rust-lang/rust/pull/39891
4945 [39983]: https://github.com/rust-lang/rust/pull/39983
4946 [40043]: https://github.com/rust-lang/rust/pull/40043
4947 [40241]: https://github.com/rust-lang/rust/pull/40241
4948 [40338]: https://github.com/rust-lang/rust/pull/40338
4949 [40367]: https://github.com/rust-lang/rust/pull/40367
4950 [40377]: https://github.com/rust-lang/rust/pull/40377
4951 [40409]: https://github.com/rust-lang/rust/pull/40409
4952 [40516]: https://github.com/rust-lang/rust/pull/40516
4953 [40556]: https://github.com/rust-lang/rust/pull/40556
4954 [40561]: https://github.com/rust-lang/rust/pull/40561
4955 [40589]: https://github.com/rust-lang/rust/pull/40589
4956 [40612]: https://github.com/rust-lang/rust/pull/40612
4957 [40723]: https://github.com/rust-lang/rust/pull/40723
4958 [40728]: https://github.com/rust-lang/rust/pull/40728
4959 [40731]: https://github.com/rust-lang/rust/pull/40731
4960 [40734]: https://github.com/rust-lang/rust/pull/40734
4961 [40805]: https://github.com/rust-lang/rust/pull/40805
4962 [40807]: https://github.com/rust-lang/rust/pull/40807
4963 [40828]: https://github.com/rust-lang/rust/pull/40828
4964 [40870]: https://github.com/rust-lang/rust/pull/40870
4965 [41085]: https://github.com/rust-lang/rust/pull/41085
4966 [41143]: https://github.com/rust-lang/rust/pull/41143
4967 [41168]: https://github.com/rust-lang/rust/pull/41168
4968 [41270]: https://github.com/rust-lang/rust/issues/41270
4969 [41469]: https://github.com/rust-lang/rust/pull/41469
4970 [41805]: https://github.com/rust-lang/rust/issues/41805
4971 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
4972 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
4973 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
4974 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
4975 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
4976 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
4977 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
4978 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
4979 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
4980 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
4981 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
4982 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
4983 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
4984 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
4985
4986
4987 Version 1.17.0 (2017-04-27)
4988 ===========================
4989
4990 Language
4991 --------
4992
4993 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
4994 * [Fields of structs may be initialized without duplicating the field/variable
4995   names][39761]. [RFC 1682]
4996 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
4997 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
4998   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
4999   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
5000   `'b`. Soundness fix.
5001 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
5002 * [Static variables may contain references to other statics][40027]
5003
5004 Compiler
5005 --------
5006
5007 * [Exit quickly on only `--emit dep-info`][40336]
5008 * [Make `-C relocation-model` more correctly determine whether the linker
5009   creates a position-independent executable][40245]
5010 * [Add `-C overflow-checks` to directly control whether integer overflow
5011   panics][40037]
5012 * [The rustc type checker now checks items on demand instead of in a single
5013   in-order pass][40008]. This is mostly an internal refactoring in support of
5014   future work, including incremental type checking, but also resolves [RFC
5015   1647], allowing `Self` to appear in `impl` `where` clauses.
5016 * [Optimize vtable loads][39995]
5017 * [Turn off vectorization for Emscripten targets][39990]
5018 * [Provide suggestions for unknown macros imported with `use`][39953]
5019 * [Fix ICEs in path resolution][39939]
5020 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
5021 * [Add clearer error message using `&str + &str`][39116]
5022
5023 Stabilized APIs
5024 ---------------
5025
5026 * [`Arc::into_raw`]
5027 * [`Arc::from_raw`]
5028 * [`Arc::ptr_eq`]
5029 * [`Rc::into_raw`]
5030 * [`Rc::from_raw`]
5031 * [`Rc::ptr_eq`]
5032 * [`Ordering::then`]
5033 * [`Ordering::then_with`]
5034 * [`BTreeMap::range`]
5035 * [`BTreeMap::range_mut`]
5036 * [`collections::Bound`]
5037 * [`process::abort`]
5038 * [`ptr::read_unaligned`]
5039 * [`ptr::write_unaligned`]
5040 * [`Result::expect_err`]
5041 * [`Cell::swap`]
5042 * [`Cell::replace`]
5043 * [`Cell::into_inner`]
5044 * [`Cell::take`]
5045
5046 Libraries
5047 ---------
5048
5049 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
5050 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
5051 * [`String` implements `FromIterator<&char>`][40028]
5052 * `Box` [implements][40009] a number of new conversions:
5053   `From<Box<str>> for String`,
5054   `From<Box<[T]>> for Vec<T>`,
5055   `From<Box<CStr>> for CString`,
5056   `From<Box<OsStr>> for OsString`,
5057   `From<Box<Path>> for PathBuf`,
5058   `Into<Box<str>> for String`,
5059   `Into<Box<[T]>> for Vec<T>`,
5060   `Into<Box<CStr>> for CString`,
5061   `Into<Box<OsStr>> for OsString`,
5062   `Into<Box<Path>> for PathBuf`,
5063   `Default for Box<str>`,
5064   `Default for Box<CStr>`,
5065   `Default for Box<OsStr>`,
5066   `From<&CStr> for Box<CStr>`,
5067   `From<&OsStr> for Box<OsStr>`,
5068   `From<&Path> for Box<Path>`
5069 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
5070 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
5071 * [Slightly optimize `slice::sort`][39538]
5072 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
5073 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
5074   `Box<str>` implements `From<&str>`][39438]
5075 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
5076   `From<(I, u16)> where I: Into<IpAddr>`][39372]
5077 * [`format!` estimates the needed capacity before writing a string][39356]
5078 * [Support unprivileged symlink creation in Windows][38921]
5079 * [`PathBuf` implements `Default`][38764]
5080 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
5081 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
5082   and poor hash functions.
5083
5084 Cargo
5085 -----
5086
5087 * [Add `cargo check --all`][cargo/3731]
5088 * [Add an option to ignore SSL revocation checking][cargo/3699]
5089 * [Add `cargo run --package`][cargo/3691]
5090 * [Add `required_features`][cargo/3667]
5091 * [Assume `build.rs` is a build script][cargo/3664]
5092 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
5093
5094 Misc
5095 ----
5096
5097 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
5098   `rustbook`][39633]
5099 * [The "Unstable Book" documents nightly-only features][ubook]
5100 * [Improve the style of the sidebar in rustdoc output][40265]
5101 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
5102 * [Fix MSP430 breakage due to `i128`][40257]
5103 * [Preliminary Solaris/SPARCv9 support][39903]
5104 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
5105   run without installing the MSVC runtime.
5106 * [`rustdoc --test` includes file names in test names][39788]
5107 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
5108   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
5109 * [Initial support for `aarch64-unknown-freebsd`][39491]
5110 * [Initial support for `i686-unknown-netbsd`][39426]
5111 * [This release no longer includes the old makefile build system][39431]. Rust
5112   is built with a custom build system, written in Rust, and with Cargo.
5113 * [Add Debug implementations for libcollection structs][39002]
5114 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
5115 * [`--test-threads=0` produces an error][38945]
5116 * [`rustup` installs documentation by default][40526]
5117 * [The Rust source includes NatVis visualizations][39843]. These can be used by
5118   WinDbg and Visual Studio to improve the debugging experience.
5119
5120 Compatibility Notes
5121 -------------------
5122
5123 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
5124   workaround, either use MSVC 2015 or run vcvars.bat.
5125 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5126   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
5127   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
5128   fix.
5129 * [`format!` and `Display::to_string` panic if an underlying formatting
5130   implementation returns an error][40117]. Previously the error was silently
5131   ignored. It is incorrect for `write_fmt` to return an error when writing
5132   to a string.
5133 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
5134   crates were marked stable and could be accessed from the stable toolchain.
5135 * [Rust git source no longer includes vendored crates][39728]. Those that need
5136   to build with vendored crates should build from release tarballs.
5137 * [Fix inert attributes from `proc_macro_derives`][39572]
5138 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
5139   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
5140   build system.
5141 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
5142   existing code generally ignores the type of dead-code unless a type-hint is
5143   provided; this can cause surprising inference interactions particularly around
5144   defaulting. The new code uniformly ignores the result type of dead-code.
5145 * [Tuple-struct constructors with private fields are no longer visible][38932]
5146 * [Lifetime parameters that do not appear in the arguments are now considered
5147   early-bound][38897], resolving a soundness bug (#[32330]). The
5148   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
5149   April of 2016.
5150 * [rustdoc: fix doctests with non-feature crate attributes][38161]
5151 * [Make transmuting from fn item types to pointer-sized types a hard
5152   error][34198]
5153
5154 [27787]: https://github.com/rust-lang/rust/issues/27787
5155 [32330]: https://github.com/rust-lang/rust/issues/32330
5156 [34198]: https://github.com/rust-lang/rust/pull/34198
5157 [38161]: https://github.com/rust-lang/rust/pull/38161
5158 [38368]: https://github.com/rust-lang/rust/pull/38368
5159 [38584]: https://github.com/rust-lang/rust/issues/38584
5160 [38661]: https://github.com/rust-lang/rust/pull/38661
5161 [38764]: https://github.com/rust-lang/rust/pull/38764
5162 [38864]: https://github.com/rust-lang/rust/issues/38864
5163 [38897]: https://github.com/rust-lang/rust/pull/38897
5164 [38921]: https://github.com/rust-lang/rust/pull/38921
5165 [38932]: https://github.com/rust-lang/rust/pull/38932
5166 [38945]: https://github.com/rust-lang/rust/pull/38945
5167 [38981]: https://github.com/rust-lang/rust/pull/38981
5168 [39002]: https://github.com/rust-lang/rust/pull/39002
5169 [39116]: https://github.com/rust-lang/rust/pull/39116
5170 [39193]: https://github.com/rust-lang/rust/pull/39193
5171 [39265]: https://github.com/rust-lang/rust/pull/39265
5172 [39356]: https://github.com/rust-lang/rust/pull/39356
5173 [39372]: https://github.com/rust-lang/rust/pull/39372
5174 [39426]: https://github.com/rust-lang/rust/pull/39426
5175 [39431]: https://github.com/rust-lang/rust/pull/39431
5176 [39438]: https://github.com/rust-lang/rust/pull/39438
5177 [39440]: https://github.com/rust-lang/rust/pull/39440
5178 [39485]: https://github.com/rust-lang/rust/pull/39485
5179 [39491]: https://github.com/rust-lang/rust/pull/39491
5180 [39518]: https://github.com/rust-lang/rust/pull/39518
5181 [39538]: https://github.com/rust-lang/rust/pull/39538
5182 [39572]: https://github.com/rust-lang/rust/pull/39572
5183 [39633]: https://github.com/rust-lang/rust/pull/39633
5184 [39642]: https://github.com/rust-lang/rust/pull/39642
5185 [39728]: https://github.com/rust-lang/rust/pull/39728
5186 [39761]: https://github.com/rust-lang/rust/pull/39761
5187 [39788]: https://github.com/rust-lang/rust/pull/39788
5188 [39793]: https://github.com/rust-lang/rust/pull/39793
5189 [39837]: https://github.com/rust-lang/rust/pull/39837
5190 [39843]: https://github.com/rust-lang/rust/pull/39843
5191 [39851]: https://github.com/rust-lang/rust/pull/39851
5192 [39903]: https://github.com/rust-lang/rust/pull/39903
5193 [39939]: https://github.com/rust-lang/rust/pull/39939
5194 [39953]: https://github.com/rust-lang/rust/pull/39953
5195 [39960]: https://github.com/rust-lang/rust/pull/39960
5196 [39990]: https://github.com/rust-lang/rust/pull/39990
5197 [39995]: https://github.com/rust-lang/rust/pull/39995
5198 [40008]: https://github.com/rust-lang/rust/pull/40008
5199 [40009]: https://github.com/rust-lang/rust/pull/40009
5200 [40027]: https://github.com/rust-lang/rust/pull/40027
5201 [40028]: https://github.com/rust-lang/rust/pull/40028
5202 [40037]: https://github.com/rust-lang/rust/pull/40037
5203 [40117]: https://github.com/rust-lang/rust/pull/40117
5204 [40166]: https://github.com/rust-lang/rust/pull/40166
5205 [40245]: https://github.com/rust-lang/rust/pull/40245
5206 [40257]: https://github.com/rust-lang/rust/pull/40257
5207 [40261]: https://github.com/rust-lang/rust/pull/40261
5208 [40265]: https://github.com/rust-lang/rust/pull/40265
5209 [40319]: https://github.com/rust-lang/rust/pull/40319
5210 [40336]: https://github.com/rust-lang/rust/pull/40336
5211 [40526]: https://github.com/rust-lang/rust/pull/40526
5212 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5213 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
5214 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
5215 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
5216 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
5217 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
5218 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
5219 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
5220 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
5221 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
5222 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
5223 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
5224 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
5225 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
5226 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
5227 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
5228 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
5229 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
5230 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
5231 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
5232 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
5233 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
5234 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
5235 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
5236 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
5237 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
5238 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
5239 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
5240 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
5241 [mdbook]: https://crates.io/crates/mdbook
5242 [ubook]: https://doc.rust-lang.org/unstable-book/
5243
5244
5245 Version 1.16.0 (2017-03-16)
5246 ===========================
5247
5248 Language
5249 --------
5250
5251 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
5252 * [Uninhabitable enums (those without any variants) no longer permit wildcard
5253   match patterns][38069]
5254 * [Clean up semantics of `self` in an import list][38313]
5255 * [`Self` may appear in `impl` headers][38920]
5256 * [`Self` may appear in struct expressions][39282]
5257
5258 Compiler
5259 --------
5260
5261 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
5262   a `.rmeta` file containing only crate metadata][38571]. This can be
5263   used by tools like the Rust Language Service to perform
5264   metadata-only builds.
5265 * [Levenshtein based typo suggestions now work in most places, while
5266   previously they worked only for fields and sometimes for local
5267   variables][38927]. Together with the overhaul of "no
5268   resolution"/"unexpected resolution" errors (#[38154]) they result in
5269   large and systematic improvement in resolution diagnostics.
5270 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
5271   `U`][38670]
5272 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
5273 * [`rustc` no longer attempts to provide "consider using an explicit
5274   lifetime" suggestions][37057]. They were inaccurate.
5275
5276 Stabilized APIs
5277 ---------------
5278
5279 * [`VecDeque::truncate`]
5280 * [`VecDeque::resize`]
5281 * [`String::insert_str`]
5282 * [`Duration::checked_add`]
5283 * [`Duration::checked_sub`]
5284 * [`Duration::checked_div`]
5285 * [`Duration::checked_mul`]
5286 * [`str::replacen`]
5287 * [`str::repeat`]
5288 * [`SocketAddr::is_ipv4`]
5289 * [`SocketAddr::is_ipv6`]
5290 * [`IpAddr::is_ipv4`]
5291 * [`IpAddr::is_ipv6`]
5292 * [`Vec::dedup_by`]
5293 * [`Vec::dedup_by_key`]
5294 * [`Result::unwrap_or_default`]
5295 * [`<*const T>::wrapping_offset`]
5296 * [`<*mut T>::wrapping_offset`]
5297 * `CommandExt::creation_flags`
5298 * [`File::set_permissions`]
5299 * [`String::split_off`]
5300
5301 Libraries
5302 ---------
5303
5304 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
5305   their argument by `Borrow` parameter][37761]
5306 * [All public types in std implement `Debug`][38006]
5307 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
5308 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
5309 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5310   Windows][38274]
5311 * [std: Fix partial writes in `LineWriter`][38062]
5312 * [std: Clamp max read/write sizes on Unix][38062]
5313 * [Use more specific panic message for `&str` slicing errors][38066]
5314 * [`TcpListener::set_only_v6` is deprecated][38304]. This
5315   functionality cannot be achieved in std currently.
5316 * [`writeln!`, like `println!`, now accepts a form with no string
5317   or formatting arguments, to just print a newline][38469]
5318 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
5319 * [Reduce the size of static data in `std_unicode::tables`][38781]
5320 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
5321   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
5322   `Display`][38909]
5323 * [`Duration` implements `Sum`][38712]
5324 * [`String` implements `ToSocketAddrs`][39048]
5325
5326 Cargo
5327 -----
5328
5329 * [The `cargo check` command does a type check of a project without
5330   building it][cargo/3296]
5331 * [crates.io will display CI badges from Travis and AppVeyor, if
5332   specified in Cargo.toml][cargo/3546]
5333 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
5334 * [Compilation profiles accept integer values for `debug`, in addition
5335   to `true` and `false`. These are passed to `rustc` as the value to
5336   `-C debuginfo`][cargo/3534]
5337 * [Implement `cargo --version --verbose`][cargo/3604]
5338 * [All builds now output 'dep-info' build dependencies compatible with
5339   make and ninja][cargo/3557]
5340 * [Build all workspace members with `build --all`][cargo/3511]
5341 * [Document all workspace members with `doc --all`][cargo/3515]
5342 * [Path deps outside workspace are not members][cargo/3443]
5343
5344 Misc
5345 ----
5346
5347 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
5348   the path to the Rust implementation][38589]
5349 * [The `armv7-linux-androideabi` target no longer enables NEON
5350   extensions, per Google's ABI guide][38413]
5351 * [The stock standard library can be compiled for Redox OS][38401]
5352 * [Rust has initial SPARC support][38726]. Tier 3. No builds
5353   available.
5354 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
5355   builds available.
5356 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
5357
5358 Compatibility Notes
5359 -------------------
5360
5361 * [Uninhabitable enums (those without any variants) no longer permit wildcard
5362   match patterns][38069]
5363 * In this release, references to uninhabited types can not be
5364   pattern-matched. This was accidentally allowed in 1.15.
5365 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
5366 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5367   Windows][38274]
5368 * [Clean up semantics of `self` in an import list][38313]
5369 * Reimplemented lifetime elision. This change was almost entirely compatible
5370   with existing code, but it did close a number of small bugs and loopholes,
5371   as well as being more accepting in some other [cases][41105].
5372
5373 [37057]: https://github.com/rust-lang/rust/pull/37057
5374 [37761]: https://github.com/rust-lang/rust/pull/37761
5375 [38006]: https://github.com/rust-lang/rust/pull/38006
5376 [38051]: https://github.com/rust-lang/rust/pull/38051
5377 [38062]: https://github.com/rust-lang/rust/pull/38062
5378 [38062]: https://github.com/rust-lang/rust/pull/38622
5379 [38066]: https://github.com/rust-lang/rust/pull/38066
5380 [38069]: https://github.com/rust-lang/rust/pull/38069
5381 [38131]: https://github.com/rust-lang/rust/pull/38131
5382 [38154]: https://github.com/rust-lang/rust/pull/38154
5383 [38274]: https://github.com/rust-lang/rust/pull/38274
5384 [38304]: https://github.com/rust-lang/rust/pull/38304
5385 [38313]: https://github.com/rust-lang/rust/pull/38313
5386 [38314]: https://github.com/rust-lang/rust/pull/38314
5387 [38327]: https://github.com/rust-lang/rust/pull/38327
5388 [38401]: https://github.com/rust-lang/rust/pull/38401
5389 [38413]: https://github.com/rust-lang/rust/pull/38413
5390 [38469]: https://github.com/rust-lang/rust/pull/38469
5391 [38559]: https://github.com/rust-lang/rust/pull/38559
5392 [38571]: https://github.com/rust-lang/rust/pull/38571
5393 [38580]: https://github.com/rust-lang/rust/pull/38580
5394 [38589]: https://github.com/rust-lang/rust/pull/38589
5395 [38670]: https://github.com/rust-lang/rust/pull/38670
5396 [38712]: https://github.com/rust-lang/rust/pull/38712
5397 [38726]: https://github.com/rust-lang/rust/pull/38726
5398 [38781]: https://github.com/rust-lang/rust/pull/38781
5399 [38798]: https://github.com/rust-lang/rust/pull/38798
5400 [38909]: https://github.com/rust-lang/rust/pull/38909
5401 [38920]: https://github.com/rust-lang/rust/pull/38920
5402 [38927]: https://github.com/rust-lang/rust/pull/38927
5403 [39048]: https://github.com/rust-lang/rust/pull/39048
5404 [39282]: https://github.com/rust-lang/rust/pull/39282
5405 [39379]: https://github.com/rust-lang/rust/pull/39379
5406 [41105]: https://github.com/rust-lang/rust/issues/41105
5407 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
5408 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
5409 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
5410 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
5411 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
5412 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
5413 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
5414 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
5415 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
5416 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
5417 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
5418 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
5419 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
5420 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
5421 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
5422 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
5423 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
5424 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
5425 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
5426 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
5427 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
5428 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
5429 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
5430 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
5431 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
5432 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
5433 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
5434 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
5435 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
5436 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5437
5438
5439 Version 1.15.1 (2017-02-09)
5440 ===========================
5441
5442 * [Fix IntoIter::as_mut_slice's signature][39466]
5443 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
5444
5445 [39466]: https://github.com/rust-lang/rust/pull/39466
5446 [39523]: https://github.com/rust-lang/rust/pull/39523
5447
5448
5449 Version 1.15.0 (2017-02-02)
5450 ===========================
5451
5452 Language
5453 --------
5454
5455 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
5456   stable. This allows popular code-generating crates like Serde and Diesel to
5457   work ergonomically. [RFC 1681].
5458 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
5459   with curly braces][36868]. Part of [RFC 1506].
5460 * [A number of minor changes to name resolution have been activated][37127].
5461   They add up to more consistent semantics, allowing for future evolution of
5462   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
5463   details of what is different. The breaking changes here have been transitioned
5464   through the [`legacy_imports`] lint since 1.14, with no known regressions.
5465 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
5466   bounds][38279]
5467 * [`?Sized` can be used in `where` clauses][37791]
5468 * [There is now a limit on the size of monomorphized types and it can be
5469   modified with the `#![type_size_limit]` crate attribute, similarly to
5470   the `#![recursion_limit]` attribute][37789]
5471
5472 Compiler
5473 --------
5474
5475 * [On Windows, the compiler will apply dllimport attributes when linking to
5476   extern functions][37973]. Additional attributes and flags can control which
5477   library kind is linked and its name. [RFC 1717].
5478 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
5479 * [The `--test` flag works with procedural macro crates][38107]
5480 * [Fix `extern "aapcs" fn` ABI][37814]
5481 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
5482 * [The `format!` expander recognizes incorrect `printf` and shell-style
5483   formatting directives and suggests the correct format][37613].
5484 * [Only report one error for all unused imports in an import list][37456]
5485
5486 Compiler Performance
5487 --------------------
5488
5489 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
5490 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
5491 * [Don't clone in `UnificationTable::probe`][37848]
5492 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
5493 * [Use small vectors in type walker][37760]
5494 * [Macro expansion performance was improved][37701]
5495 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
5496 * [Replace FNV with a faster hash function][37229]
5497
5498 Stabilized APIs
5499 ---------------
5500
5501 * [`std::iter::Iterator::min_by`]
5502 * [`std::iter::Iterator::max_by`]
5503 * [`std::os::*::fs::FileExt`]
5504 * [`std::sync::atomic::Atomic*::get_mut`]
5505 * [`std::sync::atomic::Atomic*::into_inner`]
5506 * [`std::vec::IntoIter::as_slice`]
5507 * [`std::vec::IntoIter::as_mut_slice`]
5508 * [`std::sync::mpsc::Receiver::try_iter`]
5509 * [`std::os::unix::process::CommandExt::before_exec`]
5510 * [`std::rc::Rc::strong_count`]
5511 * [`std::rc::Rc::weak_count`]
5512 * [`std::sync::Arc::strong_count`]
5513 * [`std::sync::Arc::weak_count`]
5514 * [`std::char::encode_utf8`]
5515 * [`std::char::encode_utf16`]
5516 * [`std::cell::Ref::clone`]
5517 * [`std::io::Take::into_inner`]
5518
5519 Libraries
5520 ---------
5521
5522 * [The standard sorting algorithm has been rewritten for dramatic performance
5523   improvements][38192]. It is a hybrid merge sort, drawing influences from
5524   Timsort. Previously it was a naive merge sort.
5525 * [`Iterator::nth` no longer has a `Sized` bound][38134]
5526 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
5527   performance.
5528 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
5529   and `char_indices().last()`][37882]
5530 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
5531 * [Chinese characters display correctly in `fmt::Debug`][37855]
5532 * [Derive `Default` for `Duration`][37699]
5533 * [Support creation of anonymous pipes on WinXP/2k][37677]
5534 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
5535 * [Don't pass overlapped handles to processes][38835]
5536
5537 Cargo
5538 -----
5539
5540 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
5541   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
5542   should instead check the variable at runtime with `std::env`. That the value
5543   was set at build time was a bug, and incorrect when cross-compiling. This
5544   change is known to cause breakage.
5545 * [Add `--all` flag to `cargo test`][cargo/3221]
5546 * [Compile statically against the MSVC CRT][cargo/3363]
5547 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
5548 * [Link OpenSSL statically on OSX][cargo/3311]
5549 * [Apply new fingerprinting to build dir outputs][cargo/3310]
5550 * [Test for bad path overrides with summaries][cargo/3336]
5551 * [Require `cargo install --vers` to take a semver version][cargo/3338]
5552 * [Fix retrying crate downloads for network errors][cargo/3348]
5553 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
5554 * [Emit more info on --message-format=json][cargo/3319]
5555 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
5556 * [Don't ignore errors in workspace manifest][cargo/3409]
5557 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
5558
5559 Tooling
5560 -------
5561
5562 * [Test runners (binaries built with `--test`) now support a `--list` argument
5563   that lists the tests it contains][38185]
5564 * [Test runners now support a `--exact` argument that makes the test filter
5565   match exactly, instead of matching only a substring of the test name][38181]
5566 * [rustdoc supports a `--playground-url` flag][37763]
5567 * [rustdoc provides more details about `#[should_panic]` errors][37749]
5568
5569 Misc
5570 ----
5571
5572 * [The Rust build system is now written in Rust][37817]. The Makefiles may
5573   continue to be used in this release by passing `--disable-rustbuild` to the
5574   configure script, but they will be deleted soon. Note that the new build
5575   system uses a different on-disk layout that will likely affect any scripts
5576   building Rust.
5577 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
5578   releases.
5579 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
5580 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
5581   releases.
5582
5583 Compatibility Notes
5584 -------------------
5585
5586 * [A number of minor changes to name resolution have been activated][37127].
5587   They add up to more consistent semantics, allowing for future evolution of
5588   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
5589   details of what is different. The breaking changes here have been transitioned
5590   through the [`legacy_imports`] lint since 1.14, with no known regressions.
5591 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
5592   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
5593   should instead check the variable at runtime with `std::env`. That the value
5594   was set at build time was a bug, and incorrect when cross-compiling. This
5595   change is known to cause breakage.
5596 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
5597   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
5598   1.10 and is now an error by default. It will become a hard error in the near
5599   future.
5600 * [The semantics relating modules to file system directories are changing in
5601   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
5602   lint, which is a warning in this release, and will become a hard error in the
5603   future.
5604 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
5605 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
5606   the underlying iterator][37834]
5607
5608 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
5609 [33685]: https://github.com/rust-lang/rust/issues/33685
5610 [36868]: https://github.com/rust-lang/rust/pull/36868
5611 [37127]: https://github.com/rust-lang/rust/pull/37127
5612 [37229]: https://github.com/rust-lang/rust/pull/37229
5613 [37456]: https://github.com/rust-lang/rust/pull/37456
5614 [37527]: https://github.com/rust-lang/rust/pull/37527
5615 [37602]: https://github.com/rust-lang/rust/pull/37602
5616 [37613]: https://github.com/rust-lang/rust/pull/37613
5617 [37615]: https://github.com/rust-lang/rust/pull/37615
5618 [37636]: https://github.com/rust-lang/rust/pull/37636
5619 [37627]: https://github.com/rust-lang/rust/pull/37627
5620 [37642]: https://github.com/rust-lang/rust/pull/37642
5621 [37677]: https://github.com/rust-lang/rust/pull/37677
5622 [37699]: https://github.com/rust-lang/rust/pull/37699
5623 [37701]: https://github.com/rust-lang/rust/pull/37701
5624 [37705]: https://github.com/rust-lang/rust/pull/37705
5625 [37749]: https://github.com/rust-lang/rust/pull/37749
5626 [37760]: https://github.com/rust-lang/rust/pull/37760
5627 [37763]: https://github.com/rust-lang/rust/pull/37763
5628 [37764]: https://github.com/rust-lang/rust/pull/37764
5629 [37789]: https://github.com/rust-lang/rust/pull/37789
5630 [37791]: https://github.com/rust-lang/rust/pull/37791
5631 [37814]: https://github.com/rust-lang/rust/pull/37814
5632 [37817]: https://github.com/rust-lang/rust/pull/37817
5633 [37834]: https://github.com/rust-lang/rust/pull/37834
5634 [37848]: https://github.com/rust-lang/rust/pull/37848
5635 [37855]: https://github.com/rust-lang/rust/pull/37855
5636 [37882]: https://github.com/rust-lang/rust/pull/37882
5637 [37888]: https://github.com/rust-lang/rust/pull/37888
5638 [37973]: https://github.com/rust-lang/rust/pull/37973
5639 [37979]: https://github.com/rust-lang/rust/pull/37979
5640 [38086]: https://github.com/rust-lang/rust/pull/38086
5641 [38107]: https://github.com/rust-lang/rust/pull/38107
5642 [38117]: https://github.com/rust-lang/rust/pull/38117
5643 [38134]: https://github.com/rust-lang/rust/pull/38134
5644 [38146]: https://github.com/rust-lang/rust/pull/38146
5645 [38181]: https://github.com/rust-lang/rust/pull/38181
5646 [38182]: https://github.com/rust-lang/rust/pull/38182
5647 [38185]: https://github.com/rust-lang/rust/pull/38185
5648 [38192]: https://github.com/rust-lang/rust/pull/38192
5649 [38279]: https://github.com/rust-lang/rust/pull/38279
5650 [38835]: https://github.com/rust-lang/rust/pull/38835
5651 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
5652 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
5653 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
5654 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
5655 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
5656 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
5657 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
5658 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
5659 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
5660 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
5661 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
5662 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
5663 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
5664 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
5665 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
5666 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
5667 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
5668 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
5669 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
5670 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
5671 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
5672 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
5673 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
5674 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
5675 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
5676 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
5677 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
5678 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
5679 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
5680 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
5681 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
5682 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
5683 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
5684 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
5685 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
5686 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
5687 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
5688 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
5689
5690
5691 Version 1.14.0 (2016-12-22)
5692 ===========================
5693
5694 Language
5695 --------
5696
5697 * [`..` matches multiple tuple fields in enum variants, structs
5698   and tuples][36843]. [RFC 1492].
5699 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
5700 * [`use *` and `use ::*` both glob-import from the crate root][37367]
5701 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
5702   dereferencing][36822]
5703
5704 Compiler
5705 --------
5706
5707 * [Mark enums with non-zero discriminant as non-zero][37224]
5708 * [Lower-case `static mut` names are linted like other
5709   statics and consts][37162]
5710 * [Fix ICE on some macros in const integer positions
5711    (e.g. `[u8; m!()]`)][36819]
5712 * [Improve error message and snippet for "did you mean `x`"][36798]
5713 * [Add a panic-strategy field to the target specification][36794]
5714 * [Include LLVM version in `--version --verbose`][37200]
5715
5716 Compile-time Optimizations
5717 --------------------------
5718
5719 * [Improve macro expansion performance][37569]
5720 * [Shrink `Expr_::ExprInlineAsm`][37445]
5721 * [Replace all uses of SHA-256 with BLAKE2b][37439]
5722 * [Reduce the number of bytes hashed by `IchHasher`][37427]
5723 * [Avoid more allocations when compiling html5ever][37373]
5724 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
5725 * [Avoid some allocations in the macro parser][37318]
5726 * [Use a faster deflate setting][37298]
5727 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
5728   during interning of slices][37270]
5729 * [Optimize `write_metadata`][37267]
5730 * [Don't process obligation forest cycles when stalled][37231]
5731 * [Avoid many `CrateConfig` clones][37161]
5732 * [Optimize `Substs::super_fold_with`][37108]
5733 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
5734 * [Speed up `plug_leaks`][36917]
5735
5736 Libraries
5737 ---------
5738
5739 * [`println!()`, with no arguments, prints newline][36825].
5740   Previously, an empty string was required to achieve the same.
5741 * [`Wrapping` impls standard binary and unary operators, as well as
5742    the `Sum` and `Product` iterators][37356]
5743 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
5744   Vec<T>`][37326]
5745 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
5746   `VecDeque` iterators][37315]
5747 * [Improve `SipHasher` performance on small values][37312]
5748 * [Add Iterator trait TrustedLen to enable better FromIterator /
5749   Extend][37306]
5750 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
5751 * [`ReadDir` implements `Debug`][37221]
5752 * [Implement `RefUnwindSafe` for atomic types][37178]
5753 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
5754 * [Avoid allocations in `Decoder::read_str`][37064]
5755 * [`io::Error` implements `From<io::ErrorKind>`][37037]
5756 * [Impl `Debug` for raw pointers to unsized data][36880]
5757 * [Don't reuse `HashMap` random seeds][37470]
5758 * [The internal memory layout of `HashMap` is more cache-friendly, for
5759   significant improvements in some operations][36692]
5760 * [`HashMap` uses less memory on 32-bit architectures][36595]
5761 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
5762
5763 Cargo
5764 -----
5765
5766 * [Expose rustc cfg values to build scripts][cargo/3243]
5767 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
5768 * [Fix passing --features when testing multiple packages][cargo/3280]
5769 * [Use a single profile set per workspace][cargo/3249]
5770 * [Load `replace` sections from lock files][cargo/3220]
5771 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
5772
5773 Tooling
5774 -------
5775
5776 * [rustup is the recommended Rust installation method][1.14rustup]
5777 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
5778   S390x. These are [tier 2] platforms and may have major defects. Follow the
5779   instructions on the website to install, or add the targets to an existing
5780   installation with `rustup target add`. The new target triples are:
5781   - `mips-unknown-linux-gnu`
5782   - `mipsel-unknown-linux-gnu`
5783   - `mips64-unknown-linux-gnuabi64`
5784   - `mips64el-unknown-linux-gnuabi64 `
5785   - `powerpc-unknown-linux-gnu`
5786   - `powerpc64-unknown-linux-gnu`
5787   - `powerpc64le-unknown-linux-gnu`
5788   - `s390x-unknown-linux-gnu `
5789 * This release includes target (std) builds for ARM Linux running MUSL
5790   libc. These are [tier 2] platforms and may have major defects. Add the
5791   following triples to an existing rustup installation with `rustup target add`:
5792   - `arm-unknown-linux-musleabi`
5793   - `arm-unknown-linux-musleabihf`
5794   - `armv7-unknown-linux-musleabihf`
5795 * This release includes [experimental support for WebAssembly][1.14wasm], via
5796   the `wasm32-unknown-emscripten` target. This target is known to have major
5797   defects. Please test, report, and fix.
5798 * rustup no longer installs documentation by default. Run `rustup
5799   component add rust-docs` to install.
5800 * [Fix line stepping in debugger][37310]
5801 * [Enable line number debuginfo in releases][37280]
5802
5803 Misc
5804 ----
5805
5806 * [Disable jemalloc on aarch64/powerpc/mips][37392]
5807 * [Add support for Fuchsia OS][37313]
5808 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
5809
5810 Compatibility Notes
5811 -------------------
5812
5813 * [A number of forward-compatibility lints used by the compiler
5814   to gradually introduce language changes have been converted
5815   to deny by default][36894]:
5816   - ["use of inaccessible extern crate erroneously allowed"][36886]
5817   - ["type parameter default erroneously allowed in invalid location"][36887]
5818   - ["detects super or self keywords at the beginning of global path"][36888]
5819   - ["two overlapping inherent impls define an item with the same name
5820     were erroneously allowed"][36889]
5821   - ["floating-point constants cannot be used in patterns"][36890]
5822   - ["constants of struct or enum type can only be used in a pattern if
5823      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
5824   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
5825 * [Prohibit patterns in trait methods without bodies][37378]
5826 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
5827 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
5828 * [The `$crate` macro variable is accepted in fewer locations][37213]
5829 * [Impls specifying extra region requirements beyond the trait
5830   they implement are rejected][37167]
5831 * [Enums may not be unsized][37111]. Unsized enums are intended to
5832   work but never have. For now they are forbidden.
5833 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
5834
5835 [tier 2]: https://forge.rust-lang.org/platform-support.html
5836 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
5837 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
5838 [36430]: https://github.com/rust-lang/rust/pull/36430
5839 [36595]: https://github.com/rust-lang/rust/pull/36595
5840 [36595]: https://github.com/rust-lang/rust/pull/36595
5841 [36692]: https://github.com/rust-lang/rust/pull/36692
5842 [36767]: https://github.com/rust-lang/rust/pull/36767
5843 [36794]: https://github.com/rust-lang/rust/pull/36794
5844 [36798]: https://github.com/rust-lang/rust/pull/36798
5845 [36819]: https://github.com/rust-lang/rust/pull/36819
5846 [36822]: https://github.com/rust-lang/rust/pull/36822
5847 [36825]: https://github.com/rust-lang/rust/pull/36825
5848 [36843]: https://github.com/rust-lang/rust/pull/36843
5849 [36880]: https://github.com/rust-lang/rust/pull/36880
5850 [36886]: https://github.com/rust-lang/rust/issues/36886
5851 [36887]: https://github.com/rust-lang/rust/issues/36887
5852 [36888]: https://github.com/rust-lang/rust/issues/36888
5853 [36889]: https://github.com/rust-lang/rust/issues/36889
5854 [36890]: https://github.com/rust-lang/rust/issues/36890
5855 [36891]: https://github.com/rust-lang/rust/issues/36891
5856 [36892]: https://github.com/rust-lang/rust/issues/36892
5857 [36894]: https://github.com/rust-lang/rust/pull/36894
5858 [36917]: https://github.com/rust-lang/rust/pull/36917
5859 [36993]: https://github.com/rust-lang/rust/pull/36993
5860 [37037]: https://github.com/rust-lang/rust/pull/37037
5861 [37064]: https://github.com/rust-lang/rust/pull/37064
5862 [37094]: https://github.com/rust-lang/rust/pull/37094
5863 [37108]: https://github.com/rust-lang/rust/pull/37108
5864 [37111]: https://github.com/rust-lang/rust/pull/37111
5865 [37161]: https://github.com/rust-lang/rust/pull/37161
5866 [37162]: https://github.com/rust-lang/rust/pull/37162
5867 [37167]: https://github.com/rust-lang/rust/pull/37167
5868 [37178]: https://github.com/rust-lang/rust/pull/37178
5869 [37200]: https://github.com/rust-lang/rust/pull/37200
5870 [37213]: https://github.com/rust-lang/rust/pull/37213
5871 [37221]: https://github.com/rust-lang/rust/pull/37221
5872 [37224]: https://github.com/rust-lang/rust/pull/37224
5873 [37230]: https://github.com/rust-lang/rust/pull/37230
5874 [37231]: https://github.com/rust-lang/rust/pull/37231
5875 [37247]: https://github.com/rust-lang/rust/pull/37247
5876 [37267]: https://github.com/rust-lang/rust/pull/37267
5877 [37270]: https://github.com/rust-lang/rust/pull/37270
5878 [37273]: https://github.com/rust-lang/rust/pull/37273
5879 [37280]: https://github.com/rust-lang/rust/pull/37280
5880 [37298]: https://github.com/rust-lang/rust/pull/37298
5881 [37306]: https://github.com/rust-lang/rust/pull/37306
5882 [37310]: https://github.com/rust-lang/rust/pull/37310
5883 [37312]: https://github.com/rust-lang/rust/pull/37312
5884 [37313]: https://github.com/rust-lang/rust/pull/37313
5885 [37315]: https://github.com/rust-lang/rust/pull/37315
5886 [37318]: https://github.com/rust-lang/rust/pull/37318
5887 [37322]: https://github.com/rust-lang/rust/pull/37322
5888 [37326]: https://github.com/rust-lang/rust/pull/37326
5889 [37351]: https://github.com/rust-lang/rust/pull/37351
5890 [37356]: https://github.com/rust-lang/rust/pull/37356
5891 [37367]: https://github.com/rust-lang/rust/pull/37367
5892 [37373]: https://github.com/rust-lang/rust/pull/37373
5893 [37378]: https://github.com/rust-lang/rust/pull/37378
5894 [37389]: https://github.com/rust-lang/rust/pull/37389
5895 [37392]: https://github.com/rust-lang/rust/pull/37392
5896 [37427]: https://github.com/rust-lang/rust/pull/37427
5897 [37439]: https://github.com/rust-lang/rust/pull/37439
5898 [37445]: https://github.com/rust-lang/rust/pull/37445
5899 [37470]: https://github.com/rust-lang/rust/pull/37470
5900 [37569]: https://github.com/rust-lang/rust/pull/37569
5901 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
5902 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
5903 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
5904 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
5905 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
5906 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
5907 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
5908
5909
5910 Version 1.13.0 (2016-11-10)
5911 ===========================
5912
5913 Language
5914 --------
5915
5916 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
5917   errors, like the `try!` macro, described in [RFC 0243].
5918 * [Stabilize macros in type position][36014]. Described in [RFC 873].
5919 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
5920 * [Fix `#[derive]` for empty tuple structs/variants][35728]
5921 * [Fix lifetime rules for 'if' conditions][36029]
5922 * [Avoid loading and parsing unconfigured non-inline modules][36482]
5923
5924 Compiler
5925 --------
5926
5927 * [Add the `-C link-arg` argument][36574]
5928 * [Remove the old AST-based backend from rustc_trans][35764]
5929 * [Don't enable NEON by default on armv7 Linux][35814]
5930 * [Fix debug line number info for macro expansions][35238]
5931 * [Do not emit "class method" debuginfo for types that are not
5932   DICompositeType][36008]
5933 * [Warn about multiple conflicting #[repr] hints][34623]
5934 * [When sizing DST, don't double-count nested struct prefixes][36351]
5935 * [Default RUST_MIN_STACK to 16MiB for now][36505]
5936 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
5937 * [Reject macros with empty repetitions to avoid infinite loop][36721]
5938 * [Expand macros without recursing to avoid stack overflows][36214]
5939
5940 Diagnostics
5941 -----------
5942
5943 * [Replace macro backtraces with labeled local uses][35702]
5944 * [Improve error message for misplaced doc comments][33922]
5945 * [Buffer unix and lock windows to prevent message interleaving][35975]
5946 * [Update lifetime errors to specifically note temporaries][36171]
5947 * [Special case a few colors for Windows][36178]
5948 * [Suggest `use self` when such an import resolves][36289]
5949 * [Be more specific when type parameter shadows primitive type][36338]
5950 * Many minor improvements
5951
5952 Compile-time Optimizations
5953 --------------------------
5954
5955 * [Compute and cache HIR hashes at beginning][35854]
5956 * [Don't hash types in loan paths][36004]
5957 * [Cache projections in trans][35761]
5958 * [Optimize the parser's last token handling][36527]
5959 * [Only instantiate #[inline] functions in codegen units referencing
5960   them][36524]. This leads to big improvements in cases where crates export
5961   define many inline functions without using them directly.
5962 * [Lazily allocate TypedArena's first chunk][36592]
5963 * [Don't allocate during default HashSet creation][36734]
5964
5965 Stabilized APIs
5966 ---------------
5967
5968 * [`checked_abs`]
5969 * [`wrapping_abs`]
5970 * [`overflowing_abs`]
5971 * [`RefCell::try_borrow`]
5972 * [`RefCell::try_borrow_mut`]
5973
5974 Libraries
5975 ---------
5976
5977 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
5978 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
5979   covariant][35354]
5980 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
5981 * [Implement `Debug` for `std::vec::IntoIter`][35707]
5982 * [`CString`: avoid excessive growth just to 0-terminate][35871]
5983 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
5984 * [Use arc4rand on FreeBSD][35884]
5985 * [memrchr: Correct aligned offset computation][35969]
5986 * [Improve Demangling of Rust Symbols][36059]
5987 * [Use monotonic time in condition variables][35048]
5988 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
5989 * [Implement conversion traits for `char`][35755]
5990 * [Fix illegal instruction caused by overflow in channel cloning][36104]
5991 * [Zero first byte of CString on drop][36264]
5992 * [Inherit overflow checks for sum and product][36372]
5993 * [Add missing Eq implementations][36423]
5994 * [Implement `Debug` for `DirEntry`][36631]
5995 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
5996   `errno`][36754]
5997 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
5998 * [Implement more traits for `std::io::ErrorKind`][35911]
5999 * [Optimize BinaryHeap bounds checking][36072]
6000 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
6001   `extend_with_element`][36355]
6002 * [Fix overflow checking in unsigned pow()][34942]
6003
6004 Cargo
6005 -----
6006
6007 * This release includes security fixes to both curl and OpenSSL.
6008 * [Fix transitive doctests when panic=abort][cargo/3021]
6009 * [Add --all-features flag to cargo][cargo/3038]
6010 * [Reject path-based dependencies in `cargo package`][cargo/3060]
6011 * [Don't parse the home directory more than once][cargo/3078]
6012 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
6013 * [Update OpenSSL to 1.0.2j][cargo/3121]
6014 * [Add license and license_file to cargo metadata output][cargo/3110]
6015 * [Make crates-io registry URL optional in config; ignore all changes to
6016   source.crates-io][cargo/3089]
6017 * [Don't download dependencies from other platforms][cargo/3123]
6018 * [Build transitive dev-dependencies when needed][cargo/3125]
6019 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
6020 * [Avoid updating registry when adding existing deps][cargo/3144]
6021 * [Warn about path overrides that won't work][cargo/3136]
6022 * [Use workspaces during `cargo install`][cargo/3146]
6023 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
6024 * [Add --message-format flag][cargo/3000]
6025 * [Pass target environment for rustdoc][cargo/3205]
6026 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
6027 * [Update curl and curl-sys][cargo/3241]
6028 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
6029
6030 Tooling
6031 -------
6032
6033 * [rustdoc: Add the `--sysroot` argument][36586]
6034 * [rustdoc: Fix a couple of issues with the search results][35655]
6035 * [rustdoc: remove the `!` from macro URLs and titles][35234]
6036 * [gdb: Fix pretty-printing special-cased Rust types][35585]
6037 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
6038
6039 Misc
6040 ----
6041
6042 * [Remove unmaintained style guide][35124]
6043 * [Add s390x support][36369]
6044 * [Initial work at Haiku OS support][36727]
6045 * [Add mips-uclibc targets][35734]
6046 * [Crate-ify compiler-rt into compiler-builtins][35021]
6047 * [Add rustc version info (git hash + date) to dist tarball][36213]
6048 * Many documentation improvements
6049
6050 Compatibility Notes
6051 -------------------
6052
6053 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6054 * [Deny (by default) transmuting from fn item types to pointer-sized
6055   types][34923]. Continuing the long transition to zero-sized fn items,
6056   per [RFC 401].
6057 * [Fix `#[derive]` for empty tuple structs/variants][35728].
6058   Part of [RFC 1506].
6059 * [Issue deprecation warnings for safe accesses to extern statics][36173]
6060 * [Fix lifetime rules for 'if' conditions][36029].
6061 * [Inherit overflow checks for sum and product][36372].
6062 * [Forbid user-defined macros named "macro_rules"][36730].
6063
6064 [33922]: https://github.com/rust-lang/rust/pull/33922
6065 [34623]: https://github.com/rust-lang/rust/pull/34623
6066 [34923]: https://github.com/rust-lang/rust/pull/34923
6067 [34942]: https://github.com/rust-lang/rust/pull/34942
6068 [34982]: https://github.com/rust-lang/rust/pull/34982
6069 [35021]: https://github.com/rust-lang/rust/pull/35021
6070 [35048]: https://github.com/rust-lang/rust/pull/35048
6071 [35074]: https://github.com/rust-lang/rust/pull/35074
6072 [35124]: https://github.com/rust-lang/rust/pull/35124
6073 [35234]: https://github.com/rust-lang/rust/pull/35234
6074 [35238]: https://github.com/rust-lang/rust/pull/35238
6075 [35354]: https://github.com/rust-lang/rust/pull/35354
6076 [35559]: https://github.com/rust-lang/rust/pull/35559
6077 [35585]: https://github.com/rust-lang/rust/pull/35585
6078 [35627]: https://github.com/rust-lang/rust/pull/35627
6079 [35655]: https://github.com/rust-lang/rust/pull/35655
6080 [35702]: https://github.com/rust-lang/rust/pull/35702
6081 [35707]: https://github.com/rust-lang/rust/pull/35707
6082 [35728]: https://github.com/rust-lang/rust/pull/35728
6083 [35734]: https://github.com/rust-lang/rust/pull/35734
6084 [35755]: https://github.com/rust-lang/rust/pull/35755
6085 [35761]: https://github.com/rust-lang/rust/pull/35761
6086 [35764]: https://github.com/rust-lang/rust/pull/35764
6087 [35814]: https://github.com/rust-lang/rust/pull/35814
6088 [35854]: https://github.com/rust-lang/rust/pull/35854
6089 [35871]: https://github.com/rust-lang/rust/pull/35871
6090 [35884]: https://github.com/rust-lang/rust/pull/35884
6091 [35911]: https://github.com/rust-lang/rust/pull/35911
6092 [35969]: https://github.com/rust-lang/rust/pull/35969
6093 [35975]: https://github.com/rust-lang/rust/pull/35975
6094 [36004]: https://github.com/rust-lang/rust/pull/36004
6095 [36008]: https://github.com/rust-lang/rust/pull/36008
6096 [36014]: https://github.com/rust-lang/rust/pull/36014
6097 [36029]: https://github.com/rust-lang/rust/pull/36029
6098 [36059]: https://github.com/rust-lang/rust/pull/36059
6099 [36072]: https://github.com/rust-lang/rust/pull/36072
6100 [36101]: https://github.com/rust-lang/rust/pull/36101
6101 [36104]: https://github.com/rust-lang/rust/pull/36104
6102 [36171]: https://github.com/rust-lang/rust/pull/36171
6103 [36173]: https://github.com/rust-lang/rust/pull/36173
6104 [36178]: https://github.com/rust-lang/rust/pull/36178
6105 [36213]: https://github.com/rust-lang/rust/pull/36213
6106 [36214]: https://github.com/rust-lang/rust/pull/36214
6107 [36264]: https://github.com/rust-lang/rust/pull/36264
6108 [36266]: https://github.com/rust-lang/rust/pull/36266
6109 [36289]: https://github.com/rust-lang/rust/pull/36289
6110 [36338]: https://github.com/rust-lang/rust/pull/36338
6111 [36351]: https://github.com/rust-lang/rust/pull/36351
6112 [36355]: https://github.com/rust-lang/rust/pull/36355
6113 [36369]: https://github.com/rust-lang/rust/pull/36369
6114 [36372]: https://github.com/rust-lang/rust/pull/36372
6115 [36423]: https://github.com/rust-lang/rust/pull/36423
6116 [36482]: https://github.com/rust-lang/rust/pull/36482
6117 [36505]: https://github.com/rust-lang/rust/pull/36505
6118 [36524]: https://github.com/rust-lang/rust/pull/36524
6119 [36527]: https://github.com/rust-lang/rust/pull/36527
6120 [36551]: https://github.com/rust-lang/rust/pull/36551
6121 [36574]: https://github.com/rust-lang/rust/pull/36574
6122 [36586]: https://github.com/rust-lang/rust/pull/36586
6123 [36592]: https://github.com/rust-lang/rust/pull/36592
6124 [36631]: https://github.com/rust-lang/rust/pull/36631
6125 [36639]: https://github.com/rust-lang/rust/pull/36639
6126 [36721]: https://github.com/rust-lang/rust/pull/36721
6127 [36727]: https://github.com/rust-lang/rust/pull/36727
6128 [36730]: https://github.com/rust-lang/rust/pull/36730
6129 [36734]: https://github.com/rust-lang/rust/pull/36734
6130 [36754]: https://github.com/rust-lang/rust/pull/36754
6131 [36995]: https://github.com/rust-lang/rust/pull/36995
6132 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
6133 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
6134 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6135 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
6136 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
6137 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
6138 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
6139 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
6140 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
6141 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
6142 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
6143 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
6144 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
6145 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
6146 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
6147 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
6148 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
6149 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
6150 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
6151 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
6152 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
6153 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
6154 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
6155 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
6156 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
6157 [rustup]: https://www.rustup.rs
6158 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
6159 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
6160 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
6161 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
6162 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
6163 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
6164 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
6165
6166
6167 Version 1.12.1 (2016-10-20)
6168 ===========================
6169
6170 Regression Fixes
6171 ----------------
6172
6173 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
6174 * [Confusion with double negation and booleans][36856]
6175 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
6176 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
6177 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
6178 * [Corrupted memory after updated to 1.12][36936]
6179 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
6180 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
6181 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
6182
6183 [36381]: https://github.com/rust-lang/rust/issues/36381
6184 [36856]: https://github.com/rust-lang/rust/issues/36856
6185 [36875]: https://github.com/rust-lang/rust/issues/36875
6186 [36924]: https://github.com/rust-lang/rust/issues/36924
6187 [36926]: https://github.com/rust-lang/rust/issues/36926
6188 [36936]: https://github.com/rust-lang/rust/issues/36936
6189 [37026]: https://github.com/rust-lang/rust/issues/37026
6190 [37112]: https://github.com/rust-lang/rust/issues/37112
6191 [37153]: https://github.com/rust-lang/rust/issues/37153
6192
6193
6194 Version 1.12.0 (2016-09-29)
6195 ===========================
6196
6197 Highlights
6198 ----------
6199
6200 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6201   This translation pass is far simpler than the previous AST->LLVM pass, and
6202   creates opportunities to perform new optimizations directly on the MIR. It
6203   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6204 * [`rustc` presents a new, more readable error format, along with
6205   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6206   Most common editors supporting Rust have been updated to work with it. It was
6207   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6208
6209 Compiler
6210 --------
6211
6212 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6213   This translation pass is far simpler than the previous AST->LLVM pass, and
6214   creates opportunities to perform new optimizations directly on the MIR. It
6215   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6216 * [Print the Rust target name, not the LLVM target name, with
6217   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
6218 * [The computation of `TypeId` is correct in some cases where it was previously
6219   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
6220 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
6221 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
6222   `--print relocation-models`, and `--print code-models` print the available
6223   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
6224   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
6225 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
6226   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
6227   These targets produce statically-linked binaries. There are no binary release
6228   builds yet though.
6229
6230 Diagnostics
6231 -----------
6232
6233 * [`rustc` presents a new, more readable error format, along with
6234   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6235   Most common editors supporting Rust have been updated to work with it. It was
6236   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6237 * [In error descriptions, references are now described in plain English,
6238   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
6239 * [In error type descriptions, unknown numeric types are named `{integer}` or
6240   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
6241 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
6242
6243 Language
6244 --------
6245
6246 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
6247 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
6248 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
6249   useful](https://github.com/rust-lang/rust/pull/34908)
6250 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
6251   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
6252 * [Semicolons are properly required as statement delimiters inside
6253   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
6254 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
6255
6256 Stabilized APIs
6257 ---------------
6258
6259 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
6260 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
6261 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
6262 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
6263 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
6264 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
6265 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
6266 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
6267 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
6268 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
6269   Both on Unix and Windows.
6270 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
6271 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
6272 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
6273 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
6274 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
6275 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
6276 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
6277 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
6278
6279 Libraries
6280 ---------
6281
6282 * [The `format!` macro and friends now allow a single argument to be formatted
6283   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
6284 * [The lifetime bounds on `[T]::binary_search_by` and
6285   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
6286 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
6287 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
6288 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
6289 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
6290 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
6291 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
6292 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
6293 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
6294   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
6295 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
6296   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
6297 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
6298 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
6299   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
6300 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
6301 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
6302 * [`mpsc::sync_channel` `Receiver`s return any available message before
6303   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
6304 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
6305 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
6306
6307 Cargo
6308 -----
6309
6310 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
6311 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
6312 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
6313 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
6314 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
6315 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
6316 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
6317 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
6318 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
6319 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
6320 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
6321 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
6322 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
6323 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
6324 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
6325 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
6326
6327 Performance
6328 -----------
6329
6330 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
6331 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
6332
6333 Tooling
6334 -------
6335
6336 * [Test binaries now support a `--test-threads` argument to specify the number
6337   of threads used to run tests, and which acts the same as the
6338   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
6339 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
6340 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
6341 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
6342 * [Rust releases now come with source packages that can be installed by rustup
6343   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
6344   The resulting source code can be used by tools and IDES, located in the
6345   sysroot under `lib/rustlib/src`.
6346
6347 Misc
6348 ----
6349
6350 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
6351 * Many minor improvements to the documentation.
6352 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
6353
6354 Compatibility Notes
6355 -------------------
6356
6357 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
6358   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
6359 * [When formatting strings, if "precision" is specified, the "fill",
6360   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
6361 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
6362
6363
6364 Version 1.11.0 (2016-08-18)
6365 ===========================
6366
6367 Language
6368 --------
6369
6370 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
6371 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
6372 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
6373 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
6374
6375 Stabilized APIs
6376 ---------------
6377
6378 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
6379 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
6380 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
6381 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
6382 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
6383 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
6384   (in libcore - previously stabilized in libstd)
6385 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
6386   (in libcore - previously stabilized in libstd)
6387 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
6388   (in libcore - previously stabilized in libstd)
6389 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
6390   (in libcore - previously stabilized in libstd)
6391 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
6392 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
6393 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
6394 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
6395
6396 Libraries
6397 ---------
6398
6399 * [The `thread_local!` macro supports multiple definitions in a single
6400    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
6401 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
6402 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
6403   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
6404 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
6405 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
6406 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
6407 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
6408
6409 Cargo
6410 -----
6411
6412 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
6413 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
6414 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
6415 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
6416 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
6417   and `-vv` prints warnings for all crates.
6418 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
6419 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
6420   This provides room for expansion by arbitrary tools.
6421 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
6422 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
6423 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
6424 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
6425 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
6426 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
6427 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
6428
6429 Performance
6430 -----------
6431
6432 * [Caching projections speeds up type check dramatically for some
6433   workloads](https://github.com/rust-lang/rust/pull/33816)
6434 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
6435   This hasher is faster, but is believed to provide sufficient
6436   protection from collision attacks.
6437 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
6438
6439 Rustdoc
6440 -------
6441
6442 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
6443 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
6444 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
6445 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
6446 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
6447
6448 Tooling
6449 -------
6450
6451 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
6452 * [When emitting debug info, rustc emits frame pointers for closures,
6453   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
6454 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
6455 * Many more errors have been given error codes and extended
6456   explanations
6457 * API documentation continues to be improved, with many new examples
6458
6459 Misc
6460 ----
6461
6462 * [rustc no longer hangs when dependencies recursively re-export
6463   submodules](https://github.com/rust-lang/rust/pull/34542)
6464 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
6465 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
6466   rewritten](https://github.com/rust-lang/rust/pull/33895)
6467 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
6468   No targets use this yet, but it works toward AVR support.
6469
6470 Compatibility Notes
6471 -------------------
6472
6473 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
6474 * [The new follow-set rules that place restrictions on `macro_rules!`
6475   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
6476   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
6477   and has been a warning since 1.10.
6478 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
6479   This causes breakage in some corner cases.
6480
6481
6482 Version 1.10.0 (2016-07-07)
6483 ===========================
6484
6485 Language
6486 --------
6487
6488 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
6489   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
6490 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
6491 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
6492 * [`panic!` can be converted to a runtime abort with the
6493   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
6494   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
6495 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
6496   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
6497   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
6498   Note that Cargo does not yet directly support cdylibs.
6499
6500 Stabilized APIs
6501 ---------------
6502
6503 * `os::windows::fs::OpenOptionsExt::access_mode`
6504 * `os::windows::fs::OpenOptionsExt::share_mode`
6505 * `os::windows::fs::OpenOptionsExt::custom_flags`
6506 * `os::windows::fs::OpenOptionsExt::attributes`
6507 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
6508 * `os::unix::fs::OpenOptionsExt::custom_flags`
6509 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
6510 * `Default for sync::Weak`
6511 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
6512 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
6513 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
6514 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
6515 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
6516 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
6517 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
6518 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
6519 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
6520 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
6521 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
6522 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
6523 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
6524 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
6525 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
6526 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
6527 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
6528 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
6529 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
6530 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
6531 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
6532 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
6533 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
6534 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
6535 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
6536 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
6537 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
6538 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
6539 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
6540 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
6541 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
6542 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
6543 * Read/Write/RawFd impls for `UnixStream`
6544 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
6545 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
6546 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
6547 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
6548 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
6549 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
6550 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
6551 * RawFd impls for `UnixListener`
6552 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
6553 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
6554 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
6555 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
6556 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
6557 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
6558 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
6559 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
6560 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
6561 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
6562 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
6563 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
6564 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
6565 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
6566 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
6567 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
6568 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
6569 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
6570 * RawFd impls for `UnixDatagram`
6571 * `{BTree,Hash}Map::values_mut`
6572 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
6573
6574 Libraries
6575 ---------
6576
6577 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
6578   The semantics of this minor method are subtle and probably not what
6579   most people want.
6580 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
6581 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
6582   will fall back to `/dev/urandom` temporarily to avoid blocking
6583   during early boot](https://github.com/rust-lang/rust/pull/33086).
6584 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
6585 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
6586 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
6587 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
6588 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
6589 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
6590   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
6591
6592 Cargo
6593 -----
6594 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
6595   This controls the runtime behavior of the `panic!` macro
6596   and can be either "unwind" (the default), or "abort".
6597   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
6598 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
6599 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
6600 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
6601   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
6602 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
6603 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
6604 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
6605   By default they are retried twice, which can be customized with the
6606   `net.retry` value in `.cargo/config`.
6607 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
6608 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
6609 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
6610 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
6611   Makes it possible to install multiple crates in parallel.
6612 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
6613 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
6614 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
6615 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
6616 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
6617 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
6618
6619 Performance
6620 -----------
6621
6622 * [rustc memory usage was reduced by refactoring the context used for
6623   type checking](https://github.com/rust-lang/rust/pull/33425).
6624 * [Speed up creation of `HashMap`s by caching the random keys used
6625   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
6626 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
6627 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
6628 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
6629   10x faster than the previous lookup tables.
6630 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
6631
6632 Usability
6633 ---------
6634
6635 * Many incremental improvements to documentation and rustdoc.
6636 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
6637 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
6638 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
6639 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
6640 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
6641 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
6642 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
6643
6644 Misc
6645 ----
6646
6647 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
6648 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
6649 * [`std` no longer prints backtraces on platforms where the running
6650   module must be loaded with `env::current_exe`, which can't be relied
6651   on](https://github.com/rust-lang/rust/pull/33554).
6652 * This release includes std binaries for the i586-unknown-linux-gnu,
6653   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
6654   i586 target is for old x86 hardware without SSE2, and the armv7
6655   target is for Android running on modern ARM architectures.
6656 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
6657   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
6658 * [On Unix the runtime aborts by calling `libc::abort` instead of
6659   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
6660 * [Rust is now bootstrapped from the previous release of Rust,
6661   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
6662
6663 Compatibility Notes
6664 -------------------
6665
6666 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
6667 * [`target_env` for Linux ARM targets is just `gnu`, not
6668   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
6669 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
6670 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
6671 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
6672   Affects how macros are parsed.
6673 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
6674 * [Feature-gated attributes on macro-generated macro invocations are
6675   now rejected](https://github.com/rust-lang/rust/pull/32791).
6676 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
6677   This caused some minor changes to type inference.
6678
6679
6680 Version 1.9.0 (2016-05-26)
6681 ==========================
6682
6683 Language
6684 --------
6685
6686 * The `#[deprecated]` attribute when applied to an API will generate
6687   warnings when used. The warnings may be suppressed with
6688   `#[allow(deprecated)]`. [RFC 1270].
6689 * [`fn` item types are zero sized, and each `fn` names a unique
6690   type][1.9fn]. This will break code that transmutes `fn`s, so calling
6691   `transmute` on a `fn` type will generate a warning for a few cycles,
6692   then will be converted to an error.
6693 * [Field and method resolution understand visibility, so private
6694   fields and methods cannot prevent the proper use of public fields
6695   and methods][1.9fv].
6696 * [The parser considers unicode codepoints in the
6697   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
6698
6699 Stabilized APIs
6700 ---------------
6701
6702 * [`std::panic`]
6703 * [`std::panic::catch_unwind`] (renamed from `recover`)
6704 * [`std::panic::resume_unwind`] (renamed from `propagate`)
6705 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
6706 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
6707 * [`str::is_char_boundary`]
6708 * [`<*const T>::as_ref`]
6709 * [`<*mut T>::as_ref`]
6710 * [`<*mut T>::as_mut`]
6711 * [`AsciiExt::make_ascii_uppercase`]
6712 * [`AsciiExt::make_ascii_lowercase`]
6713 * [`char::decode_utf16`]
6714 * [`char::DecodeUtf16`]
6715 * [`char::DecodeUtf16Error`]
6716 * [`char::DecodeUtf16Error::unpaired_surrogate`]
6717 * [`BTreeSet::take`]
6718 * [`BTreeSet::replace`]
6719 * [`BTreeSet::get`]
6720 * [`HashSet::take`]
6721 * [`HashSet::replace`]
6722 * [`HashSet::get`]
6723 * [`OsString::with_capacity`]
6724 * [`OsString::clear`]
6725 * [`OsString::capacity`]
6726 * [`OsString::reserve`]
6727 * [`OsString::reserve_exact`]
6728 * [`OsStr::is_empty`]
6729 * [`OsStr::len`]
6730 * [`std::os::unix::thread`]
6731 * [`RawPthread`]
6732 * [`JoinHandleExt`]
6733 * [`JoinHandleExt::as_pthread_t`]
6734 * [`JoinHandleExt::into_pthread_t`]
6735 * [`HashSet::hasher`]
6736 * [`HashMap::hasher`]
6737 * [`CommandExt::exec`]
6738 * [`File::try_clone`]
6739 * [`SocketAddr::set_ip`]
6740 * [`SocketAddr::set_port`]
6741 * [`SocketAddrV4::set_ip`]
6742 * [`SocketAddrV4::set_port`]
6743 * [`SocketAddrV6::set_ip`]
6744 * [`SocketAddrV6::set_port`]
6745 * [`SocketAddrV6::set_flowinfo`]
6746 * [`SocketAddrV6::set_scope_id`]
6747 * [`slice::copy_from_slice`]
6748 * [`ptr::read_volatile`]
6749 * [`ptr::write_volatile`]
6750 * [`OpenOptions::create_new`]
6751 * [`TcpStream::set_nodelay`]
6752 * [`TcpStream::nodelay`]
6753 * [`TcpStream::set_ttl`]
6754 * [`TcpStream::ttl`]
6755 * [`TcpStream::set_only_v6`]
6756 * [`TcpStream::only_v6`]
6757 * [`TcpStream::take_error`]
6758 * [`TcpStream::set_nonblocking`]
6759 * [`TcpListener::set_ttl`]
6760 * [`TcpListener::ttl`]
6761 * [`TcpListener::set_only_v6`]
6762 * [`TcpListener::only_v6`]
6763 * [`TcpListener::take_error`]
6764 * [`TcpListener::set_nonblocking`]
6765 * [`UdpSocket::set_broadcast`]
6766 * [`UdpSocket::broadcast`]
6767 * [`UdpSocket::set_multicast_loop_v4`]
6768 * [`UdpSocket::multicast_loop_v4`]
6769 * [`UdpSocket::set_multicast_ttl_v4`]
6770 * [`UdpSocket::multicast_ttl_v4`]
6771 * [`UdpSocket::set_multicast_loop_v6`]
6772 * [`UdpSocket::multicast_loop_v6`]
6773 * [`UdpSocket::set_multicast_ttl_v6`]
6774 * [`UdpSocket::multicast_ttl_v6`]
6775 * [`UdpSocket::set_ttl`]
6776 * [`UdpSocket::ttl`]
6777 * [`UdpSocket::set_only_v6`]
6778 * [`UdpSocket::only_v6`]
6779 * [`UdpSocket::join_multicast_v4`]
6780 * [`UdpSocket::join_multicast_v6`]
6781 * [`UdpSocket::leave_multicast_v4`]
6782 * [`UdpSocket::leave_multicast_v6`]
6783 * [`UdpSocket::take_error`]
6784 * [`UdpSocket::connect`]
6785 * [`UdpSocket::send`]
6786 * [`UdpSocket::recv`]
6787 * [`UdpSocket::set_nonblocking`]
6788
6789 Libraries
6790 ---------
6791
6792 * [`std::sync::Once` is poisoned if its initialization function
6793   fails][1.9o].
6794 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
6795 * [Most types implement `fmt::Debug`][1.9db].
6796 * [The default buffer size used by `BufReader` and `BufWriter` was
6797   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
6798   used by other languages.
6799 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
6800   `Duration` additionally implements `*=` and `/=`][1.9ta].
6801 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
6802 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
6803 * [`Chain` implements `BufRead`][1.9ch].
6804 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
6805
6806 Cargo
6807 -----
6808
6809 * [Cargo can now run concurrently][1.9cc].
6810 * [Top-level overrides allow specific revisions of crates to be
6811   overridden through the entire crate graph][1.9ct].  This is intended
6812   to make upgrades easier for large projects, by allowing crates to be
6813   forked temporarily until they've been upgraded and republished.
6814 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
6815 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
6816   on the commandline][1.9cf]. `rustc` arguments can also be specified
6817   in the `build.rustflags` configuration key.
6818
6819 Performance
6820 -----------
6821
6822 * [The time complexity of comparing variables for equivalence during type
6823   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
6824   to major compilation time improvement in some scenarios.
6825 * [`ToString` is specialized for `str`, giving it the same performance
6826   as `to_owned`][1.9ts].
6827 * [Spawning processes with `Command::output` no longer creates extra
6828   threads][1.9sp].
6829 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
6830   for C-like enums][1.9cl].
6831
6832 Misc
6833 ----
6834
6835 * [Passing the `--quiet` flag to a test runner will produce
6836   much-abbreviated output][1.9q].
6837 * The Rust Project now publishes std binaries for the
6838   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
6839   `i586-pc-windows-msvc` targets.
6840
6841 Compatibility Notes
6842 -------------------
6843
6844 * [`std::sync::Once` is poisoned if its initialization function
6845   fails][1.9o].
6846 * [It is illegal to define methods with the same name in overlapping
6847   inherent `impl` blocks][1.9sn].
6848 * [`fn` item types are zero sized, and each `fn` names a unique
6849   type][1.9fn]. This will break code that transmutes `fn`s, so calling
6850   `transmute` on a `fn` type will generate a warning for a few cycles,
6851   then will be converted to an error.
6852 * [Improvements to const evaluation may trigger new errors when integer
6853   literals are out of range][1.9ce].
6854
6855
6856 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
6857 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
6858 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
6859 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
6860 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
6861 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
6862 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
6863 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
6864 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
6865 [1.9db]: https://github.com/rust-lang/rust/pull/32054
6866 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
6867 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
6868 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
6869 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
6870 [1.9o]: https://github.com/rust-lang/rust/pull/32325
6871 [1.9q]: https://github.com/rust-lang/rust/pull/31887
6872 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
6873 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
6874 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
6875 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
6876 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
6877 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
6878 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
6879 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
6880 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
6881 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
6882 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
6883 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
6884 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
6885 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
6886 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
6887 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
6888 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
6889 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
6890 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
6891 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
6892 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
6893 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
6894 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
6895 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
6896 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
6897 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
6898 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
6899 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
6900 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
6901 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
6902 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
6903 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
6904 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
6905 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
6906 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
6907 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
6908 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
6909 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
6910 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
6911 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
6912 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
6913 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
6914 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
6915 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
6916 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
6917 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
6918 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
6919 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
6920 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
6921 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
6922 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
6923 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
6924 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
6925 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
6926 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
6927 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
6928 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
6929 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
6930 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
6931 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
6932 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
6933 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
6934 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
6935 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
6936 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
6937 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
6938 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
6939 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
6940 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
6941 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
6942 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
6943 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
6944 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
6945 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
6946 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
6947 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
6948 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
6949 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
6950 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
6951 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
6952 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
6953 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
6954 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
6955 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
6956 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
6957 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
6958 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
6959 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
6960 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
6961 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
6962 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
6963 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
6964 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
6965 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
6966
6967
6968 Version 1.8.0 (2016-04-14)
6969 ==========================
6970
6971 Language
6972 --------
6973
6974 * Rust supports overloading of compound assignment statements like
6975   `+=` by implementing the [`AddAssign`], [`SubAssign`],
6976   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
6977   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
6978   traits. [RFC 953].
6979 * Empty structs can be defined with braces, as in `struct Foo { }`, in
6980   addition to the non-braced form, `struct Foo;`. [RFC 218].
6981
6982 Libraries
6983 ---------
6984
6985 * Stabilized APIs:
6986   * [`str::encode_utf16`] (renamed from `utf16_units`)
6987   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
6988   * [`Ref::map`]
6989   * [`RefMut::map`]
6990   * [`ptr::drop_in_place`]
6991   * [`time::Instant`]
6992   * [`time::SystemTime`]
6993   * [`Instant::now`]
6994   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
6995   * [`Instant::elapsed`]
6996   * [`SystemTime::now`]
6997   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
6998   * [`SystemTime::elapsed`]
6999   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
7000   * [`SystemTimeError`]
7001   * [`SystemTimeError::duration`]
7002   * Various impls for `SystemTimeError`
7003   * [`UNIX_EPOCH`]
7004   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
7005     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
7006     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
7007 * [The `write!` and `writeln!` macros correctly emit errors if any of
7008   their arguments can't be formatted][1.8w].
7009 * [Various I/O functions support large files on 32-bit Linux][1.8l].
7010 * [The Unix-specific `raw` modules, which contain a number of
7011   redefined C types are deprecated][1.8r], including `os::raw::unix`,
7012   `os::raw::macos`, and `os::raw::linux`. These modules defined types
7013   such as `ino_t` and `dev_t`. The inconsistency of these definitions
7014   across platforms was making it difficult to implement `std`
7015   correctly. Those that need these definitions should use the `libc`
7016   crate. [RFC 1415].
7017 * The Unix-specific `MetadataExt` traits, including
7018   `os::unix::fs::MetadataExt`, which expose values such as inode
7019   numbers [no longer return platform-specific types][1.8r], but
7020   instead return widened integers. [RFC 1415].
7021 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
7022 * [Atomic loads and stores are not volatile][1.8a].
7023 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
7024
7025 Performance
7026 -----------
7027
7028 * [Inlining hash functions lead to a 3% compile-time improvement in
7029   some workloads][1.8h].
7030 * When using jemalloc, its symbols are [unprefixed so that it
7031   overrides the libc malloc implementation][1.8h]. This means that for
7032   rustc, LLVM is now using jemalloc, which results in a 6%
7033   compile-time improvement on a specific workload.
7034 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
7035
7036 Misc
7037 ----
7038
7039 * [32-bit MSVC builds finally implement unwinding][1.8ms].
7040   i686-pc-windows-msvc is now considered a tier-1 platform.
7041 * [The `--print targets` flag prints a list of supported targets][1.8t].
7042 * [The `--print cfg` flag prints the `cfg`s defined for the current
7043   target][1.8cf].
7044 * [`rustc` can be built with an new Cargo-based build system, written
7045   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
7046   build system. To enable it configure with `configure --rustbuild`.
7047 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
7048   variants while also indicating the total number of missing variants
7049   if more than 3][1.8m].
7050 * [Executable stacks are disabled on Linux and BSD][1.8nx].
7051 * The Rust Project now publishes binary releases of the standard
7052   library for a number of tier-2 targets:
7053   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
7054   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
7055   `x86_64-rumprun-netbsd`. These can be installed with
7056   tools such as [multirust][1.8mr].
7057
7058 Cargo
7059 -----
7060
7061 * [`cargo init` creates a new Cargo project in the current
7062   directory][1.8ci].  It is otherwise like `cargo new`.
7063 * [Cargo has configuration keys for `-v` and
7064   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
7065   `[term]` section of `.cargo/config`.
7066 * [Configuration keys that evaluate to strings or integers can be set
7067   via environment variables][1.8ce]. For example the `build.jobs` key
7068   can be set via `CARGO_BUILD_JOBS`. Environment variables take
7069   precedence over config files.
7070 * [Target-specific dependencies support Rust `cfg` syntax for
7071   describing targets][1.8cfg] so that dependencies for multiple
7072   targets can be specified together. [RFC 1361].
7073 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
7074   `RUSTDOC` take precedence over the `build.target-dir`,
7075   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
7076 * [The child process tree is killed on Windows when Cargo is
7077   killed][1.8ck].
7078 * [The `build.target` configuration value sets the target platform,
7079   like `--target`][1.8ct].
7080
7081 Compatibility Notes
7082 -------------------
7083
7084 * [Unstable compiler flags have been further restricted][1.8u]. Since
7085   1.0 `-Z` flags have been considered unstable, and other flags that
7086   were considered unstable additionally required passing `-Z
7087   unstable-options` to access. Unlike unstable language and library
7088   features though, these options have been accessible on the stable
7089   release channel. Going forward, *new unstable flags will not be
7090   available on the stable release channel*, and old unstable flags
7091   will warn about their usage. In the future, all unstable flags will
7092   be unavailable on the stable release channel.
7093 * [It is no longer possible to `match` on empty enum variants using
7094   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
7095 * The Unix-specific `MetadataExt` traits, including
7096   `os::unix::fs::MetadataExt`, which expose values such as inode
7097   numbers [no longer return platform-specific types][1.8r], but
7098   instead return widened integers. [RFC 1415].
7099 * [Modules sourced from the filesystem cannot appear within arbitrary
7100   blocks, but only within other modules][1.8mf].
7101 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
7102 * On Unix, [stack overflow triggers a runtime abort instead of a
7103   SIGSEGV][1.8so].
7104 * [`Command::spawn` and its equivalents return an error if any of
7105   its command-line arguments contain interior `NUL`s][1.8n].
7106 * [Tuple and unit enum variants from other crates are in the type
7107   namespace][1.8tn].
7108 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
7109   type instead of `.a` files][1.8st]. Additionally, for the MSVC
7110   toolchain, `rustc` emits import libraries named `foo.dll.lib`
7111   instead of `foo.lib`.
7112
7113
7114 [1.8a]: https://github.com/rust-lang/rust/pull/30962
7115 [1.8b]: https://github.com/rust-lang/rust/pull/31123
7116 [1.8c]: https://github.com/rust-lang/rust/pull/31530
7117 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
7118 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
7119 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
7120 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
7121 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
7122 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
7123 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
7124 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
7125 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
7126 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
7127 [1.8h]: https://github.com/rust-lang/rust/pull/31460
7128 [1.8l]: https://github.com/rust-lang/rust/pull/31668
7129 [1.8m]: https://github.com/rust-lang/rust/pull/31020
7130 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
7131 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
7132 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
7133 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
7134 [1.8n]: https://github.com/rust-lang/rust/pull/31056
7135 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
7136 [1.8r]: https://github.com/rust-lang/rust/pull/31551
7137 [1.8so]: https://github.com/rust-lang/rust/pull/31333
7138 [1.8st]: https://github.com/rust-lang/rust/pull/29520
7139 [1.8t]: https://github.com/rust-lang/rust/pull/31358
7140 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
7141 [1.8u]: https://github.com/rust-lang/rust/pull/31793
7142 [1.8v]: https://github.com/rust-lang/rust/pull/31757
7143 [1.8w]: https://github.com/rust-lang/rust/pull/31904
7144 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
7145 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
7146 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
7147 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
7148 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
7149 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
7150 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
7151 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
7152 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
7153 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
7154 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
7155 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
7156 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
7157 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
7158 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
7159 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
7160 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
7161 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
7162 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
7163 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
7164 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
7165 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
7166 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
7167 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
7168 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
7169 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
7170 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
7171 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
7172 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
7173 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
7174
7175
7176 Version 1.7.0 (2016-03-03)
7177 ==========================
7178
7179 Libraries
7180 ---------
7181
7182 * Stabilized APIs
7183   * `Path`
7184     * [`Path::strip_prefix`] (renamed from relative_from)
7185     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
7186   * `Ipv4Addr`
7187     * [`Ipv4Addr::is_loopback`]
7188     * [`Ipv4Addr::is_private`]
7189     * [`Ipv4Addr::is_link_local`]
7190     * [`Ipv4Addr::is_multicast`]
7191     * [`Ipv4Addr::is_broadcast`]
7192     * [`Ipv4Addr::is_documentation`]
7193   * `Ipv6Addr`
7194     * [`Ipv6Addr::is_unspecified`]
7195     * [`Ipv6Addr::is_loopback`]
7196     * [`Ipv6Addr::is_multicast`]
7197   * `Vec`
7198     * [`Vec::as_slice`]
7199     * [`Vec::as_mut_slice`]
7200   * `String`
7201     * [`String::as_str`]
7202     * [`String::as_mut_str`]
7203   * Slices
7204     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
7205     be the same length
7206     * `<[T]>::`[`sort_by_key`]
7207   * checked, saturated, and overflowing operations
7208     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
7209     * [`i32::saturating_mul`]
7210     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
7211     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
7212     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
7213     * [`u32::saturating_mul`]
7214     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
7215     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
7216     * and checked, saturated, and overflowing operations for other primitive types
7217   * FFI
7218     * [`ffi::IntoStringError`]
7219     * [`CString::into_string`]
7220     * [`CString::into_bytes`]
7221     * [`CString::into_bytes_with_nul`]
7222     * `From<CString> for Vec<u8>`
7223   * `IntoStringError`
7224     * [`IntoStringError::into_cstring`]
7225     * [`IntoStringError::utf8_error`]
7226     * `Error for IntoStringError`
7227   * Hashing
7228     * [`std::hash::BuildHasher`]
7229     * [`BuildHasher::Hasher`]
7230     * [`BuildHasher::build_hasher`]
7231     * [`std::hash::BuildHasherDefault`]
7232     * [`HashMap::with_hasher`]
7233     * [`HashMap::with_capacity_and_hasher`]
7234     * [`HashSet::with_hasher`]
7235     * [`HashSet::with_capacity_and_hasher`]
7236     * [`std::collections::hash_map::RandomState`]
7237     * [`RandomState::new`]
7238 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
7239   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
7240   from bytes is faster.
7241 * [The performance of `LineWriter` (and thus `io::stdout`) was
7242   improved by using `memchr` to search for newlines][1.7m].
7243 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
7244   `f64` variants were stabilized previously.
7245 * [`BTreeMap` was rewritten to use less memory and improve the performance
7246   of insertion and iteration, the latter by as much as 5x][1.7bm].
7247 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
7248   covariant over their contained type][1.7bt].
7249 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
7250   over their contained type][1.7ll].
7251 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
7252   searching methods.
7253 * [`Any` is implemented for unsized types][1.7a].
7254 * [`Hash` is implemented for `Duration`][1.7h].
7255
7256 Misc
7257 ----
7258
7259 * [When running tests with `--test`, rustdoc will pass `--cfg`
7260   arguments to the compiler][1.7dt].
7261 * [The compiler is built with RPATH information by default][1.7rpa].
7262   This means that it will be possible to run `rustc` when installed in
7263   unusual configurations without configuring the dynamic linker search
7264   path explicitly.
7265 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
7266   any RPATH entries (emitted with `-C rpath`) *not* take precedence
7267   over `LD_LIBRARY_PATH`.
7268
7269 Cargo
7270 -----
7271
7272 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
7273   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
7274 * [The `rerun-if-changed` build script directive no longer causes the
7275   build script to incorrectly run twice in certain scenarios][1.7rr].
7276
7277 Compatibility Notes
7278 -------------------
7279
7280 * Soundness fixes to the interactions between associated types and
7281   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
7282   code that violates the new rules. This is a significant change that
7283   is known to break existing code, so it has emitted warnings for the
7284   new error cases since 1.4 to give crate authors time to adapt. The
7285   details of what is changing are subtle; read the RFC for more.
7286 * [Several bugs in the compiler's visibility calculations were
7287   fixed][1.7v]. Since this was found to break significant amounts of
7288   code, the new errors will be emitted as warnings for several release
7289   cycles, under the `private_in_public` lint.
7290 * Defaulted type parameters were accidentally accepted in positions
7291   that were not intended. In this release, [defaulted type parameters
7292   appearing outside of type definitions will generate a
7293   warning][1.7d], which will become an error in future releases.
7294 * [Parsing "." as a float results in an error instead of 0][1.7p].
7295   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
7296 * [Borrows of closure parameters may not outlive the closure][1.7bc].
7297
7298 [1.7a]: https://github.com/rust-lang/rust/pull/30928
7299 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
7300 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
7301 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
7302 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
7303 [1.7d]: https://github.com/rust-lang/rust/pull/30724
7304 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
7305 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
7306 [1.7f]: https://github.com/rust-lang/rust/pull/30672
7307 [1.7h]: https://github.com/rust-lang/rust/pull/30818
7308 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
7309 [1.7m]: https://github.com/rust-lang/rust/pull/30381
7310 [1.7p]: https://github.com/rust-lang/rust/pull/30681
7311 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
7312 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
7313 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
7314 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
7315 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
7316 [1.7v]: https://github.com/rust-lang/rust/pull/29973
7317 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7318 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
7319 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
7320 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
7321 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
7322 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
7323 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
7324 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
7325 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
7326 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
7327 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
7328 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
7329 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
7330 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
7331 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
7332 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
7333 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
7334 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
7335 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
7336 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
7337 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
7338 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
7339 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
7340 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
7341 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
7342 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
7343 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
7344 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
7345 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
7346 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
7347 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
7348 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
7349 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
7350 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
7351 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
7352 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
7353 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
7354 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
7355 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
7356 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
7357 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
7358 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
7359 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
7360 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
7361 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
7362 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
7363 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
7364 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
7365 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
7366 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
7367 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
7368 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
7369 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
7370 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
7371 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
7372 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
7373 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
7374 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
7375 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
7376 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
7377
7378
7379 Version 1.6.0 (2016-01-21)
7380 ==========================
7381
7382 Language
7383 --------
7384
7385 * The `#![no_std]` attribute causes a crate to not be linked to the
7386   standard library, but only the [core library][1.6co], as described
7387   in [RFC 1184]. The core library defines common types and traits but
7388   has no platform dependencies whatsoever, and is the basis for Rust
7389   software in environments that cannot support a full port of the
7390   standard library, such as operating systems. Most of the core
7391   library is now stable.
7392
7393 Libraries
7394 ---------
7395
7396 * Stabilized APIs:
7397   [`Read::read_exact`],
7398   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
7399   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
7400   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
7401   [`os::unix::fs::DirBuilderExt`],
7402   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
7403   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
7404   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
7405   [`collections::hash_map::Drain`],
7406   [`collections::hash_map::HashMap::drain`],
7407   [`collections::hash_set::Drain`],
7408   [`collections::hash_set::HashSet::drain`],
7409   [`collections::binary_heap::Drain`],
7410   [`collections::binary_heap::BinaryHeap::drain`],
7411   [`Vec::extend_from_slice`] (renamed from `push_all`),
7412   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
7413   [`RwLock::into_inner`],
7414   [`Iterator::min_by_key`] (renamed from `min_by`),
7415   [`Iterator::max_by_key`] (renamed from `max_by`).
7416 * The [core library][1.6co] is stable, as are most of its APIs.
7417 * [The `assert_eq!` macro supports arguments that don't implement
7418   `Sized`][1.6ae], such as arrays. In this way it behaves more like
7419   `assert!`.
7420 * Several timer functions that take duration in milliseconds [are
7421   deprecated in favor of those that take `Duration`][1.6ms]. These
7422   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
7423   `thread::park_timeout_ms`.
7424 * The algorithm by which `Vec` reserves additional elements was
7425   [tweaked to not allocate excessive space][1.6a] while still growing
7426   exponentially.
7427 * `From` conversions are [implemented from integers to floats][1.6f]
7428   in cases where the conversion is lossless. Thus they are not
7429   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
7430   or `f64`. They are also not implemented for `isize` and `usize`
7431   because the implementations would be platform-specific. `From` is
7432   also implemented from `f32` to `f64`.
7433 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
7434 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
7435 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
7436 * [`BinaryHeap` was refactored][1.6bh] for modest performance
7437   improvements.
7438 * Sorting slices that are already sorted [is 50% faster in some
7439   cases][1.6s].
7440
7441 Cargo
7442 -----
7443
7444 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
7445 * Cargo build scripts can specify their dependencies by emitting the
7446   [`rerun-if-changed`][1.6rr] key.
7447 * crates.io will reject publication of crates with dependencies that
7448   have a wildcard version constraint. Crates with wildcard
7449   dependencies were seen to cause a variety of problems, as described
7450   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
7451   warning.
7452 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
7453   release folder.  A variety of artifacts that Cargo failed to clean
7454   are now correctly deleted.
7455
7456 Misc
7457 ----
7458
7459 * The `unreachable_code` lint [warns when a function call's argument
7460   diverges][1.6dv].
7461 * The parser indicates [failures that may be caused by
7462   confusingly-similar Unicode characters][1.6uc]
7463 * Certain macro errors [are reported at definition time][1.6m], not
7464   expansion.
7465
7466 Compatibility Notes
7467 -------------------
7468
7469 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
7470   environment variable when locating crates. This was a pre-cargo
7471   feature for integrating with the package manager that was
7472   accidentally never removed.
7473 * [A number of bugs were fixed in the privacy checker][1.6p] that
7474   could cause previously-accepted code to break.
7475 * [Modules and unit/tuple structs may not share the same name][1.6ts].
7476 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
7477   struct pattern syntax (`Foo(..)`) can no longer be used to match
7478   unit structs. This is a warning now, but will become an error in
7479   future releases. Patterns that share the same name as a const are
7480   now an error.
7481 * A bug was fixed that causes [rustc not to apply default type
7482   parameters][1.6xc] when resolving certain method implementations of
7483   traits defined in other crates.
7484
7485 [1.6a]: https://github.com/rust-lang/rust/pull/29454
7486 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
7487 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
7488 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
7489 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
7490 [1.6co]: http://doc.rust-lang.org/core/index.html
7491 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
7492 [1.6f]: https://github.com/rust-lang/rust/pull/29129
7493 [1.6m]: https://github.com/rust-lang/rust/pull/29828
7494 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
7495 [1.6p]: https://github.com/rust-lang/rust/pull/29726
7496 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
7497 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
7498 [1.6s]: https://github.com/rust-lang/rust/pull/29675
7499 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
7500 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
7501 [1.6us]: https://github.com/rust-lang/rust/pull/29383
7502 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
7503 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
7504 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
7505 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
7506 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
7507 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
7508 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
7509 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
7510 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
7511 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
7512 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
7513 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
7514 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
7515 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
7516 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
7517 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
7518 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
7519 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
7520 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
7521 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
7522 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
7523 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
7524 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
7525 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
7526 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
7527 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
7528 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
7529 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
7530 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
7531 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
7532
7533
7534 Version 1.5.0 (2015-12-10)
7535 ==========================
7536
7537 * ~700 changes, numerous bugfixes
7538
7539 Highlights
7540 ----------
7541
7542 * Stabilized APIs:
7543   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
7544   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
7545   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
7546   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
7547   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
7548   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
7549   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
7550   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
7551   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
7552   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
7553   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
7554   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
7555   [`Path::read_link`], [`Path::symlink_metadata`],
7556   [`Utf8Error::valid_up_to`], [`Vec::resize`],
7557   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
7558   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
7559   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
7560   [`slice::split_first_mut`], [`slice::split_first`],
7561   [`slice::split_last_mut`], [`slice::split_last`],
7562   [`char::from_u32_unchecked`], [`fs::canonicalize`],
7563   [`str::MatchIndices`], [`str::RMatchIndices`],
7564   [`str::match_indices`], [`str::rmatch_indices`],
7565   [`str::slice_mut_unchecked`], [`string::ParseError`].
7566 * Rust applications hosted on crates.io can be installed locally to
7567   `~/.cargo/bin` with the [`cargo install`] command. Among other
7568   things this makes it easier to augment Cargo with new subcommands:
7569   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
7570   invoked as `cargo foo`.
7571 * Crates with wildcard (`*`) dependencies will [emit warnings when
7572   published][1.5w]. In 1.6 it will no longer be possible to publish
7573   crates with wildcard dependencies.
7574
7575 Breaking Changes
7576 ----------------
7577
7578 * The rules determining when a particular lifetime must outlive
7579   a particular value (known as '[dropck]') have been [modified
7580   to not rely on parametricity][1.5p].
7581 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
7582   and `Arc`][1.5a]. Because these smart pointer types implement
7583   `Deref`, this causes breakage in cases where the interior type
7584   contains methods of the same name.
7585 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
7586   that they could drop their content. Soundness fix.
7587 * All method invocations are [properly checked][1.5wf1] for
7588   [well-formedness][1.5wf2]. Soundness fix.
7589 * Traits whose supertraits contain `Self` are [not object
7590   safe][1.5o]. Soundness fix.
7591 * Target specifications support a [`no_default_libraries`][1.5nd]
7592   setting that controls whether `-nodefaultlibs` is passed to the
7593   linker, and in turn the `is_like_windows` setting no longer affects
7594   the `-nodefaultlibs` flag.
7595 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
7596 * The `#[inline]` and `#[repr]` attributes [can only appear
7597   in valid locations][1.5at].
7598 * Native libraries linked from the local crate are [passed to
7599   the linker before native libraries from upstream crates][1.5nl].
7600 * Two rarely-used attributes, `#[no_debug]` and
7601   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
7602 * Negation of unsigned integers, which has been a warning for
7603   several releases, [is now behind a feature gate and will
7604   generate errors][1.5nu].
7605 * The parser accidentally accepted visibility modifiers on
7606   enum variants, a bug [which has been fixed][1.5ev].
7607 * [A bug was fixed that allowed `use` statements to import unstable
7608   features][1.5use].
7609
7610 Language
7611 --------
7612
7613 * When evaluating expressions at compile-time that are not
7614   compile-time constants (const-evaluating expressions in non-const
7615   contexts), incorrect code such as overlong bitshifts and arithmetic
7616   overflow will [generate a warning instead of an error][1.5ce],
7617   delaying the error until runtime. This will allow the
7618   const-evaluator to be expanded in the future backwards-compatibly.
7619 * The `improper_ctypes` lint [no longer warns about using `isize` and
7620   `usize` in FFI][1.5ict].
7621
7622 Libraries
7623 ---------
7624
7625 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
7626   invariant][1.5c].
7627 * `Default` is [implemented for mutable slices][1.5d].
7628 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
7629 * There are now `From` conversions [between floating point
7630   types][1.5f] where the conversions are lossless.
7631 * There are now `From` conversions [between integer types][1.5i] where
7632   the conversions are lossless.
7633 * [`fs::Metadata` implements `Clone`][1.5fs].
7634 * The `parse` method [accepts a leading "+" when parsing
7635   integers][1.5pi].
7636 * [`AsMut` is implemented for `Vec`][1.5am].
7637 * The `clone_from` implementations for `String` and `BinaryHeap` [have
7638   been optimized][1.5cf] and no longer rely on the default impl.
7639 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
7640   `unsafe extern "C"` function types now [implement `Clone`,
7641   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
7642   `fmt::Debug` for up to 12 arguments][1.5fp].
7643 * [Dropping `Vec`s is much faster in unoptimized builds when the
7644   element types don't implement `Drop`][1.5dv].
7645 * A bug that caused in incorrect behavior when [combining `VecDeque`
7646   with zero-sized types][1.5vdz] was resolved.
7647 * [`PartialOrd` for slices is faster][1.5po].
7648
7649 Miscellaneous
7650 -------------
7651
7652 * [Crate metadata size was reduced by 20%][1.5md].
7653 * [Improvements to code generation reduced the size of libcore by 3.3
7654   MB and rustc's memory usage by 18MB][1.5m].
7655 * [Improvements to deref translation increased performance in
7656   unoptimized builds][1.5dr].
7657 * Various errors in trait resolution [are deduplicated to only be
7658   reported once][1.5te].
7659 * Rust has preliminary [support for rumprun kernels][1.5rr].
7660 * Rust has preliminary [support for NetBSD on amd64][1.5na].
7661
7662 [1.5use]: https://github.com/rust-lang/rust/pull/28364
7663 [1.5po]: https://github.com/rust-lang/rust/pull/28436
7664 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
7665 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
7666 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
7667 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
7668 [1.5md]: https://github.com/rust-lang/rust/pull/28521
7669 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
7670 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
7671 [1.5na]: https://github.com/rust-lang/rust/pull/28543
7672 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
7673 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
7674 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
7675 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
7676 [1.5te]: https://github.com/rust-lang/rust/pull/28645
7677 [1.5at]: https://github.com/rust-lang/rust/pull/28650
7678 [1.5am]: https://github.com/rust-lang/rust/pull/28663
7679 [1.5m]: https://github.com/rust-lang/rust/pull/28778
7680 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
7681 [1.5a]: https://github.com/rust-lang/rust/pull/28811
7682 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
7683 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
7684 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
7685 [1.5i]: https://github.com/rust-lang/rust/pull/28921
7686 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
7687 [1.5f]: https://github.com/rust-lang/rust/pull/29129
7688 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
7689 [1.5s]: https://github.com/rust-lang/rust/pull/29190
7690 [1.5d]: https://github.com/rust-lang/rust/pull/29245
7691 [1.5o]: https://github.com/rust-lang/rust/pull/29259
7692 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
7693 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7694 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
7695 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
7696 [1.5c]: https://github.com/rust-lang/rust/pull/29110
7697 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
7698 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
7699 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
7700 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
7701 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
7702 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
7703 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
7704 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
7705 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
7706 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
7707 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
7708 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
7709 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
7710 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
7711 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
7712 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
7713 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
7714 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
7715 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
7716 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
7717 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
7718 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
7719 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
7720 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
7721 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
7722 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
7723 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
7724 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
7725 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
7726 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
7727 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
7728 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
7729 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
7730 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
7731 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
7732 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
7733 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
7734 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
7735 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
7736 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
7737 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
7738 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
7739 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
7740 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
7741 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
7742 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
7743 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
7744 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
7745 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
7746 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
7747 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
7748 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
7749 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
7750 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
7751
7752 Version 1.4.0 (2015-10-29)
7753 ==========================
7754
7755 * ~1200 changes, numerous bugfixes
7756
7757 Highlights
7758 ----------
7759
7760 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
7761   GNU) are now supported and recommended for use.
7762
7763 Breaking Changes
7764 ----------------
7765
7766 * [Several changes have been made to fix type soundness and improve
7767   the behavior of associated types][sound]. See [RFC 1214]. Although
7768   we have mostly introduced these changes as warnings this release, to
7769   become errors next release, there are still some scenarios that will
7770   see immediate breakage.
7771 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
7772   line breaks in addition to `\n`][crlf].
7773 * [Loans of `'static` lifetime extend to the end of a function][stat].
7774 * [`str::parse` no longer introduces avoidable rounding error when
7775   parsing floating point numbers. Together with earlier changes to
7776   float formatting/output, "round trips" like f.to_string().parse()
7777   now preserve the value of f exactly. Additionally, leading plus
7778   signs are now accepted][fp3].
7779
7780
7781 Language
7782 --------
7783
7784 * `use` statements that import multiple items [can now rename
7785   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
7786 * [Binops work correctly on fat pointers][binfat].
7787 * `pub extern crate`, which does not behave as expected, [issues a
7788   warning][pec] until a better solution is found.
7789
7790 Libraries
7791 ---------
7792
7793 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
7794   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
7795   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
7796   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
7797   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
7798   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
7799   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
7800   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
7801   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
7802   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
7803   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
7804   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
7805   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
7806   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
7807   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
7808   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
7809   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
7810   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
7811   [`thread::sleep`].
7812 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
7813   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
7814   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
7815   `f64::from_str_radix`.
7816 * [Reverse-searching strings is faster with the 'two-way'
7817   algorithm][s].
7818 * [`std::io::copy` allows `?Sized` arguments][cc].
7819 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
7820   [override `count`, `nth` and `last` with an O(1)
7821   implementation][it].
7822 * [`Default` is implemented for arrays up to `[T; 32]`][d].
7823 * [`IntoRawFd` has been added to the Unix-specific prelude,
7824   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
7825   prelude][pr].
7826 * [`Extend<String>` and `FromIterator<String` are both implemented for
7827   `String`][es].
7828 * [`IntoIterator` is implemented for references to `Option` and
7829   `Result`][into2].
7830 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
7831   Copy`][ext] as part of [RFC 839]. This will cause type inference
7832   breakage in rare situations.
7833 * [`BinaryHeap` implements `Debug`][bh2].
7834 * [`Borrow` and `BorrowMut` are implemented for fixed-size
7835   arrays][bm].
7836 * [`extern fn`s with the "Rust" and "C" ABIs implement common
7837   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
7838 * [String comparison is faster][faststr].
7839 * `&mut T` where `T: std::fmt::Write` [also implements
7840   `std::fmt::Write`][mutw].
7841 * [A stable regression in `VecDeque::push_back` and other
7842   capacity-altering methods that caused panics for zero-sized types
7843   was fixed][vd].
7844 * [Function pointers implement traits for up to 12 parameters][fp2].
7845
7846 Miscellaneous
7847 -------------
7848
7849 * The compiler [no longer uses the 'morestack' feature to prevent
7850   stack overflow][mm]. Instead it uses guard pages and stack
7851   probes (though stack probes are not yet implemented on any platform
7852   but Windows).
7853 * [The compiler matches traits faster when projections are involved][p].
7854 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
7855   `usize`][ffi].
7856 * [Cargo now displays useful information about what its doing during
7857   `cargo update`][cu].
7858
7859 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
7860 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
7861 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
7862 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
7863 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
7864 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
7865 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
7866 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
7867 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
7868 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
7869 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
7870 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
7871 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
7872 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
7873 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
7874 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
7875 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
7876 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
7877 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
7878 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
7879 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
7880 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
7881 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
7882 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
7883 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
7884 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
7885 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
7886 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
7887 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
7888 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
7889 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
7890 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
7891 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
7892 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
7893 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
7894 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
7895 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
7896 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
7897 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
7898 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
7899 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
7900 [bh2]: https://github.com/rust-lang/rust/pull/28156
7901 [binfat]: https://github.com/rust-lang/rust/pull/28270
7902 [bm]: https://github.com/rust-lang/rust/pull/28197
7903 [cc]: https://github.com/rust-lang/rust/pull/27531
7904 [crlf]: https://github.com/rust-lang/rust/pull/28034
7905 [cu]: https://github.com/rust-lang/cargo/pull/1931
7906 [d]: https://github.com/rust-lang/rust/pull/27825
7907 [dep]: https://github.com/rust-lang/rust/pull/28339
7908 [es]: https://github.com/rust-lang/rust/pull/27956
7909 [ext]: https://github.com/rust-lang/rust/pull/28094
7910 [faststr]: https://github.com/rust-lang/rust/pull/28338
7911 [ffi]: https://github.com/rust-lang/rust/pull/28779
7912 [fp]: https://github.com/rust-lang/rust/pull/28268
7913 [fp2]: https://github.com/rust-lang/rust/pull/28560
7914 [fp3]: https://github.com/rust-lang/rust/pull/27307
7915 [i]: https://github.com/rust-lang/rust/pull/27451
7916 [into2]: https://github.com/rust-lang/rust/pull/28039
7917 [it]: https://github.com/rust-lang/rust/pull/27652
7918 [mm]: https://github.com/rust-lang/rust/pull/27338
7919 [mutw]: https://github.com/rust-lang/rust/pull/28368
7920 [sound]: https://github.com/rust-lang/rust/pull/27641
7921 [p]: https://github.com/rust-lang/rust/pull/27866
7922 [pec]: https://github.com/rust-lang/rust/pull/28486
7923 [pr]: https://github.com/rust-lang/rust/pull/27896
7924 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
7925 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7926 [s]: https://github.com/rust-lang/rust/pull/27474
7927 [stab]: https://github.com/rust-lang/rust/pull/28339
7928 [stat]: https://github.com/rust-lang/rust/pull/28321
7929 [vd]: https://github.com/rust-lang/rust/pull/28494
7930
7931 Version 1.3.0 (2015-09-17)
7932 ==============================
7933
7934 * ~900 changes, numerous bugfixes
7935
7936 Highlights
7937 ----------
7938
7939 * The [new object lifetime defaults][nold] have been [turned
7940   on][nold2] after a cycle of warnings about the change. Now types
7941   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
7942   being interpreted as `&'a Box<Trait+'a>` to `&'a
7943   Box<Trait+'static>`.
7944 * [The Rustonomicon][nom] is a new book in the official documentation
7945   that dives into writing unsafe Rust.
7946 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
7947   timekeeping is employed by other std APIs, as well as out-of-tree
7948   time crates.
7949
7950 Breaking Changes
7951 ----------------
7952
7953 * The [new object lifetime defaults][nold] have been [turned
7954   on][nold2] after a cycle of warnings about the change.
7955 * There is a known [regression][lr] in how object lifetime elision is
7956   interpreted, the proper solution for which is undetermined.
7957 * The `#[prelude_import]` attribute, an internal implementation
7958   detail, was accidentally stabilized previously. [It has been put
7959   behind the `prelude_import` feature gate][pi]. This change is
7960   believed to break no existing code.
7961 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
7962   [more sane for dynamically sized types][dst3]. Code that relied on
7963   the previous behavior is thought to be broken.
7964 * The `dropck` rules, which checks that destructors can't access
7965   destroyed values, [have been updated][dropck] to match the
7966   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
7967   cause some previously-compiling code to no longer build.
7968
7969 Language
7970 --------
7971
7972 * The [new object lifetime defaults][nold] have been [turned
7973   on][nold2] after a cycle of warnings about the change.
7974 * Semicolons may [now follow types and paths in
7975   macros](https://github.com/rust-lang/rust/pull/27000).
7976 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
7977   [more sane for dynamically sized types][dst3]. Code that relied on
7978   the previous behavior is not known to exist, and suspected to be
7979   broken.
7980 * `'static` variables [may now be recursive][st].
7981 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
7982   implementations correctly.
7983 * The `dropck` rules, which checks that destructors can't access
7984   destroyed values, [have been updated][dropck] to match the
7985   [RFC][dropckrfc].
7986
7987 Libraries
7988 ---------
7989
7990 * The [`Duration`] API, [has been stabilized][ds], as well as the
7991   `std::time` module, which presently contains only `Duration`.
7992 * `Box<str>` and `Box<[T]>` both implement `Clone`.
7993 * The owned C string, [`CString`], implements [`Borrow`] and the
7994   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
7995   these allow C strings to be borrowed and cloned in generic code.
7996 * [`CStr`] implements [`Debug`].
7997 * [`AtomicPtr`] implements [`Debug`].
7998 * [`Error`] trait objects [can be downcast to their concrete types][e]
7999   in many common configurations, using the [`is`], [`downcast`],
8000   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
8001   [`Any`] trait.
8002 * Searching for substrings now [employs the two-way algorithm][search]
8003   instead of doing a naive search. This gives major speedups to a
8004   number of methods, including [`contains`][sc], [`find`][sf],
8005   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
8006   [`ends_with`][sew] are also faster.
8007 * The performance of `PartialEq` for slices is [much faster][ps].
8008 * The [`Hash`] trait offers the default method, [`hash_slice`], which
8009   is overridden and optimized by the implementations for scalars.
8010 * The [`Hasher`] trait now has a number of specialized `write_*`
8011   methods for primitive types, for efficiency.
8012 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
8013   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
8014   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
8015   of [`std::error::Error::cause`][iec] also delegates to the inner
8016   error.
8017 * [`process::Child`][pc] gained the [`id`] method, which returns a
8018   `u32` representing the platform-specific process identifier.
8019 * The [`connect`] method on slices is deprecated, replaced by the new
8020   [`join`] method (note that both of these are on the *unstable*
8021   [`SliceConcatExt`] trait, but through the magic of the prelude are
8022   available to stable code anyway).
8023 * The [`Div`] operator is implemented for [`Wrapping`] types.
8024 * [`DerefMut` is implemented for `String`][dms].
8025 * Performance of SipHash (the default hasher for `HashMap`) is
8026   [better for long data][sh].
8027 * [`AtomicPtr`] implements [`Send`].
8028 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
8029   are now [specialized to use uninitialized buffers for increased
8030   performance][rte].
8031 * Lifetime parameters of foreign functions [are now resolved
8032   properly][f].
8033
8034 Misc
8035 ----
8036
8037 * Rust can now, with some coercion, [produce programs that run on
8038   Windows XP][xp], though XP is not considered a supported platform.
8039 * Porting Rust on Windows from the GNU toolchain to MSVC continues
8040   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
8041   recommended for use in 1.3, though should be fully-functional
8042   in the [64-bit 1.4 beta][b14].
8043 * On Fedora-based systems installation will [properly configure the
8044   dynamic linker][fl].
8045 * The compiler gained many new extended error descriptions, which can
8046   be accessed with the `--explain` flag.
8047 * The `dropck` pass, which checks that destructors can't access
8048   destroyed values, [has been rewritten][dropck]. This fixes some
8049   soundness holes, and as such will cause some previously-compiling
8050   code to no longer build.
8051 * `rustc` now uses [LLVM to write archive files where possible][ar].
8052   Eventually this will eliminate the compiler's dependency on the ar
8053   utility.
8054 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
8055   supported FreeBSD on x86_64).
8056 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
8057   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
8058   more strict.
8059 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
8060   will kill the process instead of leaking][nlp].
8061
8062 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
8063 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
8064 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
8065 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
8066 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
8067 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8068 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8069 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
8070 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
8071 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
8072 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
8073 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
8074 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
8075 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8076 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
8077 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
8078 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
8079 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
8080 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8081 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
8082 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
8083 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
8084 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
8085 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8086 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
8087 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
8088 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
8089 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
8090 [ar]: https://github.com/rust-lang/rust/pull/26926
8091 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
8092 [dms]: https://github.com/rust-lang/rust/pull/26241
8093 [dropck]: https://github.com/rust-lang/rust/pull/27261
8094 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8095 [ds]: https://github.com/rust-lang/rust/pull/26818
8096 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
8097 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
8098 [dst3]: https://github.com/rust-lang/rust/pull/27351
8099 [e]: https://github.com/rust-lang/rust/pull/24793
8100 [f]: https://github.com/rust-lang/rust/pull/26588
8101 [fb]: https://github.com/rust-lang/rust/pull/26959
8102 [fl]: https://github.com/rust-lang/rust-installer/pull/41
8103 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8104 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
8105 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
8106 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
8107 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
8108 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
8109 [lic]: https://github.com/rust-lang/rust/pull/26583
8110 [lnu]: https://github.com/rust-lang/rust/pull/27026
8111 [lr]: https://github.com/rust-lang/rust/issues/27248
8112 [lum]: https://github.com/rust-lang/rust/pull/26378
8113 [lur]: https://github.com/rust-lang/rust/pull/26783
8114 [nlp]: https://github.com/rust-lang/rust/pull/27176
8115 [nold2]: https://github.com/rust-lang/rust/pull/27045
8116 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
8117 [nom]: http://doc.rust-lang.org/nightly/nomicon/
8118 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
8119 [pi]: https://github.com/rust-lang/rust/pull/26699
8120 [ps]: https://github.com/rust-lang/rust/pull/26884
8121 [rte]: https://github.com/rust-lang/rust/pull/26950
8122 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
8123 [search]: https://github.com/rust-lang/rust/pull/26327
8124 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
8125 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
8126 [sh]: https://github.com/rust-lang/rust/pull/27280
8127 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
8128 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
8129 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
8130 [st]: https://github.com/rust-lang/rust/pull/26630
8131 [win1]: https://github.com/rust-lang/rust/pull/26569
8132 [win2]: https://github.com/rust-lang/rust/pull/26741
8133 [win3]: https://github.com/rust-lang/rust/pull/26741
8134 [win4]: https://github.com/rust-lang/rust/pull/27210
8135 [xp]: https://github.com/rust-lang/rust/pull/26569
8136
8137 Version 1.2.0 (2015-08-07)
8138 ==========================
8139
8140 * ~1200 changes, numerous bugfixes
8141
8142 Highlights
8143 ----------
8144
8145 * [Dynamically-sized-type coercions][dst] allow smart pointer types
8146   like `Rc` to contain types without a fixed size, arrays and trait
8147   objects, finally enabling use of `Rc<[T]>` and completing the
8148   implementation of DST.
8149 * [Parallel codegen][parcodegen] is now working again, which can
8150   substantially speed up large builds in debug mode; It also gets
8151   another ~33% speedup when bootstrapping on a 4 core machine (using 8
8152   jobs). It's not enabled by default, but will be "in the near
8153   future". It can be activated with the `-C codegen-units=N` flag to
8154   `rustc`.
8155 * This is the first release with [experimental support for linking
8156   with the MSVC linker and lib C on Windows (instead of using the GNU
8157   variants via MinGW)][win]. It is yet recommended only for the most
8158   intrepid Rustaceans.
8159 * Benchmark compilations are showing a 30% improvement in
8160   bootstrapping over 1.1.
8161
8162 Breaking Changes
8163 ----------------
8164
8165 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
8166   unicode case mapping, which is a previously-planned change in
8167   behavior and considered a bugfix.
8168 * [`mem::align_of`] now specifies [the *minimum alignment* for
8169   T][align], which is usually the alignment programs are interested
8170   in, and the same value reported by clang's
8171   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
8172   break real code.
8173 * [The `#[packed]` attribute is no longer silently accepted by the
8174   compiler][packed]. This attribute did nothing and code that
8175   mentioned it likely did not work as intended.
8176 * Associated type defaults are [now behind the
8177   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
8178   defaults *did not work*, but could be mentioned syntactically. As
8179   such this breakage has minimal impact.
8180
8181 Language
8182 --------
8183
8184 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
8185   matching against dereferenceable values.
8186
8187 Libraries
8188 ---------
8189
8190 * The [`Extend`] trait, which grows a collection from an iterator, is
8191   implemented over iterators of references, for `String`, `Vec`,
8192   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
8193   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
8194 * The [`iter::once`] function returns an iterator that yields a single
8195   element, and [`iter::empty`] returns an iterator that yields no
8196   elements.
8197 * The [`matches`] and [`rmatches`] methods on `str` return iterators
8198   over substring matches.
8199 * [`Cell`] and [`RefCell`] both implement `Eq`.
8200 * A number of methods for wrapping arithmetic are added to the
8201   integral types, [`wrapping_div`], [`wrapping_rem`],
8202   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
8203   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
8204   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
8205   type.. It is illegal for the default arithmetic operations in Rust
8206   to overflow; the desire to wrap must be explicit.
8207 * The `{:#?}` formatting specifier [displays the alternate,
8208   pretty-printed][debugfmt] form of the `Debug` formatter. This
8209   feature was actually introduced prior to 1.0 with little
8210   fanfare.
8211 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
8212   for writing data to formatted strings, similar to [`io::Write`].
8213 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
8214   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
8215   are used by code generators to emit implementations of [`Debug`].
8216 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
8217   methods that convert case, following Unicode case mapping.
8218 * It is now easier to handle poisoned locks. The [`PoisonError`]
8219   type, returned by failing lock operations, exposes `into_inner`,
8220   `get_ref`, and `get_mut`, which all give access to the inner lock
8221   guard, and allow the poisoned lock to continue to operate. The
8222   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
8223   poisoned lock without attempting to take the lock.
8224 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
8225   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
8226   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
8227   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
8228   `ChildStderr`.
8229 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
8230   malformed input.
8231
8232 Misc
8233 ----
8234
8235 * `rustc` employs smarter heuristics for guessing at [typos].
8236 * `rustc` emits more efficient code for [no-op conversions between
8237   unsafe pointers][nop].
8238 * Fat pointers are now [passed in pairs of immediate arguments][fat],
8239   resulting in faster compile times and smaller code.
8240
8241 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
8242 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8243 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
8244 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
8245 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
8246 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
8247 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
8248 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
8249 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
8250 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
8251 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
8252 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
8253 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
8254 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
8255 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
8256 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
8257 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8258 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
8259 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
8260 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
8261 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
8262 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
8263 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
8264 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
8265 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
8266 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8267 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
8268 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
8269 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
8270 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
8271 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
8272 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
8273 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
8274 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8275 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8276 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
8277 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
8278 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
8279 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
8280 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
8281 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
8282 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8283 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
8284 [align]: https://github.com/rust-lang/rust/pull/25646
8285 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
8286 [typos]: https://github.com/rust-lang/rust/pull/26087
8287 [nop]: https://github.com/rust-lang/rust/pull/26336
8288 [fat]: https://github.com/rust-lang/rust/pull/26411
8289 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
8290 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
8291 [packed]: https://github.com/rust-lang/rust/pull/25541
8292 [ad]: https://github.com/rust-lang/rust/pull/27382
8293 [win]: https://github.com/rust-lang/rust/pull/25350
8294
8295 Version 1.1.0 (2015-06-25)
8296 =========================
8297
8298 * ~850 changes, numerous bugfixes
8299
8300 Highlights
8301 ----------
8302
8303 * The [`std::fs` module has been expanded][fs] to expand the set of
8304   functionality exposed:
8305   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
8306     don't incur a syscall on some platforms.
8307   * A `symlink_metadata` function has been added.
8308   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
8309     access to all underlying information.
8310 * The compiler now contains extended explanations of many errors. When an error
8311   with an explanation occurs the compiler suggests using the `--explain` flag
8312   to read the explanation. Error explanations are also [available online][err-index].
8313 * Thanks to multiple [improvements][sk] to [type checking][pre], as
8314   well as other work, the time to bootstrap the compiler decreased by
8315   32%.
8316
8317 Libraries
8318 ---------
8319
8320 * The [`str::split_whitespace`] method splits a string on unicode
8321   whitespace boundaries.
8322 * On both Windows and Unix, new extension traits provide conversion of
8323   I/O types to and from the underlying system handles. On Unix, these
8324   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
8325   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
8326   `TcpListener`, and `UpdSocket`. Further implementations for
8327   `std::process` will be stabilized later.
8328 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
8329   Windows, symlinks can be created with
8330   `std::os::windows::symlink_dir` and
8331   `std::os::windows::symlink_file`.
8332 * The `mpsc::Receiver` type can now be converted into an iterator with
8333   `into_iter` on the [`IntoIterator`] trait.
8334 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
8335   implementation of the [`From`] trait.
8336 * The `Debug` implementation for `RangeFull` [creates output that is
8337   more consistent with other implementations][rf].
8338 * [`Debug` is implemented for `File`][file].
8339 * The `Default` implementation for `Arc` [no longer requires `Sync +
8340   Send`][arc].
8341 * [The `Iterator` methods `count`, `nth`, and `last` have been
8342   overridden for slices to have O(1) performance instead of O(n)][si].
8343 * Incorrect handling of paths on Windows has been improved in both the
8344   compiler and the standard library.
8345 * [`AtomicPtr` gained a `Default` implementation][ap].
8346 * In accordance with Rust's policy on arithmetic overflow `abs` now
8347   [panics on overflow when debug assertions are enabled][abs].
8348 * The [`Cloned`] iterator, which was accidentally left unstable for
8349   1.0 [has been stabilized][c].
8350 * The [`Incoming`] iterator, which iterates over incoming TCP
8351   connections, and which was accidentally unnamable in 1.0, [is now
8352   properly exported][inc].
8353 * [`BinaryHeap`] no longer corrupts itself [when functions called by
8354   `sift_up` or `sift_down` panic][bh].
8355 * The [`split_off`] method of `LinkedList` [no longer corrupts
8356   the list in certain scenarios][ll].
8357
8358 Misc
8359 ----
8360
8361 * Type checking performance [has improved notably][sk] with
8362   [multiple improvements][pre].
8363 * The compiler [suggests code changes][ch] for more errors.
8364 * rustc and it's build system have experimental support for [building
8365   toolchains against MUSL][m] instead of glibc on Linux.
8366 * The compiler defines the `target_env` cfg value, which is used for
8367   distinguishing toolchains that are otherwise for the same
8368   platform. Presently this is set to `gnu` for common GNU Linux
8369   targets and for MinGW targets, and `musl` for MUSL Linux targets.
8370 * The [`cargo rustc`][crc] command invokes a build with custom flags
8371   to rustc.
8372 * [Android executables are always position independent][pie].
8373 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
8374   with `Drop`][drop].
8375
8376 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
8377 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8378 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8379 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
8380 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
8381 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
8382 [rf]: https://github.com/rust-lang/rust/pull/24491
8383 [err-index]: https://doc.rust-lang.org/error-index.html
8384 [sk]: https://github.com/rust-lang/rust/pull/24615
8385 [pre]: https://github.com/rust-lang/rust/pull/25323
8386 [file]: https://github.com/rust-lang/rust/pull/24598
8387 [ch]: https://github.com/rust-lang/rust/pull/24683
8388 [arc]: https://github.com/rust-lang/rust/pull/24695
8389 [si]: https://github.com/rust-lang/rust/pull/24701
8390 [ap]: https://github.com/rust-lang/rust/pull/24834
8391 [m]: https://github.com/rust-lang/rust/pull/24777
8392 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
8393 [crc]: https://github.com/rust-lang/cargo/pull/1568
8394 [pie]: https://github.com/rust-lang/rust/pull/24953
8395 [abs]: https://github.com/rust-lang/rust/pull/25441
8396 [c]: https://github.com/rust-lang/rust/pull/25496
8397 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
8398 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
8399 [inc]: https://github.com/rust-lang/rust/pull/25522
8400 [bh]: https://github.com/rust-lang/rust/pull/25856
8401 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
8402 [ll]: https://github.com/rust-lang/rust/pull/26022
8403 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
8404 [drop]: https://github.com/rust-lang/rust/pull/24935
8405
8406 Version 1.0.0 (2015-05-15)
8407 ========================
8408
8409 * ~1500 changes, numerous bugfixes
8410
8411 Highlights
8412 ----------
8413
8414 * The vast majority of the standard library is now `#[stable]`. It is
8415   no longer possible to use unstable features with a stable build of
8416   the compiler.
8417 * Many popular crates on [crates.io] now work on the stable release
8418   channel.
8419 * Arithmetic on basic integer types now [checks for overflow in debug
8420   builds][overflow].
8421
8422 Language
8423 --------
8424
8425 * Several [restrictions have been added to trait coherence][coh] in
8426   order to make it easier for upstream authors to change traits
8427   without breaking downstream code.
8428 * Digits of binary and octal literals are [lexed more eagerly][lex] to
8429   improve error messages and macro behavior. For example, `0b1234` is
8430   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
8431 * Trait bounds [are always invariant][inv], eliminating the need for
8432   the `PhantomFn` and `MarkerTrait` lang items, which have been
8433   removed.
8434 * ["-" is no longer a valid character in crate names][cr], the `extern crate
8435   "foo" as bar` syntax has been replaced with `extern crate foo as
8436   bar`, and Cargo now automatically translates "-" in *package* names
8437   to underscore for the crate name.
8438 * [Lifetime shadowing is an error][lt].
8439 * [`Send` no longer implies `'static`][send-rfc].
8440 * [UFCS now supports trait-less associated paths][moar-ufcs] like
8441   `MyType::default()`.
8442 * Primitive types [now have inherent methods][prim-inherent],
8443   obviating the need for extension traits like `SliceExt`.
8444 * Methods with `Self: Sized` in their `where` clause are [considered
8445   object-safe][self-sized], allowing many extension traits like
8446   `IteratorExt` to be merged into the traits they extended.
8447 * You can now [refer to associated types][assoc-where] whose
8448   corresponding trait bounds appear only in a `where` clause.
8449 * The final bits of [OIBIT landed][oibit-final], meaning that traits
8450   like `Send` and `Sync` are now library-defined.
8451 * A [Reflect trait][reflect] was introduced, which means that
8452   downcasting via the `Any` trait is effectively limited to concrete
8453   types. This helps retain the potentially-important "parametricity"
8454   property: generic code cannot behave differently for different type
8455   arguments except in minor ways.
8456 * The `unsafe_destructor` feature is now deprecated in favor of the
8457   [new `dropck`][dropck]. This change is a major reduction in unsafe
8458   code.
8459
8460 Libraries
8461 ---------
8462
8463 * The `thread_local` module [has been renamed to `std::thread`][th].
8464 * The methods of `IteratorExt` [have been moved to the `Iterator`
8465   trait itself][ie].
8466 * Several traits that implement Rust's conventions for type
8467   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
8468   [centralized in the `std::convert` module][con].
8469 * The `FromError` trait [was removed in favor of `From`][fe].
8470 * The basic sleep function [has moved to
8471   `std::thread::sleep_ms`][slp].
8472 * The `splitn` function now takes an `n` parameter that represents the
8473   number of items yielded by the returned iterator [instead of the
8474   number of 'splits'][spl].
8475 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
8476 * [Derived implementations of `PartialOrd` now order enums according
8477   to their explicitly-assigned discriminants][po].
8478 * [Methods for searching strings are generic over `Pattern`s][pat],
8479   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
8480   some others.
8481 * [In method resolution, object methods are resolved before inherent
8482   methods][meth].
8483 * [`String::from_str` has been deprecated in favor of the `From` impl,
8484   `String::from`][sf].
8485 * [`io::Error` implements `Sync`][ios].
8486 * [The `words` method on `&str` has been replaced with
8487   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
8488   a word?'
8489 * The new path and IO modules are complete and `#[stable]`. This
8490   was the major library focus for this cycle.
8491 * The path API was [revised][path-normalize] to normalize `.`,
8492   adjusting the tradeoffs in favor of the most common usage.
8493 * A large number of remaining APIs in `std` were also stabilized
8494   during this cycle; about 75% of the non-deprecated API surface
8495   is now stable.
8496 * The new [string pattern API][string-pattern] landed, which makes
8497   the string slice API much more internally consistent and flexible.
8498 * A new set of [generic conversion traits][conversion] replaced
8499   many existing ad hoc traits.
8500 * Generic numeric traits were [completely removed][num-traits]. This
8501   was made possible thanks to inherent methods for primitive types,
8502   and the removal gives maximal flexibility for designing a numeric
8503   hierarchy in the future.
8504 * The `Fn` traits are now related via [inheritance][fn-inherit]
8505   and provide ergonomic [blanket implementations][fn-blanket].
8506 * The `Index` and `IndexMut` traits were changed to
8507   [take the index by value][index-value], enabling code like
8508   `hash_map["string"]` to work.
8509 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
8510   `Copy` data is known to be `Clone` as well.
8511
8512 Misc
8513 ----
8514
8515 * Many errors now have extended explanations that can be accessed with
8516   the `--explain` flag to `rustc`.
8517 * Many new examples have been added to the standard library
8518   documentation.
8519 * rustdoc has received a number of improvements focused on completion
8520   and polish.
8521 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
8522 * Much headway was made on ecosystem-wide CI, making it possible
8523   to [compare builds for breakage][ci-compare].
8524
8525
8526 [crates.io]: http://crates.io
8527 [clo]: https://github.com/rust-lang/rust/pull/24034
8528 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
8529 [con]: https://github.com/rust-lang/rust/pull/23875
8530 [cr]: https://github.com/rust-lang/rust/pull/23419
8531 [fe]: https://github.com/rust-lang/rust/pull/23879
8532 [ie]: https://github.com/rust-lang/rust/pull/23300
8533 [inv]: https://github.com/rust-lang/rust/pull/23938
8534 [ios]: https://github.com/rust-lang/rust/pull/24133
8535 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
8536 [lt]: https://github.com/rust-lang/rust/pull/24057
8537 [meth]: https://github.com/rust-lang/rust/pull/24056
8538 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
8539 [po]: https://github.com/rust-lang/rust/pull/24270
8540 [sf]: https://github.com/rust-lang/rust/pull/24517
8541 [slp]: https://github.com/rust-lang/rust/pull/23949
8542 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
8543 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
8544 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
8545 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
8546 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
8547 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
8548 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
8549 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
8550 [self-sized]: https://github.com/rust-lang/rust/pull/22301
8551 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
8552 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
8553 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
8554 [reflect]: https://github.com/rust-lang/rust/pull/23712
8555 [conversion]: https://github.com/rust-lang/rfcs/pull/529
8556 [num-traits]: https://github.com/rust-lang/rust/pull/23549
8557 [index-value]: https://github.com/rust-lang/rust/pull/23601
8558 [dropck]: https://github.com/rust-lang/rfcs/pull/769
8559 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
8560 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
8561 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
8562 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
8563 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
8564
8565
8566 Version 1.0.0-alpha.2 (2015-02-20)
8567 =====================================
8568
8569 * ~1300 changes, numerous bugfixes
8570
8571 * Highlights
8572
8573     * The various I/O modules were [overhauled][io-rfc] to reduce
8574       unnecessary abstractions and provide better interoperation with
8575       the underlying platform. The old `io` module remains temporarily
8576       at `std::old_io`.
8577     * The standard library now [participates in feature gating][feat],
8578       so use of unstable libraries now requires a `#![feature(...)]`
8579       attribute. The impact of this change is [described on the
8580       forum][feat-forum]. [RFC][feat-rfc].
8581
8582 * Language
8583
8584     * `for` loops [now operate on the `IntoIterator` trait][into],
8585       which eliminates the need to call `.iter()`, etc. to iterate
8586       over collections. There are some new subtleties to remember
8587       though regarding what sort of iterators various types yield, in
8588       particular that `for foo in bar { }` yields values from a move
8589       iterator, destroying the original collection. [RFC][into-rfc].
8590     * Objects now have [default lifetime bounds][obj], so you don't
8591       have to write `Box<Trait+'static>` when you don't care about
8592       storing references. [RFC][obj-rfc].
8593     * In types that implement `Drop`, [lifetimes must outlive the
8594       value][drop]. This will soon make it possible to safely
8595       implement `Drop` for types where `#[unsafe_destructor]` is now
8596       required. Read the [gorgeous RFC][drop-rfc] for details.
8597     * The fully qualified <T as Trait>::X syntax lets you set the Self
8598       type for a trait method or associated type. [RFC][ufcs-rfc].
8599     * References to types that implement `Deref<U>` now [automatically
8600       coerce to references][deref] to the dereferenced type `U`,
8601       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
8602       should eliminate many unsightly uses of `&*`, as when converting
8603       from references to vectors into references to
8604       slices. [RFC][deref-rfc].
8605     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
8606       `|:|`) is obsolete and closure kind is inferred from context.
8607     * [`Self` is a keyword][Self].
8608
8609 * Libraries
8610
8611     * The `Show` and `String` formatting traits [have been
8612       renamed][fmt] to `Debug` and `Display` to more clearly reflect
8613       their related purposes. Automatically getting a string
8614       conversion to use with `format!("{:?}", something_to_debug)` is
8615       now written `#[derive(Debug)]`.
8616     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
8617       OsStr}`, provide strings in platform-specific encodings for easier
8618       interop with system APIs. [RFC][osstr-rfc].
8619     * The `boxed::into_raw` and `Box::from_raw` functions [convert
8620       between `Box<T>` and `*mut T`][boxraw], a common pattern for
8621       creating raw pointers.
8622
8623 * Tooling
8624
8625     * Certain long error messages of the form 'expected foo found bar'
8626       are now [split neatly across multiple
8627       lines][multiline]. Examples in the PR.
8628     * On Unix Rust can be [uninstalled][un] by running
8629       `/usr/local/lib/rustlib/uninstall.sh`.
8630     * The `#[rustc_on_unimplemented]` attribute, requiring the
8631       'on_unimplemented' feature, lets rustc [display custom error
8632       messages when a trait is expected to be implemented for a type
8633       but is not][onun].
8634
8635 * Misc
8636
8637     * Rust is tested against a [LALR grammar][lalr], which parses
8638       almost all the Rust files that rustc does.
8639
8640 [boxraw]: https://github.com/rust-lang/rust/pull/21318
8641 [close]: https://github.com/rust-lang/rust/pull/21843
8642 [deref]: https://github.com/rust-lang/rust/pull/21351
8643 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
8644 [drop]: https://github.com/rust-lang/rust/pull/21972
8645 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8646 [feat]: https://github.com/rust-lang/rust/pull/21248
8647 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
8648 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
8649 [fmt]: https://github.com/rust-lang/rust/pull/21457
8650 [into]: https://github.com/rust-lang/rust/pull/20790
8651 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
8652 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
8653 [lalr]: https://github.com/rust-lang/rust/pull/21452
8654 [multiline]: https://github.com/rust-lang/rust/pull/19870
8655 [obj]: https://github.com/rust-lang/rust/pull/22230
8656 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
8657 [onun]: https://github.com/rust-lang/rust/pull/20889
8658 [osstr]: https://github.com/rust-lang/rust/pull/21488
8659 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
8660 [Self]: https://github.com/rust-lang/rust/pull/22158
8661 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
8662 [un]: https://github.com/rust-lang/rust/pull/22256
8663
8664
8665 Version 1.0.0-alpha (2015-01-09)
8666 ==================================
8667
8668   * ~2400 changes, numerous bugfixes
8669
8670   * Highlights
8671
8672     * The language itself is considered feature complete for 1.0,
8673       though there will be many usability improvements and bugfixes
8674       before the final release.
8675     * Nearly 50% of the public API surface of the standard library has
8676       been declared 'stable'. Those interfaces are unlikely to change
8677       before 1.0.
8678     * The long-running debate over integer types has been
8679       [settled][ints]: Rust will ship with types named `isize` and
8680       `usize`, rather than `int` and `uint`, for pointer-sized
8681       integers. Guidelines will be rolled out during the alpha cycle.
8682     * Most crates that are not `std` have been moved out of the Rust
8683       distribution into the Cargo ecosystem so they can evolve
8684       separately and don't need to be stabilized as quickly, including
8685       'time', 'getopts', 'num', 'regex', and 'term'.
8686     * Documentation continues to be expanded with more API coverage, more
8687       examples, and more in-depth explanations. The guides have been
8688       consolidated into [The Rust Programming Language][trpl].
8689     * "[Rust By Example][rbe]" is now maintained by the Rust team.
8690     * All official Rust binary installers now come with [Cargo], the
8691       Rust package manager.
8692
8693 * Language
8694
8695     * Closures have been [completely redesigned][unboxed] to be
8696       implemented in terms of traits, can now be used as generic type
8697       bounds and thus monomorphized and inlined, or via an opaque
8698       pointer (boxed) as in the old system. The new system is often
8699       referred to as 'unboxed' closures.
8700     * Traits now support [associated types][assoc], allowing families
8701       of related types to be defined together and used generically in
8702       powerful ways.
8703     * Enum variants are [namespaced by their type names][enum].
8704     * [`where` clauses][where] provide a more versatile and attractive
8705       syntax for specifying generic bounds, though the previous syntax
8706       remains valid.
8707     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
8708       numeric types.
8709     * Rust [no longer has a runtime][rt] of any description, and only
8710       supports OS threads, not green threads.
8711     * At long last, Rust has been overhauled for 'dynamically-sized
8712       types' ([DST]), which integrates 'fat pointers' (object types,
8713       arrays, and `str`) more deeply into the type system, making it
8714       more consistent.
8715     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
8716       `..j` that produce range types and which, when combined with the
8717       `Index` operator and multidispatch, leads to a convenient slice
8718       notation, `[i..j]`.
8719     * The new range syntax revealed an ambiguity in the fixed-length
8720       array syntax, so now fixed length arrays [are written `[T;
8721       N]`][arrays].
8722     * The `Copy` trait is no longer implemented automatically. Unsafe
8723       pointers no longer implement `Sync` and `Send` so types
8724       containing them don't automatically either. `Sync` and `Send`
8725       are now 'unsafe traits' so one can "forcibly" implement them via
8726       `unsafe impl` if a type confirms to the requirements for them
8727       even though the internals do not (e.g. structs containing unsafe
8728       pointers like `Arc`). These changes are intended to prevent some
8729       footguns and are collectively known as [opt-in built-in
8730       traits][oibit] (though `Sync` and `Send` will soon become pure
8731       library types unknown to the compiler).
8732     * Operator traits now take their operands [by value][ops], and
8733       comparison traits can use multidispatch to compare one type
8734       against multiple other types, allowing e.g. `String` to be
8735       compared with `&str`.
8736     * `if let` and `while let` are no longer feature-gated.
8737     * Rust has adopted a more [uniform syntax for escaping unicode
8738       characters][unicode].
8739     * `macro_rules!` [has been declared stable][mac]. Though it is a
8740       flawed system it is sufficiently popular that it must be usable
8741       for 1.0. Effort has gone into [future-proofing][mac-future] it
8742       in ways that will allow other macro systems to be developed in
8743       parallel, and won't otherwise impact the evolution of the
8744       language.
8745     * The prelude has been [pared back significantly][prelude] such
8746       that it is the minimum necessary to support the most pervasive
8747       code patterns, and through [generalized where clauses][where]
8748       many of the prelude extension traits have been consolidated.
8749     * Rust's rudimentary reflection [has been removed][refl], as it
8750       incurred too much code generation for little benefit.
8751     * [Struct variants][structvars] are no longer feature-gated.
8752     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
8753       known as 'higher-ranked trait bounds', this crucially allows
8754       unboxed closures to work.
8755     * Macros invocations surrounded by parens or square brackets and
8756       not terminated by a semicolon are [parsed as
8757       expressions][macros], which makes expressions like `vec![1i32,
8758       2, 3].len()` work as expected.
8759     * Trait objects now implement their traits automatically, and
8760       traits that can be coerced to objects now must be [object
8761       safe][objsafe].
8762     * Automatically deriving traits is now done with `#[derive(...)]`
8763       not `#[deriving(...)]` for [consistency with other naming
8764       conventions][derive].
8765     * Importing the containing module or enum at the same time as
8766       items or variants they contain is [now done with `self` instead
8767       of `mod`][self], as in use `foo::{self, bar}`
8768     * Glob imports are no longer feature-gated.
8769     * The `box` operator and `box` patterns have been feature-gated
8770       pending a redesign. For now unique boxes should be allocated
8771       like other containers, with `Box::new`.
8772
8773 * Libraries
8774
8775     * A [series][coll1] of [efforts][coll2] to establish
8776       [conventions][coll3] for collections types has resulted in API
8777       improvements throughout the standard library.
8778     * New [APIs for error handling][err] provide ergonomic interop
8779       between error types, and [new conventions][err-conv] describe
8780       more clearly the recommended error handling strategies in Rust.
8781     * The `fail!` macro has been renamed to [`panic!`][panic] so that
8782       it is easier to discuss failure in the context of error handling
8783       without making clarifications as to whether you are referring to
8784       the 'fail' macro or failure more generally.
8785     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
8786       syscall when available.
8787     * The 'serialize' crate has been renamed 'rustc-serialize' and
8788       moved out of the distribution to Cargo. Although it is widely
8789       used now, it is expected to be superseded in the near future.
8790     * The `Show` formatter, typically implemented with
8791       `#[derive(Show)]` is [now requested with the `{:?}`
8792       specifier][show] and is intended for use by all types, for uses
8793       such as `println!` debugging. The new `String` formatter must be
8794       implemented by hand, uses the `{}` specifier, and is intended
8795       for full-fidelity conversions of things that can logically be
8796       represented as strings.
8797
8798 * Tooling
8799
8800     * [Flexible target specification][flex] allows rustc's code
8801       generation to be configured to support otherwise-unsupported
8802       platforms.
8803     * Rust comes with rust-gdb and rust-lldb scripts that launch their
8804       respective debuggers with Rust-appropriate pretty-printing.
8805     * The Windows installation of Rust is distributed with the
8806       MinGW components currently required to link binaries on that
8807       platform.
8808
8809 * Misc
8810
8811     * Nullable enum optimizations have been extended to more types so
8812       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
8813       space than the inner types themselves.
8814     * Work has begun on supporting AArch64.
8815
8816 [Cargo]: https://crates.io
8817 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
8818 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
8819 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
8820 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
8821 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
8822 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
8823 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
8824 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
8825 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
8826 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
8827 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
8828 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
8829 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
8830 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
8831 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
8832 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
8833 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
8834 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
8835 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
8836 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
8837 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
8838 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
8839 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
8840 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
8841 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
8842 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
8843 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
8844 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
8845 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
8846 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
8847 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
8848 [trpl]: https://doc.rust-lang.org/book/index.html
8849 [rbe]: http://rustbyexample.com/
8850
8851
8852 Version 0.12.0 (2014-10-09)
8853 =============================
8854
8855   * ~1900 changes, numerous bugfixes
8856
8857   * Highlights
8858
8859     * The introductory documentation (now called The Rust Guide) has
8860       been completely rewritten, as have a number of supplementary
8861       guides.
8862     * Rust's package manager, Cargo, continues to improve and is
8863       sometimes considered to be quite awesome.
8864     * Many API's in `std` have been reviewed and updated for
8865       consistency with the in-development Rust coding
8866       guidelines. The standard library documentation tracks
8867       stabilization progress.
8868     * Minor libraries have been moved out-of-tree to the rust-lang org
8869       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
8870       be installed with Cargo.
8871     * Lifetime elision allows lifetime annotations to be left off of
8872       function declarations in many common scenarios.
8873     * Rust now works on 64-bit Windows.
8874
8875   * Language
8876     * Indexing can be overloaded with the `Index` and `IndexMut`
8877       traits.
8878     * The `if let` construct takes a branch only if the `let` pattern
8879       matches, currently behind the 'if_let' feature gate.
8880     * 'where clauses', a more flexible syntax for specifying trait
8881       bounds that is more aesthetic, have been added for traits and
8882       free functions. Where clauses will in the future make it
8883       possible to constrain associated types, which would be
8884       impossible with the existing syntax.
8885     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
8886       the 'slicing_syntax' feature gate, and can be overloaded with
8887       the `Slice` or `SliceMut` traits.
8888     * The syntax for matching of sub-slices has been changed to use a
8889       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
8890       consistency with other uses of `..` and to future-proof
8891       potential additional uses of the syntax.
8892     * The syntax for matching inclusive ranges in patterns has changed
8893       from `0..3` to `0...4` to be consistent with the exclusive range
8894       syntax for slicing.
8895     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
8896       c]`) has been put behind the 'advanced_slice_patterns' feature
8897       gate and may be removed in the future.
8898     * Components of tuples and tuple structs can be extracted using
8899       the `value.0` syntax, currently behind the `tuple_indexing`
8900       feature gate.
8901     * The `#[crate_id]` attribute is no longer supported; versioning
8902       is handled by the package manager.
8903     * Renaming crate imports are now written `extern crate foo as bar`
8904       instead of `extern crate bar = foo`.
8905     * Renaming use statements are now written `use foo as bar` instead
8906       of `use bar = foo`.
8907     * `let` and `match` bindings and argument names in macros are now
8908       hygienic.
8909     * The new, more efficient, closure types ('unboxed closures') have
8910       been added under a feature gate, 'unboxed_closures'. These will
8911       soon replace the existing closure types, once higher-ranked
8912       trait lifetimes are added to the language.
8913     * `move` has been added as a keyword, for indicating closures
8914       that capture by value.
8915     * Mutation and assignment is no longer allowed in pattern guards.
8916     * Generic structs and enums can now have trait bounds.
8917     * The `Share` trait is now called `Sync` to free up the term
8918       'shared' to refer to 'shared reference' (the default reference
8919       type.
8920     * Dynamically-sized types have been mostly implemented,
8921       unifying the behavior of fat-pointer types with the rest of the
8922       type system.
8923     * As part of dynamically-sized types, the `Sized` trait has been
8924       introduced, which qualifying types implement by default, and
8925       which type parameters expect by default. To specify that a type
8926       parameter does not need to be sized, write `<Sized? T>`. Most
8927       types are `Sized`, notable exceptions being unsized arrays
8928       (`[T]`) and trait types.
8929     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
8930     * Lifetime bounds can now be applied to type parameters and object
8931       types.
8932     * The old, reference counted GC type, `Gc<T>` which was once
8933       denoted by the `@` sigil, has finally been removed. GC will be
8934       revisited in the future.
8935
8936   * Libraries
8937     * Library documentation has been improved for a number of modules.
8938     * Bit-vectors, collections::bitv has been modernized.
8939     * The url crate is deprecated in favor of
8940       http://github.com/servo/rust-url, which can be installed with
8941       Cargo.
8942     * Most I/O stream types can be cloned and subsequently closed from
8943       a different thread.
8944     * A `std::time::Duration` type has been added for use in I/O
8945       methods that rely on timers, as well as in the 'time' crate's
8946       `Timespec` arithmetic.
8947     * The runtime I/O abstraction layer that enabled the green thread
8948       scheduler to do non-thread-blocking I/O has been removed, along
8949       with the libuv-based implementation employed by the green thread
8950       scheduler. This will greatly simplify the future I/O work.
8951     * `collections::btree` has been rewritten to have a more
8952       idiomatic and efficient design.
8953
8954   * Tooling
8955     * rustdoc output now indicates the stability levels of API's.
8956     * The `--crate-name` flag can specify the name of the crate
8957       being compiled, like `#[crate_name]`.
8958     * The `-C metadata` specifies additional metadata to hash into
8959       symbol names, and `-C extra-filename` specifies additional
8960       information to put into the output filename, for use by the
8961       package manager for versioning.
8962     * debug info generation has continued to improve and should be
8963       more reliable under both gdb and lldb.
8964     * rustc has experimental support for compiling in parallel
8965       using the `-C codegen-units` flag.
8966     * rustc no longer encodes rpath information into binaries by
8967       default.
8968
8969   * Misc
8970     * Stack usage has been optimized with LLVM lifetime annotations.
8971     * Official Rust binaries on Linux are more compatible with older
8972       kernels and distributions, built on CentOS 5.10.
8973
8974
8975 Version 0.11.0 (2014-07-02)
8976 ==========================
8977
8978   * ~1700 changes, numerous bugfixes
8979
8980   * Language
8981     * ~[T] has been removed from the language. This type is superseded by
8982       the Vec<T> type.
8983     * ~str has been removed from the language. This type is superseded by
8984       the String type.
8985     * ~T has been removed from the language. This type is superseded by the
8986       Box<T> type.
8987     * @T has been removed from the language. This type is superseded by the
8988       standard library's std::gc::Gc<T> type.
8989     * Struct fields are now all private by default.
8990     * Vector indices and shift amounts are both required to be a `uint`
8991       instead of any integral type.
8992     * Byte character, byte string, and raw byte string literals are now all
8993       supported by prefixing the normal literal with a `b`.
8994     * Multiple ABIs are no longer allowed in an ABI string
8995     * The syntax for lifetimes on closures/procedures has been tweaked
8996       slightly: `<'a>|A, B|: 'b + K -> T`
8997     * Floating point modulus has been removed from the language; however it
8998       is still provided by a library implementation.
8999     * Private enum variants are now disallowed.
9000     * The `priv` keyword has been removed from the language.
9001     * A closure can no longer be invoked through a &-pointer.
9002     * The `use foo, bar, baz;` syntax has been removed from the language.
9003     * The transmute intrinsic no longer works on type parameters.
9004     * Statics now allow blocks/items in their definition.
9005     * Trait bounds are separated from objects with + instead of : now.
9006     * Objects can no longer be read while they are mutably borrowed.
9007     * The address of a static is now marked as insignificant unless the
9008       #[inline(never)] attribute is placed it.
9009     * The #[unsafe_destructor] attribute is now behind a feature gate.
9010     * Struct literals are no longer allowed in ambiguous positions such as
9011       if, while, match, and for..in.
9012     * Declaration of lang items and intrinsics are now feature-gated by
9013       default.
9014     * Integral literals no longer default to `int`, and floating point
9015       literals no longer default to `f64`. Literals must be suffixed with an
9016       appropriate type if inference cannot determine the type of the
9017       literal.
9018     * The Box<T> type is no longer implicitly borrowed to &mut T.
9019     * Procedures are now required to not capture borrowed references.
9020
9021   * Libraries
9022     * The standard library is now a "facade" over a number of underlying
9023       libraries. This means that development on the standard library should
9024       be speedier due to smaller crates, as well as a clearer line between
9025       all dependencies.
9026     * A new library, libcore, lives under the standard library's facade
9027       which is Rust's "0-assumption" library, suitable for embedded and
9028       kernel development for example.
9029     * A regex crate has been added to the standard distribution. This crate
9030       includes statically compiled regular expressions.
9031     * The unwrap/unwrap_err methods on Result require a Show bound for
9032       better error messages.
9033     * The return types of the std::comm primitives have been centralized
9034       around the Result type.
9035     * A number of I/O primitives have gained the ability to time out their
9036       operations.
9037     * A number of I/O primitives have gained the ability to close their
9038       reading/writing halves to cancel pending operations.
9039     * Reverse iterator methods have been removed in favor of `rev()` on
9040       their forward-iteration counterparts.
9041     * A bitflags! macro has been added to enable easy interop with C and
9042       management of bit flags.
9043     * A debug_assert! macro is now provided which is disabled when
9044       `--cfg ndebug` is passed to the compiler.
9045     * A graphviz crate has been added for creating .dot files.
9046     * The std::cast module has been migrated into std::mem.
9047     * The std::local_data api has been migrated from freestanding functions
9048       to being based on methods.
9049     * The Pod trait has been renamed to Copy.
9050     * jemalloc has been added as the default allocator for types.
9051     * The API for allocating memory has been changed to use proper alignment
9052       and sized deallocation
9053     * Connecting a TcpStream or binding a TcpListener is now based on a
9054       string address and a u16 port. This allows connecting to a hostname as
9055       opposed to an IP.
9056     * The Reader trait now contains a core method, read_at_least(), which
9057       correctly handles many repeated 0-length reads.
9058     * The process-spawning API is now centered around a builder-style
9059       Command struct.
9060     * The :? printing qualifier has been moved from the standard library to
9061       an external libdebug crate.
9062     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
9063       have been renamed to Eq/Ord.
9064     * The select/plural methods have been removed from format!. The escapes
9065       for { and } have also changed from \{ and \} to {{ and }},
9066       respectively.
9067     * The TaskBuilder API has been re-worked to be a true builder, and
9068       extension traits for spawning native/green tasks have been added.
9069
9070   * Tooling
9071     * All breaking changes to the language or libraries now have their
9072       commit message annotated with `[breaking-change]` to allow for easy
9073       discovery of breaking changes.
9074     * The compiler will now try to suggest how to annotate lifetimes if a
9075       lifetime-related error occurs.
9076     * Debug info continues to be improved greatly with general bug fixes and
9077       better support for situations like link time optimization (LTO).
9078     * Usage of syntax extensions when cross-compiling has been fixed.
9079     * Functionality equivalent to GCC & Clang's -ffunction-sections,
9080       -fdata-sections and --gc-sections has been enabled by default
9081     * The compiler is now stricter about where it will load module files
9082       from when a module is declared via `mod foo;`.
9083     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
9084       Syntax extensions are now discovered via a "plugin registrar" type
9085       which will be extended in the future to other various plugins.
9086     * Lints have been restructured to allow for dynamically loadable lints.
9087     * A number of rustdoc improvements:
9088       * The HTML output has been visually redesigned.
9089       * Markdown is now powered by hoedown instead of sundown.
9090       * Searching heuristics have been greatly improved.
9091       * The search index has been reduced in size by a great amount.
9092       * Cross-crate documentation via `pub use` has been greatly improved.
9093       * Primitive types are now hyperlinked and documented.
9094     * Documentation has been moved from static.rust-lang.org/doc to
9095       doc.rust-lang.org
9096     * A new sandbox, play.rust-lang.org, is available for running and
9097       sharing rust code examples on-line.
9098     * Unused attributes are now more robustly warned about.
9099     * The dead_code lint now warns about unused struct fields.
9100     * Cross-compiling to iOS is now supported.
9101     * Cross-compiling to mipsel is now supported.
9102     * Stability attributes are now inherited by default and no longer apply
9103       to intra-crate usage, only inter-crate usage.
9104     * Error message related to non-exhaustive match expressions have been
9105       greatly improved.
9106
9107
9108 Version 0.10 (2014-04-03)
9109 =========================
9110
9111   * ~1500 changes, numerous bugfixes
9112
9113   * Language
9114     * A new RFC process is now in place for modifying the language.
9115     * Patterns with `@`-pointers have been removed from the language.
9116     * Patterns with unique vectors (`~[T]`) have been removed from the
9117       language.
9118     * Patterns with unique strings (`~str`) have been removed from the
9119       language.
9120     * `@str` has been removed from the language.
9121     * `@[T]` has been removed from the language.
9122     * `@self` has been removed from the language.
9123     * `@Trait` has been removed from the language.
9124     * Headers on `~` allocations which contain `@` boxes inside the type for
9125       reference counting have been removed.
9126     * The semantics around the lifetimes of temporary expressions have changed,
9127       see #3511 and #11585 for more information.
9128     * Cross-crate syntax extensions are now possible, but feature gated. See
9129       #11151 for more information. This includes both `macro_rules!` macros as
9130       well as syntax extensions such as `format!`.
9131     * New lint modes have been added, and older ones have been turned on to be
9132       warn-by-default.
9133       * Unnecessary parentheses
9134       * Uppercase statics
9135       * Camel Case types
9136       * Uppercase variables
9137       * Publicly visible private types
9138       * `#[deriving]` with raw pointers
9139     * Unsafe functions can no longer be coerced to closures.
9140     * Various obscure macros such as `log_syntax!` are now behind feature gates.
9141     * The `#[simd]` attribute is now behind a feature gate.
9142     * Visibility is no longer allowed on `extern crate` statements, and
9143       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
9144     * Trailing commas are now allowed in argument lists and tuple patterns.
9145     * The `do` keyword has been removed, it is now a reserved keyword.
9146     * Default type parameters have been implemented, but are feature gated.
9147     * Borrowed variables through captures in closures are now considered soundly.
9148     * `extern mod` is now `extern crate`
9149     * The `Freeze` trait has been removed.
9150     * The `Share` trait has been added for types that can be shared among
9151       threads.
9152     * Labels in macros are now hygienic.
9153     * Expression/statement macro invocations can be delimited with `{}` now.
9154     * Treatment of types allowed in `static mut` locations has been tweaked.
9155     * The `*` and `.` operators are now overloadable through the `Deref` and
9156       `DerefMut` traits.
9157     * `~Trait` and `proc` no longer have `Send` bounds by default.
9158     * Partial type hints are now supported with the `_` type marker.
9159     * An `Unsafe` type was introduced for interior mutability. It is now
9160       considered undefined to transmute from `&T` to `&mut T` without using the
9161       `Unsafe` type.
9162     * The #[linkage] attribute was implemented for extern statics/functions.
9163     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
9164     * `Pod` was renamed to `Copy`.
9165
9166   * Libraries
9167     * The `libextra` library has been removed. It has now been decomposed into
9168       component libraries with smaller and more focused nuggets of
9169       functionality. The full list of libraries can be found on the
9170       documentation index page.
9171     * std: `std::condition` has been removed. All I/O errors are now propagated
9172       through the `Result` type. In order to assist with error handling, a
9173       `try!` macro for unwrapping errors with an early return and a lint for
9174       unused results has been added. See #12039 for more information.
9175     * std: The `vec` module has been renamed to `slice`.
9176     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
9177       This will become the only growable vector in the future.
9178     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
9179       are now found at `std::io::BufferedReader` instead of
9180       `std::io::buffered::BufferedReader`.
9181     * std: `print` and `println` are no longer in the prelude, the `print!` and
9182       `println!` macros are intended to be used instead.
9183     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
9184       attempts to statically prevent cycles.
9185     * std: The standard distribution is adopting the policy of pushing failure
9186       to the user rather than failing in libraries. Many functions (such as
9187       `slice::last()`) now return `Option<T>` instead of `T` + failing.
9188     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
9189       deriving mode: `#[deriving(Show)]`.
9190     * std: `ToStr` is now implemented for all types implementing `Show`.
9191     * std: The formatting trait methods now take `&self` instead of `&T`
9192     * std: The `invert()` method on iterators has been renamed to `rev()`
9193     * std: `std::num` has seen a reduction in the genericity of its traits,
9194       consolidating functionality into a few core traits.
9195     * std: Backtraces are now printed on task failure if the environment
9196       variable `RUST_BACKTRACE` is present.
9197     * std: Naming conventions for iterators have been standardized. More details
9198       can be found on the wiki's style guide.
9199     * std: `eof()` has been removed from the `Reader` trait. Specific types may
9200       still implement the function.
9201     * std: Networking types are now cloneable to allow simultaneous reads/writes.
9202     * std: `assert_approx_eq!` has been removed
9203     * std: The `e` and `E` formatting specifiers for floats have been added to
9204       print them in exponential notation.
9205     * std: The `Times` trait has been removed
9206     * std: Indications of variance and opting out of builtin bounds is done
9207       through marker types in `std::kinds::marker` now
9208     * std: `hash` has been rewritten, `IterBytes` has been removed, and
9209       `#[deriving(Hash)]` is now possible.
9210     * std: `SharedChan` has been removed, `Sender` is now cloneable.
9211     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
9212     * std: `Chan::new` is now `channel()`.
9213     * std: A new synchronous channel type has been implemented.
9214     * std: A `select!` macro is now provided for selecting over `Receiver`s.
9215     * std: `hashmap` and `trie` have been moved to `libcollections`
9216     * std: `run` has been rolled into `io::process`
9217     * std: `assert_eq!` now uses `{}` instead of `{:?}`
9218     * std: The equality and comparison traits have seen some reorganization.
9219     * std: `rand` has moved to `librand`.
9220     * std: `to_{lower,upper}case` has been implemented for `char`.
9221     * std: Logging has been moved to `liblog`.
9222     * collections: `HashMap` has been rewritten for higher performance and less
9223       memory usage.
9224     * native: The default runtime is now `libnative`. If `libgreen` is desired,
9225       it can be booted manually. The runtime guide has more information and
9226       examples.
9227     * native: All I/O functionality except signals has been implemented.
9228     * green: Task spawning with `libgreen` has been optimized with stack caching
9229       and various trimming of code.
9230     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
9231     * sync: The `extra::sync` module has been updated to modern rust (and moved
9232       to the `sync` library), tweaking and improving various interfaces while
9233       dropping redundant functionality.
9234     * sync: A new `Barrier` type has been added to the `sync` library.
9235     * sync: An efficient mutex for native and green tasks has been implemented.
9236     * serialize: The `base64` module has seen some improvement. It treats
9237       newlines better, has non-string error values, and has seen general
9238       cleanup.
9239     * fourcc: A `fourcc!` macro was introduced
9240     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
9241       hexadecimal literal.
9242
9243   * Tooling
9244     * `rustpkg` has been deprecated and removed from the main repository. Its
9245       replacement, `cargo`, is under development.
9246     * Nightly builds of rust are now available
9247     * The memory usage of rustc has been improved many times throughout this
9248       release cycle.
9249     * The build process supports disabling rpath support for the rustc binary
9250       itself.
9251     * Code generation has improved in some cases, giving more information to the
9252       LLVM optimization passes to enable more extensive optimizations.
9253     * Debuginfo compatibility with lldb on OSX has been restored.
9254     * The master branch is now gated on an android bot, making building for
9255       android much more reliable.
9256     * Output flags have been centralized into one `--emit` flag.
9257     * Crate type flags have been centralized into one `--crate-type` flag.
9258     * Codegen flags have been consolidated behind a `-C` flag.
9259     * Linking against outdated crates now has improved error messages.
9260     * Error messages with lifetimes will often suggest how to annotate the
9261       function to fix the error.
9262     * Many more types are documented in the standard library, and new guides
9263       were written.
9264     * Many `rustdoc` improvements:
9265       * code blocks are syntax highlighted.
9266       * render standalone markdown files.
9267       * the --test flag tests all code blocks by default.
9268       * exported macros are displayed.
9269       * re-exported types have their documentation inlined at the location of the
9270         first re-export.
9271       * search works across crates that have been rendered to the same output
9272         directory.
9273
9274
9275 Version 0.9 (2014-01-09)
9276 ==========================
9277
9278    * ~1800 changes, numerous bugfixes
9279
9280    * Language
9281       * The `float` type has been removed. Use `f32` or `f64` instead.
9282       * A new facility for enabling experimental features (feature gating) has
9283         been added, using the crate-level `#[feature(foo)]` attribute.
9284       * Managed boxes (@) are now behind a feature gate
9285         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
9286         standard library's `Gc` or `Rc` types instead.
9287       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
9288       * Jumping back to the top of a loop is now done with `continue` instead of
9289         `loop`.
9290       * Strings can no longer be mutated through index assignment.
9291       * Raw strings can be created via the basic `r"foo"` syntax or with matched
9292         hash delimiters, as in `r###"foo"###`.
9293       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
9294         called once.
9295       * The `&fn` type is now written `|args| -> ret` to match the literal form.
9296       * `@fn`s have been removed.
9297       * `do` only works with procs in order to make it obvious what the cost
9298         of `do` is.
9299       * Single-element tuple-like structs can no longer be dereferenced to
9300         obtain the inner value. A more comprehensive solution for overloading
9301         the dereference operator will be provided in the future.
9302       * The `#[link(...)]` attribute has been replaced with
9303         `#[crate_id = "name#vers"]`.
9304       * Empty `impl`s must be terminated with empty braces and may not be
9305         terminated with a semicolon.
9306       * Keywords are no longer allowed as lifetime names; the `self` lifetime
9307         no longer has any special meaning.
9308       * The old `fmt!` string formatting macro has been removed.
9309       * `printf!` and `printfln!` (old-style formatting) removed in favor of
9310         `print!` and `println!`.
9311       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
9312       * The `extern mod foo (name = "bar")` syntax has been removed. Use
9313         `extern mod foo = "bar"` instead.
9314       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
9315       * Macros can have attributes.
9316       * Macros can expand to items with attributes.
9317       * Macros can expand to multiple items.
9318       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
9319       * Comments may be nested.
9320       * Values automatically coerce to trait objects they implement, without
9321         an explicit `as`.
9322       * Enum discriminants are no longer an entire word but as small as needed to
9323         contain all the variants. The `repr` attribute can be used to override
9324         the discriminant size, as in `#[repr(int)]` for integer-sized, and
9325         `#[repr(C)]` to match C enums.
9326       * Non-string literals are not allowed in attributes (they never worked).
9327       * The FFI now supports variadic functions.
9328       * Octal numeric literals, as in `0o7777`.
9329       * The `concat!` syntax extension performs compile-time string concatenation.
9330       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
9331         removed as Rust no longer uses segmented stacks.
9332       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
9333       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
9334         not `*`; ignoring remaining fields of a struct is also done with `..`,
9335         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
9336       * `rustc` supports the "win64" calling convention via `extern "win64"`.
9337       * `rustc` supports the "system" calling convention, which defaults to the
9338         preferred convention for the target platform, "stdcall" on 32-bit Windows,
9339         "C" elsewhere.
9340       * The `type_overflow` lint (default: warn) checks literals for overflow.
9341       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
9342       * The `attribute_usage` lint (default: warn) warns about unknown
9343         attributes.
9344       * The `unknown_features` lint (default: warn) warns about unknown
9345         feature gates.
9346       * The `dead_code` lint (default: warn) checks for dead code.
9347       * Rust libraries can be linked statically to one another
9348       * `#[link_args]` is behind the `link_args` feature gate.
9349       * Native libraries are now linked with `#[link(name = "foo")]`
9350       * Native libraries can be statically linked to a rust crate
9351         (`#[link(name = "foo", kind = "static")]`).
9352       * Native OS X frameworks are now officially supported
9353         (`#[link(name = "foo", kind = "framework")]`).
9354       * The `#[thread_local]` attribute creates thread-local (not task-local)
9355         variables. Currently behind the `thread_local` feature gate.
9356       * The `return` keyword may be used in closures.
9357       * Types that can be copied via a memcpy implement the `Pod` kind.
9358       * The `cfg` attribute can now be used on struct fields and enum variants.
9359
9360    * Libraries
9361       * std: The `option` and `result` API's have been overhauled to make them
9362         simpler, more consistent, and more composable.
9363       * std: The entire `std::io` module has been replaced with one that is
9364         more comprehensive and that properly interfaces with the underlying
9365         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
9366         implemented.
9367       * std: `io::util` contains a number of useful implementations of
9368         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
9369         `ZeroReader`, `TeeReader`.
9370       * std: The reference counted pointer type `extra::rc` moved into std.
9371       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
9372         just a wrapper around it).
9373       * std: The `Either` type has been removed.
9374       * std: `fmt::Default` can be implemented for any type to provide default
9375         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
9376       * std: The `rand` API continues to be tweaked.
9377       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
9378         on failure in gdb, is now named `rust_fail`.
9379       * std: The `each_key` and `each_value` methods on `HashMap` have been
9380         replaced by the `keys` and `values` iterators.
9381       * std: Functions dealing with type size and alignment have moved from the
9382         `sys` module to the `mem` module.
9383       * std: The `path` module was written and API changed.
9384       * std: `str::from_utf8` has been changed to cast instead of allocate.
9385       * std: `starts_with` and `ends_with` methods added to vectors via the
9386         `ImmutableEqVector` trait, which is in the prelude.
9387       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
9388         if the index is out of bounds.
9389       * std: Task failure no longer propagates between tasks, as the model was
9390         complex, expensive, and incompatible with thread-based tasks.
9391       * std: The `Any` type can be used for dynamic typing.
9392       * std: `~Any` can be passed to the `fail!` macro and retrieved via
9393         `task::try`.
9394       * std: Methods that produce iterators generally do not have an `_iter`
9395         suffix now.
9396       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
9397         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
9398       * std: `util::ignore` renamed to `prelude::drop`.
9399       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
9400         trait.
9401       * std: `vec::raw` has seen a lot of cleanup and API changes.
9402       * std: The standard library no longer includes any C++ code, and very
9403         minimal C, eliminating the dependency on libstdc++.
9404       * std: Runtime scheduling and I/O functionality has been factored out into
9405         extensible interfaces and is now implemented by two different crates:
9406         libnative, for native threading and I/O; and libgreen, for green threading
9407         and I/O. This paves the way for using the standard library in more limited
9408         embedded environments.
9409       * std: The `comm` module has been rewritten to be much faster, have a
9410         simpler, more consistent API, and to work for both native and green
9411         threading.
9412       * std: All libuv dependencies have been moved into the rustuv crate.
9413       * native: New implementations of runtime scheduling on top of OS threads.
9414       * native: New native implementations of TCP, UDP, file I/O, process spawning,
9415         and other I/O.
9416       * green: The green thread scheduler and message passing types are almost
9417         entirely lock-free.
9418       * extra: The `flatpipes` module had bitrotted and was removed.
9419       * extra: All crypto functions have been removed and Rust now has a policy of
9420         not reimplementing crypto in the standard library. In the future crypto
9421         will be provided by external crates with bindings to established libraries.
9422       * extra: `c_vec` has been modernized.
9423       * extra: The `sort` module has been removed. Use the `sort` method on
9424         mutable slices.
9425
9426    * Tooling
9427       * The `rust` and `rusti` commands have been removed, due to lack of
9428         maintenance.
9429       * `rustdoc` was completely rewritten.
9430       * `rustdoc` can test code examples in documentation.
9431       * `rustpkg` can test packages with the argument, 'test'.
9432       * `rustpkg` supports arbitrary dependencies, including C libraries.
9433       * `rustc`'s support for generating debug info is improved again.
9434       * `rustc` has better error reporting for unbalanced delimiters.
9435       * `rustc`'s JIT support was removed due to bitrot.
9436       * Executables and static libraries can be built with LTO (-Z lto)
9437       * `rustc` adds a `--dep-info` flag for communicating dependencies to
9438         build tools.
9439
9440
9441 Version 0.8 (2013-09-26)
9442 ============================
9443
9444    * ~2200 changes, numerous bugfixes
9445
9446    * Language
9447       * The `for` loop syntax has changed to work with the `Iterator` trait.
9448       * At long last, unwinding works on Windows.
9449       * Default methods are ready for use.
9450       * Many trait inheritance bugs fixed.
9451       * Owned and borrowed trait objects work more reliably.
9452       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
9453       * rustc can omit emission of code for the `debug!` macro if it is passed
9454         `--cfg ndebug`
9455       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
9456         for foo.rs, then foo/mod.rs, and will generate an error when both are
9457         present.
9458       * Strings no longer contain trailing nulls. The new `std::c_str` module
9459         provides new mechanisms for converting to C strings.
9460       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
9461       * The FFI has been overhauled such that foreign functions are called directly,
9462         instead of through a stack-switching wrapper.
9463       * Calling a foreign function must be done through a Rust function with the
9464         `#[fixed_stack_segment]` attribute.
9465       * The `externfn!` macro can be used to declare both a foreign function and
9466         a `#[fixed_stack_segment]` wrapper at once.
9467       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
9468       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
9469       * `priv` is disallowed everywhere except for struct fields and enum variants.
9470       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
9471       * `ref` bindings in irrefutable patterns work correctly now.
9472       * `char` is now prevented from containing invalid code points.
9473       * Casting to `bool` is no longer allowed.
9474       * `\0` is now accepted as an escape in chars and strings.
9475       * `yield` is a reserved keyword.
9476       * `typeof` is a reserved keyword.
9477       * Crates may be imported by URL with `extern mod foo = "url";`.
9478       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
9479       * Static vectors can be initialized with repeating elements,
9480         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
9481       * Static structs can be initialized with functional record update,
9482         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
9483       * `cfg!` can be used to conditionally execute code based on the crate
9484         configuration, similarly to `#[cfg(...)]`.
9485       * The `unnecessary_qualification` lint detects unneeded module
9486         prefixes (default: allow).
9487       * Arithmetic operations have been implemented on the SIMD types in
9488         `std::unstable::simd`.
9489       * Exchange allocation headers were removed, reducing memory usage.
9490       * `format!` implements a completely new, extensible, and higher-performance
9491         string formatting system. It will replace `fmt!`.
9492       * `print!` and `println!` write formatted strings (using the `format!`
9493         extension) to stdout.
9494       * `write!` and `writeln!` write formatted strings (using the `format!`
9495         extension) to the new Writers in `std::rt::io`.
9496       * The library section in which a function or static is placed may
9497         be specified with `#[link_section = "..."]`.
9498       * The `proto!` syntax extension for defining bounded message protocols
9499         was removed.
9500       * `macro_rules!` is hygienic for `let` declarations.
9501       * The `#[export_name]` attribute specifies the name of a symbol.
9502       * `unreachable!` can be used to indicate unreachable code, and fails
9503         if executed.
9504
9505    * Libraries
9506       * std: Transitioned to the new runtime, written in Rust.
9507       * std: Added an experimental I/O library, `rt::io`, based on the new
9508         runtime.
9509       * std: A new generic `range` function was added to the prelude, replacing
9510         `uint::range` and friends.
9511       * std: `range_rev` no longer exists. Since range is an iterator it can be
9512         reversed with `range(lo, hi).invert()`.
9513       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
9514         renamed to `unwrap_or`.
9515       * std: The `iterator` module was renamed to `iter`.
9516       * std: Integral types now support the `checked_add`, `checked_sub`, and
9517         `checked_mul` operations for detecting overflow.
9518       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
9519         consistency.
9520       * std: Methods are standardizing on conventions for casting methods:
9521         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
9522         and cheap casts.
9523       * std: The `CString` type in `c_str` provides new ways to convert to and
9524         from C strings.
9525       * std: `DoubleEndedIterator` can yield elements in two directions.
9526       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
9527         two splices.
9528       * std: `str::from_bytes` renamed to `str::from_utf8`.
9529       * std: `pop_opt` and `shift_opt` methods added to vectors.
9530       * std: The task-local data interface no longer uses @, and keys are
9531         no longer function pointers.
9532       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
9533       * std: Added `SharedPort` to `comm`.
9534       * std: `Eq` has a default method for `ne`; only `eq` is required
9535         in implementations.
9536       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
9537         is required in implementations.
9538       * std: `is_utf8` performance is improved, impacting many string functions.
9539       * std: `os::MemoryMap` provides cross-platform mmap.
9540       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
9541         are not 'in-bounds' are considered undefined.
9542       * std: Many freestanding functions in `vec` removed in favor of methods.
9543       * std: Many freestanding functions on scalar types removed in favor of
9544         methods.
9545       * std: Many options to task builders were removed since they don't make
9546         sense in the new scheduler design.
9547       * std: More containers implement `FromIterator` so can be created by the
9548         `collect` method.
9549       * std: More complete atomic types in `unstable::atomics`.
9550       * std: `comm::PortSet` removed.
9551       * std: Mutating methods in the `Set` and `Map` traits have been moved into
9552         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
9553         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
9554         default implementations.
9555       * std: Various `from_str` functions were removed in favor of a generic
9556         `from_str` which is available in the prelude.
9557       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
9558       * extra: `dlist`, the doubly-linked list was modernized.
9559       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
9560       * extra: Added `glob` module, replacing `std::os::glob`.
9561       * extra: `rope` was removed.
9562       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
9563       * extra: `net`, and `timer` were removed. The experimental replacements
9564         are `std::rt::io::net` and `std::rt::io::timer`.
9565       * extra: Iterators implemented for `SmallIntMap`.
9566       * extra: Iterators implemented for `Bitv` and `BitvSet`.
9567       * extra: `SmallIntSet` removed. Use `BitvSet`.
9568       * extra: Performance of JSON parsing greatly improved.
9569       * extra: `semver` updated to SemVer 2.0.0.
9570       * extra: `term` handles more terminals correctly.
9571       * extra: `dbg` module removed.
9572       * extra: `par` module removed.
9573       * extra: `future` was cleaned up, with some method renames.
9574       * extra: Most free functions in `getopts` were converted to methods.
9575
9576    * Other
9577       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
9578       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
9579         similarly to gcc's `--march` flag.
9580       * rustc's performance compiling small crates is much better.
9581       * rustpkg has received many improvements.
9582       * rustpkg supports git tags as package IDs.
9583       * rustpkg builds into target-specific directories so it can be used for
9584         cross-compiling.
9585       * The number of concurrent test tasks is controlled by the environment
9586         variable RUST_TEST_TASKS.
9587       * The test harness can now report metrics for benchmarks.
9588       * All tools have man pages.
9589       * Programs compiled with `--test` now support the `-h` and `--help` flags.
9590       * The runtime uses jemalloc for allocations.
9591       * Segmented stacks are temporarily disabled as part of the transition to
9592         the new runtime. Stack overflows are possible!
9593       * A new documentation backend, rustdoc_ng, is available for use. It is
9594         still invoked through the normal `rustdoc` command.
9595
9596
9597 Version 0.7 (2013-07-03)
9598 =======================
9599
9600    * ~2000 changes, numerous bugfixes
9601
9602    * Language
9603       * `impl`s no longer accept a visibility qualifier. Put them on methods
9604         instead.
9605       * The borrow checker has been rewritten with flow-sensitivity, fixing
9606         many bugs and inconveniences.
9607       * The `self` parameter no longer implicitly means `&'self self`,
9608         and can be explicitly marked with a lifetime.
9609       * Overloadable compound operators (`+=`, etc.) have been temporarily
9610         removed due to bugs.
9611       * The `for` loop protocol now requires `for`-iterators to return `bool`
9612         so they compose better.
9613       * The `Durable` trait is replaced with the `'static` bounds.
9614       * Trait default methods work more often.
9615       * Structs with the `#[packed]` attribute have byte alignment and
9616         no padding between fields.
9617       * Type parameters bound by `Copy` must now be copied explicitly with
9618         the `copy` keyword.
9619       * It is now illegal to move out of a dereferenced unsafe pointer.
9620       * `Option<~T>` is now represented as a nullable pointer.
9621       * `@mut` does dynamic borrow checks correctly.
9622       * The `main` function is only detected at the topmost level of the crate.
9623         The `#[main]` attribute is still valid anywhere.
9624       * Struct fields may no longer be mutable. Use inherited mutability.
9625       * The `#[no_send]` attribute makes a type that would otherwise be
9626         `Send`, not.
9627       * The `#[no_freeze]` attribute makes a type that would otherwise be
9628         `Freeze`, not.
9629       * Unbounded recursion will abort the process after reaching the limit
9630         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
9631       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
9632         are never implicitly copyable.
9633       * `#[static_assert]` makes compile-time assertions about static bools.
9634       * At long last, 'argument modes' no longer exist.
9635       * The rarely used `use mod` statement no longer exists.
9636
9637    * Syntax extensions
9638       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
9639         argument list.
9640       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
9641         `Rand`, `Zero` and `ToStr` can all be automatically derived with
9642         `#[deriving(...)]`.
9643       * The `bytes!` macro returns a vector of bytes for string, u8, char,
9644         and unsuffixed integer literals.
9645
9646    * Libraries
9647       * The `core` crate was renamed to `std`.
9648       * The `std` crate was renamed to `extra`.
9649       * More and improved documentation.
9650       * std: `iterator` module for external iterator objects.
9651       * Many old-style (internal, higher-order function) iterators replaced by
9652         implementations of `Iterator`.
9653       * std: Many old internal vector and string iterators,
9654         incl. `any`, `all`. removed.
9655       * std: The `finalize` method of `Drop` renamed to `drop`.
9656       * std: The `drop` method now takes `&mut self` instead of `&self`.
9657       * std: The prelude no longer re-exports any modules, only types and traits.
9658       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
9659         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
9660       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
9661         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
9662       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
9663         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
9664       * std: Many types implement `Clone`.
9665       * std: `path` type renamed to `Path`.
9666       * std: `mut` module and `Mut` type removed.
9667       * std: Many standalone functions removed in favor of methods and iterators
9668         in `vec`, `str`. In the future methods will also work as functions.
9669       * std: `reinterpret_cast` removed. Use `transmute`.
9670       * std: ascii string handling in `std::ascii`.
9671       * std: `Rand` is implemented for ~/@.
9672       * std: `run` module for spawning processes overhauled.
9673       * std: Various atomic types added to `unstable::atomic`.
9674       * std: Various types implement `Zero`.
9675       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
9676       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
9677       * std: Added `os::mkdir_recursive`.
9678       * std: Added `os::glob` function performs filesystems globs.
9679       * std: `FuzzyEq` renamed to `ApproxEq`.
9680       * std: `Map` now defines `pop` and `swap` methods.
9681       * std: `Cell` constructors converted to static methods.
9682       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
9683       * extra: `flate` module moved from `std` to `extra`.
9684       * extra: `fileinput` module for iterating over a series of files.
9685       * extra: `Complex` number type and `complex` module.
9686       * extra: `Rational` number type and `rational` module.
9687       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
9688       * extra: `term` uses terminfo now, is more correct.
9689       * extra: `arc` functions converted to methods.
9690       * extra: Implementation of fixed output size variations of SHA-2.
9691
9692    * Tooling
9693       * `unused_variables` lint mode for unused variables (default: warn).
9694       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
9695         (default: warn).
9696       * `unused_mut` lint mode for identifying unused `mut` qualifiers
9697         (default: warn).
9698       * `dead_assignment` lint mode for unread variables (default: warn).
9699       * `unnecessary_allocation` lint mode detects some heap allocations that are
9700         immediately borrowed so could be written without allocating (default: warn).
9701       * `missing_doc` lint mode (default: allow).
9702       * `unreachable_code` lint mode (default: warn).
9703       * The `rusti` command has been rewritten and a number of bugs addressed.
9704       * rustc outputs in color on more terminals.
9705       * rustc accepts a `--link-args` flag to pass arguments to the linker.
9706       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
9707       * Compiling with `-g` will make the binary record information about
9708         dynamic borrowcheck failures for debugging.
9709       * rustdoc has a nicer stylesheet.
9710       * Various improvements to rustdoc.
9711       * Improvements to rustpkg (see the detailed release notes).
9712
9713
9714 Version 0.6 (2013-04-03)
9715 ========================
9716
9717    * ~2100 changes, numerous bugfixes
9718
9719    * Syntax changes
9720       * The self type parameter in traits is now spelled `Self`
9721       * The `self` parameter in trait and impl methods must now be explicitly
9722         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
9723       * Static methods no longer require the `static` keyword and instead
9724         are distinguished by the lack of a `self` parameter
9725       * Replaced the `Durable` trait with the `'static` lifetime
9726       * The old closure type syntax with the trailing sigil has been
9727         removed in favor of the more consistent leading sigil
9728       * `super` is a keyword, and may be prefixed to paths
9729       * Trait bounds are separated with `+` instead of whitespace
9730       * Traits are implemented with `impl Trait for Type`
9731         instead of `impl Type: Trait`
9732       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
9733       * The `export` keyword has finally been removed
9734       * The `move` keyword has been removed (see "Semantic changes")
9735       * The interior mutability qualifier on vectors, `[mut T]`, has been
9736         removed. Use `&mut [T]`, etc.
9737       * `mut` is no longer valid in `~mut T`. Use inherited mutability
9738       * `fail` is no longer a keyword. Use `fail!()`
9739       * `assert` is no longer a keyword. Use `assert!()`
9740       * `log` is no longer a keyword. use `debug!`, etc.
9741       * 1-tuples may be represented as `(T,)`
9742       * Struct fields may no longer be `mut`. Use inherited mutability,
9743         `@mut T`, `core::mut` or `core::cell`
9744       * `extern mod { ... }` is no longer valid syntax for foreign
9745         function modules. Use extern blocks: `extern { ... }`
9746       * Newtype enums removed. Use tuple-structs.
9747       * Trait implementations no longer support visibility modifiers
9748       * Pattern matching over vectors improved and expanded
9749       * `const` renamed to `static` to correspond to lifetime name,
9750         and make room for future `static mut` unsafe mutable globals.
9751       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
9752       * `Clone` implementations can be automatically generated with
9753         `#[deriving(Clone)]`
9754       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
9755         instead of `foo as Bar`.
9756       * Fixed length vector types are now written as `[int, .. 3]`
9757         instead of `[int * 3]`.
9758       * Fixed length vector types can express the length as a constant
9759         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
9760
9761    * Semantic changes
9762       * Types with owned pointers or custom destructors move by default,
9763         eliminating the `move` keyword
9764       * All foreign functions are considered unsafe
9765       * &mut is now unaliasable
9766       * Writes to borrowed @mut pointers are prevented dynamically
9767       * () has size 0
9768       * The name of the main function can be customized using #[main]
9769       * The default type of an inferred closure is &fn instead of @fn
9770       * `use` statements may no longer be "chained" - they cannot import
9771         identifiers imported by previous `use` statements
9772       * `use` statements are crate relative, importing from the "top"
9773         of the crate by default. Paths may be prefixed with `super::`
9774         or `self::` to change the search behavior.
9775       * Method visibility is inherited from the implementation declaration
9776       * Structural records have been removed
9777       * Many more types can be used in static items, including enums
9778         'static-lifetime pointers and vectors
9779       * Pattern matching over vectors improved and expanded
9780       * Typechecking of closure types has been overhauled to
9781         improve inference and eliminate unsoundness
9782       * Macros leave scope at the end of modules, unless that module is
9783         tagged with #[macro_escape]
9784
9785    * Libraries
9786       * Added big integers to `std::bigint`
9787       * Removed `core::oldcomm` module
9788       * Added pipe-based `core::comm` module
9789       * Numeric traits have been reorganized under `core::num`
9790       * `vec::slice` finally returns a slice
9791       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
9792       * Containers reorganized around traits in `core::container`
9793       * `core::dvec` removed, `~[T]` is a drop-in replacement
9794       * `core::send_map` renamed to `core::hashmap`
9795       * `std::map` removed; replaced with `core::hashmap`
9796       * `std::treemap` reimplemented as an owned balanced tree
9797       * `std::deque` and `std::smallintmap` reimplemented as owned containers
9798       * `core::trie` added as a fast ordered map for integer keys
9799       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
9800       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
9801         overload the comparison operators, whereas `TotalOrd` is used
9802         by certain container types
9803
9804    * Other
9805       * Replaced the 'cargo' package manager with 'rustpkg'
9806       * Added all-purpose 'rust' tool
9807       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
9808       * rustc now *attempts* to offer spelling suggestions
9809       * Improved support for ARM and Android
9810       * Preliminary MIPS backend
9811       * Improved foreign function ABI implementation for x86, x86_64
9812       * Various memory usage improvements
9813       * Rust code may be embedded in foreign code under limited circumstances
9814       * Inline assembler supported by new asm!() syntax extension.
9815
9816
9817 Version 0.5 (2012-12-21)
9818 ===========================
9819
9820    * ~900 changes, numerous bugfixes
9821
9822    * Syntax changes
9823       * Removed `<-` move operator
9824       * Completed the transition from the `#fmt` extension syntax to `fmt!`
9825       * Removed old fixed length vector syntax - `[T]/N`
9826       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
9827       * Macros may now expand to items and statements
9828       * `a.b()` is always parsed as a method call, never as a field projection
9829       * `Eq` and `IterBytes` implementations can be automatically generated
9830         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
9831       * Removed the special crate language for `.rc` files
9832       * Function arguments may consist of any irrefutable pattern
9833
9834    * Semantic changes
9835       * `&` and `~` pointers may point to objects
9836       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
9837       * Enum variants may be structs
9838       * Destructors can be added to all nominal types with the Drop trait
9839       * Structs and nullary enum variants may be constants
9840       * Values that cannot be implicitly copied are now automatically moved
9841         without writing `move` explicitly
9842       * `&T` may now be coerced to `*T`
9843       * Coercions happen in `let` statements as well as function calls
9844       * `use` statements now take crate-relative paths
9845       * The module and type namespaces have been merged so that static
9846         method names can be resolved under the trait in which they are
9847         declared
9848
9849    * Improved support for language features
9850       * Trait inheritance works in many scenarios
9851       * More support for explicit self arguments in methods - `self`, `&self`
9852         `@self`, and `~self` all generally work as expected
9853       * Static methods work in more situations
9854       * Experimental: Traits may declare default methods for the implementations
9855         to use
9856
9857    * Libraries
9858       * New condition handling system in `core::condition`
9859       * Timsort added to `std::sort`
9860       * New priority queue, `std::priority_queue`
9861       * Pipes for serializable types, `std::flatpipes'
9862       * Serialization overhauled to be trait-based
9863       * Expanded `getopts` definitions
9864       * Moved futures to `std`
9865       * More functions are pure now
9866       * `core::comm` renamed to `oldcomm`. Still deprecated
9867       * `rustdoc` and `cargo` are libraries now
9868
9869    * Misc
9870       * Added a preliminary REPL, `rusti`
9871       * License changed from MIT to dual MIT/APL2
9872
9873
9874 Version 0.4 (2012-10-15)
9875 ==========================
9876
9877    * ~2000 changes, numerous bugfixes
9878
9879    * Syntax
9880       * All keywords are now strict and may not be used as identifiers anywhere
9881       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
9882         'of', 'with', 'to', 'class'.
9883       * Classes are replaced with simpler structs
9884       * Explicit method self types
9885       * `ret` became `return` and `alt` became `match`
9886       * `import` is now `use`; `use is now `extern mod`
9887       * `extern mod { ... }` is now `extern { ... }`
9888       * `use mod` is the recommended way to import modules
9889       * `pub` and `priv` replace deprecated export lists
9890       * The syntax of `match` pattern arms now uses fat arrow (=>)
9891       * `main` no longer accepts an args vector; use `os::args` instead
9892
9893    * Semantics
9894       * Trait implementations are now coherent, ala Haskell typeclasses
9895       * Trait methods may be static
9896       * Argument modes are deprecated
9897       * Borrowed pointers are much more mature and recommended for use
9898       * Strings and vectors in the static region are stored in constant memory
9899       * Typestate was removed
9900       * Resolution rewritten to be more reliable
9901       * Support for 'dual-mode' data structures (freezing and thawing)
9902
9903    * Libraries
9904       * Most binary operators can now be overloaded via the traits in
9905         `core::ops'
9906       * `std::net::url` for representing URLs
9907       * Sendable hash maps in `core::send_map`
9908       * `core::task' gained a (currently unsafe) task-local storage API
9909
9910    * Concurrency
9911       * An efficient new intertask communication primitive called the pipe,
9912         along with a number of higher-level channel types, in `core::pipes`
9913       * `std::arc`, an atomically reference counted, immutable, shared memory
9914         type
9915       * `std::sync`, various exotic synchronization tools based on arcs and pipes
9916       * Futures are now based on pipes and sendable
9917       * More robust linked task failure
9918       * Improved task builder API
9919
9920    * Other
9921       * Improved error reporting
9922       * Preliminary JIT support
9923       * Preliminary work on precise GC
9924       * Extensive architectural improvements to rustc
9925       * Begun a transition away from buggy C++-based reflection (shape) code to
9926         Rust-based (visitor) code
9927       * All hash functions and tables converted to secure, randomized SipHash
9928
9929
9930 Version 0.3  (2012-07-12)
9931 ========================
9932
9933    * ~1900 changes, numerous bugfixes
9934
9935    * New coding conveniences
9936       * Integer-literal suffix inference
9937       * Per-item control over warnings, errors
9938       * #[cfg(windows)] and #[cfg(unix)] attributes
9939       * Documentation comments
9940       * More compact closure syntax
9941       * 'do' expressions for treating higher-order functions as
9942         control structures
9943       * *-patterns (wildcard extended to all constructor fields)
9944
9945    * Semantic cleanup
9946       * Name resolution pass and exhaustiveness checker rewritten
9947       * Region pointers and borrow checking supersede alias
9948         analysis
9949       * Init-ness checking is now provided by a region-based liveness
9950         pass instead of the typestate pass; same for last-use analysis
9951       * Extensive work on region pointers
9952
9953    * Experimental new language features
9954       * Slices and fixed-size, interior-allocated vectors
9955       * #!-comments for lang versioning, shell execution
9956       * Destructors and iface implementation for classes;
9957         type-parameterized classes and class methods
9958       * 'const' type kind for types that can be used to implement
9959         shared-memory concurrency patterns
9960
9961    * Type reflection
9962
9963    * Removal of various obsolete features
9964       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
9965                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
9966
9967       * Constructs: do-while loops ('do' repurposed), fn binding,
9968                     resources (replaced by destructors)
9969
9970    * Compiler reorganization
9971       * Syntax-layer of compiler split into separate crate
9972       * Clang (from LLVM project) integrated into build
9973       * Typechecker split into sub-modules
9974
9975    * New library code
9976       * New time functions
9977       * Extension methods for many built-in types
9978       * Arc: atomic-refcount read-only / exclusive-use shared cells
9979       * Par: parallel map and search routines
9980       * Extensive work on libuv interface
9981       * Much vector code moved to libraries
9982       * Syntax extensions: #line, #col, #file, #mod, #stringify,
9983         #include, #include_str, #include_bin
9984
9985    * Tool improvements
9986       * Cargo automatically resolves dependencies
9987
9988
9989 Version 0.2  (2012-03-29)
9990 =========================
9991
9992    * >1500 changes, numerous bugfixes
9993
9994    * New docs and doc tooling
9995
9996    * New port: FreeBSD x86_64
9997
9998    * Compilation model enhancements
9999       * Generics now specialized, multiply instantiated
10000       * Functions now inlined across separate crates
10001
10002    * Scheduling, stack and threading fixes
10003       * Noticeably improved message-passing performance
10004       * Explicit schedulers
10005       * Callbacks from C
10006       * Helgrind clean
10007
10008    * Experimental new language features
10009       * Operator overloading
10010       * Region pointers
10011       * Classes
10012
10013    * Various language extensions
10014       * C-callback function types: 'crust fn ...'
10015       * Infinite-loop construct: 'loop { ... }'
10016       * Shorten 'mutable' to 'mut'
10017       * Required mutable-local qualifier: 'let mut ...'
10018       * Basic glob-exporting: 'export foo::*;'
10019       * Alt now exhaustive, 'alt check' for runtime-checked
10020       * Block-function form of 'for' loop, with 'break' and 'ret'.
10021
10022    * New library code
10023       * AST quasi-quote syntax extension
10024       * Revived libuv interface
10025       * New modules: core::{future, iter}, std::arena
10026       * Merged per-platform std::{os*, fs*} to core::{libc, os}
10027       * Extensive cleanup, regularization in libstd, libcore
10028
10029
10030 Version 0.1  (2012-01-20)
10031 ===============================
10032
10033    * Most language features work, including:
10034       * Unique pointers, unique closures, move semantics
10035       * Interface-constrained generics
10036       * Static interface dispatch
10037       * Stack growth
10038       * Multithread task scheduling
10039       * Typestate predicates
10040       * Failure unwinding, destructors
10041       * Pattern matching and destructuring assignment
10042       * Lightweight block-lambda syntax
10043       * Preliminary macro-by-example
10044
10045    * Compiler works with the following configurations:
10046       * Linux: x86 and x86_64 hosts and targets
10047       * macOS: x86 and x86_64 hosts and targets
10048       * Windows: x86 hosts and targets
10049
10050    * Cross compilation / multi-target configuration supported.
10051
10052    * Preliminary API-documentation and package-management tools included.
10053
10054 Known issues:
10055
10056    * Documentation is incomplete.
10057
10058    * Performance is below intended target.
10059
10060    * Standard library APIs are subject to extensive change, reorganization.
10061
10062    * Language-level versioning is not yet operational - future code will
10063      break unexpectedly.