RELEASES.md

   1 Version 1.51.0 (2021-03-25)
   2 ============================
   3
   4 Language
   5 --------
   6 - [You can now parameterize items such as functions, traits, and `struct`s by constant
   7   values in addition to by types and lifetimes.][79135] Also known as "const generics"
   8   E.g. you can now write the following. Note: Only values of primitive integers,
   9   `bool`, or `char` types are currently permitted.
  10   ```rust
  11   struct GenericArray<T, const LENGTH: usize> {
  12       inner: [T; LENGTH]
  13   }
  14
  15   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
  16       const fn last(&self) -> Option<&T> {
  17           if LENGTH == 0 {
  18               None
  19           } else {
  20               Some(&self.inner[LENGTH - 1])
  21           }
  22       }
  23   }
  24   ```
  25
  26
  27 Compiler
  28 --------
  29
  30 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
  31   This option controls whether debug information is split across multiple files
  32   or packed into a single file. **Note** This option is unstable on other platforms.
  33 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
  34   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
  35 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
  36 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
  37
  38 \* Refer to Rust's [platform support page][platform-support-doc] for more
  39 information on Rust's tiered platform support.
  40
  41 Libraries
  42 ---------
  43
  44 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
  45 - [`str` now implements `AsMut<str>`.][80279]
  46 - [`u64` and `u128` now implement `From<char>`.][79502]
  47 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
  48 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
  49 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
  50 - [`io::Empty` now implements `io::Seek`.][78044]
  51 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
  52   `T: ?Sized` types.][80764]
  53 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
  54
  55
  56 Stabilized APIs
  57 ---------------
  58
  59 - [`Arc::decrement_strong_count`]
  60 - [`Arc::increment_strong_count`]
  61 - [`Once::call_once_force`]
  62 - [`Peekable::next_if_eq`]
  63 - [`Peekable::next_if`]
  64 - [`Seek::stream_position`]
  65 - [`array::IntoIter`]
  66 - [`panic::panic_any`]
  67 - [`ptr::addr_of!`]
  68 - [`ptr::addr_of_mut!`]
  69 - [`slice::fill_with`]
  70 - [`slice::split_inclusive_mut`]
  71 - [`slice::split_inclusive`]
  72 - [`slice::strip_prefix`]
  73 - [`slice::strip_suffix`]
  74 - [`str::split_inclusive`]
  75 - [`sync::OnceState`]
  76 - [`task::Wake`]
  77 - [`VecDeque::range`]
  78 - [`VecDeque::range_mut`]
  79
  80 Cargo
  81 -----
  82 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
  83   codegen option.][cargo/9112]
  84 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
  85   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
  86   to avoid unifying features of dependencies where that unification could be unwanted.
  87   Such as using the same dependency with a `std` feature in a build scripts and
  88   proc-macros, while using the `no-std` feature in the final binary. See the
  89   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
  90
  91 Rustdoc
  92 -------
  93
  94 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
  95 - [You can now provide a `--default-theme` flag which sets the default theme to use for
  96   documentation.][79642]
  97
  98 Various improvements to intra-doc links:
  99
 100 - [You can link to non-path primitives such as `slice`.][80181]
 101 - [You can link to associated items.][74489]
 102 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
 103
 104 Misc
 105 ----
 106 - [You can now pass `--include-ignored` to tests (e.g. with
 107   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
 108
 109 Compatibility Notes
 110 -------------------
 111
 112 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
 113 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
 114   could fail.][80579]
 115 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
 116   for the distributed artifacts.][81521]
 117     - `armv5te-unknown-linux-gnueabi`
 118     - `sparc64-unknown-linux-gnu`
 119     - `thumbv7neon-unknown-linux-gnueabihf`
 120     - `armv7-unknown-linux-gnueabi`
 121     - `x86_64-unknown-linux-gnux32`
 122 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
 123
 124 Internal Only
 125 -------------
 126
 127 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
 128
 129 [79135]: https://github.com/rust-lang/rust/pull/79135
 130 [74489]: https://github.com/rust-lang/rust/pull/74489
 131 [76934]: https://github.com/rust-lang/rust/pull/76934
 132 [79570]: https://github.com/rust-lang/rust/pull/79570
 133 [80181]: https://github.com/rust-lang/rust/pull/80181
 134 [79642]: https://github.com/rust-lang/rust/pull/79642
 135 [80945]: https://github.com/rust-lang/rust/pull/80945
 136 [80279]: https://github.com/rust-lang/rust/pull/80279
 137 [80053]: https://github.com/rust-lang/rust/pull/80053
 138 [79502]: https://github.com/rust-lang/rust/pull/79502
 139 [75180]: https://github.com/rust-lang/rust/pull/75180
 140 [79135]: https://github.com/rust-lang/rust/pull/79135
 141 [81521]: https://github.com/rust-lang/rust/pull/81521
 142 [80968]: https://github.com/rust-lang/rust/pull/80968
 143 [80959]: https://github.com/rust-lang/rust/pull/80959
 144 [80718]: https://github.com/rust-lang/rust/pull/80718
 145 [80653]: https://github.com/rust-lang/rust/pull/80653
 146 [80579]: https://github.com/rust-lang/rust/pull/80579
 147 [79998]: https://github.com/rust-lang/rust/pull/79998
 148 [78044]: https://github.com/rust-lang/rust/pull/78044
 149 [81455]: https://github.com/rust-lang/rust/pull/81455
 150 [80764]: https://github.com/rust-lang/rust/pull/80764
 151 [80749]: https://github.com/rust-lang/rust/pull/80749
 152 [80662]: https://github.com/rust-lang/rust/pull/80662
 153 [79134]: https://github.com/rust-lang/rust/pull/79134
 154 [80966]: https://github.com/rust-lang/rust/pull/80966
 155 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
 156 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
 157 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
 158 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
 159 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
 160 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
 161 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
 162 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
 163 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
 164 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
 165 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
 166 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
 167 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
 168 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
 169 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
 170 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
 171 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
 172 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
 173 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
 174 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
 175 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
 176 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
 177 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
 178
 179 Version 1.50.0 (2021-02-11)
 180 ============================
 181
 182 Language
 183 -----------------------
 184 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
 185   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
 186 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
 187
 188 Compiler
 189 -----------------------
 190 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
 191 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
 192 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
 193 - [Dropped support for all cloudabi targets.][78439]
 194
 195 \* Refer to Rust's [platform support page][platform-support-doc] for more
 196 information on Rust's tiered platform support.
 197
 198 Libraries
 199 -----------------------
 200
 201 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
 202 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
 203 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
 204   This value cannot be a valid file descriptor, and now means `Option<File>` takes
 205   up the same amount of space as `File`.
 206
 207 Stabilized APIs
 208 ---------------
 209
 210 - [`bool::then`]
 211 - [`btree_map::Entry::or_insert_with_key`]
 212 - [`f32::clamp`]
 213 - [`f64::clamp`]
 214 - [`hash_map::Entry::or_insert_with_key`]
 215 - [`Ord::clamp`]
 216 - [`RefCell::take`]
 217 - [`slice::fill`]
 218 - [`UnsafeCell::get_mut`]
 219
 220 The following previously stable methods are now `const`.
 221
 222 - [`IpAddr::is_ipv4`]
 223 - [`IpAddr::is_ipv6`]
 224 - [`IpAddr::is_unspecified`]
 225 - [`IpAddr::is_loopback`]
 226 - [`IpAddr::is_multicast`]
 227 - [`Ipv4Addr::octets`]
 228 - [`Ipv4Addr::is_loopback`]
 229 - [`Ipv4Addr::is_private`]
 230 - [`Ipv4Addr::is_link_local`]
 231 - [`Ipv4Addr::is_multicast`]
 232 - [`Ipv4Addr::is_broadcast`]
 233 - [`Ipv4Addr::is_documentation`]
 234 - [`Ipv4Addr::to_ipv6_compatible`]
 235 - [`Ipv4Addr::to_ipv6_mapped`]
 236 - [`Ipv6Addr::segments`]
 237 - [`Ipv6Addr::is_unspecified`]
 238 - [`Ipv6Addr::is_loopback`]
 239 - [`Ipv6Addr::is_multicast`]
 240 - [`Ipv6Addr::to_ipv4`]
 241 - [`Layout::size`]
 242 - [`Layout::align`]
 243 - [`Layout::from_size_align`]
 244 - `pow` for all integer types.
 245 - `checked_pow` for all integer types.
 246 - `saturating_pow` for all integer types.
 247 - `wrapping_pow` for all integer types.
 248 - `next_power_of_two` for all unsigned integer types.
 249 - `checked_next_power_of_two` for all unsigned integer types.
 250
 251 Cargo
 252 -----------------------
 253
 254 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
 255   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
 256 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
 257   contents of that directory for changes.][cargo/8973]
 258 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
 259
 260 Misc
 261 ----
 262
 263 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
 264 - [Running tests will now print the total time taken to execute.][75752]
 265
 266 Compatibility Notes
 267 -------------------
 268
 269 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
 270   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
 271 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
 272   unhygenic `macro_rules!` macros.][79472]
 273 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
 274   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
 275 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
 276 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
 277   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
 278 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
 279
 280 [74989]: https://github.com/rust-lang/rust/pull/74989
 281 [79261]: https://github.com/rust-lang/rust/pull/79261
 282 [79896]: https://github.com/rust-lang/rust/pull/79896
 283 [79484]: https://github.com/rust-lang/rust/pull/79484
 284 [79472]: https://github.com/rust-lang/rust/pull/79472
 285 [79270]: https://github.com/rust-lang/rust/pull/79270
 286 [79003]: https://github.com/rust-lang/rust/pull/79003
 287 [78864]: https://github.com/rust-lang/rust/pull/78864
 288 [78636]: https://github.com/rust-lang/rust/pull/78636
 289 [78439]: https://github.com/rust-lang/rust/pull/78439
 290 [78343]: https://github.com/rust-lang/rust/pull/78343
 291 [78296]: https://github.com/rust-lang/rust/pull/78296
 292 [78068]: https://github.com/rust-lang/rust/pull/78068
 293 [75752]: https://github.com/rust-lang/rust/pull/75752
 294 [74699]: https://github.com/rust-lang/rust/pull/74699
 295 [78142]: https://github.com/rust-lang/rust/pull/78142
 296 [77484]: https://github.com/rust-lang/rust/pull/77484
 297 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
 298 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
 299 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
 300 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
 301 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
 302 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
 303 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
 304 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
 305 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
 306 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
 307 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
 308 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
 309 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
 310 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
 311 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
 312 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
 313 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
 314 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
 315 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
 316 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
 317 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
 318 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
 319 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
 320 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
 321 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
 322 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
 323 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
 324 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
 325 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
 326 [`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
 327 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
 328 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
 329 [`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
 330 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
 331
 332
 333 Version 1.49.0 (2020-12-31)
 334 ============================
 335
 336 Language
 337 -----------------------
 338
 339 - [Unions can now implement `Drop`, and you can now have a field in a union
 340   with `ManuallyDrop<T>`.][77547]
 341 - [You can now cast uninhabited enums to integers.][76199]
 342 - [You can now bind by reference and by move in patterns.][76119] This
 343   allows you to selectively borrow individual components of a type. E.g.
 344   ```rust
 345   #[derive(Debug)]
 346   struct Person {
 347       name: String,
 348       age: u8,
 349   }
 350
 351   let person = Person {
 352       name: String::from("Alice"),
 353       age: 20,
 354   };
 355
 356   // `name` is moved out of person, but `age` is referenced.
 357   let Person { name, ref age } = person;
 358   println!("{} {}", name, age);
 359   ```
 360
 361 Compiler
 362 -----------------------
 363
 364 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
 365 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
 366 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
 367 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
 368 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
 369 - [Output from threads spawned in tests is now captured.][78227]
 370 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
 371
 372 \* Refer to Rust's [platform support page][platform-support-doc] for more
 373 information on Rust's tiered platform support.
 374
 375 Libraries
 376 -----------------------
 377
 378 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
 379 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
 380
 381 Stabilized APIs
 382 ---------------
 383
 384 - [`slice::select_nth_unstable`]
 385 - [`slice::select_nth_unstable_by`]
 386 - [`slice::select_nth_unstable_by_key`]
 387
 388 The following previously stable methods are now `const`.
 389
 390 - [`Poll::is_ready`]
 391 - [`Poll::is_pending`]
 392
 393 Cargo
 394 -----------------------
 395 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
 396 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
 397 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
 398   variable will be set if the crate being built is one the user selected to build, either
 399   with `-p` or through defaults.
 400 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
 401
 402
 403 Compatibility Notes
 404 -------------------
 405
 406 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
 407 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
 408 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
 409   Previously such invalid or unused attributes could be ignored.
 410 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
 411   read [this post about the changes][rustdoc-ws-post] for more details.
 412 - [Trait bounds are no longer inferred for associated types.][79904]
 413
 414 Internal Only
 415 -------------
 416 These changes provide no direct user facing benefits, but represent significant
 417 improvements to the internals and overall performance of rustc and
 418 related tools.
 419
 420 - [rustc's internal crates are now compiled using the `initial-exec` Thread
 421   Local Storage model.][78201]
 422 - [Calculate visibilities once in resolve.][78077]
 423 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
 424 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
 425
 426
 427 [75991]: https://github.com/rust-lang/rust/pull/75991
 428 [78951]: https://github.com/rust-lang/rust/pull/78951
 429 [78848]: https://github.com/rust-lang/rust/pull/78848
 430 [78746]: https://github.com/rust-lang/rust/pull/78746
 431 [78376]: https://github.com/rust-lang/rust/pull/78376
 432 [78228]: https://github.com/rust-lang/rust/pull/78228
 433 [78227]: https://github.com/rust-lang/rust/pull/78227
 434 [78201]: https://github.com/rust-lang/rust/pull/78201
 435 [78109]: https://github.com/rust-lang/rust/pull/78109
 436 [78077]: https://github.com/rust-lang/rust/pull/78077
 437 [77997]: https://github.com/rust-lang/rust/pull/77997
 438 [77703]: https://github.com/rust-lang/rust/pull/77703
 439 [77547]: https://github.com/rust-lang/rust/pull/77547
 440 [77015]: https://github.com/rust-lang/rust/pull/77015
 441 [76199]: https://github.com/rust-lang/rust/pull/76199
 442 [76119]: https://github.com/rust-lang/rust/pull/76119
 443 [75914]: https://github.com/rust-lang/rust/pull/75914
 444 [79004]: https://github.com/rust-lang/rust/pull/79004
 445 [78676]: https://github.com/rust-lang/rust/pull/78676
 446 [79904]: https://github.com/rust-lang/rust/issues/79904
 447 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
 448 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
 449 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
 450 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
 451 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
 452 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
 453 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
 454 [`hint::spin_loop`]: https://doc.rust-lang.org/stable/std/hint/fn.spin_loop.html
 455 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
 456 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
 457 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
 458
 459 Version 1.48.0 (2020-11-19)
 460 ==========================
 461
 462 Language
 463 --------
 464
 465 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
 466   is still rejected *semantically*, but can now be parsed by procedural macros.
 467
 468 Compiler
 469 --------
 470 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
 471   `rustc` whether to link its own C runtime and libraries or to rely on a external
 472   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
 473 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
 474   Note: If you're using cargo you must explicitly pass the `--target` flag.
 475 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
 476
 477 \* Refer to Rust's [platform support page][platform-support-doc] for more
 478 information on Rust's tiered platform support.
 479
 480 Libraries
 481 ---------
 482 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
 483   and `&Stderr`.][76275]
 484 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
 485 - [The `matches!` macro now supports having a trailing comma.][74880]
 486 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
 487 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
 488
 489 Stabilized APIs
 490 ---------------
 491 - [`slice::as_ptr_range`]
 492 - [`slice::as_mut_ptr_range`]
 493 - [`VecDeque::make_contiguous`]
 494 - [`future::pending`]
 495 - [`future::ready`]
 496
 497 The following previously stable methods are now `const fn`'s:
 498
 499 - [`Option::is_some`]
 500 - [`Option::is_none`]
 501 - [`Option::as_ref`]
 502 - [`Result::is_ok`]
 503 - [`Result::is_err`]
 504 - [`Result::as_ref`]
 505 - [`Ordering::reverse`]
 506 - [`Ordering::then`]
 507
 508 Cargo
 509 -----
 510
 511 Rustdoc
 512 -------
 513 - [You can now link to items in `rustdoc` using the intra-doc link
 514   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
 515   a link to `std::future`'s documentation. See ["Linking to items by
 516   name"][intradoc-links] for more information.
 517 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
 518   when searching through `rustdoc`'s UI.][75740]
 519
 520 Compatibility Notes
 521 -------------------
 522 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
 523   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
 524   promoted to `'static` lifetime any more inside `const fn`s.
 525 - [Associated type bindings on trait objects are now verified to meet the bounds
 526   declared on the trait when checking that they implement the trait.][27675]
 527 - [When trait bounds on associated types or opaque types are ambiguous, the
 528   compiler no longer makes an arbitrary choice on which bound to use.][54121]
 529 - [Fixed recursive nonterminals not being expanded in macros during
 530   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
 531   correctly handling recursive nonterminal tokens.
 532 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
 533 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
 534   in places where they have no effect.][73461]
 535 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
 536   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
 537 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
 538   disallow zero-initialization.][71274]
 539 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
 540 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
 541   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
 542   see the [`catch_unwind`] documentation for further information.
 543
 544
 545
 546 Internal Only
 547 -------------
 548 These changes provide no direct user facing benefits, but represent significant
 549 improvements to the internals and overall performance of rustc and
 550 related tools.
 551
 552 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
 553   You can continue building with `make` by setting `ninja=false` in
 554   your `config.toml`.
 555 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
 556 - [Made `ensure_sufficient_stack()` non-generic][76680]
 557
 558 [78143]: https://github.com/rust-lang/rust/issues/78143
 559 [76680]: https://github.com/rust-lang/rust/pull/76680/
 560 [76030]: https://github.com/rust-lang/rust/pull/76030/
 561 [70212]: https://github.com/rust-lang/rust/pull/70212/
 562 [27675]: https://github.com/rust-lang/rust/issues/27675/
 563 [54121]: https://github.com/rust-lang/rust/issues/54121/
 564 [71274]: https://github.com/rust-lang/rust/pull/71274/
 565 [77386]: https://github.com/rust-lang/rust/pull/77386/
 566 [77153]: https://github.com/rust-lang/rust/pull/77153/
 567 [77055]: https://github.com/rust-lang/rust/pull/77055/
 568 [76275]: https://github.com/rust-lang/rust/pull/76275/
 569 [76310]: https://github.com/rust-lang/rust/pull/76310/
 570 [76420]: https://github.com/rust-lang/rust/pull/76420/
 571 [76158]: https://github.com/rust-lang/rust/pull/76158/
 572 [75857]: https://github.com/rust-lang/rust/pull/75857/
 573 [75585]: https://github.com/rust-lang/rust/pull/75585/
 574 [75740]: https://github.com/rust-lang/rust/pull/75740/
 575 [75502]: https://github.com/rust-lang/rust/pull/75502/
 576 [74880]: https://github.com/rust-lang/rust/pull/74880/
 577 [74922]: https://github.com/rust-lang/rust/pull/74922/
 578 [74430]: https://github.com/rust-lang/rust/pull/74430/
 579 [74194]: https://github.com/rust-lang/rust/pull/74194/
 580 [73461]: https://github.com/rust-lang/rust/pull/73461/
 581 [73166]: https://github.com/rust-lang/rust/pull/73166/
 582 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
 583 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
 584 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
 585 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
 586 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
 587 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
 588 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
 589 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
 590 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
 591 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
 592 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
 593 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
 594 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
 595 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
 596 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
 597
 598
 599 Version 1.47.0 (2020-10-08)
 600 ==========================
 601
 602 Language
 603 --------
 604 - [Closures will now warn when not used.][74869]
 605
 606 Compiler
 607 --------
 608 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
 609   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
 610   platforms.
 611 - [Upgraded to LLVM 11.][73526]
 612 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
 613 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
 614 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
 615
 616 \* Refer to Rust's [platform support page][platform-support-doc] for more
 617 information on Rust's tiered platform support.
 618
 619 Libraries
 620 ---------
 621 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
 622 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
 623   those of length less than 33.][74060]
 624 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
 625 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
 626   `PartialEq`, and `PartialOrd`.][73583]
 627
 628 Stabilized APIs
 629 ---------------
 630 - [`Ident::new_raw`]
 631 - [`Range::is_empty`]
 632 - [`RangeInclusive::is_empty`]
 633 - [`Result::as_deref`]
 634 - [`Result::as_deref_mut`]
 635 - [`Vec::leak`]
 636 - [`pointer::offset_from`]
 637 - [`f32::TAU`]
 638 - [`f64::TAU`]
 639
 640 The following previously stable APIs have now been made const.
 641
 642 - [The `new` method for all `NonZero` integers.][73858]
 643 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
 644   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
 645   methods for all integers.][73858]
 646 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
 647   signed integers.][73858]
 648 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
 649   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
 650   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
 651   `is_ascii_control` methods for `char` and `u8`.][73858]
 652
 653 Cargo
 654 -----
 655 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
 656   You can override this by setting the following in your `Cargo.toml`.
 657   ```toml
 658   [profile.release.build-override]
 659   opt-level = 3
 660   ```
 661 - [`cargo-help` will now display man pages for commands rather just the
 662   `--help` text.][cargo/8456]
 663 - [`cargo-metadata` now emits a `test` field indicating if a target has
 664   tests enabled.][cargo/8478]
 665 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
 666 - [`cargo-publish` will now use an alternative registry by default if it's the
 667   only registry specified in `package.publish`.][cargo/8571]
 668
 669 Misc
 670 ----
 671 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
 672   type based search.][75366]
 673 - [Added the Ayu theme to rustdoc.][71237]
 674
 675 Compatibility Notes
 676 -------------------
 677 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
 678 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
 679 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
 680   help to preserve more span information.][73084] These changes may cause
 681   compiliation errors if your macro was unhygenic or didn't correctly handle
 682   `Delimiter::None`.
 683 - [Moved support for the CloudABI target to tier 3.][75568]
 684 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
 685 - [Added the `rustc-docs` component.][75560] This allows you to install
 686   and read the documentation for the compiler internal APIs. (Currently only
 687   available for `x86_64-unknown-linux-gnu`.)
 688
 689 Internal Only
 690 --------
 691
 692 - [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.
 693
 694 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
 695 [75048]: https://github.com/rust-lang/rust/pull/75048/
 696 [74163]: https://github.com/rust-lang/rust/pull/74163/
 697 [71237]: https://github.com/rust-lang/rust/pull/71237/
 698 [74869]: https://github.com/rust-lang/rust/pull/74869/
 699 [73858]: https://github.com/rust-lang/rust/pull/73858/
 700 [75716]: https://github.com/rust-lang/rust/pull/75716/
 701 [75908]: https://github.com/rust-lang/rust/pull/75908/
 702 [75516]: https://github.com/rust-lang/rust/pull/75516/
 703 [75560]: https://github.com/rust-lang/rust/pull/75560/
 704 [75568]: https://github.com/rust-lang/rust/pull/75568/
 705 [75366]: https://github.com/rust-lang/rust/pull/75366/
 706 [75204]: https://github.com/rust-lang/rust/pull/75204/
 707 [74650]: https://github.com/rust-lang/rust/pull/74650/
 708 [74419]: https://github.com/rust-lang/rust/pull/74419/
 709 [73964]: https://github.com/rust-lang/rust/pull/73964/
 710 [74021]: https://github.com/rust-lang/rust/pull/74021/
 711 [74060]: https://github.com/rust-lang/rust/pull/74060/
 712 [73893]: https://github.com/rust-lang/rust/pull/73893/
 713 [73526]: https://github.com/rust-lang/rust/pull/73526/
 714 [73583]: https://github.com/rust-lang/rust/pull/73583/
 715 [73084]: https://github.com/rust-lang/rust/pull/73084/
 716 [73197]: https://github.com/rust-lang/rust/pull/73197/
 717 [72488]: https://github.com/rust-lang/rust/pull/72488/
 718 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
 719 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
 720 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
 721 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
 722 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
 723 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
 724 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
 725 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
 726 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
 727 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
 728 [`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
 729 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
 730 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
 731 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
 732 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
 733
 734
 735 Version 1.46.0 (2020-08-27)
 736 ==========================
 737
 738 Language
 739 --------
 740 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
 741 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
 742   const functions.][73862]
 743 - [The `#[track_caller]` attribute can now be added to functions to use the
 744   function's caller's location information for panic messages.][72445]
 745 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
 746   `x.0.0` over `(x.0).0`.
 747 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
 748   You currently can't use `mem::transmute` in constant functions.
 749
 750 Compiler
 751 --------
 752 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
 753 - [Enabled static "Position Independent Executables" by default
 754   for `x86_64-unknown-linux-musl`.][70740]
 755
 756 Libraries
 757 ---------
 758 - [`mem::forget` is now a `const fn`.][73887]
 759 - [`String` now implements `From<char>`.][73466]
 760 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
 761   integer types.][73032]
 762 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
 763 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
 764   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
 765 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
 766 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
 767 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
 768
 769 Stabilized APIs
 770 ---------------
 771 - [`Option::zip`]
 772 - [`vec::Drain::as_slice`]
 773
 774 Cargo
 775 -----
 776 Added a number of new environment variables that are now available when
 777 compiling your crate.
 778
 779 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
 780   the specific binary being compiled and the name of the crate.
 781 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
 782 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
 783
 784 Compatibility Notes
 785 -------------------
 786 - [The target configuration option `abi_blacklist` has been renamed
 787   to `unsupported_abis`.][74150] The old name will still continue to work.
 788 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
 789   This was previously accepted but will become a hard error in a future release.
 790 - [Rustc will fail to compile if you have a struct with
 791   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
 792   allowed on `enum`s.
 793 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
 794   ensure that spans have the correct information, and may cause breakage if you
 795   were relying on receiving spans with dummy information.
 796 - [The InnoSetup installer for Windows is no longer available.][72569] This was
 797   a legacy installer that was replaced by a MSI installer a few years ago but
 798   was still being built.
 799 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
 800 - [Rustc will no longer accept overlapping trait implementations that only
 801   differ in how the lifetime was bound.][72493]
 802 - [Rustc now correctly relates the lifetime of an existential associated
 803   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
 804   you to pass a shorter lifetime than expected.
 805 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
 806   The library will need to be installed for `rustc` to work, even though we
 807   expect it to be already available on most systems.
 808 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
 809   under QEMU.][74820]
 810 - [Pretty printing of some tokens in procedural macros changed.][75453] The
 811   exact output returned by rustc's pretty printing is an unstable
 812   implementation detail: we recommend any macro relying on it to switch to a
 813   more robust parsing system.
 814
 815 [75453]: https://github.com/rust-lang/rust/issues/75453/
 816 [74820]: https://github.com/rust-lang/rust/issues/74820/
 817 [74420]: https://github.com/rust-lang/rust/issues/74420/
 818 [74109]: https://github.com/rust-lang/rust/pull/74109/
 819 [74150]: https://github.com/rust-lang/rust/pull/74150/
 820 [73862]: https://github.com/rust-lang/rust/pull/73862/
 821 [73887]: https://github.com/rust-lang/rust/pull/73887/
 822 [73466]: https://github.com/rust-lang/rust/pull/73466/
 823 [73516]: https://github.com/rust-lang/rust/pull/73516/
 824 [73293]: https://github.com/rust-lang/rust/pull/73293/
 825 [73007]: https://github.com/rust-lang/rust/pull/73007/
 826 [73032]: https://github.com/rust-lang/rust/pull/73032/
 827 [72920]: https://github.com/rust-lang/rust/pull/72920/
 828 [72569]: https://github.com/rust-lang/rust/pull/72569/
 829 [72583]: https://github.com/rust-lang/rust/pull/72583/
 830 [72584]: https://github.com/rust-lang/rust/pull/72584/
 831 [72717]: https://github.com/rust-lang/rust/pull/72717/
 832 [72437]: https://github.com/rust-lang/rust/pull/72437/
 833 [72445]: https://github.com/rust-lang/rust/pull/72445/
 834 [72486]: https://github.com/rust-lang/rust/pull/72486/
 835 [72493]: https://github.com/rust-lang/rust/pull/72493/
 836 [72331]: https://github.com/rust-lang/rust/pull/72331/
 837 [71896]: https://github.com/rust-lang/rust/pull/71896/
 838 [71660]: https://github.com/rust-lang/rust/pull/71660/
 839 [71322]: https://github.com/rust-lang/rust/pull/71322/
 840 [70740]: https://github.com/rust-lang/rust/pull/70740/
 841 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
 842 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
 843 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
 844 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
 845 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
 846
 847
 848 Version 1.45.2 (2020-08-03)
 849 ==========================
 850
 851 * [Fix bindings in tuple struct patterns][74954]
 852 * [Fix track_caller integration with trait objects][74784]
 853
 854 [74954]: https://github.com/rust-lang/rust/issues/74954
 855 [74784]: https://github.com/rust-lang/rust/issues/74784
 856
 857
 858 Version 1.45.1 (2020-07-30)
 859 ==========================
 860
 861 * [Fix const propagation with references.][73613]
 862 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
 863 * [Avoid spurious implicit region bound.][74509]
 864 * [Install clippy on x.py install][74457]
 865
 866 [73613]: https://github.com/rust-lang/rust/pull/73613
 867 [73078]: https://github.com/rust-lang/rust/issues/73078
 868 [74509]: https://github.com/rust-lang/rust/pull/74509
 869 [74457]: https://github.com/rust-lang/rust/pull/74457
 870
 871
 872 Version 1.45.0 (2020-07-16)
 873 ==========================
 874
 875 Language
 876 --------
 877 - [Out of range float to int conversions using `as` has been defined as a saturating
 878   conversion.][71269] This was previously undefined behaviour, but you can use the
 879    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
 880    may be desirable in rare performance sensitive situations.
 881 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
 882   using `u64`.][70705]
 883 - [Function like procedural macros can now be used in expression, pattern, and  statement
 884   positions.][68717] This means you can now use a function-like procedural macro
 885   anywhere you can use a declarative (`macro_rules!`) macro.
 886
 887 Compiler
 888 --------
 889 - [You can now override individual target features through the `target-feature`
 890   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
 891   equivalent to `-C target-feature=+avx2,+fma`.
 892 - [Added the `force-unwind-tables` flag.][69984] This option allows
 893   rustc to always generate unwind tables regardless of panic strategy.
 894 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
 895   to include LLVM bitcode into generated `rlib`s (this is on by default).
 896 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
 897 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
 898 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
 899 - [Upgraded to LLVM 10.][67759]
 900
 901 \* Refer to Rust's [platform support page][platform-support-doc] for more
 902 information on Rust's tiered platform support.
 903
 904
 905 Libraries
 906 ---------
 907 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
 908   and `Ord`.][72239]
 909 - [`proc_macro::TokenStream` now implements `Default`.][72234]
 910 - [You can now use `char` with
 911   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
 912   a range of codepoints.][72413] E.g.
 913   you can now write the following;
 914   ```rust
 915   for ch in 'a'..='z' {
 916       print!("{}", ch);
 917   }
 918   println!();
 919   // Prints "abcdefghijklmnopqrstuvwxyz"
 920   ```
 921 - [`OsString` now implements `FromStr`.][71662]
 922 - [The `saturating_neg` method has been added to all signed integer primitive
 923   types, and the `saturating_abs` method has been added for all integer
 924   primitive types.][71886]
 925 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
 926   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
 927   or `Path`.][71447]
 928 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
 929 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
 930   integer types.][69813]
 931 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
 932   integer types.][72324]
 933 - [The `fetch_update` method has been added to all atomic integer types.][71843]
 934
 935 Stabilized APIs
 936 ---------------
 937 - [`Arc::as_ptr`]
 938 - [`BTreeMap::remove_entry`]
 939 - [`Rc::as_ptr`]
 940 - [`rc::Weak::as_ptr`]
 941 - [`rc::Weak::from_raw`]
 942 - [`rc::Weak::into_raw`]
 943 - [`str::strip_prefix`]
 944 - [`str::strip_suffix`]
 945 - [`sync::Weak::as_ptr`]
 946 - [`sync::Weak::from_raw`]
 947 - [`sync::Weak::into_raw`]
 948 - [`char::UNICODE_VERSION`]
 949 - [`Span::resolved_at`]
 950 - [`Span::located_at`]
 951 - [`Span::mixed_site`]
 952 - [`unix::process::CommandExt::arg0`]
 953
 954 Cargo
 955 -----
 956
 957 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
 958   time.][cargo/8066]
 959
 960 Misc
 961 ----
 962 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
 963   `~~outdated information~~` becomes "~~outdated information~~".
 964 - [Added an emoji to Rustdoc's deprecated API message.][72014]
 965
 966 Compatibility Notes
 967 -------------------
 968 - [Trying to self initialize a static value (that is creating a value using
 969   itself) is unsound and now causes a compile error.][71140]
 970 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
 971   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
 972 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
 973   previously undocumented and not intended for public use. Rustdoc still provides
 974   a non-zero exit code on errors.
 975 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
 976   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
 977   flags while cargo is adding `embed-bitcode` itself. The recommended way to
 978   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
 979   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
 980
 981 Internals Only
 982 --------------
 983 - [Make clippy a git subtree instead of a git submodule][70655]
 984 - [Unify the undo log of all snapshot types][69464]
 985
 986 [71848]: https://github.com/rust-lang/rust/issues/71848/
 987 [73420]: https://github.com/rust-lang/rust/issues/73420/
 988 [72324]: https://github.com/rust-lang/rust/pull/72324/
 989 [71843]: https://github.com/rust-lang/rust/pull/71843/
 990 [71886]: https://github.com/rust-lang/rust/pull/71886/
 991 [72234]: https://github.com/rust-lang/rust/pull/72234/
 992 [72239]: https://github.com/rust-lang/rust/pull/72239/
 993 [72397]: https://github.com/rust-lang/rust/pull/72397/
 994 [72413]: https://github.com/rust-lang/rust/pull/72413/
 995 [72014]: https://github.com/rust-lang/rust/pull/72014/
 996 [72062]: https://github.com/rust-lang/rust/pull/72062/
 997 [72094]: https://github.com/rust-lang/rust/pull/72094/
 998 [72133]: https://github.com/rust-lang/rust/pull/72133/
 999 [67759]: https://github.com/rust-lang/rust/pull/67759/
1000 [71900]: https://github.com/rust-lang/rust/pull/71900/
1001 [71928]: https://github.com/rust-lang/rust/pull/71928/
1002 [71662]: https://github.com/rust-lang/rust/pull/71662/
1003 [71716]: https://github.com/rust-lang/rust/pull/71716/
1004 [71447]: https://github.com/rust-lang/rust/pull/71447/
1005 [71269]: https://github.com/rust-lang/rust/pull/71269/
1006 [71095]: https://github.com/rust-lang/rust/pull/71095/
1007 [71140]: https://github.com/rust-lang/rust/pull/71140/
1008 [70655]: https://github.com/rust-lang/rust/pull/70655/
1009 [70705]: https://github.com/rust-lang/rust/pull/70705/
1010 [69984]: https://github.com/rust-lang/rust/pull/69984/
1011 [69813]: https://github.com/rust-lang/rust/pull/69813/
1012 [69464]: https://github.com/rust-lang/rust/pull/69464/
1013 [68717]: https://github.com/rust-lang/rust/pull/68717/
1014 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
1015 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
1016 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
1017 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
1018 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
1019 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
1020 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
1021 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
1022 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
1023 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
1024 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
1025 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
1026 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
1027 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
1028 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
1029 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
1030 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
1031
1032
1033 Version 1.44.1 (2020-06-18)
1034 ===========================
1035
1036 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1037 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
1038 * [Fix crashes when finding backtrace on macOS.][71397]
1039 * [Clippy applies lint levels into different files.][clippy/5356]
1040
1041 [71397]: https://github.com/rust-lang/rust/issues/71397
1042 [73078]: https://github.com/rust-lang/rust/issues/73078
1043 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
1044 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
1045
1046
1047 Version 1.44.0 (2020-06-04)
1048 ==========================
1049
1050 Language
1051 --------
1052 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
1053 - [Added the `unused_braces` lint.][70081]
1054
1055 **Syntax-only changes**
1056
1057 - [Expansion-driven outline module parsing][69838]
1058 ```rust
1059 #[cfg(FALSE)]
1060 mod foo {
1061     mod bar {
1062         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
1063     }
1064 }
1065 ```
1066
1067 These are still rejected semantically, so you will likely receive an error but
1068 these changes can be seen and parsed by macros and conditional compilation.
1069
1070 Compiler
1071 --------
1072 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
1073   Additionally when in incremental mode rustc defaults to 256 codegen units.
1074 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
1075   a panic is thrown.][67502]
1076 - [Added tier 3\* support for the `aarch64-unknown-none` and
1077   `aarch64-unknown-none-softfloat` targets.][68334]
1078 - [Added tier 3 support for `arm64-apple-tvos` and
1079   `x86_64-apple-tvos` targets.][68191]
1080
1081
1082 Libraries
1083 ---------
1084 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
1085   `vec![]` to be able to be used in `const` contexts.
1086 - [`convert::Infallible` now implements `Hash`.][70281]
1087 - [`OsString` now implements `DerefMut` and `IndexMut` returning
1088   a `&mut OsStr`.][70048]
1089 - [Unicode 13 is now supported.][69929]
1090 - [`String` now implements `From<&mut str>`.][69661]
1091 - [`IoSlice` now implements `Copy`.][69403]
1092 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
1093 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
1094 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
1095   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
1096   integer types.][69373]
1097
1098 Stabilized APIs
1099 ---------------
1100 - [`PathBuf::with_capacity`]
1101 - [`PathBuf::capacity`]
1102 - [`PathBuf::clear`]
1103 - [`PathBuf::reserve`]
1104 - [`PathBuf::reserve_exact`]
1105 - [`PathBuf::shrink_to_fit`]
1106 - [`f32::to_int_unchecked`]
1107 - [`f64::to_int_unchecked`]
1108 - [`Layout::align_to`]
1109 - [`Layout::pad_to_align`]
1110 - [`Layout::array`]
1111 - [`Layout::extend`]
1112
1113 Cargo
1114 -----
1115 - [Added the `cargo tree` command which will print a tree graph of
1116   your dependencies.][cargo/8062] E.g.
1117   ```
1118     mdbook v0.3.2 (/Users/src/rust/mdbook)
1119   ├── ammonia v3.0.0
1120   │   ├── html5ever v0.24.0
1121   │   │   ├── log v0.4.8
1122   │   │   │   └── cfg-if v0.1.9
1123   │   │   ├── mac v0.1.1
1124   │   │   └── markup5ever v0.9.0
1125   │   │       ├── log v0.4.8 (*)
1126   │   │       ├── phf v0.7.24
1127   │   │       │   └── phf_shared v0.7.24
1128   │   │       │       ├── siphasher v0.2.3
1129   │   │       │       └── unicase v1.4.2
1130   │   │       │           [build-dependencies]
1131   │   │       │           └── version_check v0.1.5
1132   ...
1133   ```
1134   You can also display dependencies on multiple versions of the same crate with
1135   `cargo tree -d` (short for `cargo tree --duplicates`).
1136
1137 Misc
1138 ----
1139 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
1140   the version in the sidebar.][69494]
1141
1142 Compatibility Notes
1143 -------------------
1144 - [Rustc now correctly generates static libraries on Windows GNU targets with
1145   the `.a` extension, rather than the previous `.lib`.][70937]
1146 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
1147 - [The `file_name` property in JSON output of macro errors now points the actual
1148   source file rather than the previous format of `<NAME macros>`.][70969]
1149   **Note:** this may not point to a file that actually exists on the user's system.
1150 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
1151 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
1152   not allow zero initialization such as `NonZeroU8`.][66059] This was
1153   previously a warning.
1154 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
1155   operator has been defined as a saturating operation.][71269] This was previously
1156   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
1157   continue using the current behaviour, which may be desirable in rare performance
1158   sensitive situations.
1159
1160 Internal Only
1161 -------------
1162 These changes provide no direct user facing benefits, but represent significant
1163 improvements to the internals and overall performance of rustc and
1164 related tools.
1165
1166 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
1167 - [Replace big JS dict with JSON parsing.][71250]
1168
1169 [69373]: https://github.com/rust-lang/rust/pull/69373/
1170 [66059]: https://github.com/rust-lang/rust/pull/66059/
1171 [68191]: https://github.com/rust-lang/rust/pull/68191/
1172 [68899]: https://github.com/rust-lang/rust/pull/68899/
1173 [71147]: https://github.com/rust-lang/rust/pull/71147/
1174 [71250]: https://github.com/rust-lang/rust/pull/71250/
1175 [70937]: https://github.com/rust-lang/rust/pull/70937/
1176 [70969]: https://github.com/rust-lang/rust/pull/70969/
1177 [70632]: https://github.com/rust-lang/rust/pull/70632/
1178 [70281]: https://github.com/rust-lang/rust/pull/70281/
1179 [70345]: https://github.com/rust-lang/rust/pull/70345/
1180 [70048]: https://github.com/rust-lang/rust/pull/70048/
1181 [70081]: https://github.com/rust-lang/rust/pull/70081/
1182 [70156]: https://github.com/rust-lang/rust/pull/70156/
1183 [71269]: https://github.com/rust-lang/rust/pull/71269/
1184 [69838]: https://github.com/rust-lang/rust/pull/69838/
1185 [69929]: https://github.com/rust-lang/rust/pull/69929/
1186 [69661]: https://github.com/rust-lang/rust/pull/69661/
1187 [69778]: https://github.com/rust-lang/rust/pull/69778/
1188 [69494]: https://github.com/rust-lang/rust/pull/69494/
1189 [69403]: https://github.com/rust-lang/rust/pull/69403/
1190 [69033]: https://github.com/rust-lang/rust/pull/69033/
1191 [68692]: https://github.com/rust-lang/rust/pull/68692/
1192 [68334]: https://github.com/rust-lang/rust/pull/68334/
1193 [67502]: https://github.com/rust-lang/rust/pull/67502/
1194 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
1195 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
1196 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
1197 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
1198 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
1199 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
1200 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
1201 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
1202 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
1203 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
1204 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
1205 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
1206 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
1207
1208
1209 Version 1.43.1 (2020-05-07)
1210 ===========================
1211
1212 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
1213 * [Fixed the stabilization of AVX-512 features.][71473]
1214 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
1215
1216 [71430]: https://github.com/rust-lang/rust/pull/71430
1217 [71473]: https://github.com/rust-lang/rust/issues/71473
1218 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
1219
1220
1221 Version 1.43.0 (2020-04-23)
1222 ==========================
1223
1224 Language
1225 --------
1226 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
1227   the type inferred correctly.][68129]
1228 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
1229
1230 **Syntax only changes**
1231 - [Allow `type Foo: Ord` syntactically.][69361]
1232 - [Fuse associated and extern items up to defaultness.][69194]
1233 - [Syntactically allow `self` in all `fn` contexts.][68764]
1234 - [Merge `fn` syntax + cleanup item parsing.][68728]
1235 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
1236   For example, you may now write:
1237   ```rust
1238   macro_rules! mac_trait {
1239       ($i:item) => {
1240           trait T { $i }
1241       }
1242   }
1243   mac_trait! {
1244       fn foo() {}
1245   }
1246   ```
1247
1248 These are still rejected *semantically*, so you will likely receive an error but
1249 these changes can be seen and parsed by macros and
1250 conditional compilation.
1251
1252
1253 Compiler
1254 --------
1255 - [You can now pass multiple lint flags to rustc to override the previous
1256   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
1257   everything in the `unused` lint group except `unused-variables` which
1258   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
1259   everything in the `unused` lint group **including** `unused-variables` since
1260   the allow flag is specified before the deny flag (and therefore overridden).
1261 - [rustc will now prefer your system MinGW libraries over its bundled libraries
1262   if they are available on `windows-gnu`.][67429]
1263 - [rustc now buffers errors/warnings printed in JSON.][69227]
1264
1265 Libraries
1266 ---------
1267 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
1268   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
1269   respectively.][69538] **Note** These conversions are only available when `N`
1270   is `0..=32`.
1271 - [You can now use associated constants on floats and integers directly, rather
1272   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
1273   `f32::NAN` with no imports.
1274 - [`u8::is_ascii` is now `const`.][68984]
1275 - [`String` now implements `AsMut<str>`.][68742]
1276 - [Added the `primitive` module to `std` and `core`.][67637] This module
1277   reexports Rust's primitive types. This is mainly useful in macros
1278   where you want avoid these types being shadowed.
1279 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
1280 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
1281
1282 Stabilized APIs
1283 ---------------
1284 - [`Once::is_completed`]
1285 - [`f32::LOG10_2`]
1286 - [`f32::LOG2_10`]
1287 - [`f64::LOG10_2`]
1288 - [`f64::LOG2_10`]
1289 - [`iter::once_with`]
1290
1291 Cargo
1292 -----
1293 - [You can now set config `[profile]`s in your `.cargo/config`, or through
1294   your environment.][cargo/7823]
1295 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
1296   executable path when running integration tests or benchmarks.][cargo/7697]
1297   `<name>` is the name of your binary as-is e.g. If you wanted the executable
1298   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
1299
1300 Misc
1301 ----
1302 - [Certain checks in the `const_err` lint were deemed unrelated to const
1303   evaluation][69185], and have been moved to the `unconditional_panic` and
1304   `arithmetic_overflow` lints.
1305
1306 Compatibility Notes
1307 -------------------
1308
1309 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
1310   has been a warning since 1.36.0.
1311 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
1312   led to some instances being accepted, and now correctly emits a hard error.
1313
1314 [69340]: https://github.com/rust-lang/rust/pull/69340
1315
1316 Internal Only
1317 -------------
1318 These changes provide no direct user facing benefits, but represent significant
1319 improvements to the internals and overall performance of `rustc` and
1320 related tools.
1321
1322 - [All components are now built with `opt-level=3` instead of `2`.][67878]
1323 - [Improved how rustc generates drop code.][67332]
1324 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
1325 - [traits: preallocate 2 Vecs of known initial size][69022]
1326 - [Avoid exponential behaviour when relating types][68772]
1327 - [Skip `Drop` terminators for enum variants without drop glue][68943]
1328 - [Improve performance of coherence checks][68966]
1329 - [Deduplicate types in the generator witness][68672]
1330 - [Invert control in struct_lint_level.][68725]
1331
1332 [67332]: https://github.com/rust-lang/rust/pull/67332/
1333 [67429]: https://github.com/rust-lang/rust/pull/67429/
1334 [67637]: https://github.com/rust-lang/rust/pull/67637/
1335 [67642]: https://github.com/rust-lang/rust/pull/67642/
1336 [67878]: https://github.com/rust-lang/rust/pull/67878/
1337 [67885]: https://github.com/rust-lang/rust/pull/67885/
1338 [68129]: https://github.com/rust-lang/rust/pull/68129/
1339 [68672]: https://github.com/rust-lang/rust/pull/68672/
1340 [68725]: https://github.com/rust-lang/rust/pull/68725/
1341 [68728]: https://github.com/rust-lang/rust/pull/68728/
1342 [68738]: https://github.com/rust-lang/rust/pull/68738/
1343 [68742]: https://github.com/rust-lang/rust/pull/68742/
1344 [68764]: https://github.com/rust-lang/rust/pull/68764/
1345 [68772]: https://github.com/rust-lang/rust/pull/68772/
1346 [68943]: https://github.com/rust-lang/rust/pull/68943/
1347 [68952]: https://github.com/rust-lang/rust/pull/68952/
1348 [68966]: https://github.com/rust-lang/rust/pull/68966/
1349 [68984]: https://github.com/rust-lang/rust/pull/68984/
1350 [69022]: https://github.com/rust-lang/rust/pull/69022/
1351 [69185]: https://github.com/rust-lang/rust/pull/69185/
1352 [69194]: https://github.com/rust-lang/rust/pull/69194/
1353 [69201]: https://github.com/rust-lang/rust/pull/69201/
1354 [69227]: https://github.com/rust-lang/rust/pull/69227/
1355 [69548]: https://github.com/rust-lang/rust/pull/69548/
1356 [69256]: https://github.com/rust-lang/rust/pull/69256/
1357 [69361]: https://github.com/rust-lang/rust/pull/69361/
1358 [69366]: https://github.com/rust-lang/rust/pull/69366/
1359 [69538]: https://github.com/rust-lang/rust/pull/69538/
1360 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
1361 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
1362 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
1363 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
1364 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
1365 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
1366 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
1367 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
1368
1369
1370 Version 1.42.0 (2020-03-12)
1371 ==========================
1372
1373 Language
1374 --------
1375 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
1376   ```rust
1377   fn foo(words: &[&str]) {
1378       match words {
1379           ["Hello", "World", "!", ..] => println!("Hello World!"),
1380           ["Foo", "Bar", ..] => println!("Baz"),
1381           rest => println!("{:?}", rest),
1382       }
1383   }
1384   ```
1385 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
1386   that you can create an enum that has the exact layout and ABI of the type
1387   it contains.
1388 - [There are some *syntax-only* changes:][67131]
1389    - `default` is syntactically allowed before items in `trait` definitions.
1390    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
1391      leave out their bodies in favor of `;`.
1392    - Bounds on associated types in `impl`s are now syntactically allowed
1393      (e.g. `type Foo: Ord;`).
1394    - `...` (the C-variadic type) may occur syntactically directly as the type of
1395       any function parameter.
1396
1397   These are still rejected *semantically*, so you will likely receive an error
1398   but these changes can be seen and parsed by procedural macros and
1399   conditional compilation.
1400
1401 Compiler
1402 --------
1403 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
1404 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
1405 - [`Option::{expect,unwrap}` and
1406    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
1407    pointing to the location where they were called, rather than
1408    `core`'s internals. ][67887]
1409
1410 \* Refer to Rust's [platform support page][platform-support-doc] for more
1411 information on Rust's tiered platform support.
1412
1413 Libraries
1414 ---------
1415 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
1416 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
1417    to implement `Sized`.][67935]
1418 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
1419 - [`Layout::new` is now `const`.][66254]
1420 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
1421
1422
1423 Stabilized APIs
1424 ---------------
1425 - [`CondVar::wait_while`]
1426 - [`CondVar::wait_timeout_while`]
1427 - [`DebugMap::key`]
1428 - [`DebugMap::value`]
1429 - [`ManuallyDrop::take`]
1430 - [`matches!`]
1431 - [`ptr::slice_from_raw_parts_mut`]
1432 - [`ptr::slice_from_raw_parts`]
1433
1434 Cargo
1435 -----
1436 - [You no longer need to include `extern crate proc_macro;` to be able to
1437   `use proc_macro;` in the `2018` edition.][cargo/7700]
1438
1439 Compatibility Notes
1440 -------------------
1441 - [`Error::description` has been deprecated, and its use will now produce a
1442   warning.][66919] It's recommended to use `Display`/`to_string` instead.
1443
1444 [68253]: https://github.com/rust-lang/rust/pull/68253/
1445 [68348]: https://github.com/rust-lang/rust/pull/68348/
1446 [67935]: https://github.com/rust-lang/rust/pull/67935/
1447 [68339]: https://github.com/rust-lang/rust/pull/68339/
1448 [68122]: https://github.com/rust-lang/rust/pull/68122/
1449 [67712]: https://github.com/rust-lang/rust/pull/67712/
1450 [67887]: https://github.com/rust-lang/rust/pull/67887/
1451 [67131]: https://github.com/rust-lang/rust/pull/67131/
1452 [67233]: https://github.com/rust-lang/rust/pull/67233/
1453 [66899]: https://github.com/rust-lang/rust/pull/66899/
1454 [66919]: https://github.com/rust-lang/rust/pull/66919/
1455 [66254]: https://github.com/rust-lang/rust/pull/66254/
1456 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
1457 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
1458 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
1459 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
1460 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
1461 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
1462 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
1463 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
1464 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
1465
1466
1467 Version 1.41.1 (2020-02-27)
1468 ===========================
1469
1470 * [Always check types of static items][69145]
1471 * [Always check lifetime bounds of `Copy` impls][69145]
1472 * [Fix miscompilation in callers of `Layout::repeat`][69225]
1473
1474 [69225]: https://github.com/rust-lang/rust/issues/69225
1475 [69145]: https://github.com/rust-lang/rust/pull/69145
1476
1477
1478 Version 1.41.0 (2020-01-30)
1479 ===========================
1480
1481 Language
1482 --------
1483
1484 - [You can now pass type parameters to foreign items when implementing
1485   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
1486 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
1487   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
1488   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
1489 - [You can now use any valid identifier in a `format_args` macro.][66847]
1490   Previously identifiers starting with an underscore were not allowed.
1491 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
1492   enum variants.][66183] These are still rejected semantically, but
1493   can be seen and parsed by procedural macros and conditional compilation.
1494
1495 Compiler
1496 --------
1497
1498 - [Rustc will now warn if you have unused loop `'label`s.][66325]
1499 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
1500 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
1501 - [You can now pass an arguments file passing the `@path` syntax
1502   to rustc.][66172] Note that the format differs somewhat from what is
1503   found in other tooling; please see [the documentation][argfile-docs] for
1504   more information.
1505 - [You can now provide `--extern` flag without a path, indicating that it is
1506   available from the search path or specified with an `-L` flag.][64882]
1507
1508 \* Refer to Rust's [platform support page][platform-support-doc] for more
1509 information on Rust's tiered platform support.
1510
1511 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
1512
1513 Libraries
1514 ---------
1515
1516 - [The `core::panic` module is now stable.][66771] It was already stable
1517   through `std`.
1518 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
1519   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
1520 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
1521
1522 Stabilized APIs
1523 ---------------
1524
1525 - [`Result::map_or`]
1526 - [`Result::map_or_else`]
1527 - [`std::rc::Weak::weak_count`]
1528 - [`std::rc::Weak::strong_count`]
1529 - [`std::sync::Weak::weak_count`]
1530 - [`std::sync::Weak::strong_count`]
1531
1532 Cargo
1533 -----
1534
1535 - [Cargo will now document all the private items for binary crates
1536   by default.][cargo/7593]
1537 - [`cargo-install` will now reinstall the package if it detects that it is out
1538   of date.][cargo/7560]
1539 - [Cargo.lock now uses a more git friendly format that should help to reduce
1540   merge conflicts.][cargo/7579]
1541 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
1542   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
1543   optimisation level to `2` for debug builds. You can also use
1544   `[profile.<profile>.build-override]` to override build scripts and
1545   their dependencies.
1546
1547 Misc
1548 ----
1549
1550 - [You can now specify `edition` in documentation code blocks to compile the block
1551   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
1552   should be compiled the 2018 edition of Rust.
1553 - [You can now provide custom themes to rustdoc with `--theme`, and check the
1554   current theme with `--check-theme`.][54733]
1555 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
1556
1557 Compatibility Notes
1558 -------------------
1559
1560 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
1561   Apple targets.][apple-32bit-drop] This means that the source code is still
1562   available to build, but the targets are no longer being tested and release
1563   binaries for those platforms will no longer be distributed by the Rust project.
1564   Please refer to the linked blog post for more information.
1565
1566 [54733]: https://github.com/rust-lang/rust/pull/54733/
1567 [61351]: https://github.com/rust-lang/rust/pull/61351/
1568 [67255]: https://github.com/rust-lang/rust/pull/67255/
1569 [66661]: https://github.com/rust-lang/rust/pull/66661/
1570 [66771]: https://github.com/rust-lang/rust/pull/66771/
1571 [66847]: https://github.com/rust-lang/rust/pull/66847/
1572 [66238]: https://github.com/rust-lang/rust/pull/66238/
1573 [66277]: https://github.com/rust-lang/rust/pull/66277/
1574 [66325]: https://github.com/rust-lang/rust/pull/66325/
1575 [66172]: https://github.com/rust-lang/rust/pull/66172/
1576 [66183]: https://github.com/rust-lang/rust/pull/66183/
1577 [65879]: https://github.com/rust-lang/rust/pull/65879/
1578 [65013]: https://github.com/rust-lang/rust/pull/65013/
1579 [64882]: https://github.com/rust-lang/rust/pull/64882/
1580 [64325]: https://github.com/rust-lang/rust/pull/64325/
1581 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
1582 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
1583 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
1584 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
1585 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
1586 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
1587 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
1588 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
1589 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
1590 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
1591 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
1592
1593 Version 1.40.0 (2019-12-19)
1594 ===========================
1595
1596 Language
1597 --------
1598 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
1599   `const` contexts.][65188] e.g.
1600
1601   ```rust
1602   pub struct Point(i32, i32);
1603
1604   const ORIGIN: Point = {
1605       let constructor = Point;
1606
1607       constructor(0, 0)
1608   };
1609   ```
1610
1611 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
1612   indicate that there may be variants or fields added in the future.][64639]
1613   For example this requires adding a wild-card branch (`_ => {}`) to any match
1614   statements on a non-exhaustive `enum`. [(RFC 2008)]
1615 - [You can now use function-like procedural macros in `extern` blocks and in
1616   type positions.][63931] e.g. `type Generated = macro!();`
1617 - [Function-like and attribute procedural macros can now emit
1618   `macro_rules!` items, so you can now have your macros generate macros.][64035]
1619 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
1620   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
1621   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
1622
1623 Compiler
1624 --------
1625 - [Added tier 3 support\* for the
1626   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
1627 - [Added tier 3 support for the
1628   `aarch64-unknown-none-softfloat` target.][64589]
1629 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
1630   `mips64el-unknown-linux-muslabi64` targets.][65843]
1631
1632 \* Refer to Rust's [platform support page][platform-support-doc] for more
1633   information on Rust's tiered platform support.
1634
1635 Libraries
1636 ---------
1637 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
1638
1639 Stabilized APIs
1640 ---------------
1641 - [`BTreeMap::get_key_value`]
1642 - [`HashMap::get_key_value`]
1643 - [`Option::as_deref_mut`]
1644 - [`Option::as_deref`]
1645 - [`Option::flatten`]
1646 - [`UdpSocket::peer_addr`]
1647 - [`f32::to_be_bytes`]
1648 - [`f32::to_le_bytes`]
1649 - [`f32::to_ne_bytes`]
1650 - [`f64::to_be_bytes`]
1651 - [`f64::to_le_bytes`]
1652 - [`f64::to_ne_bytes`]
1653 - [`f32::from_be_bytes`]
1654 - [`f32::from_le_bytes`]
1655 - [`f32::from_ne_bytes`]
1656 - [`f64::from_be_bytes`]
1657 - [`f64::from_le_bytes`]
1658 - [`f64::from_ne_bytes`]
1659 - [`mem::take`]
1660 - [`slice::repeat`]
1661 - [`todo!`]
1662
1663 Cargo
1664 -----
1665 - [Cargo will now always display warnings, rather than only on
1666   fresh builds.][cargo/7450]
1667 - [Feature flags (except `--all-features`) passed to a virtual workspace will
1668   now produce an error.][cargo/7507] Previously these flags were ignored.
1669 - [You can now publish `dev-dependencies` without including
1670   a `version`.][cargo/7333]
1671
1672 Misc
1673 ----
1674 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
1675   when running documentation tests with `rustdoc`.][63803]
1676
1677 Compatibility Notes
1678 -------------------
1679 - [As previously announced, any previous NLL warnings in the 2015 edition are
1680   now hard errors.][64221]
1681 - [The `include!` macro will now warn if it failed to include the
1682   entire file.][64284] The `include!` macro unintentionally only includes the
1683   first _expression_ in a file, and this can be unintuitive. This will become
1684   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
1685 - [Using `#[inline]` on function prototypes and consts now emits a warning under
1686   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
1687   or `extern` blocks now correctly emits a hard error.
1688
1689 [65294]: https://github.com/rust-lang/rust/pull/65294/
1690 [66103]: https://github.com/rust-lang/rust/pull/66103/
1691 [65843]: https://github.com/rust-lang/rust/pull/65843/
1692 [65188]: https://github.com/rust-lang/rust/pull/65188/
1693 [65092]: https://github.com/rust-lang/rust/pull/65092/
1694 [64589]: https://github.com/rust-lang/rust/pull/64589/
1695 [64639]: https://github.com/rust-lang/rust/pull/64639/
1696 [64221]: https://github.com/rust-lang/rust/pull/64221/
1697 [64284]: https://github.com/rust-lang/rust/pull/64284/
1698 [63931]: https://github.com/rust-lang/rust/pull/63931/
1699 [64035]: https://github.com/rust-lang/rust/pull/64035/
1700 [63674]: https://github.com/rust-lang/rust/pull/63674/
1701 [63803]: https://github.com/rust-lang/rust/pull/63803/
1702 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
1703 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
1704 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
1705 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
1706 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
1707 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
1708 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
1709 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
1710 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
1711 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
1712 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
1713 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
1714 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
1715 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
1716 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
1717 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
1718 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
1719 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
1720 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
1721 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
1722 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
1723 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
1724 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
1725 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
1726 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
1727 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
1728
1729
1730 Version 1.39.0 (2019-11-07)
1731 ===========================
1732
1733 Language
1734 --------
1735 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
1736   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
1737 - [You can now use certain attributes on function, closure, and function pointer
1738   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
1739   `deny`, `forbid` as well as inert helper attributes used by procedural macro
1740   attributes applied to items. e.g.
1741   ```rust
1742   fn len(
1743       #[cfg(windows)] slice: &[u16],
1744       #[cfg(not(windows))] slice: &[u8],
1745   ) -> usize {
1746       slice.len()
1747   }
1748   ```
1749 - [You can now take shared references to bind-by-move patterns in the `if` guards
1750   of `match` arms.][63118] e.g.
1751   ```rust
1752   fn main() {
1753       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
1754
1755       match array {
1756           nums
1757   //      ---- `nums` is bound by move.
1758               if nums.iter().sum::<u8>() == 10
1759   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
1760           => {
1761               drop(nums);
1762   //          ----------- Legal as `nums` was bound by move and so we have ownership.
1763           }
1764           _ => unreachable!(),
1765       }
1766   }
1767   ```
1768
1769
1770
1771 Compiler
1772 --------
1773 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
1774 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
1775 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
1776   **Note** Cargo currently doesn't use this feature. Refer to
1777   [cargo#7315][cargo/7315] to track this feature's progress.
1778 - [You can now pass `--show-output` argument to test binaries to print the
1779   output of successful tests.][62600]
1780
1781
1782 \* Refer to Rust's [platform support page][platform-support-doc] for more
1783 information on Rust's tiered platform support.
1784
1785 Libraries
1786 ---------
1787 - [`Vec::new` and `String::new` are now `const` functions.][64028]
1788 - [`LinkedList::new` is now a `const` function.][63684]
1789 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
1790 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
1791   now `const`.][63786]
1792
1793 Stabilized APIs
1794 ---------------
1795 - [`Pin::into_inner`]
1796 - [`Instant::checked_duration_since`]
1797 - [`Instant::saturating_duration_since`]
1798
1799 Cargo
1800 -----
1801 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
1802 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
1803   `--all` is now deprecated.
1804
1805 Misc
1806 ----
1807 - [You can now pass `-Clinker` to rustdoc to control the linker used
1808   for compiling doctests.][63834]
1809
1810 Compatibility Notes
1811 -------------------
1812 - [Code that was previously accepted by the old borrow checker, but rejected by
1813   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
1814   previously a warning, and will also become a hard error in the Rust 2015
1815   edition in the 1.40.0 release.
1816 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
1817   run tests.][63827] This should improve performance when running a large
1818   amount of doctests.
1819 - [The `try!` macro will now issue a deprecation warning.][62672] It is
1820   recommended to use the `?` operator instead.
1821 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
1822   returned `0.0`.
1823
1824 [62600]: https://github.com/rust-lang/rust/pull/62600/
1825 [62672]: https://github.com/rust-lang/rust/pull/62672/
1826 [63118]: https://github.com/rust-lang/rust/pull/63118/
1827 [63209]: https://github.com/rust-lang/rust/pull/63209/
1828 [63402]: https://github.com/rust-lang/rust/pull/63402/
1829 [63565]: https://github.com/rust-lang/rust/pull/63565/
1830 [63595]: https://github.com/rust-lang/rust/pull/63595/
1831 [63684]: https://github.com/rust-lang/rust/pull/63684/
1832 [63698]: https://github.com/rust-lang/rust/pull/63698/
1833 [63770]: https://github.com/rust-lang/rust/pull/63770/
1834 [63786]: https://github.com/rust-lang/rust/pull/63786/
1835 [63827]: https://github.com/rust-lang/rust/pull/63827/
1836 [63834]: https://github.com/rust-lang/rust/pull/63834/
1837 [63927]: https://github.com/rust-lang/rust/pull/63927/
1838 [63933]: https://github.com/rust-lang/rust/pull/63933/
1839 [63934]: https://github.com/rust-lang/rust/pull/63934/
1840 [63938]: https://github.com/rust-lang/rust/pull/63938/
1841 [63940]: https://github.com/rust-lang/rust/pull/63940/
1842 [63941]: https://github.com/rust-lang/rust/pull/63941/
1843 [63945]: https://github.com/rust-lang/rust/pull/63945/
1844 [64010]: https://github.com/rust-lang/rust/pull/64010/
1845 [64028]: https://github.com/rust-lang/rust/pull/64028/
1846 [64334]: https://github.com/rust-lang/rust/pull/64334/
1847 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
1848 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
1849 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
1850 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
1851 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
1852 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
1853
1854 Version 1.38.0 (2019-09-26)
1855 ==========================
1856
1857 Language
1858 --------
1859 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
1860 - [The `#[deprecated]` attribute can now be used on macros.][62042]
1861
1862 Compiler
1863 --------
1864 - [Added pipelined compilation support to `rustc`.][62766] This will
1865   improve compilation times in some cases. For further information please refer
1866   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
1867 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
1868   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
1869   `x86_64-uwp-windows-msvc` targets.][60260]
1870 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
1871   `armv7-unknown-linux-musleabi` targets.][63107]
1872 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
1873 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
1874 - [Upgraded to LLVM 9.][62592]
1875
1876 \* Refer to Rust's [platform support page][platform-support-doc] for more
1877 information on Rust's tiered platform support.
1878
1879 Libraries
1880 ---------
1881 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
1882 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
1883   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
1884   is available at `std::clone::Clone`). This also makes all built-in macros
1885   available in `std`/`core` root. e.g. `std::include_bytes!`.
1886 - [`str::Chars` now implements `Debug`.][63000]
1887 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
1888 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
1889 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
1890 - [Added euclidean remainder and division operations (`div_euclid`,
1891   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
1892   `overflowing`, and `wrapping` versions are available for all
1893   integer primitives.
1894 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
1895   `PartialEq`.][61491]
1896 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
1897
1898 Stabilized APIs
1899 ---------------
1900 - [`<*const T>::cast`]
1901 - [`<*mut T>::cast`]
1902 - [`Duration::as_secs_f32`]
1903 - [`Duration::as_secs_f64`]
1904 - [`Duration::div_f32`]
1905 - [`Duration::div_f64`]
1906 - [`Duration::from_secs_f32`]
1907 - [`Duration::from_secs_f64`]
1908 - [`Duration::mul_f32`]
1909 - [`Duration::mul_f64`]
1910 - [`any::type_name`]
1911
1912 Cargo
1913 -----
1914 - [Added pipelined compilation support to `cargo`.][cargo/7143]
1915 - [You can now pass the `--features` option multiple times to enable
1916   multiple features.][cargo/7084]
1917
1918 Rustdoc
1919 -------
1920
1921 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
1922
1923 Misc
1924 ----
1925 - [`rustc` will now warn about some incorrect uses of
1926   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
1927
1928 Compatibility Notes
1929 -------------------
1930 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
1931   1.38.0.
1932 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
1933   issues][62896] with certain crates such as libc.
1934
1935 [60260]: https://github.com/rust-lang/rust/pull/60260/
1936 [61457]: https://github.com/rust-lang/rust/pull/61457/
1937 [61491]: https://github.com/rust-lang/rust/pull/61491/
1938 [61884]: https://github.com/rust-lang/rust/pull/61884/
1939 [61953]: https://github.com/rust-lang/rust/pull/61953/
1940 [62042]: https://github.com/rust-lang/rust/pull/62042/
1941 [62528]: https://github.com/rust-lang/rust/pull/62528/
1942 [62583]: https://github.com/rust-lang/rust/pull/62583/
1943 [62735]: https://github.com/rust-lang/rust/pull/62735/
1944 [62766]: https://github.com/rust-lang/rust/pull/62766/
1945 [62784]: https://github.com/rust-lang/rust/pull/62784/
1946 [62592]: https://github.com/rust-lang/rust/pull/62592/
1947 [62785]: https://github.com/rust-lang/rust/issues/62785/
1948 [62814]: https://github.com/rust-lang/rust/pull/62814/
1949 [62896]: https://github.com/rust-lang/rust/issues/62896/
1950 [63000]: https://github.com/rust-lang/rust/pull/63000/
1951 [63056]: https://github.com/rust-lang/rust/pull/63056/
1952 [63107]: https://github.com/rust-lang/rust/pull/63107/
1953 [63346]: https://github.com/rust-lang/rust/pull/63346/
1954 [63421]: https://github.com/rust-lang/rust/pull/63421/
1955 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
1956 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
1957 [63048]: https://github.com/rust-lang/rust/pull/63048
1958 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
1959 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
1960 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
1961 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
1962 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
1963 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
1964 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
1965 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
1966 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
1967 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
1968 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
1969 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
1970 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
1971
1972 Version 1.37.0 (2019-08-15)
1973 ==========================
1974
1975 Language
1976 --------
1977 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
1978   [`Box`][62228], or an [array][62235] and unused.
1979 - [You can now use the `cfg` and `cfg_attr` attributes on
1980   generic parameters.][61547]
1981 - [You can now use enum variants through type alias.][61682] e.g. You can
1982   write the following:
1983   ```rust
1984   type MyOption = Option<u8>;
1985
1986   fn increment_or_zero(x: MyOption) -> u8 {
1987       match x {
1988           MyOption::Some(y) => y + 1,
1989           MyOption::None => 0,
1990       }
1991   }
1992   ```
1993 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
1994   `const _: u32 = 5;`.
1995 - [You can now use `#[repr(align(X)]` on enums.][61229]
1996 - [The  `?` Kleene macro operator is now available in the
1997   2015 edition.][60932]
1998
1999 Compiler
2000 --------
2001 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
2002   and `-C profile-use` flags.][61268] For more information on how to use profile
2003   guided optimization, please refer to the [rustc book][rustc-book-pgo].
2004 - [The `rust-lldb` wrapper script should now work again.][61827]
2005
2006 Libraries
2007 ---------
2008 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
2009
2010 Stabilized APIs
2011 ---------------
2012 - [`BufReader::buffer`]
2013 - [`BufWriter::buffer`]
2014 - [`Cell::from_mut`]
2015 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
2016 - [`DoubleEndedIterator::nth_back`]
2017 - [`Option::xor`]
2018 - [`Wrapping::reverse_bits`]
2019 - [`i128::reverse_bits`]
2020 - [`i16::reverse_bits`]
2021 - [`i32::reverse_bits`]
2022 - [`i64::reverse_bits`]
2023 - [`i8::reverse_bits`]
2024 - [`isize::reverse_bits`]
2025 - [`slice::copy_within`]
2026 - [`u128::reverse_bits`]
2027 - [`u16::reverse_bits`]
2028 - [`u32::reverse_bits`]
2029 - [`u64::reverse_bits`]
2030 - [`u8::reverse_bits`]
2031 - [`usize::reverse_bits`]
2032
2033 Cargo
2034 -----
2035 - [`Cargo.lock` files are now included by default when publishing executable crates
2036   with executables.][cargo/7026]
2037 - [You can now specify `default-run="foo"` in `[package]` to specify the
2038   default executable to use for `cargo run`.][cargo/7056]
2039
2040 Misc
2041 ----
2042
2043 Compatibility Notes
2044 -------------------
2045 - [Using `...` for inclusive range patterns will now warn by default.][61342]
2046   Please transition your code to using the `..=` syntax for inclusive
2047   ranges instead.
2048 - [Using a trait object without the `dyn` will now warn by default.][61203]
2049   Please transition your code to use `dyn Trait` for trait objects instead.
2050
2051 [62228]: https://github.com/rust-lang/rust/pull/62228/
2052 [62235]: https://github.com/rust-lang/rust/pull/62235/
2053 [61802]: https://github.com/rust-lang/rust/pull/61802/
2054 [61827]: https://github.com/rust-lang/rust/pull/61827/
2055 [61547]: https://github.com/rust-lang/rust/pull/61547/
2056 [61682]: https://github.com/rust-lang/rust/pull/61682/
2057 [61268]: https://github.com/rust-lang/rust/pull/61268/
2058 [61342]: https://github.com/rust-lang/rust/pull/61342/
2059 [61347]: https://github.com/rust-lang/rust/pull/61347/
2060 [61100]: https://github.com/rust-lang/rust/pull/61100/
2061 [61203]: https://github.com/rust-lang/rust/pull/61203/
2062 [61229]: https://github.com/rust-lang/rust/pull/61229/
2063 [60932]: https://github.com/rust-lang/rust/pull/60932/
2064 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
2065 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
2066 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
2067 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
2068 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
2069 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
2070 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
2071 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
2072 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
2073 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
2074 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
2075 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
2076 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
2077 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
2078 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
2079 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
2080 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
2081 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
2082 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
2083 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
2084 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
2085 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
2086 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
2087 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
2088
2089
2090 Version 1.36.0 (2019-07-04)
2091 ==========================
2092
2093 Language
2094 --------
2095 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
2096 - [The order of traits in trait objects no longer affects the semantics of that
2097   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
2098   `dyn fmt::Debug + Send`, where this was previously not the case.
2099
2100 Libraries
2101 ---------
2102 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
2103 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
2104 - [`mem::needs_drop` is now available as a const fn.][60364]
2105 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
2106 - [`String` now implements `BorrowMut<str>`.][60404]
2107 - [`io::Cursor` now implements `Default`.][60234]
2108 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
2109 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
2110   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
2111   environment has access to heap memory allocation.
2112 - [`String` now implements `From<&String>`.][59825]
2113 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
2114   return a tuple of each argument when there is multiple arguments.
2115 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
2116   not used.][59648]
2117
2118 Stabilized APIs
2119 ---------------
2120 - [`VecDeque::rotate_left`]
2121 - [`VecDeque::rotate_right`]
2122 - [`Iterator::copied`]
2123 - [`io::IoSlice`]
2124 - [`io::IoSliceMut`]
2125 - [`Read::read_vectored`]
2126 - [`Write::write_vectored`]
2127 - [`str::as_mut_ptr`]
2128 - [`mem::MaybeUninit`]
2129 - [`pointer::align_offset`]
2130 - [`future::Future`]
2131 - [`task::Context`]
2132 - [`task::RawWaker`]
2133 - [`task::RawWakerVTable`]
2134 - [`task::Waker`]
2135 - [`task::Poll`]
2136
2137 Cargo
2138 -----
2139 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
2140 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
2141
2142 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
2143
2144 Clippy
2145 ------
2146 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
2147
2148 Misc
2149 ----
2150
2151 Compatibility Notes
2152 -------------------
2153 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
2154   longer recommended, and will be deprecated in 1.39.0.
2155
2156 [60318]: https://github.com/rust-lang/rust/pull/60318/
2157 [60364]: https://github.com/rust-lang/rust/pull/60364/
2158 [60370]: https://github.com/rust-lang/rust/pull/60370/
2159 [60404]: https://github.com/rust-lang/rust/pull/60404/
2160 [60234]: https://github.com/rust-lang/rust/pull/60234/
2161 [60244]: https://github.com/rust-lang/rust/pull/60244/
2162 [58623]: https://github.com/rust-lang/rust/pull/58623/
2163 [59648]: https://github.com/rust-lang/rust/pull/59648/
2164 [59675]: https://github.com/rust-lang/rust/pull/59675/
2165 [59825]: https://github.com/rust-lang/rust/pull/59825/
2166 [59826]: https://github.com/rust-lang/rust/pull/59826/
2167 [59445]: https://github.com/rust-lang/rust/pull/59445/
2168 [59114]: https://github.com/rust-lang/rust/pull/59114/
2169 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
2170 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
2171 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
2172 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
2173 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
2174 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
2175 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
2176 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
2177 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
2178 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
2179 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
2180 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
2181 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
2182 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
2183 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
2184 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
2185 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
2186 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
2187 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
2188 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
2189
2190
2191 Version 1.35.0 (2019-05-23)
2192 ==========================
2193
2194 Language
2195 --------
2196 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
2197   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
2198 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
2199   ```rust
2200   unsafe fn call_unsafe(func: unsafe fn()) {
2201       func()
2202   }
2203
2204   pub fn main() {
2205       unsafe { call_unsafe(|| {}); }
2206   }
2207   ```
2208
2209
2210 Compiler
2211 --------
2212 - [Added the `armv6-unknown-freebsd-gnueabihf` and
2213   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
2214 - [Added the `wasm32-unknown-wasi` target.][59464]
2215
2216
2217 Libraries
2218 ---------
2219 - [`Thread` will now show its ID in `Debug` output.][59460]
2220 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
2221 - [`alloc::System` now implements `Default`.][59451]
2222 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
2223   last field.][59076]
2224 - [`char::{ToLowercase, ToUppercase}` now
2225   implement `ExactSizeIterator`.][58778]
2226 - [All `NonZero` numeric types now implement `FromStr`.][58717]
2227 - [Removed the `Read` trait bounds
2228   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
2229 - [You can now call the `dbg!` macro without any parameters to print the file
2230   and line where it is called.][57847]
2231 - [In place ASCII case conversions are now up to 4× faster.][59283]
2232   e.g. `str::make_ascii_lowercase`
2233 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
2234   and `Send`.][58369]
2235
2236 Stabilized APIs
2237 ---------------
2238 - [`f32::copysign`]
2239 - [`f64::copysign`]
2240 - [`RefCell::replace_with`]
2241 - [`RefCell::map_split`]
2242 - [`ptr::hash`]
2243 - [`Range::contains`]
2244 - [`RangeFrom::contains`]
2245 - [`RangeTo::contains`]
2246 - [`RangeInclusive::contains`]
2247 - [`RangeToInclusive::contains`]
2248 - [`Option::copied`]
2249
2250 Cargo
2251 -----
2252 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
2253   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
2254   platform specific.
2255
2256 Misc
2257 ----
2258 - [The Rust toolchain is now available natively for musl based distros.][58575]
2259
2260 [59460]: https://github.com/rust-lang/rust/pull/59460/
2261 [59464]: https://github.com/rust-lang/rust/pull/59464/
2262 [59500]: https://github.com/rust-lang/rust/pull/59500/
2263 [59512]: https://github.com/rust-lang/rust/pull/59512/
2264 [59580]: https://github.com/rust-lang/rust/pull/59580/
2265 [59283]: https://github.com/rust-lang/rust/pull/59283/
2266 [59451]: https://github.com/rust-lang/rust/pull/59451/
2267 [59076]: https://github.com/rust-lang/rust/pull/59076/
2268 [58778]: https://github.com/rust-lang/rust/pull/58778/
2269 [58717]: https://github.com/rust-lang/rust/pull/58717/
2270 [58369]: https://github.com/rust-lang/rust/pull/58369/
2271 [58423]: https://github.com/rust-lang/rust/pull/58423/
2272 [58080]: https://github.com/rust-lang/rust/pull/58080/
2273 [57847]: https://github.com/rust-lang/rust/pull/57847/
2274 [58575]: https://github.com/rust-lang/rust/pull/58575
2275 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
2276 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
2277 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
2278 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
2279 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
2280 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
2281 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
2282 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
2283 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
2284 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
2285 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
2286 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
2287
2288 Version 1.34.2 (2019-05-14)
2289 ===========================
2290
2291 * [Destabilize the `Error::type_id` function due to a security
2292    vulnerability][60785] ([CVE-2019-12083])
2293
2294 [60785]: https://github.com/rust-lang/rust/pull/60785
2295 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
2296
2297 Version 1.34.1 (2019-04-25)
2298 ===========================
2299
2300 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
2301 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
2302 * [Fix Clippy panic when checking some macros][clippy/3805]
2303
2304 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
2305 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
2306 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
2307
2308 Version 1.34.0 (2019-04-11)
2309 ==========================
2310
2311 Language
2312 --------
2313 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
2314   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
2315   but had no effect.
2316 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
2317   `#[attr{}]` procedural macros.][57367]
2318 - [You can now write `extern crate self as foo;`][57407] to import your
2319   crate's root into the extern prelude.
2320
2321
2322 Compiler
2323 --------
2324 - [You can now target `riscv64imac-unknown-none-elf` and
2325   `riscv64gc-unknown-none-elf`.][58406]
2326 - [You can now enable linker plugin LTO optimisations with
2327   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
2328   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
2329   boundaries.
2330 - [You can now target `powerpc64-unknown-freebsd`.][57809]
2331
2332
2333 Libraries
2334 ---------
2335 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
2336   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
2337   the `Hash` trait to create an iterator.
2338 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
2339   methods.][58421] Most notably you no longer require the `Ord` trait to create
2340   an iterator.
2341 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
2342   for all numeric types.][58044]
2343 - [Indexing a `str` is now generic over all types that
2344   implement `SliceIndex<str>`.][57604]
2345 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
2346   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
2347   produce a warning if their returning type is unused.
2348 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
2349   `overflowing_pow` are now available for all numeric types.][57873] These are
2350   equivalent to methods such as `wrapping_add` for the `pow` operation.
2351
2352
2353 Stabilized APIs
2354 ---------------
2355
2356 #### std & core
2357 * [`Any::type_id`]
2358 * [`Error::type_id`]
2359 * [`atomic::AtomicI16`]
2360 * [`atomic::AtomicI32`]
2361 * [`atomic::AtomicI64`]
2362 * [`atomic::AtomicI8`]
2363 * [`atomic::AtomicU16`]
2364 * [`atomic::AtomicU32`]
2365 * [`atomic::AtomicU64`]
2366 * [`atomic::AtomicU8`]
2367 * [`convert::Infallible`]
2368 * [`convert::TryFrom`]
2369 * [`convert::TryInto`]
2370 * [`iter::from_fn`]
2371 * [`iter::successors`]
2372 * [`num::NonZeroI128`]
2373 * [`num::NonZeroI16`]
2374 * [`num::NonZeroI32`]
2375 * [`num::NonZeroI64`]
2376 * [`num::NonZeroI8`]
2377 * [`num::NonZeroIsize`]
2378 * [`slice::sort_by_cached_key`]
2379 * [`str::escape_debug`]
2380 * [`str::escape_default`]
2381 * [`str::escape_unicode`]
2382 * [`str::split_ascii_whitespace`]
2383
2384 #### std
2385 * [`Instant::checked_add`]
2386 * [`Instant::checked_sub`]
2387 * [`SystemTime::checked_add`]
2388 * [`SystemTime::checked_sub`]
2389
2390 Cargo
2391 -----
2392 - [You can now use alternative registries to crates.io.][cargo/6654]
2393
2394 Misc
2395 ----
2396 - [You can now use the `?` operator in your documentation tests without manually
2397   adding `fn main() -> Result<(), _> {}`.][56470]
2398
2399 Compatibility Notes
2400 -------------------
2401 - [`Command::before_exec` is being replaced by the unsafe method
2402   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
2403 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
2404   can now use `const` functions in `static` variables.
2405
2406 [58370]: https://github.com/rust-lang/rust/pull/58370/
2407 [58406]: https://github.com/rust-lang/rust/pull/58406/
2408 [58421]: https://github.com/rust-lang/rust/pull/58421/
2409 [58166]: https://github.com/rust-lang/rust/pull/58166/
2410 [58044]: https://github.com/rust-lang/rust/pull/58044/
2411 [58057]: https://github.com/rust-lang/rust/pull/58057/
2412 [58059]: https://github.com/rust-lang/rust/pull/58059/
2413 [57809]: https://github.com/rust-lang/rust/pull/57809/
2414 [57873]: https://github.com/rust-lang/rust/pull/57873/
2415 [57604]: https://github.com/rust-lang/rust/pull/57604/
2416 [57367]: https://github.com/rust-lang/rust/pull/57367/
2417 [57407]: https://github.com/rust-lang/rust/pull/57407/
2418 [57425]: https://github.com/rust-lang/rust/pull/57425/
2419 [57106]: https://github.com/rust-lang/rust/pull/57106/
2420 [56470]: https://github.com/rust-lang/rust/pull/56470/
2421 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
2422 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
2423 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
2424 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
2425 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
2426 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
2427 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
2428 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
2429 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
2430 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
2431 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
2432 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
2433 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
2434 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
2435 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
2436 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
2437 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
2438 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
2439 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
2440 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
2441 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
2442 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
2443 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
2444 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
2445 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
2446 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
2447 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
2448 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
2449 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
2450 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
2451 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
2452
2453
2454 Version 1.33.0 (2019-02-28)
2455 ==========================
2456
2457 Language
2458 --------
2459 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
2460   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
2461 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
2462   E.g. You can have match statement on a `u8` that covers `0..=255` and
2463   you would no longer be required to have a `_ => unreachable!()` case.
2464 - [You can now have multiple patterns in `if let` and `while let`
2465   expressions.][57532] You can do this with the same syntax as a `match`
2466   expression. E.g.
2467   ```rust
2468   enum Creature {
2469       Crab(String),
2470       Lobster(String),
2471       Person(String),
2472   }
2473
2474   fn main() {
2475       let state = Creature::Crab("Ferris");
2476
2477       if let Creature::Crab(name) | Creature::Person(name) = state {
2478           println!("This creature's name is: {}", name);
2479       }
2480   }
2481   ```
2482 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
2483   this feature will by default produce a warning as this behaviour can be
2484   unintuitive. E.g. `if let _ = 5 {}`
2485 - [You can now use `let` bindings, assignments, expression statements,
2486   and irrefutable pattern destructuring in const functions.][57175]
2487 - [You can now call unsafe const functions.][57067] E.g.
2488   ```rust
2489   const unsafe fn foo() -> i32 { 5 }
2490   const fn bar() -> i32 {
2491       unsafe { foo() }
2492   }
2493   ```
2494 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
2495   E.g. `#[cfg_attr(all(), must_use, optimize)]`
2496 - [You can now specify a specific alignment with the `#[repr(packed)]`
2497   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
2498   with an alignment of 2 bytes and a size of 6 bytes.
2499 - [You can now import an item from a module as an `_`.][56303] This allows you to
2500   import a trait's impls, and not have the name in the namespace. E.g.
2501   ```rust
2502   use std::io::Read as _;
2503
2504   // Allowed as there is only one `Read` in the module.
2505   pub trait Read {}
2506   ```
2507 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
2508
2509 Compiler
2510 --------
2511 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
2512   command line argument.][56351]
2513 - [The minimum required LLVM version has been bumped to 6.0.][56642]
2514 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
2515 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
2516   tier 2 support.][57130] Visit the [platform support][platform-support] page for
2517   information on Rust's platform support.
2518 - [Added support for the `thumbv7neon-linux-androideabi` and
2519   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
2520 - [Added support for the `x86_64-unknown-uefi` target.][56769]
2521
2522 Libraries
2523 ---------
2524 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
2525   functions for all numeric types.][57566]
2526 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
2527   are now `const` functions for all numeric types.][57105]
2528 - [The methods `is_positive` and `is_negative` are now `const` functions for
2529   all signed numeric types.][57105]
2530 - [The `get` method for all `NonZero` types is now `const`.][57167]
2531 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
2532   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
2533   numeric types.][57234]
2534 - [`Ipv4Addr::new` is now a `const` function][57234]
2535
2536 Stabilized APIs
2537 ---------------
2538 - [`unix::FileExt::read_exact_at`]
2539 - [`unix::FileExt::write_all_at`]
2540 - [`Option::transpose`]
2541 - [`Result::transpose`]
2542 - [`convert::identity`]
2543 - [`pin::Pin`]
2544 - [`marker::Unpin`]
2545 - [`marker::PhantomPinned`]
2546 - [`Vec::resize_with`]
2547 - [`VecDeque::resize_with`]
2548 - [`Duration::as_millis`]
2549 - [`Duration::as_micros`]
2550 - [`Duration::as_nanos`]
2551
2552
2553 Cargo
2554 -----
2555 - [You can now publish crates that require a feature flag to compile with
2556   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
2557 - [Cargo should now rebuild a crate if a file was modified during the initial
2558   build.][cargo/6484]
2559
2560 Compatibility Notes
2561 -------------------
2562 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
2563   are now deprecated in the standard library, and their usage will now produce a warning.
2564   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
2565   methods instead.
2566 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
2567   downcasting.
2568 - [Libtest no longer creates a new thread for each test when
2569   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
2570
2571 [55982]: https://github.com/rust-lang/rust/pull/55982/
2572 [56243]: https://github.com/rust-lang/rust/pull/56243
2573 [56303]: https://github.com/rust-lang/rust/pull/56303/
2574 [56351]: https://github.com/rust-lang/rust/pull/56351/
2575 [56362]: https://github.com/rust-lang/rust/pull/56362
2576 [56642]: https://github.com/rust-lang/rust/pull/56642/
2577 [56769]: https://github.com/rust-lang/rust/pull/56769/
2578 [56805]: https://github.com/rust-lang/rust/pull/56805
2579 [56947]: https://github.com/rust-lang/rust/pull/56947/
2580 [57049]: https://github.com/rust-lang/rust/pull/57049/
2581 [57067]: https://github.com/rust-lang/rust/pull/57067/
2582 [57105]: https://github.com/rust-lang/rust/pull/57105
2583 [57130]: https://github.com/rust-lang/rust/pull/57130/
2584 [57167]: https://github.com/rust-lang/rust/pull/57167/
2585 [57175]: https://github.com/rust-lang/rust/pull/57175/
2586 [57234]: https://github.com/rust-lang/rust/pull/57234/
2587 [57332]: https://github.com/rust-lang/rust/pull/57332/
2588 [57465]: https://github.com/rust-lang/rust/pull/57465/
2589 [57532]: https://github.com/rust-lang/rust/pull/57532/
2590 [57535]: https://github.com/rust-lang/rust/pull/57535/
2591 [57566]: https://github.com/rust-lang/rust/pull/57566/
2592 [57615]: https://github.com/rust-lang/rust/pull/57615/
2593 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
2594 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
2595 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
2596 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
2597 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
2598 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
2599 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
2600 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
2601 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
2602 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
2603 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
2604 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
2605 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
2606 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
2607 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
2608 [platform-support]: https://forge.rust-lang.org/platform-support.html
2609
2610 Version 1.32.0 (2019-01-17)
2611 ==========================
2612
2613 Language
2614 --------
2615 #### 2018 edition
2616 - [You can now use the `?` operator in macro definitions.][56245] The `?`
2617   operator allows you to specify zero or one repetitions similar to the `*` and
2618   `+` operators.
2619 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
2620   now always resolve to the item (`enum`, `struct`, etc.) available in the
2621   module if present, before resolving to a external crate or an item the prelude.][56759]
2622   E.g.
2623   ```rust
2624   enum Color { Red, Green, Blue }
2625
2626   use Color::*;
2627   ```
2628
2629 #### All editions
2630 - [You can now match against `PhantomData<T>` types.][55837]
2631 - [You can now match against literals in macros with the `literal`
2632   specifier.][56072] This will match against a literal of any type.
2633   E.g. `1`, `'A'`, `"Hello World"`
2634 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
2635   ```rust
2636   struct Point(i32, i32);
2637
2638   impl Point {
2639       pub fn new(x: i32, y: i32) -> Self {
2640           Self(x, y)
2641       }
2642
2643       pub fn is_origin(&self) -> bool {
2644           match self {
2645               Self(0, 0) => true,
2646               _ => false,
2647           }
2648       }
2649   }
2650   ```
2651 - [Self can also now be used in type definitions.][56366] E.g.
2652   ```rust
2653   enum List<T>
2654   where
2655       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
2656   {
2657       Nil,
2658       Cons(T, Box<Self>) // likewise here
2659   }
2660   ```
2661 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
2662   a `impl Trait` or `dyn Trait` is returned and unused in the program.
2663
2664 Compiler
2665 --------
2666 - [The default allocator has changed from jemalloc to the default allocator on
2667   your system.][55238] The compiler itself on Linux & macOS will still use
2668   jemalloc, but programs compiled with it will use the system allocator.
2669 - [Added the `aarch64-pc-windows-msvc` target.][55702]
2670
2671 Libraries
2672 ---------
2673 - [`PathBuf` now implements `FromStr`.][55148]
2674 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
2675 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
2676   easily debug expressions in your rust program. E.g.
2677   ```rust
2678   let a = 2;
2679   let b = dbg!(a * 2) + 1;
2680   //      ^-- prints: [src/main.rs:4] a * 2 = 4
2681   assert_eq!(b, 5);
2682   ```
2683
2684 The following APIs are now `const` functions and can be used in a
2685 `const` context.
2686
2687 - [`Cell::as_ptr`]
2688 - [`UnsafeCell::get`]
2689 - [`char::is_ascii`]
2690 - [`iter::empty`]
2691 - [`ManuallyDrop::new`]
2692 - [`ManuallyDrop::into_inner`]
2693 - [`RangeInclusive::start`]
2694 - [`RangeInclusive::end`]
2695 - [`NonNull::as_ptr`]
2696 - [`slice::as_ptr`]
2697 - [`str::as_ptr`]
2698 - [`Duration::as_secs`]
2699 - [`Duration::subsec_millis`]
2700 - [`Duration::subsec_micros`]
2701 - [`Duration::subsec_nanos`]
2702 - [`CStr::as_ptr`]
2703 - [`Ipv4Addr::is_unspecified`]
2704 - [`Ipv6Addr::new`]
2705 - [`Ipv6Addr::octets`]
2706
2707 Stabilized APIs
2708 ---------------
2709 - [`i8::to_be_bytes`]
2710 - [`i8::to_le_bytes`]
2711 - [`i8::to_ne_bytes`]
2712 - [`i8::from_be_bytes`]
2713 - [`i8::from_le_bytes`]
2714 - [`i8::from_ne_bytes`]
2715 - [`i16::to_be_bytes`]
2716 - [`i16::to_le_bytes`]
2717 - [`i16::to_ne_bytes`]
2718 - [`i16::from_be_bytes`]
2719 - [`i16::from_le_bytes`]
2720 - [`i16::from_ne_bytes`]
2721 - [`i32::to_be_bytes`]
2722 - [`i32::to_le_bytes`]
2723 - [`i32::to_ne_bytes`]
2724 - [`i32::from_be_bytes`]
2725 - [`i32::from_le_bytes`]
2726 - [`i32::from_ne_bytes`]
2727 - [`i64::to_be_bytes`]
2728 - [`i64::to_le_bytes`]
2729 - [`i64::to_ne_bytes`]
2730 - [`i64::from_be_bytes`]
2731 - [`i64::from_le_bytes`]
2732 - [`i64::from_ne_bytes`]
2733 - [`i128::to_be_bytes`]
2734 - [`i128::to_le_bytes`]
2735 - [`i128::to_ne_bytes`]
2736 - [`i128::from_be_bytes`]
2737 - [`i128::from_le_bytes`]
2738 - [`i128::from_ne_bytes`]
2739 - [`isize::to_be_bytes`]
2740 - [`isize::to_le_bytes`]
2741 - [`isize::to_ne_bytes`]
2742 - [`isize::from_be_bytes`]
2743 - [`isize::from_le_bytes`]
2744 - [`isize::from_ne_bytes`]
2745 - [`u8::to_be_bytes`]
2746 - [`u8::to_le_bytes`]
2747 - [`u8::to_ne_bytes`]
2748 - [`u8::from_be_bytes`]
2749 - [`u8::from_le_bytes`]
2750 - [`u8::from_ne_bytes`]
2751 - [`u16::to_be_bytes`]
2752 - [`u16::to_le_bytes`]
2753 - [`u16::to_ne_bytes`]
2754 - [`u16::from_be_bytes`]
2755 - [`u16::from_le_bytes`]
2756 - [`u16::from_ne_bytes`]
2757 - [`u32::to_be_bytes`]
2758 - [`u32::to_le_bytes`]
2759 - [`u32::to_ne_bytes`]
2760 - [`u32::from_be_bytes`]
2761 - [`u32::from_le_bytes`]
2762 - [`u32::from_ne_bytes`]
2763 - [`u64::to_be_bytes`]
2764 - [`u64::to_le_bytes`]
2765 - [`u64::to_ne_bytes`]
2766 - [`u64::from_be_bytes`]
2767 - [`u64::from_le_bytes`]
2768 - [`u64::from_ne_bytes`]
2769 - [`u128::to_be_bytes`]
2770 - [`u128::to_le_bytes`]
2771 - [`u128::to_ne_bytes`]
2772 - [`u128::from_be_bytes`]
2773 - [`u128::from_le_bytes`]
2774 - [`u128::from_ne_bytes`]
2775 - [`usize::to_be_bytes`]
2776 - [`usize::to_le_bytes`]
2777 - [`usize::to_ne_bytes`]
2778 - [`usize::from_be_bytes`]
2779 - [`usize::from_le_bytes`]
2780 - [`usize::from_ne_bytes`]
2781
2782 Cargo
2783 -----
2784 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
2785 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
2786
2787 Misc
2788 ----
2789 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
2790
2791 Compatibility Notes
2792 -------------------
2793 - [The argument types for AVX's
2794   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
2795   been changed from `*const` to `*mut` as the previous implementation
2796   was unsound.
2797
2798
2799 [55148]: https://github.com/rust-lang/rust/pull/55148/
2800 [55238]: https://github.com/rust-lang/rust/pull/55238/
2801 [55280]: https://github.com/rust-lang/rust/pull/55280/
2802 [55610]: https://github.com/rust-lang/rust/pull/55610/
2803 [55663]: https://github.com/rust-lang/rust/pull/55663/
2804 [55702]: https://github.com/rust-lang/rust/pull/55702/
2805 [55837]: https://github.com/rust-lang/rust/pull/55837/
2806 [55843]: https://github.com/rust-lang/rust/pull/55843/
2807 [56072]: https://github.com/rust-lang/rust/pull/56072/
2808 [56245]: https://github.com/rust-lang/rust/pull/56245/
2809 [56365]: https://github.com/rust-lang/rust/pull/56365/
2810 [56366]: https://github.com/rust-lang/rust/pull/56366/
2811 [56395]: https://github.com/rust-lang/rust/pull/56395/
2812 [56759]: https://github.com/rust-lang/rust/pull/56759/
2813 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
2814 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
2815 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
2816 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
2817 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
2818 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
2819 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
2820 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
2821 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
2822 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
2823 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
2824 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
2825 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
2826 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
2827 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
2828 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
2829 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
2830 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
2831 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
2832 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
2833 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
2834 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
2835 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
2836 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
2837 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
2838 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
2839 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
2840 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
2841 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
2842 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
2843 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
2844 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
2845 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
2846 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
2847 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
2848 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
2849 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
2850 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
2851 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
2852 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
2853 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
2854 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
2855 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
2856 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
2857 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
2858 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
2859 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
2860 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
2861 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
2862 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
2863 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
2864 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
2865 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
2866 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
2867 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
2868 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
2869 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
2870 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
2871 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
2872 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
2873 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
2874 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
2875 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
2876 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
2877 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
2878 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
2879 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
2880 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
2881 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
2882 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
2883 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
2884 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
2885 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
2886 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
2887 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
2888 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
2889 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
2890 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
2891 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
2892 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
2893 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
2894 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
2895 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
2896 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
2897 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
2898 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
2899 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
2900 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
2901 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
2902 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
2903 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
2904 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
2905 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
2906
2907
2908 Version 1.31.1 (2018-12-20)
2909 ===========================
2910
2911 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
2912 - [Fix broken go-to-definition in RLS][rls/1171]
2913 - [Fix infinite loop on hover in RLS][rls/1170]
2914
2915 [56562]: https://github.com/rust-lang/rust/pull/56562
2916 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
2917 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
2918
2919 Version 1.31.0 (2018-12-06)
2920 ==========================
2921
2922 Language
2923 --------
2924 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
2925 - [New lifetime elision rules now allow for eliding lifetimes in functions and
2926   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
2927   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
2928   in structs.
2929 - [You can now define and use `const` functions.][54835] These are currently
2930   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
2931   [language reference][const-reference] for what exactly is available.
2932 - [You can now use tool lints, which allow you to scope lints from external
2933   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
2934 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
2935   a crate, not just in exported functions.][54451]
2936 - [You can now use parentheses in pattern matches.][54497]
2937
2938 Compiler
2939 --------
2940 - [Updated musl to 1.1.20][54430]
2941
2942 Libraries
2943 ---------
2944 - [You can now convert `num::NonZero*` types to their raw equivalents using the
2945   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
2946 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
2947   into `Option<&mut T>` using the `From` trait.][53218]
2948 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
2949
2950
2951 Stabilized APIs
2952 ---------------
2953 - [`slice::align_to`]
2954 - [`slice::align_to_mut`]
2955 - [`slice::chunks_exact`]
2956 - [`slice::chunks_exact_mut`]
2957 - [`slice::rchunks`]
2958 - [`slice::rchunks_mut`]
2959 - [`slice::rchunks_exact`]
2960 - [`slice::rchunks_exact_mut`]
2961 - [`Option::replace`]
2962
2963 Cargo
2964 -----
2965 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
2966 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
2967   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
2968
2969 [52813]: https://github.com/rust-lang/rust/pull/52813/
2970 [53218]: https://github.com/rust-lang/rust/pull/53218/
2971 [53555]: https://github.com/rust-lang/rust/issues/53555/
2972 [54057]: https://github.com/rust-lang/rust/pull/54057/
2973 [54240]: https://github.com/rust-lang/rust/pull/54240/
2974 [54430]: https://github.com/rust-lang/rust/pull/54430/
2975 [54451]: https://github.com/rust-lang/rust/pull/54451/
2976 [54497]: https://github.com/rust-lang/rust/pull/54497/
2977 [54778]: https://github.com/rust-lang/rust/pull/54778/
2978 [54835]: https://github.com/rust-lang/rust/pull/54835/
2979 [54870]: https://github.com/rust-lang/rust/pull/54870/
2980 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
2981 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
2982 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
2983 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
2984 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
2985 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
2986 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
2987 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
2988 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
2989 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
2990 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
2991 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
2992 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
2993 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
2994
2995 Version 1.30.1 (2018-11-08)
2996 ===========================
2997
2998 - [Fixed overflow ICE in rustdoc][54199]
2999 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
3000
3001 [54199]: https://github.com/rust-lang/rust/pull/54199
3002 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
3003
3004 Version 1.30.0 (2018-10-25)
3005 ==========================
3006
3007 Language
3008 --------
3009 - [Procedural macros are now available.][52081] These kinds of macros allow for
3010   more powerful code generation. There is a [new chapter available][proc-macros]
3011   in the Rust Programming Language book that goes further in depth.
3012 - [You can now use keywords as identifiers using the raw identifiers
3013   syntax (`r#`),][53236] e.g. `let r#for = true;`
3014 - [Using anonymous parameters in traits is now deprecated with a warning and
3015   will be a hard error in the 2018 edition.][53272]
3016 - [You can now use `crate` in paths.][54404] This allows you to refer to the
3017   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
3018 - [Using a external crate no longer requires being prefixed with `::`.][54404]
3019   Previously, using a external crate in a module without a use statement
3020   required `let json = ::serde_json::from_str(foo);` but can now be written
3021   as `let json = serde_json::from_str(foo);`.
3022 - [You can now apply the `#[used]` attribute to static items to prevent the
3023   compiler from optimising them away, even if they appear to be unused,][51363]
3024   e.g. `#[used] static FOO: u32 = 1;`
3025 - [You can now import and reexport macros from other crates with the `use`
3026   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
3027   the root module of the crate. If your macro relies on calling other local
3028   macros, it is recommended to export with the
3029   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
3030   those macros.
3031 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
3032   using the `vis` specifier.][53370]
3033 - [Non-macro attributes now allow all forms of literals, not just
3034   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
3035   write `#[attr(true)]`.
3036 - [You can now specify a function to handle a panic in the Rust runtime with the
3037   `#[panic_handler]` attribute.][51366]
3038
3039 Compiler
3040 --------
3041 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
3042 - [Added the `aarch64-unknown-netbsd` target][53165]
3043 - [Upgraded to LLVM 8.][53611]
3044
3045 Libraries
3046 ---------
3047 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
3048
3049 Stabilized APIs
3050 ---------------
3051 - [`Ipv4Addr::BROADCAST`]
3052 - [`Ipv4Addr::LOCALHOST`]
3053 - [`Ipv4Addr::UNSPECIFIED`]
3054 - [`Ipv6Addr::LOCALHOST`]
3055 - [`Ipv6Addr::UNSPECIFIED`]
3056 - [`Iterator::find_map`]
3057
3058   The following methods are replacement methods for `trim_left`, `trim_right`,
3059   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
3060   in 1.33.0:
3061 - [`str::trim_end_matches`]
3062 - [`str::trim_end`]
3063 - [`str::trim_start_matches`]
3064 - [`str::trim_start`]
3065
3066 Cargo
3067 ----
3068 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
3069 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
3070   equivalent to calling `rustdoc --error-format=json`.
3071 - [Cargo will now provide a progress bar for builds.][cargo/5995]
3072
3073 Misc
3074 ----
3075 - [`rustdoc` allows you to specify what edition to treat your code as with the
3076   `--edition` option.][54057]
3077 - [`rustdoc` now has the `--color` (specify whether to output color) and
3078   `--error-format` (specify error format, e.g. `json`) options.][53003]
3079 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
3080   debug symbols.][53774]
3081 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
3082   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
3083
3084 [50911]: https://github.com/rust-lang/rust/pull/50911/
3085 [51363]: https://github.com/rust-lang/rust/pull/51363/
3086 [51366]: https://github.com/rust-lang/rust/pull/51366/
3087 [52081]: https://github.com/rust-lang/rust/pull/52081/
3088 [53003]: https://github.com/rust-lang/rust/pull/53003/
3089 [53033]: https://github.com/rust-lang/rust/pull/53033/
3090 [53044]: https://github.com/rust-lang/rust/pull/53044/
3091 [53165]: https://github.com/rust-lang/rust/pull/53165/
3092 [53611]: https://github.com/rust-lang/rust/pull/53611/
3093 [53213]: https://github.com/rust-lang/rust/pull/53213/
3094 [53236]: https://github.com/rust-lang/rust/pull/53236/
3095 [53272]: https://github.com/rust-lang/rust/pull/53272/
3096 [53370]: https://github.com/rust-lang/rust/pull/53370/
3097 [53459]: https://github.com/rust-lang/rust/pull/53459/
3098 [53774]: https://github.com/rust-lang/rust/pull/53774/
3099 [53822]: https://github.com/rust-lang/rust/pull/53822/
3100 [54057]: https://github.com/rust-lang/rust/pull/54057/
3101 [54146]: https://github.com/rust-lang/rust/pull/54146/
3102 [54404]: https://github.com/rust-lang/rust/pull/54404/
3103 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
3104 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
3105 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
3106 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
3107
3108 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
3109 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
3110 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
3111 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
3112 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
3113 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
3114 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
3115 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
3116 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
3117 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
3118
3119
3120 Version 1.29.2 (2018-10-11)
3121 ===========================
3122
3123 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
3124 - The `rls-preview` component on the windows-gnu targets has been restored.
3125
3126 [54639]: https://github.com/rust-lang/rust/pull/54639
3127
3128
3129 Version 1.29.1 (2018-09-25)
3130 ===========================
3131
3132 Security Notes
3133 --------------
3134
3135 - The standard library's `str::repeat` function contained an out of bounds write
3136   caused by an integer overflow. This has been fixed by deterministically
3137   panicking when an overflow happens.
3138
3139   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
3140   us.
3141
3142
3143 Version 1.29.0 (2018-09-13)
3144 ==========================
3145
3146 Compiler
3147 --------
3148 - [Bumped minimum LLVM version to 5.0.][51899]
3149 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
3150 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
3151 - [Upgraded to LLVM 7.][51966]
3152
3153 Libraries
3154 ---------
3155 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
3156 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
3157 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
3158 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
3159   for `&str`.][51178]
3160 - [`Cell<T>` now allows `T` to be unsized.][50494]
3161 - [`SocketAddr` is now stable on Redox.][52656]
3162
3163 Stabilized APIs
3164 ---------------
3165 - [`Arc::downcast`]
3166 - [`Iterator::flatten`]
3167 - [`Rc::downcast`]
3168
3169 Cargo
3170 -----
3171 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
3172   `--locked` to disable this behavior.
3173 - [`cargo-install` will now allow you to cross compile an install
3174   using `--target`.][cargo/5614]
3175 - [Added the `cargo-fix` subcommand to automatically move project code from
3176   2015 edition to 2018.][cargo/5723]
3177 - [`cargo doc` can now optionally document private types using the
3178   `--document-private-items` flag.][cargo/5543]
3179
3180 Misc
3181 ----
3182 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
3183   the specified level to that level.][52354] For example `--cap-lints warn`
3184   will demote `deny` and `forbid` lints to `warn`.
3185 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
3186   fails and `101` if there is a panic.][52197]
3187 - [A preview of clippy has been made available through rustup.][51122]
3188   You can install the preview with `rustup component add clippy-preview`.
3189
3190 Compatibility Notes
3191 -------------------
3192 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
3193   Use `str::get_unchecked(begin..end)` instead.
3194 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
3195   Consider using the `home_dir` function from
3196   https://crates.io/crates/dirs instead.
3197 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
3198 - [`cfg` attributes and `--cfg` command line flags are now more
3199   strictly validated.][53893]
3200
3201 [53893]: https://github.com/rust-lang/rust/pull/53893/
3202 [52861]: https://github.com/rust-lang/rust/pull/52861/
3203 [51966]: https://github.com/rust-lang/rust/pull/51966/
3204 [52656]: https://github.com/rust-lang/rust/pull/52656/
3205 [52239]: https://github.com/rust-lang/rust/pull/52239/
3206 [52330]: https://github.com/rust-lang/rust/pull/52330/
3207 [52354]: https://github.com/rust-lang/rust/pull/52354/
3208 [52402]: https://github.com/rust-lang/rust/pull/52402/
3209 [52103]: https://github.com/rust-lang/rust/pull/52103/
3210 [52197]: https://github.com/rust-lang/rust/pull/52197/
3211 [51807]: https://github.com/rust-lang/rust/pull/51807/
3212 [51899]: https://github.com/rust-lang/rust/pull/51899/
3213 [51912]: https://github.com/rust-lang/rust/pull/51912/
3214 [51511]: https://github.com/rust-lang/rust/pull/51511/
3215 [51619]: https://github.com/rust-lang/rust/pull/51619/
3216 [51656]: https://github.com/rust-lang/rust/pull/51656/
3217 [51178]: https://github.com/rust-lang/rust/pull/51178/
3218 [51122]: https://github.com/rust-lang/rust/pull/51122
3219 [50494]: https://github.com/rust-lang/rust/pull/50494/
3220 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
3221 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
3222 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
3223 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
3224 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
3225 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
3226 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
3227
3228
3229 Version 1.28.0 (2018-08-02)
3230 ===========================
3231
3232 Language
3233 --------
3234 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
3235   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
3236   the inner type across Foreign Function Interface (FFI) boundaries.
3237 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
3238   and can now be used as identifiers.][51196]
3239 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
3240   stable.][51241] This will allow users to specify a global allocator for
3241   their program.
3242 - [Unit test functions marked with the `#[test]` attribute can now return
3243   `Result<(), E: Debug>` in addition to `()`.][51298]
3244 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
3245   allows macros to easily target lifetimes.
3246
3247 Compiler
3248 --------
3249 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
3250   prioritise making smaller binary sizes. `z` is the same as `s` with the
3251   exception that it does not vectorise loops, which typically results in an even
3252   smaller binary.
3253 - [The short error format is now stable.][49546] Specified with
3254   `--error-format=short` this option will provide a more compressed output of
3255   rust error messages.
3256 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
3257 - [Reduced the number of allocations in the macro parser.][50855] This can
3258   improve compile times of macro heavy crates on average by 5%.
3259
3260 Libraries
3261 ---------
3262 - [Implemented `Default` for `&mut str`.][51306]
3263 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
3264 - [Implemented `Extend` for `()`.][50234]
3265 - [The `Debug` implementation of `time::Duration` should now be more easily
3266   human readable.][50364] Previously a `Duration` of one second would printed as
3267   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
3268 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
3269   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
3270   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
3271   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
3272   for `PathBuf`.][50170]
3273 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
3274   and `Wrapping<i128>`.][50465]
3275 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
3276   possible.][51050] This can provide up to a 40% speed increase.
3277 - [Improved error messages when using `format!`.][50610]
3278
3279 Stabilized APIs
3280 ---------------
3281 - [`Iterator::step_by`]
3282 - [`Path::ancestors`]
3283 - [`SystemTime::UNIX_EPOCH`]
3284 - [`alloc::GlobalAlloc`]
3285 - [`alloc::Layout`]
3286 - [`alloc::LayoutErr`]
3287 - [`alloc::System`]
3288 - [`alloc::alloc`]
3289 - [`alloc::alloc_zeroed`]
3290 - [`alloc::dealloc`]
3291 - [`alloc::realloc`]
3292 - [`alloc::handle_alloc_error`]
3293 - [`btree_map::Entry::or_default`]
3294 - [`fmt::Alignment`]
3295 - [`hash_map::Entry::or_default`]
3296 - [`iter::repeat_with`]
3297 - [`num::NonZeroUsize`]
3298 - [`num::NonZeroU128`]
3299 - [`num::NonZeroU16`]
3300 - [`num::NonZeroU32`]
3301 - [`num::NonZeroU64`]
3302 - [`num::NonZeroU8`]
3303 - [`ops::RangeBounds`]
3304 - [`slice::SliceIndex`]
3305 - [`slice::from_mut`]
3306 - [`slice::from_ref`]
3307 - [`{Any + Send + Sync}::downcast_mut`]
3308 - [`{Any + Send + Sync}::downcast_ref`]
3309 - [`{Any + Send + Sync}::is`]
3310
3311 Cargo
3312 -----
3313 - [Cargo will now no longer allow you to publish crates with build scripts that
3314   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
3315   considered to be immutable.
3316
3317 Misc
3318 ----
3319 - [The `suggestion_applicability` field in `rustc`'s json output is now
3320   stable.][50486] This will allow dev tools to check whether a code suggestion
3321   would apply to them.
3322
3323 Compatibility Notes
3324 -------------------
3325 - [Rust will consider trait objects with duplicated constraints to be the same
3326   type as without the duplicated constraint.][51276] For example the below code will
3327   now fail to compile.
3328   ```rust
3329   trait Trait {}
3330
3331   impl Trait + Send {
3332       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
3333   }
3334
3335   impl Trait + Send + Send {
3336       fn test(&self) { println!("two"); }
3337   }
3338   ```
3339
3340 [49546]: https://github.com/rust-lang/rust/pull/49546/
3341 [50143]: https://github.com/rust-lang/rust/pull/50143/
3342 [50170]: https://github.com/rust-lang/rust/pull/50170/
3343 [50234]: https://github.com/rust-lang/rust/pull/50234/
3344 [50265]: https://github.com/rust-lang/rust/pull/50265/
3345 [50364]: https://github.com/rust-lang/rust/pull/50364/
3346 [50385]: https://github.com/rust-lang/rust/pull/50385/
3347 [50465]: https://github.com/rust-lang/rust/pull/50465/
3348 [50486]: https://github.com/rust-lang/rust/pull/50486/
3349 [50554]: https://github.com/rust-lang/rust/pull/50554/
3350 [50610]: https://github.com/rust-lang/rust/pull/50610/
3351 [50855]: https://github.com/rust-lang/rust/pull/50855/
3352 [51050]: https://github.com/rust-lang/rust/pull/51050/
3353 [51196]: https://github.com/rust-lang/rust/pull/51196/
3354 [51200]: https://github.com/rust-lang/rust/pull/51200/
3355 [51241]: https://github.com/rust-lang/rust/pull/51241/
3356 [51276]: https://github.com/rust-lang/rust/pull/51276/
3357 [51298]: https://github.com/rust-lang/rust/pull/51298/
3358 [51306]: https://github.com/rust-lang/rust/pull/51306/
3359 [51562]: https://github.com/rust-lang/rust/pull/51562/
3360 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
3361 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
3362 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
3363 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
3364 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
3365 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
3366 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
3367 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
3368 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
3369 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
3370 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
3371 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
3372 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
3373 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
3374 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
3375 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
3376 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
3377 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
3378 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
3379 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
3380 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
3381 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
3382 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
3383 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
3384 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
3385 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
3386 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
3387 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
3388 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
3389 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
3390
3391 Version 1.27.2 (2018-07-20)
3392 ===========================
3393
3394 Compatibility Notes
3395 -------------------
3396
3397 - The borrow checker was fixed to avoid potential unsoundness when using
3398   match ergonomics: [#52213][52213].
3399
3400 [52213]: https://github.com/rust-lang/rust/issues/52213
3401
3402 Version 1.27.1 (2018-07-10)
3403 ===========================
3404
3405 Security Notes
3406 --------------
3407
3408 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
3409   when running, which enabled executing code as some other user on a
3410   given machine. This release fixes that vulnerability; you can read
3411   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
3412
3413   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
3414
3415 Compatibility Notes
3416 -------------------
3417
3418 - The borrow checker was fixed to avoid an additional potential unsoundness when using
3419   match ergonomics: [#51415][51415], [#49534][49534].
3420
3421 [51415]: https://github.com/rust-lang/rust/issues/51415
3422 [49534]: https://github.com/rust-lang/rust/issues/49534
3423 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
3424 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
3425
3426 Version 1.27.0 (2018-06-21)
3427 ==========================
3428
3429 Language
3430 --------
3431 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
3432   be used as an identifier.
3433 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
3434   bare `Trait` syntax, and should make it clearer when being used in tandem with
3435   `impl Trait` because it is equivalent to the following syntax:
3436   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
3437   `Box<Trait> == Box<dyn Trait>`.
3438 - [Attributes on generic parameters such as types and lifetimes are
3439   now stable.][48851] e.g.
3440   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
3441 - [The `#[must_use]` attribute can now also be used on functions as well as
3442   types.][48925] It provides a lint that by default warns users when the
3443   value returned by a function has not been used.
3444
3445 Compiler
3446 --------
3447 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
3448
3449 Libraries
3450 ---------
3451 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
3452   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
3453   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
3454   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
3455   the `cfg` attribute.
3456 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
3457   std are now available in core.][49896]
3458 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
3459   to `Self`.][49630]
3460 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
3461   that the operation isn't done in place.
3462 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
3463   the `#[must_use]` attribute][49533] to warn about unused potentially
3464   expensive allocations.
3465
3466 Stabilized APIs
3467 ---------------
3468 - [`DoubleEndedIterator::rfind`]
3469 - [`DoubleEndedIterator::rfold`]
3470 - [`DoubleEndedIterator::try_rfold`]
3471 - [`Duration::from_micros`]
3472 - [`Duration::from_nanos`]
3473 - [`Duration::subsec_micros`]
3474 - [`Duration::subsec_millis`]
3475 - [`HashMap::remove_entry`]
3476 - [`Iterator::try_fold`]
3477 - [`Iterator::try_for_each`]
3478 - [`NonNull::cast`]
3479 - [`Option::filter`]
3480 - [`String::replace_range`]
3481 - [`Take::set_limit`]
3482 - [`hint::unreachable_unchecked`]
3483 - [`os::unix::process::parent_id`]
3484 - [`ptr::swap_nonoverlapping`]
3485 - [`slice::rsplit_mut`]
3486 - [`slice::rsplit`]
3487 - [`slice::swap_with_slice`]
3488
3489 Cargo
3490 -----
3491 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
3492   `readme`, and `repository` fields.][cargo/5386]
3493 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
3494 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
3495   a different directory than `target` for placing compilation artifacts.
3496 - [Cargo will be adding automatic target inference for binaries, benchmarks,
3497   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
3498   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
3499   where cargo would infer a binary, Cargo will produce a warning. You can
3500   disable this feature ahead of time by setting any of the following to false:
3501   `autobins`, `autobenches`, `autoexamples`, `autotests`.
3502 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
3503   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
3504
3505 Misc
3506 ----
3507 - [Added “The Rustc book” into the official documentation.][49707]
3508   [“The Rustc book”] documents and teaches how to use the rustc compiler.
3509 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
3510
3511 Compatibility Notes
3512 -------------------
3513 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
3514   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
3515   compile, `"".is_empty()` will still compile.
3516 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
3517   will only print the inner type.][48553] E.g.
3518   `print!("{:?}", AtomicBool::new(true))` will print `true`,
3519   not `AtomicBool(true)`.
3520 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
3521   could enter higher numbers but they were not supported by LLVM. Up to 512MB
3522   alignment should cover all use cases.
3523 - The `.description()` method on the `std::error::Error` trait
3524   [has been soft-deprecated][50163]. It is no longer required to implement it.
3525
3526 [48553]: https://github.com/rust-lang/rust/pull/48553/
3527 [48851]: https://github.com/rust-lang/rust/pull/48851/
3528 [48925]: https://github.com/rust-lang/rust/pull/48925/
3529 [49533]: https://github.com/rust-lang/rust/pull/49533/
3530 [49623]: https://github.com/rust-lang/rust/pull/49623/
3531 [49630]: https://github.com/rust-lang/rust/pull/49630/
3532 [49664]: https://github.com/rust-lang/rust/pull/49664/
3533 [49699]: https://github.com/rust-lang/rust/pull/49699/
3534 [49707]: https://github.com/rust-lang/rust/pull/49707/
3535 [49719]: https://github.com/rust-lang/rust/pull/49719/
3536 [49896]: https://github.com/rust-lang/rust/pull/49896/
3537 [49968]: https://github.com/rust-lang/rust/pull/49968/
3538 [50163]: https://github.com/rust-lang/rust/pull/50163
3539 [50177]: https://github.com/rust-lang/rust/pull/50177/
3540 [50378]: https://github.com/rust-lang/rust/pull/50378/
3541 [50398]: https://github.com/rust-lang/rust/pull/50398/
3542 [50423]: https://github.com/rust-lang/rust/pull/50423/
3543 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
3544 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
3545 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
3546 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
3547 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
3548 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
3549 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
3550 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
3551 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
3552 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
3553 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
3554 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3555 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3556 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
3557 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
3558 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
3559 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
3560 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
3561 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
3562 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
3563 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
3564 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
3565 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
3566 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
3567 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
3568 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
3569 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
3570 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
3571 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
3572 [“The Rustc book”]: https://doc.rust-lang.org/rustc
3573
3574
3575 Version 1.26.2 (2018-06-05)
3576 ==========================
3577
3578 Compatibility Notes
3579 -------------------
3580
3581 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
3582
3583 [51117]: https://github.com/rust-lang/rust/issues/51117
3584
3585
3586 Version 1.26.1 (2018-05-29)
3587 ==========================
3588
3589 Tools
3590 -----
3591
3592 - [RLS now works on Windows.][50646]
3593 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
3594
3595
3596 Compatibility Notes
3597 --------
3598
3599 - [`fn main() -> impl Trait` no longer works for non-Termination
3600   trait.][50656]
3601   This reverts an accidental stabilization.
3602 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
3603 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
3604
3605 [50646]: https://github.com/rust-lang/rust/issues/50646
3606 [50656]: https://github.com/rust-lang/rust/pull/50656
3607 [50812]: https://github.com/rust-lang/rust/pull/50812
3608 [50950]: https://github.com/rust-lang/rust/issues/50950
3609 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
3610
3611 Version 1.26.0 (2018-05-10)
3612 ==========================
3613
3614 Language
3615 --------
3616 - [Closures now implement `Copy` and/or `Clone` if all captured variables
3617   implement either or both traits.][49299]
3618 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
3619 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
3620   lifetime can be elided.][49458]
3621 - [`impl Trait` is now stable allowing you to have abstract types in returns
3622    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
3623   `fn open(path: impl AsRef<Path>)`.
3624 - [Pattern matching will now automatically apply dereferences.][49394]
3625 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
3626 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
3627 - [A lot of operations are now available in a const context.][46882] E.g. You
3628   can now index into constant arrays, reference and dereference into constants,
3629   and use tuple struct constructors.
3630 - [Fixed entry slice patterns are now stable.][48516] E.g.
3631   ```rust
3632   let points = [1, 2, 3, 4];
3633   match points {
3634       [1, 2, 3, 4] => println!("All points were sequential."),
3635       _ => println!("Not all points were sequential."),
3636   }
3637   ```
3638
3639
3640 Compiler
3641 --------
3642 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
3643 - [Fixed exponential projection complexity on nested types.][48296]
3644   This can provide up to a ~12% reduction in compile times for certain crates.
3645 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
3646   to remap path prefixes outputted by the compiler.
3647 - [Added `powerpc-unknown-netbsd` target.][48281]
3648
3649 Libraries
3650 ---------
3651 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
3652 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
3653   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
3654 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
3655 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
3656 - [`ascii::escape_default` is now available in libcore.][48735]
3657 - [Trailing commas are now supported in std and core macros.][48056]
3658 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
3659 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
3660
3661 Stabilized APIs
3662 ---------------
3663 - [`*const T::add`]
3664 - [`*const T::copy_to_nonoverlapping`]
3665 - [`*const T::copy_to`]
3666 - [`*const T::read_unaligned`]
3667 - [`*const T::read_volatile`]
3668 - [`*const T::read`]
3669 - [`*const T::sub`]
3670 - [`*const T::wrapping_add`]
3671 - [`*const T::wrapping_sub`]
3672 - [`*mut T::add`]
3673 - [`*mut T::copy_to_nonoverlapping`]
3674 - [`*mut T::copy_to`]
3675 - [`*mut T::read_unaligned`]
3676 - [`*mut T::read_volatile`]
3677 - [`*mut T::read`]
3678 - [`*mut T::replace`]
3679 - [`*mut T::sub`]
3680 - [`*mut T::swap`]
3681 - [`*mut T::wrapping_add`]
3682 - [`*mut T::wrapping_sub`]
3683 - [`*mut T::write_bytes`]
3684 - [`*mut T::write_unaligned`]
3685 - [`*mut T::write_volatile`]
3686 - [`*mut T::write`]
3687 - [`Box::leak`]
3688 - [`FromUtf8Error::as_bytes`]
3689 - [`LocalKey::try_with`]
3690 - [`Option::cloned`]
3691 - [`btree_map::Entry::and_modify`]
3692 - [`fs::read_to_string`]
3693 - [`fs::read`]
3694 - [`fs::write`]
3695 - [`hash_map::Entry::and_modify`]
3696 - [`iter::FusedIterator`]
3697 - [`ops::RangeInclusive`]
3698 - [`ops::RangeToInclusive`]
3699 - [`process::id`]
3700 - [`slice::rotate_left`]
3701 - [`slice::rotate_right`]
3702 - [`String::retain`]
3703
3704
3705 Cargo
3706 -----
3707 - [Cargo will now output path to custom commands when `-v` is
3708   passed with `--list`][cargo/5041]
3709 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
3710
3711 Misc
3712 ----
3713 - [The second edition of "The Rust Programming Language" book is now recommended
3714   over the first.][48404]
3715
3716 Compatibility Notes
3717 -------------------
3718
3719 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
3720   syntax is now invalid.
3721   ```
3722   use std::ops::Fn as dyn;
3723   fn g(_: Box<dyn(std::fmt::Debug)>) {}
3724   ```
3725 - [The result of dereferences are no longer promoted to `'static`.][47408]
3726   e.g.
3727   ```rust
3728   fn main() {
3729       const PAIR: &(i32, i32) = &(0, 1);
3730       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
3731   }
3732   ```
3733 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
3734 - [`".e0"` will now no longer parse as `0.0` and will instead cause
3735   an error.][48235]
3736 - [Removed hoedown from rustdoc.][48274]
3737 - [Bounds on higher-kinded lifetimes a hard error.][48326]
3738
3739 [46882]: https://github.com/rust-lang/rust/pull/46882
3740 [47379]: https://github.com/rust-lang/rust/pull/47379
3741 [47408]: https://github.com/rust-lang/rust/pull/47408
3742 [47813]: https://github.com/rust-lang/rust/pull/47813
3743 [48056]: https://github.com/rust-lang/rust/pull/48056
3744 [48125]: https://github.com/rust-lang/rust/pull/48125
3745 [48166]: https://github.com/rust-lang/rust/pull/48166
3746 [48235]: https://github.com/rust-lang/rust/pull/48235
3747 [48274]: https://github.com/rust-lang/rust/pull/48274
3748 [48281]: https://github.com/rust-lang/rust/pull/48281
3749 [48296]: https://github.com/rust-lang/rust/pull/48296
3750 [48326]: https://github.com/rust-lang/rust/pull/48326
3751 [48359]: https://github.com/rust-lang/rust/pull/48359
3752 [48404]: https://github.com/rust-lang/rust/pull/48404
3753 [48481]: https://github.com/rust-lang/rust/pull/48481
3754 [48516]: https://github.com/rust-lang/rust/pull/48516
3755 [48628]: https://github.com/rust-lang/rust/pull/48628
3756 [48629]: https://github.com/rust-lang/rust/pull/48629
3757 [48657]: https://github.com/rust-lang/rust/pull/48657
3758 [48735]: https://github.com/rust-lang/rust/pull/48735
3759 [48978]: https://github.com/rust-lang/rust/pull/48978
3760 [49101]: https://github.com/rust-lang/rust/pull/49101
3761 [49109]: https://github.com/rust-lang/rust/pull/49109
3762 [49121]: https://github.com/rust-lang/rust/pull/49121
3763 [49162]: https://github.com/rust-lang/rust/pull/49162
3764 [49184]: https://github.com/rust-lang/rust/pull/49184
3765 [49234]: https://github.com/rust-lang/rust/pull/49234
3766 [49255]: https://github.com/rust-lang/rust/pull/49255
3767 [49299]: https://github.com/rust-lang/rust/pull/49299
3768 [49305]: https://github.com/rust-lang/rust/pull/49305
3769 [49394]: https://github.com/rust-lang/rust/pull/49394
3770 [49458]: https://github.com/rust-lang/rust/pull/49458
3771 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
3772 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
3773 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
3774 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
3775 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
3776 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
3777 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
3778 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
3779 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
3780 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
3781 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
3782 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
3783 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
3784 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
3785 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
3786 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
3787 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
3788 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
3789 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
3790 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
3791 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
3792 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
3793 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
3794 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
3795 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
3796 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
3797 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
3798 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
3799 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
3800 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
3801 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
3802 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
3803 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
3804 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
3805 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
3806 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
3807 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
3808 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
3809 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
3810 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
3811 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
3812 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
3813
3814
3815 Version 1.25.0 (2018-03-29)
3816 ==========================
3817
3818 Language
3819 --------
3820 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
3821 - [You can now use nested groups of imports.][47948]
3822   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
3823 - [You can now have `|` at the start of a match arm.][47947] e.g.
3824 ```rust
3825 enum Foo { A, B, C }
3826
3827 fn main() {
3828     let x = Foo::A;
3829     match x {
3830         | Foo::A
3831         | Foo::B => println!("AB"),
3832         | Foo::C => println!("C"),
3833     }
3834 }
3835 ```
3836
3837 Compiler
3838 --------
3839 - [Upgraded to LLVM 6.][47828]
3840 - [Added `-C lto=val` option.][47521]
3841 - [Added `i586-unknown-linux-musl` target][47282]
3842
3843 Libraries
3844 ---------
3845 - [Impl Send for `process::Command` on Unix.][47760]
3846 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
3847 - [`UnsafeCell::into_inner` is now safe.][47204]
3848 - [Implement libstd for CloudABI.][47268]
3849 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
3850 - [Implement `AsRef<Path>` for Component][46985]
3851 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
3852 - [Moved `Duration` to libcore.][46666]
3853
3854 Stabilized APIs
3855 ---------------
3856 - [`Location::column`]
3857 - [`ptr::NonNull`]
3858
3859 The following functions can now be used in a constant expression.
3860 eg. `static MINUTE: Duration = Duration::from_secs(60);`
3861 - [`Duration::new`][47300]
3862 - [`Duration::from_secs`][47300]
3863 - [`Duration::from_millis`][47300]
3864
3865 Cargo
3866 -----
3867 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
3868 - [`cargo new` now defaults to creating a binary crate, instead of a
3869   library crate.][cargo/5029]
3870
3871 Misc
3872 ----
3873 - [Rust by example is now shipped with new releases][46196]
3874
3875 Compatibility Notes
3876 -------------------
3877 - [Deprecated `net::lookup_host`.][47510]
3878 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
3879 - The borrow checker was sometimes incorrectly permitting overlapping borrows
3880   around indexing operations (see [#47349][47349]). This has been fixed (which also
3881   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
3882 - [Removed deprecated unstable attribute `#[simd]`.][47251]
3883
3884 [33903]: https://github.com/rust-lang/rust/pull/33903
3885 [47947]: https://github.com/rust-lang/rust/pull/47947
3886 [47948]: https://github.com/rust-lang/rust/pull/47948
3887 [47760]: https://github.com/rust-lang/rust/pull/47760
3888 [47790]: https://github.com/rust-lang/rust/pull/47790
3889 [47828]: https://github.com/rust-lang/rust/pull/47828
3890 [47398]: https://github.com/rust-lang/rust/pull/47398
3891 [47510]: https://github.com/rust-lang/rust/pull/47510
3892 [47521]: https://github.com/rust-lang/rust/pull/47521
3893 [47204]: https://github.com/rust-lang/rust/pull/47204
3894 [47251]: https://github.com/rust-lang/rust/pull/47251
3895 [47268]: https://github.com/rust-lang/rust/pull/47268
3896 [47282]: https://github.com/rust-lang/rust/pull/47282
3897 [47300]: https://github.com/rust-lang/rust/pull/47300
3898 [47349]: https://github.com/rust-lang/rust/pull/47349
3899 [46931]: https://github.com/rust-lang/rust/pull/46931
3900 [46985]: https://github.com/rust-lang/rust/pull/46985
3901 [47006]: https://github.com/rust-lang/rust/pull/47006
3902 [46830]: https://github.com/rust-lang/rust/pull/46830
3903 [46095]: https://github.com/rust-lang/rust/pull/46095
3904 [46666]: https://github.com/rust-lang/rust/pull/46666
3905 [46196]: https://github.com/rust-lang/rust/pull/46196
3906 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
3907 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
3908 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
3909 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
3910 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
3911
3912
3913 Version 1.24.1 (2018-03-01)
3914 ==========================
3915
3916  - [Do not abort when unwinding through FFI][48251]
3917  - [Emit UTF-16 files for linker arguments on Windows][48318]
3918  - [Make the error index generator work again][48308]
3919  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
3920
3921 [48251]: https://github.com/rust-lang/rust/issues/48251
3922 [48308]: https://github.com/rust-lang/rust/issues/48308
3923 [48318]: https://github.com/rust-lang/rust/issues/48318
3924 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
3925
3926
3927 Version 1.24.0 (2018-02-15)
3928 ==========================
3929
3930 Language
3931 --------
3932 - [External `sysv64` ffi is now available.][46528]
3933   eg. `extern "sysv64" fn foo () {}`
3934
3935 Compiler
3936 --------
3937 - [rustc now uses 16 codegen units by default for release builds.][46910]
3938   For the fastest builds, utilize `codegen-units=1`.
3939 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
3940 - [Add `aarch64-unknown-openbsd` support][46760]
3941
3942 Libraries
3943 ---------
3944 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
3945   improvement in performance in the majority of cases.
3946 - [`OsStr`'s `Debug` implementation is now lossless and consistent
3947   with Windows.][46798]
3948 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
3949 - [impl `From<bool>` for `AtomicBool`][46293]
3950 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
3951 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
3952 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
3953 - [float::from_bits now just uses transmute.][46012] This provides
3954   some optimisations from LLVM.
3955 - [Copied `AsciiExt` methods onto `char`][46077]
3956 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
3957 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
3958 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
3959 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
3960
3961 Stabilized APIs
3962 ---------------
3963 - [`RefCell::replace`]
3964 - [`RefCell::swap`]
3965 - [`atomic::spin_loop_hint`]
3966
3967 The following functions can now be used in a constant expression.
3968 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
3969
3970 - [`AtomicBool::new`][46287]
3971 - [`AtomicUsize::new`][46287]
3972 - [`AtomicIsize::new`][46287]
3973 - [`AtomicPtr::new`][46287]
3974 - [`Cell::new`][46287]
3975 - [`{integer}::min_value`][46287]
3976 - [`{integer}::max_value`][46287]
3977 - [`mem::size_of`][46287]
3978 - [`mem::align_of`][46287]
3979 - [`ptr::null`][46287]
3980 - [`ptr::null_mut`][46287]
3981 - [`RefCell::new`][46287]
3982 - [`UnsafeCell::new`][46287]
3983
3984 Cargo
3985 -----
3986 - [Added a `workspace.default-members` config that
3987   overrides implied `--all` in virtual workspaces.][cargo/4743]
3988 - [Enable incremental by default on development builds.][cargo/4817] Also added
3989   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
3990   per-project or global basis respectively.
3991
3992 Misc
3993 ----
3994
3995 Compatibility Notes
3996 -------------------
3997 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
3998 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
3999   in accordance with IETF RFC 4291 §2.2.
4000 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
4001 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
4002   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
4003 - [Leading zeros in tuple struct members is now an error][47084]
4004 - [`column!()` macro is one-based instead of zero-based][46977]
4005 - [`fmt::Arguments` can no longer be shared across threads][45198]
4006 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
4007 - [Cargo sets a different working directory for the compiler][cargo/4788]
4008
4009 [44884]: https://github.com/rust-lang/rust/pull/44884
4010 [45198]: https://github.com/rust-lang/rust/pull/45198
4011 [45506]: https://github.com/rust-lang/rust/pull/45506
4012 [45904]: https://github.com/rust-lang/rust/pull/45904
4013 [45990]: https://github.com/rust-lang/rust/pull/45990
4014 [46012]: https://github.com/rust-lang/rust/pull/46012
4015 [46077]: https://github.com/rust-lang/rust/pull/46077
4016 [46094]: https://github.com/rust-lang/rust/pull/46094
4017 [46284]: https://github.com/rust-lang/rust/pull/46284
4018 [46287]: https://github.com/rust-lang/rust/pull/46287
4019 [46293]: https://github.com/rust-lang/rust/pull/46293
4020 [46528]: https://github.com/rust-lang/rust/pull/46528
4021 [46671]: https://github.com/rust-lang/rust/pull/46671
4022 [46713]: https://github.com/rust-lang/rust/pull/46713
4023 [46735]: https://github.com/rust-lang/rust/pull/46735
4024 [46749]: https://github.com/rust-lang/rust/pull/46749
4025 [46760]: https://github.com/rust-lang/rust/pull/46760
4026 [46798]: https://github.com/rust-lang/rust/pull/46798
4027 [46828]: https://github.com/rust-lang/rust/pull/46828
4028 [46831]: https://github.com/rust-lang/rust/pull/46831
4029 [46833]: https://github.com/rust-lang/rust/pull/46833
4030 [46910]: https://github.com/rust-lang/rust/pull/46910
4031 [46977]: https://github.com/rust-lang/rust/pull/46977
4032 [47018]: https://github.com/rust-lang/rust/pull/47018
4033 [47080]: https://github.com/rust-lang/rust/pull/47080
4034 [47084]: https://github.com/rust-lang/rust/pull/47084
4035 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
4036 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
4037 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
4038 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
4039 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
4040 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
4041
4042
4043 Version 1.23.0 (2018-01-04)
4044 ==========================
4045
4046 Language
4047 --------
4048 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
4049 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
4050   Which should fix some confusing errors in some operations.
4051
4052 Compiler
4053 --------
4054 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
4055   undefined behavior.][45920]
4056 - [rustc now suggests renaming import if names clash.][45660]
4057 - [Display errors/warnings correctly when there are zero-width or
4058   wide characters.][45711]
4059 - [rustc now avoids unnecessary copies of arguments that are
4060   simple bindings][45380] This should improve memory usage on average by 5-10%.
4061 - [Updated musl used to build musl rustc to 1.1.17][45393]
4062
4063 Libraries
4064 ---------
4065 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
4066 - [Implement Hash for raw pointers to unsized types][45483]
4067 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
4068 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
4069 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
4070 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
4071   and `<*mut T>::as_mut`][44932]
4072 - [Optimized `Thread::{park, unpark}` implementation][45524]
4073 - [Improved `SliceExt::binary_search` performance.][45333]
4074 - [impl `FromIterator<()>` for `()`][45379]
4075 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
4076   is now deprecated.
4077
4078 Stabilized APIs
4079 ---------------
4080
4081 Cargo
4082 -----
4083 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
4084   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
4085 - [Added unit test checking to `cargo check`][cargo/4592]
4086 - [Cargo now lets you install a specific version
4087   using `cargo install --version`][cargo/4637]
4088
4089 Misc
4090 ----
4091 - [Releases now ship with the Cargo book documentation.][45692]
4092 - [rustdoc now prints rendering warnings on every run.][45324]
4093
4094 Compatibility Notes
4095 -------------------
4096 - [Changes have been made to type equality to make it more correct,
4097   in rare cases this could break some code.][45853] [Tracking issue for
4098   further information][45852]
4099 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
4100 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
4101   Android 9, the minimum supported version is Android 14.
4102 - [Bumped the minimum LLVM to 3.9][45326]
4103
4104 [44042]: https://github.com/rust-lang/rust/pull/44042
4105 [44932]: https://github.com/rust-lang/rust/pull/44932
4106 [45267]: https://github.com/rust-lang/rust/pull/45267
4107 [45324]: https://github.com/rust-lang/rust/pull/45324
4108 [45326]: https://github.com/rust-lang/rust/pull/45326
4109 [45333]: https://github.com/rust-lang/rust/pull/45333
4110 [45379]: https://github.com/rust-lang/rust/pull/45379
4111 [45380]: https://github.com/rust-lang/rust/pull/45380
4112 [45393]: https://github.com/rust-lang/rust/pull/45393
4113 [45435]: https://github.com/rust-lang/rust/pull/45435
4114 [45483]: https://github.com/rust-lang/rust/pull/45483
4115 [45524]: https://github.com/rust-lang/rust/pull/45524
4116 [45571]: https://github.com/rust-lang/rust/pull/45571
4117 [45580]: https://github.com/rust-lang/rust/pull/45580
4118 [45610]: https://github.com/rust-lang/rust/pull/45610
4119 [45660]: https://github.com/rust-lang/rust/pull/45660
4120 [45692]: https://github.com/rust-lang/rust/pull/45692
4121 [45711]: https://github.com/rust-lang/rust/pull/45711
4122 [45772]: https://github.com/rust-lang/rust/pull/45772
4123 [45852]: https://github.com/rust-lang/rust/issues/45852
4124 [45853]: https://github.com/rust-lang/rust/pull/45853
4125 [45887]: https://github.com/rust-lang/rust/pull/45887
4126 [45920]: https://github.com/rust-lang/rust/pull/45920
4127 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
4128 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
4129 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
4130
4131
4132 Version 1.22.1 (2017-11-22)
4133 ==========================
4134
4135 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
4136
4137 [46183]: https://github.com/rust-lang/rust/pull/46183
4138
4139 Version 1.22.0 (2017-11-22)
4140 ==========================
4141
4142 Language
4143 --------
4144 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
4145 - [Now accepts underscores in unicode escapes][43716]
4146 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
4147 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
4148
4149 Compiler
4150 --------
4151 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
4152 - [rustc will no longer inline in codegen units when compiling for debug][45075]
4153   This should decrease compile times for debug builds.
4154 - [strict memory alignment now enabled on ARMv6][45094]
4155 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
4156
4157 Libraries
4158 ---------
4159 - [Allow atomic operations up to 32 bits
4160   on `armv5te_unknown_linux_gnueabi`][44978]
4161 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
4162 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
4163 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
4164 - [Properly detect overflow in `Instant += Duration`.][44220]
4165 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
4166 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
4167 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
4168
4169 Stabilized APIs
4170 ---------------
4171
4172 Cargo
4173 -----
4174 - [Cargo will now build multi file examples in subdirectories of the `examples`
4175   folder that have a `main.rs` file.][cargo/4496]
4176 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
4177   the old format will continue to work and can be updated with `cargo update`.
4178 - [Now supports vendoring git repositories][cargo/3992]
4179
4180 Misc
4181 ----
4182 - [`libbacktrace` is now available on Apple platforms.][44251]
4183 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
4184   This now lets you specify that a given code example will fail to compile.
4185
4186 Compatibility Notes
4187 -------------------
4188 - [The minimum Android version that rustc can build for has been bumped
4189   to `4.0` from `2.3`][45656]
4190 - [Allowing `T op= &T` for numeric types has broken some type
4191   inference cases][45480]
4192
4193
4194 [42526]: https://github.com/rust-lang/rust/pull/42526
4195 [43017]: https://github.com/rust-lang/rust/pull/43017
4196 [43716]: https://github.com/rust-lang/rust/pull/43716
4197 [43949]: https://github.com/rust-lang/rust/pull/43949
4198 [44015]: https://github.com/rust-lang/rust/pull/44015
4199 [44220]: https://github.com/rust-lang/rust/pull/44220
4200 [44251]: https://github.com/rust-lang/rust/pull/44251
4201 [44287]: https://github.com/rust-lang/rust/pull/44287
4202 [44303]: https://github.com/rust-lang/rust/pull/44303
4203 [44456]: https://github.com/rust-lang/rust/pull/44456
4204 [44466]: https://github.com/rust-lang/rust/pull/44466
4205 [44895]: https://github.com/rust-lang/rust/pull/44895
4206 [44966]: https://github.com/rust-lang/rust/pull/44966
4207 [44978]: https://github.com/rust-lang/rust/pull/44978
4208 [45041]: https://github.com/rust-lang/rust/pull/45041
4209 [45064]: https://github.com/rust-lang/rust/pull/45064
4210 [45075]: https://github.com/rust-lang/rust/pull/45075
4211 [45094]: https://github.com/rust-lang/rust/pull/45094
4212 [45095]: https://github.com/rust-lang/rust/pull/45095
4213 [45480]: https://github.com/rust-lang/rust/issues/45480
4214 [45656]: https://github.com/rust-lang/rust/pull/45656
4215 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
4216 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
4217 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
4218
4219
4220
4221
4222
4223
4224 Version 1.21.0 (2017-10-12)
4225 ==========================
4226
4227 Language
4228 --------
4229 - [You can now use static references for literals.][43838]
4230   Example:
4231   ```rust
4232   fn main() {
4233       let x: &'static u32 = &0;
4234   }
4235   ```
4236 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
4237   Example:
4238   ```rust
4239   my_macro!(Vec<i32>::new); // Always worked
4240   my_macro!(Vec::<i32>::new); // Now works
4241   ```
4242
4243 Compiler
4244 --------
4245 - [Upgraded jemalloc to 4.5.0][43911]
4246 - [Enabled unwinding panics on Redox][43917]
4247 - [Now runs LLVM in parallel during translation phase.][43506]
4248   This should reduce peak memory usage.
4249
4250 Libraries
4251 ---------
4252 - [Generate builtin impls for `Clone` for all arrays and tuples that
4253   are `T: Clone`][43690]
4254 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
4255 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
4256   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
4257
4258 Stabilized APIs
4259 ---------------
4260
4261 [`std::mem::discriminant`]
4262
4263 Cargo
4264 -----
4265 - [You can now call `cargo install` with multiple package names][cargo/4216]
4266 - [Cargo commands inside a virtual workspace will now implicitly
4267   pass `--all`][cargo/4335]
4268 - [Added a `[patch]` section to `Cargo.toml` to handle
4269   prepublication dependencies][cargo/4123] [RFC 1969]
4270 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
4271   like patterns][cargo/4270]
4272 - [Added the `--all-targets` option][cargo/4400]
4273 - [Using required dependencies as a feature is now deprecated and emits
4274   a warning][cargo/4364]
4275
4276
4277 Misc
4278 ----
4279 - [Cargo docs are moving][43916]
4280   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
4281 - [The rustdoc book is now available][43863]
4282   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
4283 - [Added a preview of RLS has been made available through rustup][44204]
4284   Install with `rustup component add rls-preview`
4285 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
4286   Previously only showed `std::os::unix`.
4287
4288 Compatibility Notes
4289 -------------------
4290 - [Changes in method matching against higher-ranked types][43880] This may cause
4291   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
4292 - [rustc's JSON error output's byte position start at top of file.][42973]
4293   Was previously relative to the rustc's internal `CodeMap` struct which
4294   required the unstable library `libsyntax` to correctly use.
4295 - [`unused_results` lint no longer ignores booleans][43728]
4296
4297 [42565]: https://github.com/rust-lang/rust/pull/42565
4298 [42973]: https://github.com/rust-lang/rust/pull/42973
4299 [43348]: https://github.com/rust-lang/rust/pull/43348
4300 [43459]: https://github.com/rust-lang/rust/pull/43459
4301 [43506]: https://github.com/rust-lang/rust/pull/43506
4302 [43540]: https://github.com/rust-lang/rust/pull/43540
4303 [43690]: https://github.com/rust-lang/rust/pull/43690
4304 [43728]: https://github.com/rust-lang/rust/pull/43728
4305 [43838]: https://github.com/rust-lang/rust/pull/43838
4306 [43863]: https://github.com/rust-lang/rust/pull/43863
4307 [43880]: https://github.com/rust-lang/rust/pull/43880
4308 [43911]: https://github.com/rust-lang/rust/pull/43911
4309 [43916]: https://github.com/rust-lang/rust/pull/43916
4310 [43917]: https://github.com/rust-lang/rust/pull/43917
4311 [44204]: https://github.com/rust-lang/rust/pull/44204
4312 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
4313 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
4314 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
4315 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
4316 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
4317 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
4318 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
4319 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
4320 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
4321
4322 Version 1.20.0 (2017-08-31)
4323 ===========================
4324
4325 Language
4326 --------
4327 - [Associated constants are now stabilised.][42809]
4328 - [A lot of macro bugs are now fixed.][42913]
4329
4330 Compiler
4331 --------
4332
4333 - [Struct fields are now properly coerced to the expected field type.][42807]
4334 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
4335   `wasm32-experimental-emscripten` target.
4336 - [Changed some of the error messages to be more helpful.][42033]
4337 - [Add support for RELRO(RELocation Read-Only) for platforms that support
4338   it.][43170]
4339 - [rustc now reports the total number of errors on compilation failure][43015]
4340   previously this was only the number of errors in the pass that failed.
4341 - [Expansion in rustc has been sped up 29x.][42533]
4342 - [added `msp430-none-elf` target.][43099]
4343 - [rustc will now suggest one-argument enum variant to fix type mismatch when
4344   applicable][43178]
4345 - [Fixes backtraces on Redox][43228]
4346 - [rustc now identifies different versions of same crate when absolute paths of
4347   different types match in an error message.][42826]
4348
4349 Libraries
4350 ---------
4351
4352
4353 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
4354 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
4355   tuples.][43011]
4356 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
4357   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
4358 - [Impl `Clone` for `DefaultHasher`.][42799]
4359 - [Impl `Sync` for `SyncSender`.][42397]
4360 - [Impl `FromStr` for `char`][42271]
4361 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
4362   NaN.][42431]
4363 - [allow messages in the `unimplemented!()` macro.][42155]
4364   ie. `unimplemented!("Waiting for 1.21 to be stable")`
4365 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
4366 - [Upgrade to Unicode 10.0.0][42999]
4367 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
4368 - [Skip the main thread's manual stack guard on Linux][43072]
4369 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
4370 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
4371   previously 2^15.
4372 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
4373
4374 Stabilized APIs
4375 ---------------
4376
4377 - [`CStr::into_c_string`]
4378 - [`CString::as_c_str`]
4379 - [`CString::into_boxed_c_str`]
4380 - [`Chain::get_mut`]
4381 - [`Chain::get_ref`]
4382 - [`Chain::into_inner`]
4383 - [`Option::get_or_insert_with`]
4384 - [`Option::get_or_insert`]
4385 - [`OsStr::into_os_string`]
4386 - [`OsString::into_boxed_os_str`]
4387 - [`Take::get_mut`]
4388 - [`Take::get_ref`]
4389 - [`Utf8Error::error_len`]
4390 - [`char::EscapeDebug`]
4391 - [`char::escape_debug`]
4392 - [`compile_error!`]
4393 - [`f32::from_bits`]
4394 - [`f32::to_bits`]
4395 - [`f64::from_bits`]
4396 - [`f64::to_bits`]
4397 - [`mem::ManuallyDrop`]
4398 - [`slice::sort_unstable_by_key`]
4399 - [`slice::sort_unstable_by`]
4400 - [`slice::sort_unstable`]
4401 - [`str::from_boxed_utf8_unchecked`]
4402 - [`str::as_bytes_mut`]
4403 - [`str::as_bytes_mut`]
4404 - [`str::from_utf8_mut`]
4405 - [`str::from_utf8_unchecked_mut`]
4406 - [`str::get_mut`]
4407 - [`str::get_unchecked_mut`]
4408 - [`str::get_unchecked`]
4409 - [`str::get`]
4410 - [`str::into_boxed_bytes`]
4411
4412
4413 Cargo
4414 -----
4415 - [Cargo API token location moved from `~/.cargo/config` to
4416   `~/.cargo/credentials`.][cargo/3978]
4417 - [Cargo will now build `main.rs` binaries that are in sub-directories of
4418   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
4419   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
4420 - [You can now specify version of a binary when installed through
4421   `cargo install` using `--vers`.][cargo/4229]
4422 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
4423   failure.][cargo/4248]
4424 - [Changed the convention around which file is the crate root.][cargo/4259]
4425 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
4426   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
4427
4428 Compatibility Notes
4429 -------------------
4430
4431 - [Functions with `'static` in their return types will now not be as usable as
4432   if they were using lifetime parameters instead.][42417]
4433 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
4434   takes the sign of NaN into account where previously didn't.][42430]
4435
4436 [42033]: https://github.com/rust-lang/rust/pull/42033
4437 [42155]: https://github.com/rust-lang/rust/pull/42155
4438 [42271]: https://github.com/rust-lang/rust/pull/42271
4439 [42397]: https://github.com/rust-lang/rust/pull/42397
4440 [42417]: https://github.com/rust-lang/rust/pull/42417
4441 [42430]: https://github.com/rust-lang/rust/pull/42430
4442 [42431]: https://github.com/rust-lang/rust/pull/42431
4443 [42533]: https://github.com/rust-lang/rust/pull/42533
4444 [42571]: https://github.com/rust-lang/rust/pull/42571
4445 [42613]: https://github.com/rust-lang/rust/pull/42613
4446 [42799]: https://github.com/rust-lang/rust/pull/42799
4447 [42807]: https://github.com/rust-lang/rust/pull/42807
4448 [42809]: https://github.com/rust-lang/rust/pull/42809
4449 [42822]: https://github.com/rust-lang/rust/pull/42822
4450 [42826]: https://github.com/rust-lang/rust/pull/42826
4451 [42854]: https://github.com/rust-lang/rust/pull/42854
4452 [42913]: https://github.com/rust-lang/rust/pull/42913
4453 [42999]: https://github.com/rust-lang/rust/pull/42999
4454 [43011]: https://github.com/rust-lang/rust/pull/43011
4455 [43015]: https://github.com/rust-lang/rust/pull/43015
4456 [43072]: https://github.com/rust-lang/rust/pull/43072
4457 [43077]: https://github.com/rust-lang/rust/pull/43077
4458 [43097]: https://github.com/rust-lang/rust/pull/43097
4459 [43099]: https://github.com/rust-lang/rust/pull/43099
4460 [43170]: https://github.com/rust-lang/rust/pull/43170
4461 [43178]: https://github.com/rust-lang/rust/pull/43178
4462 [43185]: https://github.com/rust-lang/rust/pull/43185
4463 [43228]: https://github.com/rust-lang/rust/pull/43228
4464 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
4465 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
4466 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
4467 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
4468 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
4469 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
4470 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
4471 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
4472 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
4473 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
4474 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
4475 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
4476 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
4477 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
4478 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
4479 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
4480 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
4481 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
4482 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
4483 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
4484 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
4485 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
4486 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
4487 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
4488 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
4489 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
4490 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
4491 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
4492 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
4493 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
4494 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
4495 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
4496 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
4497 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
4498 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
4499 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
4500 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
4501 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
4502 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
4503
4504
4505 Version 1.19.0 (2017-07-20)
4506 ===========================
4507
4508 Language
4509 --------
4510
4511 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
4512   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
4513 - [Macro recursion limit increased to 1024 from 64.][41676]
4514 - [Added lint for detecting unused macros.][41907]
4515 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
4516   For example: `let x = loop { break 7; };`
4517 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
4518   contain `Copy` types and cannot have a `Drop` implementation.
4519   Example: `union Foo { bar: u8, baz: usize }`
4520 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
4521   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
4522
4523 Compiler
4524 --------
4525
4526 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
4527 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
4528   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
4529   you should use `--target armv7-linux-androideabi`.
4530 - [Fixed ICE when removing a source file between compilation sessions.][41873]
4531 - [Minor optimisation of string operations.][42037]
4532 - [Compiler error message is now `aborting due to previous error(s)` instead of
4533   `aborting due to N previous errors`][42150] This was previously inaccurate and
4534   would only count certain kinds of errors.
4535 - [The compiler now supports Visual Studio 2017][42225]
4536 - [The compiler is now built against LLVM 4.0.1 by default][42948]
4537 - [Added a lot][42264] of [new error codes][42302]
4538 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
4539   libraries with C Run-time Libraries(CRT) to be statically linked.
4540 - [Fixed various ARM codegen bugs][42740]
4541
4542 Libraries
4543 ---------
4544
4545 - [`String` now implements `FromIterator<Cow<'a, str>>` and
4546   `Extend<Cow<'a, str>>`][41449]
4547 - [`Vec` now implements `From<&mut [T]>`][41530]
4548 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
4549 - [`SplitWhitespace` now implements `Clone`][41659]
4550 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
4551   1.5x faster][41764]
4552 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
4553   macros, but for printing to stderr.
4554
4555 Stabilized APIs
4556 ---------------
4557
4558 - [`OsString::shrink_to_fit`]
4559 - [`cmp::Reverse`]
4560 - [`Command::envs`]
4561 - [`thread::ThreadId`]
4562
4563 Cargo
4564 -----
4565
4566 - [Build scripts can now add environment variables to the environment
4567   the crate is being compiled in.
4568   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
4569 - [Subcommands now replace the current process rather than spawning a new
4570   child process][cargo/3970]
4571 - [Workspace members can now accept glob file patterns][cargo/3979]
4572 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
4573   the members in a given workspace.][cargo/3988]
4574 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
4575 - [Target directory path is now in the cargo metadata][cargo/4022]
4576 - [Cargo no longer checks out a local working directory for the
4577   crates.io index][cargo/4026] This should provide smaller file size for the
4578   registry, and improve cloning times, especially on Windows machines.
4579 - [Added an `--exclude` option for excluding certain packages when using the
4580   `--all` option][cargo/4031]
4581 - [Cargo will now automatically retry when receiving a 5xx error
4582   from crates.io][cargo/4032]
4583 - [The `--features` option now accepts multiple comma or space
4584   delimited values.][cargo/4084]
4585 - [Added support for custom target specific runners][cargo/3954]
4586
4587 Misc
4588 ----
4589
4590 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
4591   Windows Debugger.
4592 - [Rust will now release XZ compressed packages][rust-installer/57]
4593 - [rustup will now prefer to download rust packages with
4594   XZ compression][rustup/1100] over GZip packages.
4595 - [Added the ability to escape `#` in rust documentation][41785] By adding
4596   additional `#`'s ie. `##` is now `#`
4597
4598 Compatibility Notes
4599 -------------------
4600
4601 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
4602 - [`-Z` flags are now no longer allowed to be used on the stable
4603   compiler.][41751] This has been a warning for a year previous to this.
4604 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
4605   longer works][42844]. Users should migrate to the built-in `check`
4606   command, which has been available since 1.16.
4607 - [Ending a float literal with `._` is now a hard error.
4608   Example: `42._` .][41946]
4609 - [Any use of a private `extern crate` outside of its module is now a
4610   hard error.][36886] This was previously a warning.
4611 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
4612   relative while the `::` prefix makes a path absolute, but was ignored and the
4613   path was relative regardless.
4614 - [Floating point constants in match patterns is now a hard error][36890]
4615   This was previously a warning.
4616 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
4617   match patterns is now a hard error][36891] This was previously a warning.
4618 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
4619   a warning.
4620 - [From the pound escape, lines consisting of multiple `#`s are
4621   now visible][41785]
4622 - [It is an error to re-export private enum variants][42460]. This is
4623   known to break a number of crates that depend on an older version of
4624   mustache.
4625 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
4626   to use it to find the linker, and the build will fail where it did
4627   not previously][42607]
4628
4629 [36886]: https://github.com/rust-lang/rust/issues/36886
4630 [36888]: https://github.com/rust-lang/rust/issues/36888
4631 [36890]: https://github.com/rust-lang/rust/issues/36890
4632 [36891]: https://github.com/rust-lang/rust/issues/36891
4633 [36892]: https://github.com/rust-lang/rust/issues/36892
4634 [37406]: https://github.com/rust-lang/rust/issues/37406
4635 [39983]: https://github.com/rust-lang/rust/pull/39983
4636 [41145]: https://github.com/rust-lang/rust/pull/41145
4637 [41192]: https://github.com/rust-lang/rust/pull/41192
4638 [41258]: https://github.com/rust-lang/rust/pull/41258
4639 [41370]: https://github.com/rust-lang/rust/pull/41370
4640 [41449]: https://github.com/rust-lang/rust/pull/41449
4641 [41530]: https://github.com/rust-lang/rust/pull/41530
4642 [41624]: https://github.com/rust-lang/rust/pull/41624
4643 [41656]: https://github.com/rust-lang/rust/pull/41656
4644 [41659]: https://github.com/rust-lang/rust/pull/41659
4645 [41676]: https://github.com/rust-lang/rust/pull/41676
4646 [41751]: https://github.com/rust-lang/rust/pull/41751
4647 [41764]: https://github.com/rust-lang/rust/pull/41764
4648 [41785]: https://github.com/rust-lang/rust/pull/41785
4649 [41873]: https://github.com/rust-lang/rust/pull/41873
4650 [41907]: https://github.com/rust-lang/rust/pull/41907
4651 [41946]: https://github.com/rust-lang/rust/pull/41946
4652 [42016]: https://github.com/rust-lang/rust/pull/42016
4653 [42037]: https://github.com/rust-lang/rust/pull/42037
4654 [42068]: https://github.com/rust-lang/rust/pull/42068
4655 [42150]: https://github.com/rust-lang/rust/pull/42150
4656 [42162]: https://github.com/rust-lang/rust/pull/42162
4657 [42225]: https://github.com/rust-lang/rust/pull/42225
4658 [42264]: https://github.com/rust-lang/rust/pull/42264
4659 [42302]: https://github.com/rust-lang/rust/pull/42302
4660 [42460]: https://github.com/rust-lang/rust/issues/42460
4661 [42607]: https://github.com/rust-lang/rust/issues/42607
4662 [42740]: https://github.com/rust-lang/rust/pull/42740
4663 [42844]: https://github.com/rust-lang/rust/issues/42844
4664 [42948]: https://github.com/rust-lang/rust/pull/42948
4665 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
4666 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
4667 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
4668 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
4669 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
4670 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
4671 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
4672 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
4673 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
4674 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
4675 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
4676 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
4677 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
4678 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
4679 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
4680 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
4681 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
4682 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
4683 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
4684 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
4685 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
4686 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
4687
4688
4689 Version 1.18.0 (2017-06-08)
4690 ===========================
4691
4692 Language
4693 --------
4694
4695 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
4696   make the item visible to just that module tree. Also accepts the keyword
4697   `crate` to make something public to the whole crate but not users of the
4698   library. Example: `pub(crate) mod utils;`. [RFC 1422].
4699 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
4700   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
4701 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
4702   types like `Write + Send`, trailing `+` are now supported in trait objects,
4703   and better error reporting for trait objects starting with `?Sized`.
4704 - [0e+10 is now a valid floating point literal][40589]
4705 - [Now warns if you bind a lifetime parameter to 'static][40734]
4706 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
4707   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
4708   representation in some cases.][40377]
4709
4710 Compiler
4711 --------
4712
4713 - [rustc can now emit mir with `--emit mir`][39891]
4714 - [Improved LLVM IR for trivial functions][40367]
4715 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
4716 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
4717   opportunities found through profiling
4718 - [Improved backtrace formatting when panicking][38165]
4719
4720 Libraries
4721 ---------
4722
4723 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
4724   iterator hasn't been advanced the original `Vec` is reassembled with no actual
4725   iteration or reallocation.
4726 - [Simplified HashMap Bucket interface][40561] provides performance
4727   improvements for iterating and cloning.
4728 - [Specialize Vec::from_elem to use calloc][40409]
4729 - [Fixed Race condition in fs::create_dir_all][39799]
4730 - [No longer caching stdio on Windows][40516]
4731 - [Optimized insertion sort in slice][40807] insertion sort in some cases
4732   2.50%~ faster and in one case now 12.50% faster.
4733 - [Optimized `AtomicBool::fetch_nand`][41143]
4734
4735 Stabilized APIs
4736 ---------------
4737
4738 - [`Child::try_wait`]
4739 - [`HashMap::retain`]
4740 - [`HashSet::retain`]
4741 - [`PeekMut::pop`]
4742 - [`TcpStream::peek`]
4743 - [`UdpSocket::peek`]
4744 - [`UdpSocket::peek_from`]
4745
4746 Cargo
4747 -----
4748
4749 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
4750   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
4751 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
4752 - [Added Android build support][cargo/3885]
4753 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
4754   of a certain type, for example `cargo build --bins` will build all
4755   binaries.
4756 - [Added support for haiku][cargo/3952]
4757
4758 Misc
4759 ----
4760
4761 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
4762 - [Added rust-windbg script for better debugging on Windows][39983]
4763 - [Rust now uses the official cross compiler for NetBSD][40612]
4764 - [rustdoc now accepts `#` at the start of files][40828]
4765 - [Fixed jemalloc support for musl][41168]
4766
4767 Compatibility Notes
4768 -------------------
4769
4770 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
4771   always placed after the sign if it exists and before the digits. With the `#`
4772   flag the zeroes are placed after the prefix and before the digits.
4773 - [Due to the struct field optimisation][40377], using `transmute` on structs
4774   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
4775   always been undefined behavior, but is now more likely to break in practice.
4776 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
4777   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
4778   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
4779 - [Overlapping inherent `impl`s are now a hard error][40728]
4780 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
4781 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
4782   `out.asm` and `out.ll` instead of only one of the filetypes.
4783 - [ calling a function that returns `Self` will no longer work][41805] when
4784   the size of `Self` cannot be statically determined.
4785 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
4786   this has caused a few regressions namely:
4787
4788   - Changed the link order of local static/dynamic libraries (respecting the
4789     order on given rather than having the compiler reorder).
4790   - Changed how MinGW is linked, native code linked to dynamic libraries
4791     may require manually linking to the gcc support library (for the native
4792     code itself)
4793
4794 [38165]: https://github.com/rust-lang/rust/pull/38165
4795 [39799]: https://github.com/rust-lang/rust/pull/39799
4796 [39891]: https://github.com/rust-lang/rust/pull/39891
4797 [39983]: https://github.com/rust-lang/rust/pull/39983
4798 [40043]: https://github.com/rust-lang/rust/pull/40043
4799 [40241]: https://github.com/rust-lang/rust/pull/40241
4800 [40338]: https://github.com/rust-lang/rust/pull/40338
4801 [40367]: https://github.com/rust-lang/rust/pull/40367
4802 [40377]: https://github.com/rust-lang/rust/pull/40377
4803 [40409]: https://github.com/rust-lang/rust/pull/40409
4804 [40516]: https://github.com/rust-lang/rust/pull/40516
4805 [40556]: https://github.com/rust-lang/rust/pull/40556
4806 [40561]: https://github.com/rust-lang/rust/pull/40561
4807 [40589]: https://github.com/rust-lang/rust/pull/40589
4808 [40612]: https://github.com/rust-lang/rust/pull/40612
4809 [40723]: https://github.com/rust-lang/rust/pull/40723
4810 [40728]: https://github.com/rust-lang/rust/pull/40728
4811 [40731]: https://github.com/rust-lang/rust/pull/40731
4812 [40734]: https://github.com/rust-lang/rust/pull/40734
4813 [40805]: https://github.com/rust-lang/rust/pull/40805
4814 [40807]: https://github.com/rust-lang/rust/pull/40807
4815 [40828]: https://github.com/rust-lang/rust/pull/40828
4816 [40870]: https://github.com/rust-lang/rust/pull/40870
4817 [41085]: https://github.com/rust-lang/rust/pull/41085
4818 [41143]: https://github.com/rust-lang/rust/pull/41143
4819 [41168]: https://github.com/rust-lang/rust/pull/41168
4820 [41270]: https://github.com/rust-lang/rust/issues/41270
4821 [41469]: https://github.com/rust-lang/rust/pull/41469
4822 [41805]: https://github.com/rust-lang/rust/issues/41805
4823 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
4824 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
4825 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
4826 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
4827 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
4828 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
4829 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
4830 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
4831 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
4832 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
4833 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
4834 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
4835 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
4836 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
4837
4838
4839 Version 1.17.0 (2017-04-27)
4840 ===========================
4841
4842 Language
4843 --------
4844
4845 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
4846 * [Fields of structs may be initialized without duplicating the field/variable
4847   names][39761]. [RFC 1682]
4848 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
4849 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
4850   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
4851   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
4852   `'b`. Soundness fix.
4853 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
4854 * [Static variables may contain references to other statics][40027]
4855
4856 Compiler
4857 --------
4858
4859 * [Exit quickly on only `--emit dep-info`][40336]
4860 * [Make `-C relocation-model` more correctly determine whether the linker
4861   creates a position-independent executable][40245]
4862 * [Add `-C overflow-checks` to directly control whether integer overflow
4863   panics][40037]
4864 * [The rustc type checker now checks items on demand instead of in a single
4865   in-order pass][40008]. This is mostly an internal refactoring in support of
4866   future work, including incremental type checking, but also resolves [RFC
4867   1647], allowing `Self` to appear in `impl` `where` clauses.
4868 * [Optimize vtable loads][39995]
4869 * [Turn off vectorization for Emscripten targets][39990]
4870 * [Provide suggestions for unknown macros imported with `use`][39953]
4871 * [Fix ICEs in path resolution][39939]
4872 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
4873 * [Add clearer error message using `&str + &str`][39116]
4874
4875 Stabilized APIs
4876 ---------------
4877
4878 * [`Arc::into_raw`]
4879 * [`Arc::from_raw`]
4880 * [`Arc::ptr_eq`]
4881 * [`Rc::into_raw`]
4882 * [`Rc::from_raw`]
4883 * [`Rc::ptr_eq`]
4884 * [`Ordering::then`]
4885 * [`Ordering::then_with`]
4886 * [`BTreeMap::range`]
4887 * [`BTreeMap::range_mut`]
4888 * [`collections::Bound`]
4889 * [`process::abort`]
4890 * [`ptr::read_unaligned`]
4891 * [`ptr::write_unaligned`]
4892 * [`Result::expect_err`]
4893 * [`Cell::swap`]
4894 * [`Cell::replace`]
4895 * [`Cell::into_inner`]
4896 * [`Cell::take`]
4897
4898 Libraries
4899 ---------
4900
4901 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
4902 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
4903 * [`String` implements `FromIterator<&char>`][40028]
4904 * `Box` [implements][40009] a number of new conversions:
4905   `From<Box<str>> for String`,
4906   `From<Box<[T]>> for Vec<T>`,
4907   `From<Box<CStr>> for CString`,
4908   `From<Box<OsStr>> for OsString`,
4909   `From<Box<Path>> for PathBuf`,
4910   `Into<Box<str>> for String`,
4911   `Into<Box<[T]>> for Vec<T>`,
4912   `Into<Box<CStr>> for CString`,
4913   `Into<Box<OsStr>> for OsString`,
4914   `Into<Box<Path>> for PathBuf`,
4915   `Default for Box<str>`,
4916   `Default for Box<CStr>`,
4917   `Default for Box<OsStr>`,
4918   `From<&CStr> for Box<CStr>`,
4919   `From<&OsStr> for Box<OsStr>`,
4920   `From<&Path> for Box<Path>`
4921 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
4922 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
4923 * [Slightly optimize `slice::sort`][39538]
4924 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
4925 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
4926   `Box<str>` implements `From<&str>`][39438]
4927 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
4928   `From<(I, u16)> where I: Into<IpAddr>`][39372]
4929 * [`format!` estimates the needed capacity before writing a string][39356]
4930 * [Support unprivileged symlink creation in Windows][38921]
4931 * [`PathBuf` implements `Default`][38764]
4932 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
4933 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
4934   and poor hash functions.
4935
4936 Cargo
4937 -----
4938
4939 * [Add `cargo check --all`][cargo/3731]
4940 * [Add an option to ignore SSL revocation checking][cargo/3699]
4941 * [Add `cargo run --package`][cargo/3691]
4942 * [Add `required_features`][cargo/3667]
4943 * [Assume `build.rs` is a build script][cargo/3664]
4944 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
4945
4946 Misc
4947 ----
4948
4949 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
4950   `rustbook`][39633]
4951 * [The "Unstable Book" documents nightly-only features][ubook]
4952 * [Improve the style of the sidebar in rustdoc output][40265]
4953 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
4954 * [Fix MSP430 breakage due to `i128`][40257]
4955 * [Preliminary Solaris/SPARCv9 support][39903]
4956 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
4957   run without installing the MSVC runtime.
4958 * [`rustdoc --test` includes file names in test names][39788]
4959 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
4960   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
4961 * [Initial support for `aarch64-unknown-freebsd`][39491]
4962 * [Initial support for `i686-unknown-netbsd`][39426]
4963 * [This release no longer includes the old makefile build system][39431]. Rust
4964   is built with a custom build system, written in Rust, and with Cargo.
4965 * [Add Debug implementations for libcollection structs][39002]
4966 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
4967 * [`--test-threads=0` produces an error][38945]
4968 * [`rustup` installs documentation by default][40526]
4969 * [The Rust source includes NatVis visualizations][39843]. These can be used by
4970   WinDbg and Visual Studio to improve the debugging experience.
4971
4972 Compatibility Notes
4973 -------------------
4974
4975 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
4976   workaround, either use MSVC 2015 or run vcvars.bat.
4977 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
4978   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
4979   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
4980   fix.
4981 * [`format!` and `Display::to_string` panic if an underlying formatting
4982   implementation returns an error][40117]. Previously the error was silently
4983   ignored. It is incorrect for `write_fmt` to return an error when writing
4984   to a string.
4985 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
4986   crates were marked stable and could be accessed from the stable toolchain.
4987 * [Rust git source no longer includes vendored crates][39728]. Those that need
4988   to build with vendored crates should build from release tarballs.
4989 * [Fix inert attributes from `proc_macro_derives`][39572]
4990 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
4991   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
4992   build system.
4993 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
4994   existing code generally ignores the type of dead-code unless a type-hint is
4995   provided; this can cause surprising inference interactions particularly around
4996   defaulting. The new code uniformly ignores the result type of dead-code.
4997 * [Tuple-struct constructors with private fields are no longer visible][38932]
4998 * [Lifetime parameters that do not appear in the arguments are now considered
4999   early-bound][38897], resolving a soundness bug (#[32330]). The
5000   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
5001   April of 2016.
5002 * [rustdoc: fix doctests with non-feature crate attributes][38161]
5003 * [Make transmuting from fn item types to pointer-sized types a hard
5004   error][34198]
5005
5006 [27787]: https://github.com/rust-lang/rust/issues/27787
5007 [32330]: https://github.com/rust-lang/rust/issues/32330
5008 [34198]: https://github.com/rust-lang/rust/pull/34198
5009 [38161]: https://github.com/rust-lang/rust/pull/38161
5010 [38368]: https://github.com/rust-lang/rust/pull/38368
5011 [38584]: https://github.com/rust-lang/rust/issues/38584
5012 [38661]: https://github.com/rust-lang/rust/pull/38661
5013 [38764]: https://github.com/rust-lang/rust/pull/38764
5014 [38864]: https://github.com/rust-lang/rust/issues/38864
5015 [38897]: https://github.com/rust-lang/rust/pull/38897
5016 [38921]: https://github.com/rust-lang/rust/pull/38921
5017 [38932]: https://github.com/rust-lang/rust/pull/38932
5018 [38945]: https://github.com/rust-lang/rust/pull/38945
5019 [38981]: https://github.com/rust-lang/rust/pull/38981
5020 [39002]: https://github.com/rust-lang/rust/pull/39002
5021 [39116]: https://github.com/rust-lang/rust/pull/39116
5022 [39193]: https://github.com/rust-lang/rust/pull/39193
5023 [39265]: https://github.com/rust-lang/rust/pull/39265
5024 [39356]: https://github.com/rust-lang/rust/pull/39356
5025 [39372]: https://github.com/rust-lang/rust/pull/39372
5026 [39426]: https://github.com/rust-lang/rust/pull/39426
5027 [39431]: https://github.com/rust-lang/rust/pull/39431
5028 [39438]: https://github.com/rust-lang/rust/pull/39438
5029 [39440]: https://github.com/rust-lang/rust/pull/39440
5030 [39485]: https://github.com/rust-lang/rust/pull/39485
5031 [39491]: https://github.com/rust-lang/rust/pull/39491
5032 [39518]: https://github.com/rust-lang/rust/pull/39518
5033 [39538]: https://github.com/rust-lang/rust/pull/39538
5034 [39572]: https://github.com/rust-lang/rust/pull/39572
5035 [39633]: https://github.com/rust-lang/rust/pull/39633
5036 [39642]: https://github.com/rust-lang/rust/pull/39642
5037 [39728]: https://github.com/rust-lang/rust/pull/39728
5038 [39761]: https://github.com/rust-lang/rust/pull/39761
5039 [39788]: https://github.com/rust-lang/rust/pull/39788
5040 [39793]: https://github.com/rust-lang/rust/pull/39793
5041 [39837]: https://github.com/rust-lang/rust/pull/39837
5042 [39843]: https://github.com/rust-lang/rust/pull/39843
5043 [39851]: https://github.com/rust-lang/rust/pull/39851
5044 [39903]: https://github.com/rust-lang/rust/pull/39903
5045 [39939]: https://github.com/rust-lang/rust/pull/39939
5046 [39953]: https://github.com/rust-lang/rust/pull/39953
5047 [39960]: https://github.com/rust-lang/rust/pull/39960
5048 [39990]: https://github.com/rust-lang/rust/pull/39990
5049 [39995]: https://github.com/rust-lang/rust/pull/39995
5050 [40008]: https://github.com/rust-lang/rust/pull/40008
5051 [40009]: https://github.com/rust-lang/rust/pull/40009
5052 [40027]: https://github.com/rust-lang/rust/pull/40027
5053 [40028]: https://github.com/rust-lang/rust/pull/40028
5054 [40037]: https://github.com/rust-lang/rust/pull/40037
5055 [40117]: https://github.com/rust-lang/rust/pull/40117
5056 [40166]: https://github.com/rust-lang/rust/pull/40166
5057 [40245]: https://github.com/rust-lang/rust/pull/40245
5058 [40257]: https://github.com/rust-lang/rust/pull/40257
5059 [40261]: https://github.com/rust-lang/rust/pull/40261
5060 [40265]: https://github.com/rust-lang/rust/pull/40265
5061 [40319]: https://github.com/rust-lang/rust/pull/40319
5062 [40336]: https://github.com/rust-lang/rust/pull/40336
5063 [40526]: https://github.com/rust-lang/rust/pull/40526
5064 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5065 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
5066 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
5067 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
5068 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
5069 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
5070 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
5071 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
5072 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
5073 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
5074 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
5075 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
5076 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
5077 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
5078 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
5079 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
5080 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
5081 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
5082 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
5083 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
5084 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
5085 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
5086 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
5087 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
5088 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
5089 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
5090 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
5091 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
5092 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
5093 [mdbook]: https://crates.io/crates/mdbook
5094 [ubook]: https://doc.rust-lang.org/unstable-book/
5095
5096
5097 Version 1.16.0 (2017-03-16)
5098 ===========================
5099
5100 Language
5101 --------
5102
5103 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
5104 * [Uninhabitable enums (those without any variants) no longer permit wildcard
5105   match patterns][38069]
5106 * [Clean up semantics of `self` in an import list][38313]
5107 * [`Self` may appear in `impl` headers][38920]
5108 * [`Self` may appear in struct expressions][39282]
5109
5110 Compiler
5111 --------
5112
5113 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
5114   a `.rmeta` file containing only crate metadata][38571]. This can be
5115   used by tools like the Rust Language Service to perform
5116   metadata-only builds.
5117 * [Levenshtein based typo suggestions now work in most places, while
5118   previously they worked only for fields and sometimes for local
5119   variables][38927]. Together with the overhaul of "no
5120   resolution"/"unexpected resolution" errors (#[38154]) they result in
5121   large and systematic improvement in resolution diagnostics.
5122 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
5123   `U`][38670]
5124 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
5125 * [`rustc` no longer attempts to provide "consider using an explicit
5126   lifetime" suggestions][37057]. They were inaccurate.
5127
5128 Stabilized APIs
5129 ---------------
5130
5131 * [`VecDeque::truncate`]
5132 * [`VecDeque::resize`]
5133 * [`String::insert_str`]
5134 * [`Duration::checked_add`]
5135 * [`Duration::checked_sub`]
5136 * [`Duration::checked_div`]
5137 * [`Duration::checked_mul`]
5138 * [`str::replacen`]
5139 * [`str::repeat`]
5140 * [`SocketAddr::is_ipv4`]
5141 * [`SocketAddr::is_ipv6`]
5142 * [`IpAddr::is_ipv4`]
5143 * [`IpAddr::is_ipv6`]
5144 * [`Vec::dedup_by`]
5145 * [`Vec::dedup_by_key`]
5146 * [`Result::unwrap_or_default`]
5147 * [`<*const T>::wrapping_offset`]
5148 * [`<*mut T>::wrapping_offset`]
5149 * `CommandExt::creation_flags`
5150 * [`File::set_permissions`]
5151 * [`String::split_off`]
5152
5153 Libraries
5154 ---------
5155
5156 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
5157   their argument by `Borrow` parameter][37761]
5158 * [All public types in std implement `Debug`][38006]
5159 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
5160 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
5161 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5162   Windows][38274]
5163 * [std: Fix partial writes in `LineWriter`][38062]
5164 * [std: Clamp max read/write sizes on Unix][38062]
5165 * [Use more specific panic message for `&str` slicing errors][38066]
5166 * [`TcpListener::set_only_v6` is deprecated][38304]. This
5167   functionality cannot be achieved in std currently.
5168 * [`writeln!`, like `println!`, now accepts a form with no string
5169   or formatting arguments, to just print a newline][38469]
5170 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
5171 * [Reduce the size of static data in `std_unicode::tables`][38781]
5172 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
5173   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
5174   `Display`][38909]
5175 * [`Duration` implements `Sum`][38712]
5176 * [`String` implements `ToSocketAddrs`][39048]
5177
5178 Cargo
5179 -----
5180
5181 * [The `cargo check` command does a type check of a project without
5182   building it][cargo/3296]
5183 * [crates.io will display CI badges from Travis and AppVeyor, if
5184   specified in Cargo.toml][cargo/3546]
5185 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
5186 * [Compilation profiles accept integer values for `debug`, in addition
5187   to `true` and `false`. These are passed to `rustc` as the value to
5188   `-C debuginfo`][cargo/3534]
5189 * [Implement `cargo --version --verbose`][cargo/3604]
5190 * [All builds now output 'dep-info' build dependencies compatible with
5191   make and ninja][cargo/3557]
5192 * [Build all workspace members with `build --all`][cargo/3511]
5193 * [Document all workspace members with `doc --all`][cargo/3515]
5194 * [Path deps outside workspace are not members][cargo/3443]
5195
5196 Misc
5197 ----
5198
5199 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
5200   the path to the Rust implementation][38589]
5201 * [The `armv7-linux-androideabi` target no longer enables NEON
5202   extensions, per Google's ABI guide][38413]
5203 * [The stock standard library can be compiled for Redox OS][38401]
5204 * [Rust has initial SPARC support][38726]. Tier 3. No builds
5205   available.
5206 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
5207   builds available.
5208 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
5209
5210 Compatibility Notes
5211 -------------------
5212
5213 * [Uninhabitable enums (those without any variants) no longer permit wildcard
5214   match patterns][38069]
5215 * In this release, references to uninhabited types can not be
5216   pattern-matched. This was accidentally allowed in 1.15.
5217 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
5218 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5219   Windows][38274]
5220 * [Clean up semantics of `self` in an import list][38313]
5221 * Reimplemented lifetime elision. This change was almost entirely compatible
5222   with existing code, but it did close a number of small bugs and loopholes,
5223   as well as being more accepting in some other [cases][41105].
5224
5225 [37057]: https://github.com/rust-lang/rust/pull/37057
5226 [37761]: https://github.com/rust-lang/rust/pull/37761
5227 [38006]: https://github.com/rust-lang/rust/pull/38006
5228 [38051]: https://github.com/rust-lang/rust/pull/38051
5229 [38062]: https://github.com/rust-lang/rust/pull/38062
5230 [38062]: https://github.com/rust-lang/rust/pull/38622
5231 [38066]: https://github.com/rust-lang/rust/pull/38066
5232 [38069]: https://github.com/rust-lang/rust/pull/38069
5233 [38131]: https://github.com/rust-lang/rust/pull/38131
5234 [38154]: https://github.com/rust-lang/rust/pull/38154
5235 [38274]: https://github.com/rust-lang/rust/pull/38274
5236 [38304]: https://github.com/rust-lang/rust/pull/38304
5237 [38313]: https://github.com/rust-lang/rust/pull/38313
5238 [38314]: https://github.com/rust-lang/rust/pull/38314
5239 [38327]: https://github.com/rust-lang/rust/pull/38327
5240 [38401]: https://github.com/rust-lang/rust/pull/38401
5241 [38413]: https://github.com/rust-lang/rust/pull/38413
5242 [38469]: https://github.com/rust-lang/rust/pull/38469
5243 [38559]: https://github.com/rust-lang/rust/pull/38559
5244 [38571]: https://github.com/rust-lang/rust/pull/38571
5245 [38580]: https://github.com/rust-lang/rust/pull/38580
5246 [38589]: https://github.com/rust-lang/rust/pull/38589
5247 [38670]: https://github.com/rust-lang/rust/pull/38670
5248 [38712]: https://github.com/rust-lang/rust/pull/38712
5249 [38726]: https://github.com/rust-lang/rust/pull/38726
5250 [38781]: https://github.com/rust-lang/rust/pull/38781
5251 [38798]: https://github.com/rust-lang/rust/pull/38798
5252 [38909]: https://github.com/rust-lang/rust/pull/38909
5253 [38920]: https://github.com/rust-lang/rust/pull/38920
5254 [38927]: https://github.com/rust-lang/rust/pull/38927
5255 [39048]: https://github.com/rust-lang/rust/pull/39048
5256 [39282]: https://github.com/rust-lang/rust/pull/39282
5257 [39379]: https://github.com/rust-lang/rust/pull/39379
5258 [41105]: https://github.com/rust-lang/rust/issues/41105
5259 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
5260 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
5261 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
5262 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
5263 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
5264 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
5265 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
5266 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
5267 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
5268 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
5269 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
5270 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
5271 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
5272 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
5273 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
5274 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
5275 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
5276 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
5277 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
5278 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
5279 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
5280 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
5281 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
5282 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
5283 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
5284 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
5285 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
5286 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
5287 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
5288 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5289
5290
5291 Version 1.15.1 (2017-02-09)
5292 ===========================
5293
5294 * [Fix IntoIter::as_mut_slice's signature][39466]
5295 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
5296
5297 [39466]: https://github.com/rust-lang/rust/pull/39466
5298 [39523]: https://github.com/rust-lang/rust/pull/39523
5299
5300
5301 Version 1.15.0 (2017-02-02)
5302 ===========================
5303
5304 Language
5305 --------
5306
5307 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
5308   stable. This allows popular code-generating crates like Serde and Diesel to
5309   work ergonomically. [RFC 1681].
5310 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
5311   with curly braces][36868]. Part of [RFC 1506].
5312 * [A number of minor changes to name resolution have been activated][37127].
5313   They add up to more consistent semantics, allowing for future evolution of
5314   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
5315   details of what is different. The breaking changes here have been transitioned
5316   through the [`legacy_imports`] lint since 1.14, with no known regressions.
5317 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
5318   bounds][38279]
5319 * [`?Sized` can be used in `where` clauses][37791]
5320 * [There is now a limit on the size of monomorphized types and it can be
5321   modified with the `#![type_size_limit]` crate attribute, similarly to
5322   the `#![recursion_limit]` attribute][37789]
5323
5324 Compiler
5325 --------
5326
5327 * [On Windows, the compiler will apply dllimport attributes when linking to
5328   extern functions][37973]. Additional attributes and flags can control which
5329   library kind is linked and its name. [RFC 1717].
5330 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
5331 * [The `--test` flag works with procedural macro crates][38107]
5332 * [Fix `extern "aapcs" fn` ABI][37814]
5333 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
5334 * [The `format!` expander recognizes incorrect `printf` and shell-style
5335   formatting directives and suggests the correct format][37613].
5336 * [Only report one error for all unused imports in an import list][37456]
5337
5338 Compiler Performance
5339 --------------------
5340
5341 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
5342 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
5343 * [Don't clone in `UnificationTable::probe`][37848]
5344 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
5345 * [Use small vectors in type walker][37760]
5346 * [Macro expansion performance was improved][37701]
5347 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
5348 * [Replace FNV with a faster hash function][37229]
5349
5350 Stabilized APIs
5351 ---------------
5352
5353 * [`std::iter::Iterator::min_by`]
5354 * [`std::iter::Iterator::max_by`]
5355 * [`std::os::*::fs::FileExt`]
5356 * [`std::sync::atomic::Atomic*::get_mut`]
5357 * [`std::sync::atomic::Atomic*::into_inner`]
5358 * [`std::vec::IntoIter::as_slice`]
5359 * [`std::vec::IntoIter::as_mut_slice`]
5360 * [`std::sync::mpsc::Receiver::try_iter`]
5361 * [`std::os::unix::process::CommandExt::before_exec`]
5362 * [`std::rc::Rc::strong_count`]
5363 * [`std::rc::Rc::weak_count`]
5364 * [`std::sync::Arc::strong_count`]
5365 * [`std::sync::Arc::weak_count`]
5366 * [`std::char::encode_utf8`]
5367 * [`std::char::encode_utf16`]
5368 * [`std::cell::Ref::clone`]
5369 * [`std::io::Take::into_inner`]
5370
5371 Libraries
5372 ---------
5373
5374 * [The standard sorting algorithm has been rewritten for dramatic performance
5375   improvements][38192]. It is a hybrid merge sort, drawing influences from
5376   Timsort. Previously it was a naive merge sort.
5377 * [`Iterator::nth` no longer has a `Sized` bound][38134]
5378 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
5379   performance.
5380 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
5381   and `char_indices().last()`][37882]
5382 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
5383 * [Chinese characters display correctly in `fmt::Debug`][37855]
5384 * [Derive `Default` for `Duration`][37699]
5385 * [Support creation of anonymous pipes on WinXP/2k][37677]
5386 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
5387 * [Don't pass overlapped handles to processes][38835]
5388
5389 Cargo
5390 -----
5391
5392 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
5393   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
5394   should instead check the variable at runtime with `std::env`. That the value
5395   was set at build time was a bug, and incorrect when cross-compiling. This
5396   change is known to cause breakage.
5397 * [Add `--all` flag to `cargo test`][cargo/3221]
5398 * [Compile statically against the MSVC CRT][cargo/3363]
5399 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
5400 * [Link OpenSSL statically on OSX][cargo/3311]
5401 * [Apply new fingerprinting to build dir outputs][cargo/3310]
5402 * [Test for bad path overrides with summaries][cargo/3336]
5403 * [Require `cargo install --vers` to take a semver version][cargo/3338]
5404 * [Fix retrying crate downloads for network errors][cargo/3348]
5405 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
5406 * [Emit more info on --message-format=json][cargo/3319]
5407 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
5408 * [Don't ignore errors in workspace manifest][cargo/3409]
5409 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
5410
5411 Tooling
5412 -------
5413
5414 * [Test runners (binaries built with `--test`) now support a `--list` argument
5415   that lists the tests it contains][38185]
5416 * [Test runners now support a `--exact` argument that makes the test filter
5417   match exactly, instead of matching only a substring of the test name][38181]
5418 * [rustdoc supports a `--playground-url` flag][37763]
5419 * [rustdoc provides more details about `#[should_panic]` errors][37749]
5420
5421 Misc
5422 ----
5423
5424 * [The Rust build system is now written in Rust][37817]. The Makefiles may
5425   continue to be used in this release by passing `--disable-rustbuild` to the
5426   configure script, but they will be deleted soon. Note that the new build
5427   system uses a different on-disk layout that will likely affect any scripts
5428   building Rust.
5429 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
5430   releases.
5431 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
5432 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
5433   releases.
5434
5435 Compatibility Notes
5436 -------------------
5437
5438 * [A number of minor changes to name resolution have been activated][37127].
5439   They add up to more consistent semantics, allowing for future evolution of
5440   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
5441   details of what is different. The breaking changes here have been transitioned
5442   through the [`legacy_imports`] lint since 1.14, with no known regressions.
5443 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
5444   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
5445   should instead check the variable at runtime with `std::env`. That the value
5446   was set at build time was a bug, and incorrect when cross-compiling. This
5447   change is known to cause breakage.
5448 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
5449   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
5450   1.10 and is now an error by default. It will become a hard error in the near
5451   future.
5452 * [The semantics relating modules to file system directories are changing in
5453   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
5454   lint, which is a warning in this release, and will become a hard error in the
5455   future.
5456 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
5457 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
5458   the underlying iterator][37834]
5459
5460 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
5461 [33685]: https://github.com/rust-lang/rust/issues/33685
5462 [36868]: https://github.com/rust-lang/rust/pull/36868
5463 [37127]: https://github.com/rust-lang/rust/pull/37127
5464 [37229]: https://github.com/rust-lang/rust/pull/37229
5465 [37456]: https://github.com/rust-lang/rust/pull/37456
5466 [37527]: https://github.com/rust-lang/rust/pull/37527
5467 [37602]: https://github.com/rust-lang/rust/pull/37602
5468 [37613]: https://github.com/rust-lang/rust/pull/37613
5469 [37615]: https://github.com/rust-lang/rust/pull/37615
5470 [37636]: https://github.com/rust-lang/rust/pull/37636
5471 [37627]: https://github.com/rust-lang/rust/pull/37627
5472 [37642]: https://github.com/rust-lang/rust/pull/37642
5473 [37677]: https://github.com/rust-lang/rust/pull/37677
5474 [37699]: https://github.com/rust-lang/rust/pull/37699
5475 [37701]: https://github.com/rust-lang/rust/pull/37701
5476 [37705]: https://github.com/rust-lang/rust/pull/37705
5477 [37749]: https://github.com/rust-lang/rust/pull/37749
5478 [37760]: https://github.com/rust-lang/rust/pull/37760
5479 [37763]: https://github.com/rust-lang/rust/pull/37763
5480 [37764]: https://github.com/rust-lang/rust/pull/37764
5481 [37789]: https://github.com/rust-lang/rust/pull/37789
5482 [37791]: https://github.com/rust-lang/rust/pull/37791
5483 [37814]: https://github.com/rust-lang/rust/pull/37814
5484 [37817]: https://github.com/rust-lang/rust/pull/37817
5485 [37834]: https://github.com/rust-lang/rust/pull/37834
5486 [37848]: https://github.com/rust-lang/rust/pull/37848
5487 [37855]: https://github.com/rust-lang/rust/pull/37855
5488 [37882]: https://github.com/rust-lang/rust/pull/37882
5489 [37888]: https://github.com/rust-lang/rust/pull/37888
5490 [37973]: https://github.com/rust-lang/rust/pull/37973
5491 [37979]: https://github.com/rust-lang/rust/pull/37979
5492 [38086]: https://github.com/rust-lang/rust/pull/38086
5493 [38107]: https://github.com/rust-lang/rust/pull/38107
5494 [38117]: https://github.com/rust-lang/rust/pull/38117
5495 [38134]: https://github.com/rust-lang/rust/pull/38134
5496 [38146]: https://github.com/rust-lang/rust/pull/38146
5497 [38181]: https://github.com/rust-lang/rust/pull/38181
5498 [38182]: https://github.com/rust-lang/rust/pull/38182
5499 [38185]: https://github.com/rust-lang/rust/pull/38185
5500 [38192]: https://github.com/rust-lang/rust/pull/38192
5501 [38279]: https://github.com/rust-lang/rust/pull/38279
5502 [38835]: https://github.com/rust-lang/rust/pull/38835
5503 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
5504 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
5505 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
5506 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
5507 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
5508 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
5509 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
5510 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
5511 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
5512 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
5513 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
5514 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
5515 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
5516 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
5517 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
5518 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
5519 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
5520 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
5521 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
5522 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
5523 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
5524 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
5525 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
5526 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
5527 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
5528 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
5529 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
5530 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
5531 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
5532 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
5533 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
5534 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
5535 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
5536 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
5537 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
5538 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
5539 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
5540 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
5541
5542
5543 Version 1.14.0 (2016-12-22)
5544 ===========================
5545
5546 Language
5547 --------
5548
5549 * [`..` matches multiple tuple fields in enum variants, structs
5550   and tuples][36843]. [RFC 1492].
5551 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
5552 * [`use *` and `use ::*` both glob-import from the crate root][37367]
5553 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
5554   dereferencing][36822]
5555
5556 Compiler
5557 --------
5558
5559 * [Mark enums with non-zero discriminant as non-zero][37224]
5560 * [Lower-case `static mut` names are linted like other
5561   statics and consts][37162]
5562 * [Fix ICE on some macros in const integer positions
5563    (e.g. `[u8; m!()]`)][36819]
5564 * [Improve error message and snippet for "did you mean `x`"][36798]
5565 * [Add a panic-strategy field to the target specification][36794]
5566 * [Include LLVM version in `--version --verbose`][37200]
5567
5568 Compile-time Optimizations
5569 --------------------------
5570
5571 * [Improve macro expansion performance][37569]
5572 * [Shrink `Expr_::ExprInlineAsm`][37445]
5573 * [Replace all uses of SHA-256 with BLAKE2b][37439]
5574 * [Reduce the number of bytes hashed by `IchHasher`][37427]
5575 * [Avoid more allocations when compiling html5ever][37373]
5576 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
5577 * [Avoid some allocations in the macro parser][37318]
5578 * [Use a faster deflate setting][37298]
5579 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
5580   during interning of slices][37270]
5581 * [Optimize `write_metadata`][37267]
5582 * [Don't process obligation forest cycles when stalled][37231]
5583 * [Avoid many `CrateConfig` clones][37161]
5584 * [Optimize `Substs::super_fold_with`][37108]
5585 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
5586 * [Speed up `plug_leaks`][36917]
5587
5588 Libraries
5589 ---------
5590
5591 * [`println!()`, with no arguments, prints newline][36825].
5592   Previously, an empty string was required to achieve the same.
5593 * [`Wrapping` impls standard binary and unary operators, as well as
5594    the `Sum` and `Product` iterators][37356]
5595 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
5596   Vec<T>`][37326]
5597 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
5598   `VecDeque` iterators][37315]
5599 * [Improve `SipHasher` performance on small values][37312]
5600 * [Add Iterator trait TrustedLen to enable better FromIterator /
5601   Extend][37306]
5602 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
5603 * [`ReadDir` implements `Debug`][37221]
5604 * [Implement `RefUnwindSafe` for atomic types][37178]
5605 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
5606 * [Avoid allocations in `Decoder::read_str`][37064]
5607 * [`io::Error` implements `From<io::ErrorKind>`][37037]
5608 * [Impl `Debug` for raw pointers to unsized data][36880]
5609 * [Don't reuse `HashMap` random seeds][37470]
5610 * [The internal memory layout of `HashMap` is more cache-friendly, for
5611   significant improvements in some operations][36692]
5612 * [`HashMap` uses less memory on 32-bit architectures][36595]
5613 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
5614
5615 Cargo
5616 -----
5617
5618 * [Expose rustc cfg values to build scripts][cargo/3243]
5619 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
5620 * [Fix passing --features when testing multiple packages][cargo/3280]
5621 * [Use a single profile set per workspace][cargo/3249]
5622 * [Load `replace` sections from lock files][cargo/3220]
5623 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
5624
5625 Tooling
5626 -------
5627
5628 * [rustup is the recommended Rust installation method][1.14rustup]
5629 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
5630   S390x. These are [tier 2] platforms and may have major defects. Follow the
5631   instructions on the website to install, or add the targets to an existing
5632   installation with `rustup target add`. The new target triples are:
5633   - `mips-unknown-linux-gnu`
5634   - `mipsel-unknown-linux-gnu`
5635   - `mips64-unknown-linux-gnuabi64`
5636   - `mips64el-unknown-linux-gnuabi64 `
5637   - `powerpc-unknown-linux-gnu`
5638   - `powerpc64-unknown-linux-gnu`
5639   - `powerpc64le-unknown-linux-gnu`
5640   - `s390x-unknown-linux-gnu `
5641 * This release includes target (std) builds for ARM Linux running MUSL
5642   libc. These are [tier 2] platforms and may have major defects. Add the
5643   following triples to an existing rustup installation with `rustup target add`:
5644   - `arm-unknown-linux-musleabi`
5645   - `arm-unknown-linux-musleabihf`
5646   - `armv7-unknown-linux-musleabihf`
5647 * This release includes [experimental support for WebAssembly][1.14wasm], via
5648   the `wasm32-unknown-emscripten` target. This target is known to have major
5649   defects. Please test, report, and fix.
5650 * rustup no longer installs documentation by default. Run `rustup
5651   component add rust-docs` to install.
5652 * [Fix line stepping in debugger][37310]
5653 * [Enable line number debuginfo in releases][37280]
5654
5655 Misc
5656 ----
5657
5658 * [Disable jemalloc on aarch64/powerpc/mips][37392]
5659 * [Add support for Fuchsia OS][37313]
5660 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
5661
5662 Compatibility Notes
5663 -------------------
5664
5665 * [A number of forward-compatibility lints used by the compiler
5666   to gradually introduce language changes have been converted
5667   to deny by default][36894]:
5668   - ["use of inaccessible extern crate erroneously allowed"][36886]
5669   - ["type parameter default erroneously allowed in invalid location"][36887]
5670   - ["detects super or self keywords at the beginning of global path"][36888]
5671   - ["two overlapping inherent impls define an item with the same name
5672     were erroneously allowed"][36889]
5673   - ["floating-point constants cannot be used in patterns"][36890]
5674   - ["constants of struct or enum type can only be used in a pattern if
5675      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
5676   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
5677 * [Prohibit patterns in trait methods without bodies][37378]
5678 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
5679 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
5680 * [The `$crate` macro variable is accepted in fewer locations][37213]
5681 * [Impls specifying extra region requirements beyond the trait
5682   they implement are rejected][37167]
5683 * [Enums may not be unsized][37111]. Unsized enums are intended to
5684   work but never have. For now they are forbidden.
5685 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
5686
5687 [tier 2]: https://forge.rust-lang.org/platform-support.html
5688 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
5689 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
5690 [36430]: https://github.com/rust-lang/rust/pull/36430
5691 [36595]: https://github.com/rust-lang/rust/pull/36595
5692 [36595]: https://github.com/rust-lang/rust/pull/36595
5693 [36692]: https://github.com/rust-lang/rust/pull/36692
5694 [36767]: https://github.com/rust-lang/rust/pull/36767
5695 [36794]: https://github.com/rust-lang/rust/pull/36794
5696 [36798]: https://github.com/rust-lang/rust/pull/36798
5697 [36819]: https://github.com/rust-lang/rust/pull/36819
5698 [36822]: https://github.com/rust-lang/rust/pull/36822
5699 [36825]: https://github.com/rust-lang/rust/pull/36825
5700 [36843]: https://github.com/rust-lang/rust/pull/36843
5701 [36880]: https://github.com/rust-lang/rust/pull/36880
5702 [36886]: https://github.com/rust-lang/rust/issues/36886
5703 [36887]: https://github.com/rust-lang/rust/issues/36887
5704 [36888]: https://github.com/rust-lang/rust/issues/36888
5705 [36889]: https://github.com/rust-lang/rust/issues/36889
5706 [36890]: https://github.com/rust-lang/rust/issues/36890
5707 [36891]: https://github.com/rust-lang/rust/issues/36891
5708 [36892]: https://github.com/rust-lang/rust/issues/36892
5709 [36894]: https://github.com/rust-lang/rust/pull/36894
5710 [36917]: https://github.com/rust-lang/rust/pull/36917
5711 [36993]: https://github.com/rust-lang/rust/pull/36993
5712 [37037]: https://github.com/rust-lang/rust/pull/37037
5713 [37064]: https://github.com/rust-lang/rust/pull/37064
5714 [37094]: https://github.com/rust-lang/rust/pull/37094
5715 [37108]: https://github.com/rust-lang/rust/pull/37108
5716 [37111]: https://github.com/rust-lang/rust/pull/37111
5717 [37161]: https://github.com/rust-lang/rust/pull/37161
5718 [37162]: https://github.com/rust-lang/rust/pull/37162
5719 [37167]: https://github.com/rust-lang/rust/pull/37167
5720 [37178]: https://github.com/rust-lang/rust/pull/37178
5721 [37200]: https://github.com/rust-lang/rust/pull/37200
5722 [37213]: https://github.com/rust-lang/rust/pull/37213
5723 [37221]: https://github.com/rust-lang/rust/pull/37221
5724 [37224]: https://github.com/rust-lang/rust/pull/37224
5725 [37230]: https://github.com/rust-lang/rust/pull/37230
5726 [37231]: https://github.com/rust-lang/rust/pull/37231
5727 [37247]: https://github.com/rust-lang/rust/pull/37247
5728 [37267]: https://github.com/rust-lang/rust/pull/37267
5729 [37270]: https://github.com/rust-lang/rust/pull/37270
5730 [37273]: https://github.com/rust-lang/rust/pull/37273
5731 [37280]: https://github.com/rust-lang/rust/pull/37280
5732 [37298]: https://github.com/rust-lang/rust/pull/37298
5733 [37306]: https://github.com/rust-lang/rust/pull/37306
5734 [37310]: https://github.com/rust-lang/rust/pull/37310
5735 [37312]: https://github.com/rust-lang/rust/pull/37312
5736 [37313]: https://github.com/rust-lang/rust/pull/37313
5737 [37315]: https://github.com/rust-lang/rust/pull/37315
5738 [37318]: https://github.com/rust-lang/rust/pull/37318
5739 [37322]: https://github.com/rust-lang/rust/pull/37322
5740 [37326]: https://github.com/rust-lang/rust/pull/37326
5741 [37351]: https://github.com/rust-lang/rust/pull/37351
5742 [37356]: https://github.com/rust-lang/rust/pull/37356
5743 [37367]: https://github.com/rust-lang/rust/pull/37367
5744 [37373]: https://github.com/rust-lang/rust/pull/37373
5745 [37378]: https://github.com/rust-lang/rust/pull/37378
5746 [37389]: https://github.com/rust-lang/rust/pull/37389
5747 [37392]: https://github.com/rust-lang/rust/pull/37392
5748 [37427]: https://github.com/rust-lang/rust/pull/37427
5749 [37439]: https://github.com/rust-lang/rust/pull/37439
5750 [37445]: https://github.com/rust-lang/rust/pull/37445
5751 [37470]: https://github.com/rust-lang/rust/pull/37470
5752 [37569]: https://github.com/rust-lang/rust/pull/37569
5753 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
5754 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
5755 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
5756 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
5757 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
5758 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
5759 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
5760
5761
5762 Version 1.13.0 (2016-11-10)
5763 ===========================
5764
5765 Language
5766 --------
5767
5768 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
5769   errors, like the `try!` macro, described in [RFC 0243].
5770 * [Stabilize macros in type position][36014]. Described in [RFC 873].
5771 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
5772 * [Fix `#[derive]` for empty tuple structs/variants][35728]
5773 * [Fix lifetime rules for 'if' conditions][36029]
5774 * [Avoid loading and parsing unconfigured non-inline modules][36482]
5775
5776 Compiler
5777 --------
5778
5779 * [Add the `-C link-arg` argument][36574]
5780 * [Remove the old AST-based backend from rustc_trans][35764]
5781 * [Don't enable NEON by default on armv7 Linux][35814]
5782 * [Fix debug line number info for macro expansions][35238]
5783 * [Do not emit "class method" debuginfo for types that are not
5784   DICompositeType][36008]
5785 * [Warn about multiple conflicting #[repr] hints][34623]
5786 * [When sizing DST, don't double-count nested struct prefixes][36351]
5787 * [Default RUST_MIN_STACK to 16MiB for now][36505]
5788 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
5789 * [Reject macros with empty repetitions to avoid infinite loop][36721]
5790 * [Expand macros without recursing to avoid stack overflows][36214]
5791
5792 Diagnostics
5793 -----------
5794
5795 * [Replace macro backtraces with labeled local uses][35702]
5796 * [Improve error message for misplaced doc comments][33922]
5797 * [Buffer unix and lock windows to prevent message interleaving][35975]
5798 * [Update lifetime errors to specifically note temporaries][36171]
5799 * [Special case a few colors for Windows][36178]
5800 * [Suggest `use self` when such an import resolves][36289]
5801 * [Be more specific when type parameter shadows primitive type][36338]
5802 * Many minor improvements
5803
5804 Compile-time Optimizations
5805 --------------------------
5806
5807 * [Compute and cache HIR hashes at beginning][35854]
5808 * [Don't hash types in loan paths][36004]
5809 * [Cache projections in trans][35761]
5810 * [Optimize the parser's last token handling][36527]
5811 * [Only instantiate #[inline] functions in codegen units referencing
5812   them][36524]. This leads to big improvements in cases where crates export
5813   define many inline functions without using them directly.
5814 * [Lazily allocate TypedArena's first chunk][36592]
5815 * [Don't allocate during default HashSet creation][36734]
5816
5817 Stabilized APIs
5818 ---------------
5819
5820 * [`checked_abs`]
5821 * [`wrapping_abs`]
5822 * [`overflowing_abs`]
5823 * [`RefCell::try_borrow`]
5824 * [`RefCell::try_borrow_mut`]
5825
5826 Libraries
5827 ---------
5828
5829 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
5830 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
5831   covariant][35354]
5832 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
5833 * [Implement `Debug` for `std::vec::IntoIter`][35707]
5834 * [`CString`: avoid excessive growth just to 0-terminate][35871]
5835 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
5836 * [Use arc4rand on FreeBSD][35884]
5837 * [memrchr: Correct aligned offset computation][35969]
5838 * [Improve Demangling of Rust Symbols][36059]
5839 * [Use monotonic time in condition variables][35048]
5840 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
5841 * [Implement conversion traits for `char`][35755]
5842 * [Fix illegal instruction caused by overflow in channel cloning][36104]
5843 * [Zero first byte of CString on drop][36264]
5844 * [Inherit overflow checks for sum and product][36372]
5845 * [Add missing Eq implementations][36423]
5846 * [Implement `Debug` for `DirEntry`][36631]
5847 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
5848   `errno`][36754]
5849 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
5850 * [Implement more traits for `std::io::ErrorKind`][35911]
5851 * [Optimize BinaryHeap bounds checking][36072]
5852 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
5853   `extend_with_element`][36355]
5854 * [Fix overflow checking in unsigned pow()][34942]
5855
5856 Cargo
5857 -----
5858
5859 * This release includes security fixes to both curl and OpenSSL.
5860 * [Fix transitive doctests when panic=abort][cargo/3021]
5861 * [Add --all-features flag to cargo][cargo/3038]
5862 * [Reject path-based dependencies in `cargo package`][cargo/3060]
5863 * [Don't parse the home directory more than once][cargo/3078]
5864 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
5865 * [Update OpenSSL to 1.0.2j][cargo/3121]
5866 * [Add license and license_file to cargo metadata output][cargo/3110]
5867 * [Make crates-io registry URL optional in config; ignore all changes to
5868   source.crates-io][cargo/3089]
5869 * [Don't download dependencies from other platforms][cargo/3123]
5870 * [Build transitive dev-dependencies when needed][cargo/3125]
5871 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
5872 * [Avoid updating registry when adding existing deps][cargo/3144]
5873 * [Warn about path overrides that won't work][cargo/3136]
5874 * [Use workspaces during `cargo install`][cargo/3146]
5875 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
5876 * [Add --message-format flag][cargo/3000]
5877 * [Pass target environment for rustdoc][cargo/3205]
5878 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
5879 * [Update curl and curl-sys][cargo/3241]
5880 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
5881
5882 Tooling
5883 -------
5884
5885 * [rustdoc: Add the `--sysroot` argument][36586]
5886 * [rustdoc: Fix a couple of issues with the search results][35655]
5887 * [rustdoc: remove the `!` from macro URLs and titles][35234]
5888 * [gdb: Fix pretty-printing special-cased Rust types][35585]
5889 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
5890
5891 Misc
5892 ----
5893
5894 * [Remove unmaintained style guide][35124]
5895 * [Add s390x support][36369]
5896 * [Initial work at Haiku OS support][36727]
5897 * [Add mips-uclibc targets][35734]
5898 * [Crate-ify compiler-rt into compiler-builtins][35021]
5899 * [Add rustc version info (git hash + date) to dist tarball][36213]
5900 * Many documentation improvements
5901
5902 Compatibility Notes
5903 -------------------
5904
5905 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
5906 * [Deny (by default) transmuting from fn item types to pointer-sized
5907   types][34923]. Continuing the long transition to zero-sized fn items,
5908   per [RFC 401].
5909 * [Fix `#[derive]` for empty tuple structs/variants][35728].
5910   Part of [RFC 1506].
5911 * [Issue deprecation warnings for safe accesses to extern statics][36173]
5912 * [Fix lifetime rules for 'if' conditions][36029].
5913 * [Inherit overflow checks for sum and product][36372].
5914 * [Forbid user-defined macros named "macro_rules"][36730].
5915
5916 [33922]: https://github.com/rust-lang/rust/pull/33922
5917 [34623]: https://github.com/rust-lang/rust/pull/34623
5918 [34923]: https://github.com/rust-lang/rust/pull/34923
5919 [34942]: https://github.com/rust-lang/rust/pull/34942
5920 [34982]: https://github.com/rust-lang/rust/pull/34982
5921 [35021]: https://github.com/rust-lang/rust/pull/35021
5922 [35048]: https://github.com/rust-lang/rust/pull/35048
5923 [35074]: https://github.com/rust-lang/rust/pull/35074
5924 [35124]: https://github.com/rust-lang/rust/pull/35124
5925 [35234]: https://github.com/rust-lang/rust/pull/35234
5926 [35238]: https://github.com/rust-lang/rust/pull/35238
5927 [35354]: https://github.com/rust-lang/rust/pull/35354
5928 [35559]: https://github.com/rust-lang/rust/pull/35559
5929 [35585]: https://github.com/rust-lang/rust/pull/35585
5930 [35627]: https://github.com/rust-lang/rust/pull/35627
5931 [35655]: https://github.com/rust-lang/rust/pull/35655
5932 [35702]: https://github.com/rust-lang/rust/pull/35702
5933 [35707]: https://github.com/rust-lang/rust/pull/35707
5934 [35728]: https://github.com/rust-lang/rust/pull/35728
5935 [35734]: https://github.com/rust-lang/rust/pull/35734
5936 [35755]: https://github.com/rust-lang/rust/pull/35755
5937 [35761]: https://github.com/rust-lang/rust/pull/35761
5938 [35764]: https://github.com/rust-lang/rust/pull/35764
5939 [35814]: https://github.com/rust-lang/rust/pull/35814
5940 [35854]: https://github.com/rust-lang/rust/pull/35854
5941 [35871]: https://github.com/rust-lang/rust/pull/35871
5942 [35884]: https://github.com/rust-lang/rust/pull/35884
5943 [35911]: https://github.com/rust-lang/rust/pull/35911
5944 [35969]: https://github.com/rust-lang/rust/pull/35969
5945 [35975]: https://github.com/rust-lang/rust/pull/35975
5946 [36004]: https://github.com/rust-lang/rust/pull/36004
5947 [36008]: https://github.com/rust-lang/rust/pull/36008
5948 [36014]: https://github.com/rust-lang/rust/pull/36014
5949 [36029]: https://github.com/rust-lang/rust/pull/36029
5950 [36059]: https://github.com/rust-lang/rust/pull/36059
5951 [36072]: https://github.com/rust-lang/rust/pull/36072
5952 [36101]: https://github.com/rust-lang/rust/pull/36101
5953 [36104]: https://github.com/rust-lang/rust/pull/36104
5954 [36171]: https://github.com/rust-lang/rust/pull/36171
5955 [36173]: https://github.com/rust-lang/rust/pull/36173
5956 [36178]: https://github.com/rust-lang/rust/pull/36178
5957 [36213]: https://github.com/rust-lang/rust/pull/36213
5958 [36214]: https://github.com/rust-lang/rust/pull/36214
5959 [36264]: https://github.com/rust-lang/rust/pull/36264
5960 [36266]: https://github.com/rust-lang/rust/pull/36266
5961 [36289]: https://github.com/rust-lang/rust/pull/36289
5962 [36338]: https://github.com/rust-lang/rust/pull/36338
5963 [36351]: https://github.com/rust-lang/rust/pull/36351
5964 [36355]: https://github.com/rust-lang/rust/pull/36355
5965 [36369]: https://github.com/rust-lang/rust/pull/36369
5966 [36372]: https://github.com/rust-lang/rust/pull/36372
5967 [36423]: https://github.com/rust-lang/rust/pull/36423
5968 [36482]: https://github.com/rust-lang/rust/pull/36482
5969 [36505]: https://github.com/rust-lang/rust/pull/36505
5970 [36524]: https://github.com/rust-lang/rust/pull/36524
5971 [36527]: https://github.com/rust-lang/rust/pull/36527
5972 [36551]: https://github.com/rust-lang/rust/pull/36551
5973 [36574]: https://github.com/rust-lang/rust/pull/36574
5974 [36586]: https://github.com/rust-lang/rust/pull/36586
5975 [36592]: https://github.com/rust-lang/rust/pull/36592
5976 [36631]: https://github.com/rust-lang/rust/pull/36631
5977 [36639]: https://github.com/rust-lang/rust/pull/36639
5978 [36721]: https://github.com/rust-lang/rust/pull/36721
5979 [36727]: https://github.com/rust-lang/rust/pull/36727
5980 [36730]: https://github.com/rust-lang/rust/pull/36730
5981 [36734]: https://github.com/rust-lang/rust/pull/36734
5982 [36754]: https://github.com/rust-lang/rust/pull/36754
5983 [36995]: https://github.com/rust-lang/rust/pull/36995
5984 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
5985 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
5986 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
5987 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
5988 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
5989 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
5990 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
5991 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
5992 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
5993 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
5994 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
5995 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
5996 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
5997 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
5998 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
5999 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
6000 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
6001 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
6002 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
6003 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
6004 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
6005 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
6006 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
6007 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
6008 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
6009 [rustup]: https://www.rustup.rs
6010 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
6011 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
6012 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
6013 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
6014 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
6015 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
6016 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
6017
6018
6019 Version 1.12.1 (2016-10-20)
6020 ===========================
6021
6022 Regression Fixes
6023 ----------------
6024
6025 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
6026 * [Confusion with double negation and booleans][36856]
6027 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
6028 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
6029 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
6030 * [Corrupted memory after updated to 1.12][36936]
6031 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
6032 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
6033 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
6034
6035 [36381]: https://github.com/rust-lang/rust/issues/36381
6036 [36856]: https://github.com/rust-lang/rust/issues/36856
6037 [36875]: https://github.com/rust-lang/rust/issues/36875
6038 [36924]: https://github.com/rust-lang/rust/issues/36924
6039 [36926]: https://github.com/rust-lang/rust/issues/36926
6040 [36936]: https://github.com/rust-lang/rust/issues/36936
6041 [37026]: https://github.com/rust-lang/rust/issues/37026
6042 [37112]: https://github.com/rust-lang/rust/issues/37112
6043 [37153]: https://github.com/rust-lang/rust/issues/37153
6044
6045
6046 Version 1.12.0 (2016-09-29)
6047 ===========================
6048
6049 Highlights
6050 ----------
6051
6052 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6053   This translation pass is far simpler than the previous AST->LLVM pass, and
6054   creates opportunities to perform new optimizations directly on the MIR. It
6055   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6056 * [`rustc` presents a new, more readable error format, along with
6057   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6058   Most common editors supporting Rust have been updated to work with it. It was
6059   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6060
6061 Compiler
6062 --------
6063
6064 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6065   This translation pass is far simpler than the previous AST->LLVM pass, and
6066   creates opportunities to perform new optimizations directly on the MIR. It
6067   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6068 * [Print the Rust target name, not the LLVM target name, with
6069   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
6070 * [The computation of `TypeId` is correct in some cases where it was previously
6071   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
6072 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
6073 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
6074   `--print relocation-models`, and `--print code-models` print the available
6075   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
6076   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
6077 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
6078   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
6079   These targets produce statically-linked binaries. There are no binary release
6080   builds yet though.
6081
6082 Diagnostics
6083 -----------
6084
6085 * [`rustc` presents a new, more readable error format, along with
6086   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6087   Most common editors supporting Rust have been updated to work with it. It was
6088   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6089 * [In error descriptions, references are now described in plain English,
6090   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
6091 * [In error type descriptions, unknown numeric types are named `{integer}` or
6092   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
6093 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
6094
6095 Language
6096 --------
6097
6098 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
6099 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
6100 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
6101   useful](https://github.com/rust-lang/rust/pull/34908)
6102 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
6103   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
6104 * [Semicolons are properly required as statement delimiters inside
6105   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
6106 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
6107
6108 Stabilized APIs
6109 ---------------
6110
6111 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
6112 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
6113 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
6114 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
6115 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
6116 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
6117 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
6118 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
6119 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
6120 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
6121   Both on Unix and Windows.
6122 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
6123 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
6124 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
6125 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
6126 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
6127 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
6128 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
6129 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
6130
6131 Libraries
6132 ---------
6133
6134 * [The `format!` macro and friends now allow a single argument to be formatted
6135   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
6136 * [The lifetime bounds on `[T]::binary_search_by` and
6137   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
6138 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
6139 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
6140 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
6141 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
6142 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
6143 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
6144 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
6145 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
6146   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
6147 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
6148   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
6149 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
6150 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
6151   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
6152 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
6153 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
6154 * [`mpsc::sync_channel` `Receiver`s return any available message before
6155   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
6156 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
6157 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
6158
6159 Cargo
6160 -----
6161
6162 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
6163 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
6164 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
6165 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
6166 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
6167 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
6168 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
6169 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
6170 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
6171 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
6172 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
6173 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
6174 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
6175 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
6176 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
6177 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
6178
6179 Performance
6180 -----------
6181
6182 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
6183 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
6184
6185 Tooling
6186 -------
6187
6188 * [Test binaries now support a `--test-threads` argument to specify the number
6189   of threads used to run tests, and which acts the same as the
6190   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
6191 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
6192 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
6193 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
6194 * [Rust releases now come with source packages that can be installed by rustup
6195   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
6196   The resulting source code can be used by tools and IDES, located in the
6197   sysroot under `lib/rustlib/src`.
6198
6199 Misc
6200 ----
6201
6202 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
6203 * Many minor improvements to the documentation.
6204 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
6205
6206 Compatibility Notes
6207 -------------------
6208
6209 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
6210   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
6211 * [When formatting strings, if "precision" is specified, the "fill",
6212   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
6213 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
6214
6215
6216 Version 1.11.0 (2016-08-18)
6217 ===========================
6218
6219 Language
6220 --------
6221
6222 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
6223 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
6224 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
6225 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
6226
6227 Stabilized APIs
6228 ---------------
6229
6230 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
6231 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
6232 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
6233 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
6234 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
6235 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
6236   (in libcore - previously stabilized in libstd)
6237 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
6238   (in libcore - previously stabilized in libstd)
6239 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
6240   (in libcore - previously stabilized in libstd)
6241 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
6242   (in libcore - previously stabilized in libstd)
6243 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
6244 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
6245 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
6246 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
6247
6248 Libraries
6249 ---------
6250
6251 * [The `thread_local!` macro supports multiple definitions in a single
6252    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
6253 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
6254 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
6255   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
6256 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
6257 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
6258 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
6259 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
6260
6261 Cargo
6262 -----
6263
6264 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
6265 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
6266 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
6267 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
6268 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
6269   and `-vv` prints warnings for all crates.
6270 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
6271 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
6272   This provides room for expansion by arbitrary tools.
6273 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
6274 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
6275 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
6276 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
6277 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
6278 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
6279 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
6280
6281 Performance
6282 -----------
6283
6284 * [Caching projections speeds up type check dramatically for some
6285   workloads](https://github.com/rust-lang/rust/pull/33816)
6286 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
6287   This hasher is faster, but is believed to provide sufficient
6288   protection from collision attacks.
6289 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
6290
6291 Rustdoc
6292 -------
6293
6294 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
6295 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
6296 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
6297 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
6298 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
6299
6300 Tooling
6301 -------
6302
6303 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
6304 * [When emitting debug info, rustc emits frame pointers for closures,
6305   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
6306 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
6307 * Many more errors have been given error codes and extended
6308   explanations
6309 * API documentation continues to be improved, with many new examples
6310
6311 Misc
6312 ----
6313
6314 * [rustc no longer hangs when dependencies recursively re-export
6315   submodules](https://github.com/rust-lang/rust/pull/34542)
6316 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
6317 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
6318   rewritten](https://github.com/rust-lang/rust/pull/33895)
6319 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
6320   No targets use this yet, but it works toward AVR support.
6321
6322 Compatibility Notes
6323 -------------------
6324
6325 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
6326 * [The new follow-set rules that place restrictions on `macro_rules!`
6327   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
6328   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
6329   and has been a warning since 1.10.
6330 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
6331   This causes breakage in some corner cases.
6332
6333
6334 Version 1.10.0 (2016-07-07)
6335 ===========================
6336
6337 Language
6338 --------
6339
6340 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
6341   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
6342 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
6343 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
6344 * [`panic!` can be converted to a runtime abort with the
6345   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
6346   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
6347 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
6348   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
6349   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
6350   Note that Cargo does not yet directly support cdylibs.
6351
6352 Stabilized APIs
6353 ---------------
6354
6355 * `os::windows::fs::OpenOptionsExt::access_mode`
6356 * `os::windows::fs::OpenOptionsExt::share_mode`
6357 * `os::windows::fs::OpenOptionsExt::custom_flags`
6358 * `os::windows::fs::OpenOptionsExt::attributes`
6359 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
6360 * `os::unix::fs::OpenOptionsExt::custom_flags`
6361 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
6362 * `Default for sync::Weak`
6363 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
6364 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
6365 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
6366 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
6367 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
6368 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
6369 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
6370 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
6371 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
6372 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
6373 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
6374 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
6375 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
6376 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
6377 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
6378 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
6379 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
6380 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
6381 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
6382 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
6383 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
6384 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
6385 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
6386 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
6387 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
6388 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
6389 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
6390 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
6391 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
6392 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
6393 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
6394 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
6395 * Read/Write/RawFd impls for `UnixStream`
6396 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
6397 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
6398 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
6399 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
6400 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
6401 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
6402 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
6403 * RawFd impls for `UnixListener`
6404 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
6405 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
6406 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
6407 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
6408 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
6409 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
6410 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
6411 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
6412 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
6413 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
6414 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
6415 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
6416 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
6417 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
6418 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
6419 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
6420 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
6421 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
6422 * RawFd impls for `UnixDatagram`
6423 * `{BTree,Hash}Map::values_mut`
6424 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
6425
6426 Libraries
6427 ---------
6428
6429 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
6430   The semantics of this minor method are subtle and probably not what
6431   most people want.
6432 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
6433 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
6434   will fall back to `/dev/urandom` temporarily to avoid blocking
6435   during early boot](https://github.com/rust-lang/rust/pull/33086).
6436 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
6437 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
6438 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
6439 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
6440 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
6441 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
6442   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
6443
6444 Cargo
6445 -----
6446 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
6447   This controls the runtime behavior of the `panic!` macro
6448   and can be either "unwind" (the default), or "abort".
6449   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
6450 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
6451 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
6452 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
6453   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
6454 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
6455 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
6456 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
6457   By default they are retried twice, which can be customized with the
6458   `net.retry` value in `.cargo/config`.
6459 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
6460 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
6461 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
6462 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
6463   Makes it possible to install multiple crates in parallel.
6464 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
6465 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
6466 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
6467 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
6468 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
6469 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
6470
6471 Performance
6472 -----------
6473
6474 * [rustc memory usage was reduced by refactoring the context used for
6475   type checking](https://github.com/rust-lang/rust/pull/33425).
6476 * [Speed up creation of `HashMap`s by caching the random keys used
6477   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
6478 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
6479 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
6480 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
6481   10x faster than the previous lookup tables.
6482 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
6483
6484 Usability
6485 ---------
6486
6487 * Many incremental improvements to documentation and rustdoc.
6488 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
6489 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
6490 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
6491 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
6492 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
6493 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
6494 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
6495
6496 Misc
6497 ----
6498
6499 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
6500 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
6501 * [`std` no longer prints backtraces on platforms where the running
6502   module must be loaded with `env::current_exe`, which can't be relied
6503   on](https://github.com/rust-lang/rust/pull/33554).
6504 * This release includes std binaries for the i586-unknown-linux-gnu,
6505   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
6506   i586 target is for old x86 hardware without SSE2, and the armv7
6507   target is for Android running on modern ARM architectures.
6508 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
6509   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
6510 * [On Unix the runtime aborts by calling `libc::abort` instead of
6511   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
6512 * [Rust is now bootstrapped from the previous release of Rust,
6513   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
6514
6515 Compatibility Notes
6516 -------------------
6517
6518 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
6519 * [`target_env` for Linux ARM targets is just `gnu`, not
6520   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
6521 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
6522 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
6523 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
6524   Affects how macros are parsed.
6525 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
6526 * [Feature-gated attributes on macro-generated macro invocations are
6527   now rejected](https://github.com/rust-lang/rust/pull/32791).
6528 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
6529   This caused some minor changes to type inference.
6530
6531
6532 Version 1.9.0 (2016-05-26)
6533 ==========================
6534
6535 Language
6536 --------
6537
6538 * The `#[deprecated]` attribute when applied to an API will generate
6539   warnings when used. The warnings may be suppressed with
6540   `#[allow(deprecated)]`. [RFC 1270].
6541 * [`fn` item types are zero sized, and each `fn` names a unique
6542   type][1.9fn]. This will break code that transmutes `fn`s, so calling
6543   `transmute` on a `fn` type will generate a warning for a few cycles,
6544   then will be converted to an error.
6545 * [Field and method resolution understand visibility, so private
6546   fields and methods cannot prevent the proper use of public fields
6547   and methods][1.9fv].
6548 * [The parser considers unicode codepoints in the
6549   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
6550
6551 Stabilized APIs
6552 ---------------
6553
6554 * [`std::panic`]
6555 * [`std::panic::catch_unwind`] (renamed from `recover`)
6556 * [`std::panic::resume_unwind`] (renamed from `propagate`)
6557 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
6558 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
6559 * [`str::is_char_boundary`]
6560 * [`<*const T>::as_ref`]
6561 * [`<*mut T>::as_ref`]
6562 * [`<*mut T>::as_mut`]
6563 * [`AsciiExt::make_ascii_uppercase`]
6564 * [`AsciiExt::make_ascii_lowercase`]
6565 * [`char::decode_utf16`]
6566 * [`char::DecodeUtf16`]
6567 * [`char::DecodeUtf16Error`]
6568 * [`char::DecodeUtf16Error::unpaired_surrogate`]
6569 * [`BTreeSet::take`]
6570 * [`BTreeSet::replace`]
6571 * [`BTreeSet::get`]
6572 * [`HashSet::take`]
6573 * [`HashSet::replace`]
6574 * [`HashSet::get`]
6575 * [`OsString::with_capacity`]
6576 * [`OsString::clear`]
6577 * [`OsString::capacity`]
6578 * [`OsString::reserve`]
6579 * [`OsString::reserve_exact`]
6580 * [`OsStr::is_empty`]
6581 * [`OsStr::len`]
6582 * [`std::os::unix::thread`]
6583 * [`RawPthread`]
6584 * [`JoinHandleExt`]
6585 * [`JoinHandleExt::as_pthread_t`]
6586 * [`JoinHandleExt::into_pthread_t`]
6587 * [`HashSet::hasher`]
6588 * [`HashMap::hasher`]
6589 * [`CommandExt::exec`]
6590 * [`File::try_clone`]
6591 * [`SocketAddr::set_ip`]
6592 * [`SocketAddr::set_port`]
6593 * [`SocketAddrV4::set_ip`]
6594 * [`SocketAddrV4::set_port`]
6595 * [`SocketAddrV6::set_ip`]
6596 * [`SocketAddrV6::set_port`]
6597 * [`SocketAddrV6::set_flowinfo`]
6598 * [`SocketAddrV6::set_scope_id`]
6599 * [`slice::copy_from_slice`]
6600 * [`ptr::read_volatile`]
6601 * [`ptr::write_volatile`]
6602 * [`OpenOptions::create_new`]
6603 * [`TcpStream::set_nodelay`]
6604 * [`TcpStream::nodelay`]
6605 * [`TcpStream::set_ttl`]
6606 * [`TcpStream::ttl`]
6607 * [`TcpStream::set_only_v6`]
6608 * [`TcpStream::only_v6`]
6609 * [`TcpStream::take_error`]
6610 * [`TcpStream::set_nonblocking`]
6611 * [`TcpListener::set_ttl`]
6612 * [`TcpListener::ttl`]
6613 * [`TcpListener::set_only_v6`]
6614 * [`TcpListener::only_v6`]
6615 * [`TcpListener::take_error`]
6616 * [`TcpListener::set_nonblocking`]
6617 * [`UdpSocket::set_broadcast`]
6618 * [`UdpSocket::broadcast`]
6619 * [`UdpSocket::set_multicast_loop_v4`]
6620 * [`UdpSocket::multicast_loop_v4`]
6621 * [`UdpSocket::set_multicast_ttl_v4`]
6622 * [`UdpSocket::multicast_ttl_v4`]
6623 * [`UdpSocket::set_multicast_loop_v6`]
6624 * [`UdpSocket::multicast_loop_v6`]
6625 * [`UdpSocket::set_multicast_ttl_v6`]
6626 * [`UdpSocket::multicast_ttl_v6`]
6627 * [`UdpSocket::set_ttl`]
6628 * [`UdpSocket::ttl`]
6629 * [`UdpSocket::set_only_v6`]
6630 * [`UdpSocket::only_v6`]
6631 * [`UdpSocket::join_multicast_v4`]
6632 * [`UdpSocket::join_multicast_v6`]
6633 * [`UdpSocket::leave_multicast_v4`]
6634 * [`UdpSocket::leave_multicast_v6`]
6635 * [`UdpSocket::take_error`]
6636 * [`UdpSocket::connect`]
6637 * [`UdpSocket::send`]
6638 * [`UdpSocket::recv`]
6639 * [`UdpSocket::set_nonblocking`]
6640
6641 Libraries
6642 ---------
6643
6644 * [`std::sync::Once` is poisoned if its initialization function
6645   fails][1.9o].
6646 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
6647 * [Most types implement `fmt::Debug`][1.9db].
6648 * [The default buffer size used by `BufReader` and `BufWriter` was
6649   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
6650   used by other languages.
6651 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
6652   `Duration` additionally implements `*=` and `/=`][1.9ta].
6653 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
6654 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
6655 * [`Chain` implements `BufRead`][1.9ch].
6656 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
6657
6658 Cargo
6659 -----
6660
6661 * [Cargo can now run concurrently][1.9cc].
6662 * [Top-level overrides allow specific revisions of crates to be
6663   overridden through the entire crate graph][1.9ct].  This is intended
6664   to make upgrades easier for large projects, by allowing crates to be
6665   forked temporarily until they've been upgraded and republished.
6666 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
6667 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
6668   on the commandline][1.9cf]. `rustc` arguments can also be specified
6669   in the `build.rustflags` configuration key.
6670
6671 Performance
6672 -----------
6673
6674 * [The time complexity of comparing variables for equivalence during type
6675   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
6676   to major compilation time improvement in some scenarios.
6677 * [`ToString` is specialized for `str`, giving it the same performance
6678   as `to_owned`][1.9ts].
6679 * [Spawning processes with `Command::output` no longer creates extra
6680   threads][1.9sp].
6681 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
6682   for C-like enums][1.9cl].
6683
6684 Misc
6685 ----
6686
6687 * [Passing the `--quiet` flag to a test runner will produce
6688   much-abbreviated output][1.9q].
6689 * The Rust Project now publishes std binaries for the
6690   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
6691   `i586-pc-windows-msvc` targets.
6692
6693 Compatibility Notes
6694 -------------------
6695
6696 * [`std::sync::Once` is poisoned if its initialization function
6697   fails][1.9o].
6698 * [It is illegal to define methods with the same name in overlapping
6699   inherent `impl` blocks][1.9sn].
6700 * [`fn` item types are zero sized, and each `fn` names a unique
6701   type][1.9fn]. This will break code that transmutes `fn`s, so calling
6702   `transmute` on a `fn` type will generate a warning for a few cycles,
6703   then will be converted to an error.
6704 * [Improvements to const evaluation may trigger new errors when integer
6705   literals are out of range][1.9ce].
6706
6707
6708 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
6709 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
6710 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
6711 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
6712 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
6713 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
6714 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
6715 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
6716 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
6717 [1.9db]: https://github.com/rust-lang/rust/pull/32054
6718 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
6719 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
6720 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
6721 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
6722 [1.9o]: https://github.com/rust-lang/rust/pull/32325
6723 [1.9q]: https://github.com/rust-lang/rust/pull/31887
6724 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
6725 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
6726 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
6727 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
6728 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
6729 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
6730 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
6731 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
6732 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
6733 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
6734 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
6735 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
6736 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
6737 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
6738 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
6739 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
6740 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
6741 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
6742 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
6743 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
6744 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
6745 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
6746 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
6747 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
6748 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
6749 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
6750 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
6751 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
6752 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
6753 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
6754 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
6755 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
6756 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
6757 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
6758 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
6759 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
6760 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
6761 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
6762 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
6763 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
6764 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
6765 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
6766 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
6767 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
6768 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
6769 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
6770 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
6771 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
6772 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
6773 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
6774 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
6775 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
6776 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
6777 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
6778 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
6779 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
6780 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
6781 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
6782 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
6783 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
6784 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
6785 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
6786 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
6787 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
6788 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
6789 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
6790 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
6791 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
6792 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
6793 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
6794 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
6795 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
6796 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
6797 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
6798 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
6799 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
6800 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
6801 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
6802 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
6803 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
6804 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
6805 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
6806 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
6807 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
6808 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
6809 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
6810 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
6811 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
6812 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
6813 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
6814 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
6815 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
6816 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
6817 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
6818
6819
6820 Version 1.8.0 (2016-04-14)
6821 ==========================
6822
6823 Language
6824 --------
6825
6826 * Rust supports overloading of compound assignment statements like
6827   `+=` by implementing the [`AddAssign`], [`SubAssign`],
6828   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
6829   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
6830   traits. [RFC 953].
6831 * Empty structs can be defined with braces, as in `struct Foo { }`, in
6832   addition to the non-braced form, `struct Foo;`. [RFC 218].
6833
6834 Libraries
6835 ---------
6836
6837 * Stabilized APIs:
6838   * [`str::encode_utf16`] (renamed from `utf16_units`)
6839   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
6840   * [`Ref::map`]
6841   * [`RefMut::map`]
6842   * [`ptr::drop_in_place`]
6843   * [`time::Instant`]
6844   * [`time::SystemTime`]
6845   * [`Instant::now`]
6846   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
6847   * [`Instant::elapsed`]
6848   * [`SystemTime::now`]
6849   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
6850   * [`SystemTime::elapsed`]
6851   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
6852   * [`SystemTimeError`]
6853   * [`SystemTimeError::duration`]
6854   * Various impls for `SystemTimeError`
6855   * [`UNIX_EPOCH`]
6856   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
6857     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
6858     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
6859 * [The `write!` and `writeln!` macros correctly emit errors if any of
6860   their arguments can't be formatted][1.8w].
6861 * [Various I/O functions support large files on 32-bit Linux][1.8l].
6862 * [The Unix-specific `raw` modules, which contain a number of
6863   redefined C types are deprecated][1.8r], including `os::raw::unix`,
6864   `os::raw::macos`, and `os::raw::linux`. These modules defined types
6865   such as `ino_t` and `dev_t`. The inconsistency of these definitions
6866   across platforms was making it difficult to implement `std`
6867   correctly. Those that need these definitions should use the `libc`
6868   crate. [RFC 1415].
6869 * The Unix-specific `MetadataExt` traits, including
6870   `os::unix::fs::MetadataExt`, which expose values such as inode
6871   numbers [no longer return platform-specific types][1.8r], but
6872   instead return widened integers. [RFC 1415].
6873 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
6874 * [Atomic loads and stores are not volatile][1.8a].
6875 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
6876
6877 Performance
6878 -----------
6879
6880 * [Inlining hash functions lead to a 3% compile-time improvement in
6881   some workloads][1.8h].
6882 * When using jemalloc, its symbols are [unprefixed so that it
6883   overrides the libc malloc implementation][1.8h]. This means that for
6884   rustc, LLVM is now using jemalloc, which results in a 6%
6885   compile-time improvement on a specific workload.
6886 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
6887
6888 Misc
6889 ----
6890
6891 * [32-bit MSVC builds finally implement unwinding][1.8ms].
6892   i686-pc-windows-msvc is now considered a tier-1 platform.
6893 * [The `--print targets` flag prints a list of supported targets][1.8t].
6894 * [The `--print cfg` flag prints the `cfg`s defined for the current
6895   target][1.8cf].
6896 * [`rustc` can be built with an new Cargo-based build system, written
6897   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
6898   build system. To enable it configure with `configure --rustbuild`.
6899 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
6900   variants while also indicating the total number of missing variants
6901   if more than 3][1.8m].
6902 * [Executable stacks are disabled on Linux and BSD][1.8nx].
6903 * The Rust Project now publishes binary releases of the standard
6904   library for a number of tier-2 targets:
6905   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
6906   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
6907   `x86_64-rumprun-netbsd`. These can be installed with
6908   tools such as [multirust][1.8mr].
6909
6910 Cargo
6911 -----
6912
6913 * [`cargo init` creates a new Cargo project in the current
6914   directory][1.8ci].  It is otherwise like `cargo new`.
6915 * [Cargo has configuration keys for `-v` and
6916   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
6917   `[term]` section of `.cargo/config`.
6918 * [Configuration keys that evaluate to strings or integers can be set
6919   via environment variables][1.8ce]. For example the `build.jobs` key
6920   can be set via `CARGO_BUILD_JOBS`. Environment variables take
6921   precedence over config files.
6922 * [Target-specific dependencies support Rust `cfg` syntax for
6923   describing targets][1.8cfg] so that dependencies for multiple
6924   targets can be specified together. [RFC 1361].
6925 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
6926   `RUSTDOC` take precedence over the `build.target-dir`,
6927   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
6928 * [The child process tree is killed on Windows when Cargo is
6929   killed][1.8ck].
6930 * [The `build.target` configuration value sets the target platform,
6931   like `--target`][1.8ct].
6932
6933 Compatibility Notes
6934 -------------------
6935
6936 * [Unstable compiler flags have been further restricted][1.8u]. Since
6937   1.0 `-Z` flags have been considered unstable, and other flags that
6938   were considered unstable additionally required passing `-Z
6939   unstable-options` to access. Unlike unstable language and library
6940   features though, these options have been accessible on the stable
6941   release channel. Going forward, *new unstable flags will not be
6942   available on the stable release channel*, and old unstable flags
6943   will warn about their usage. In the future, all unstable flags will
6944   be unavailable on the stable release channel.
6945 * [It is no longer possible to `match` on empty enum variants using
6946   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
6947 * The Unix-specific `MetadataExt` traits, including
6948   `os::unix::fs::MetadataExt`, which expose values such as inode
6949   numbers [no longer return platform-specific types][1.8r], but
6950   instead return widened integers. [RFC 1415].
6951 * [Modules sourced from the filesystem cannot appear within arbitrary
6952   blocks, but only within other modules][1.8mf].
6953 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
6954 * On Unix, [stack overflow triggers a runtime abort instead of a
6955   SIGSEGV][1.8so].
6956 * [`Command::spawn` and its equivalents return an error if any of
6957   its command-line arguments contain interior `NUL`s][1.8n].
6958 * [Tuple and unit enum variants from other crates are in the type
6959   namespace][1.8tn].
6960 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
6961   type instead of `.a` files][1.8st]. Additionally, for the MSVC
6962   toolchain, `rustc` emits import libraries named `foo.dll.lib`
6963   instead of `foo.lib`.
6964
6965
6966 [1.8a]: https://github.com/rust-lang/rust/pull/30962
6967 [1.8b]: https://github.com/rust-lang/rust/pull/31123
6968 [1.8c]: https://github.com/rust-lang/rust/pull/31530
6969 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
6970 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
6971 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
6972 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
6973 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
6974 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
6975 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
6976 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
6977 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
6978 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
6979 [1.8h]: https://github.com/rust-lang/rust/pull/31460
6980 [1.8l]: https://github.com/rust-lang/rust/pull/31668
6981 [1.8m]: https://github.com/rust-lang/rust/pull/31020
6982 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
6983 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
6984 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
6985 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
6986 [1.8n]: https://github.com/rust-lang/rust/pull/31056
6987 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
6988 [1.8r]: https://github.com/rust-lang/rust/pull/31551
6989 [1.8so]: https://github.com/rust-lang/rust/pull/31333
6990 [1.8st]: https://github.com/rust-lang/rust/pull/29520
6991 [1.8t]: https://github.com/rust-lang/rust/pull/31358
6992 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
6993 [1.8u]: https://github.com/rust-lang/rust/pull/31793
6994 [1.8v]: https://github.com/rust-lang/rust/pull/31757
6995 [1.8w]: https://github.com/rust-lang/rust/pull/31904
6996 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
6997 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
6998 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
6999 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
7000 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
7001 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
7002 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
7003 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
7004 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
7005 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
7006 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
7007 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
7008 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
7009 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
7010 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
7011 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
7012 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
7013 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
7014 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
7015 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
7016 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
7017 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
7018 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
7019 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
7020 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
7021 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
7022 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
7023 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
7024 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
7025 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
7026
7027
7028 Version 1.7.0 (2016-03-03)
7029 ==========================
7030
7031 Libraries
7032 ---------
7033
7034 * Stabilized APIs
7035   * `Path`
7036     * [`Path::strip_prefix`] (renamed from relative_from)
7037     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
7038   * `Ipv4Addr`
7039     * [`Ipv4Addr::is_loopback`]
7040     * [`Ipv4Addr::is_private`]
7041     * [`Ipv4Addr::is_link_local`]
7042     * [`Ipv4Addr::is_multicast`]
7043     * [`Ipv4Addr::is_broadcast`]
7044     * [`Ipv4Addr::is_documentation`]
7045   * `Ipv6Addr`
7046     * [`Ipv6Addr::is_unspecified`]
7047     * [`Ipv6Addr::is_loopback`]
7048     * [`Ipv6Addr::is_multicast`]
7049   * `Vec`
7050     * [`Vec::as_slice`]
7051     * [`Vec::as_mut_slice`]
7052   * `String`
7053     * [`String::as_str`]
7054     * [`String::as_mut_str`]
7055   * Slices
7056     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
7057     be the same length
7058     * `<[T]>::`[`sort_by_key`]
7059   * checked, saturated, and overflowing operations
7060     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
7061     * [`i32::saturating_mul`]
7062     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
7063     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
7064     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
7065     * [`u32::saturating_mul`]
7066     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
7067     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
7068     * and checked, saturated, and overflowing operations for other primitive types
7069   * FFI
7070     * [`ffi::IntoStringError`]
7071     * [`CString::into_string`]
7072     * [`CString::into_bytes`]
7073     * [`CString::into_bytes_with_nul`]
7074     * `From<CString> for Vec<u8>`
7075   * `IntoStringError`
7076     * [`IntoStringError::into_cstring`]
7077     * [`IntoStringError::utf8_error`]
7078     * `Error for IntoStringError`
7079   * Hashing
7080     * [`std::hash::BuildHasher`]
7081     * [`BuildHasher::Hasher`]
7082     * [`BuildHasher::build_hasher`]
7083     * [`std::hash::BuildHasherDefault`]
7084     * [`HashMap::with_hasher`]
7085     * [`HashMap::with_capacity_and_hasher`]
7086     * [`HashSet::with_hasher`]
7087     * [`HashSet::with_capacity_and_hasher`]
7088     * [`std::collections::hash_map::RandomState`]
7089     * [`RandomState::new`]
7090 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
7091   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
7092   from bytes is faster.
7093 * [The performance of `LineWriter` (and thus `io::stdout`) was
7094   improved by using `memchr` to search for newlines][1.7m].
7095 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
7096   `f64` variants were stabilized previously.
7097 * [`BTreeMap` was rewritten to use less memory and improve the performance
7098   of insertion and iteration, the latter by as much as 5x][1.7bm].
7099 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
7100   covariant over their contained type][1.7bt].
7101 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
7102   over their contained type][1.7ll].
7103 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
7104   searching methods.
7105 * [`Any` is implemented for unsized types][1.7a].
7106 * [`Hash` is implemented for `Duration`][1.7h].
7107
7108 Misc
7109 ----
7110
7111 * [When running tests with `--test`, rustdoc will pass `--cfg`
7112   arguments to the compiler][1.7dt].
7113 * [The compiler is built with RPATH information by default][1.7rpa].
7114   This means that it will be possible to run `rustc` when installed in
7115   unusual configurations without configuring the dynamic linker search
7116   path explicitly.
7117 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
7118   any RPATH entries (emitted with `-C rpath`) *not* take precedence
7119   over `LD_LIBRARY_PATH`.
7120
7121 Cargo
7122 -----
7123
7124 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
7125   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
7126 * [The `rerun-if-changed` build script directive no longer causes the
7127   build script to incorrectly run twice in certain scenarios][1.7rr].
7128
7129 Compatibility Notes
7130 -------------------
7131
7132 * Soundness fixes to the interactions between associated types and
7133   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
7134   code that violates the new rules. This is a significant change that
7135   is known to break existing code, so it has emitted warnings for the
7136   new error cases since 1.4 to give crate authors time to adapt. The
7137   details of what is changing are subtle; read the RFC for more.
7138 * [Several bugs in the compiler's visibility calculations were
7139   fixed][1.7v]. Since this was found to break significant amounts of
7140   code, the new errors will be emitted as warnings for several release
7141   cycles, under the `private_in_public` lint.
7142 * Defaulted type parameters were accidentally accepted in positions
7143   that were not intended. In this release, [defaulted type parameters
7144   appearing outside of type definitions will generate a
7145   warning][1.7d], which will become an error in future releases.
7146 * [Parsing "." as a float results in an error instead of 0][1.7p].
7147   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
7148 * [Borrows of closure parameters may not outlive the closure][1.7bc].
7149
7150 [1.7a]: https://github.com/rust-lang/rust/pull/30928
7151 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
7152 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
7153 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
7154 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
7155 [1.7d]: https://github.com/rust-lang/rust/pull/30724
7156 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
7157 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
7158 [1.7f]: https://github.com/rust-lang/rust/pull/30672
7159 [1.7h]: https://github.com/rust-lang/rust/pull/30818
7160 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
7161 [1.7m]: https://github.com/rust-lang/rust/pull/30381
7162 [1.7p]: https://github.com/rust-lang/rust/pull/30681
7163 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
7164 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
7165 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
7166 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
7167 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
7168 [1.7v]: https://github.com/rust-lang/rust/pull/29973
7169 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7170 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
7171 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
7172 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
7173 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
7174 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
7175 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
7176 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
7177 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
7178 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
7179 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
7180 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
7181 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
7182 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
7183 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
7184 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
7185 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
7186 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
7187 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
7188 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
7189 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
7190 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
7191 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
7192 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
7193 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
7194 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
7195 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
7196 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
7197 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
7198 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
7199 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
7200 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
7201 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
7202 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
7203 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
7204 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
7205 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
7206 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
7207 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
7208 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
7209 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
7210 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
7211 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
7212 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
7213 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
7214 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
7215 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
7216 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
7217 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
7218 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
7219 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
7220 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
7221 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
7222 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
7223 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
7224 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
7225 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
7226 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
7227 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
7228 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
7229
7230
7231 Version 1.6.0 (2016-01-21)
7232 ==========================
7233
7234 Language
7235 --------
7236
7237 * The `#![no_std]` attribute causes a crate to not be linked to the
7238   standard library, but only the [core library][1.6co], as described
7239   in [RFC 1184]. The core library defines common types and traits but
7240   has no platform dependencies whatsoever, and is the basis for Rust
7241   software in environments that cannot support a full port of the
7242   standard library, such as operating systems. Most of the core
7243   library is now stable.
7244
7245 Libraries
7246 ---------
7247
7248 * Stabilized APIs:
7249   [`Read::read_exact`],
7250   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
7251   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
7252   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
7253   [`os::unix::fs::DirBuilderExt`],
7254   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
7255   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
7256   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
7257   [`collections::hash_map::Drain`],
7258   [`collections::hash_map::HashMap::drain`],
7259   [`collections::hash_set::Drain`],
7260   [`collections::hash_set::HashSet::drain`],
7261   [`collections::binary_heap::Drain`],
7262   [`collections::binary_heap::BinaryHeap::drain`],
7263   [`Vec::extend_from_slice`] (renamed from `push_all`),
7264   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
7265   [`RwLock::into_inner`],
7266   [`Iterator::min_by_key`] (renamed from `min_by`),
7267   [`Iterator::max_by_key`] (renamed from `max_by`).
7268 * The [core library][1.6co] is stable, as are most of its APIs.
7269 * [The `assert_eq!` macro supports arguments that don't implement
7270   `Sized`][1.6ae], such as arrays. In this way it behaves more like
7271   `assert!`.
7272 * Several timer functions that take duration in milliseconds [are
7273   deprecated in favor of those that take `Duration`][1.6ms]. These
7274   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
7275   `thread::park_timeout_ms`.
7276 * The algorithm by which `Vec` reserves additional elements was
7277   [tweaked to not allocate excessive space][1.6a] while still growing
7278   exponentially.
7279 * `From` conversions are [implemented from integers to floats][1.6f]
7280   in cases where the conversion is lossless. Thus they are not
7281   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
7282   or `f64`. They are also not implemented for `isize` and `usize`
7283   because the implementations would be platform-specific. `From` is
7284   also implemented from `f32` to `f64`.
7285 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
7286 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
7287 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
7288 * [`BinaryHeap` was refactored][1.6bh] for modest performance
7289   improvements.
7290 * Sorting slices that are already sorted [is 50% faster in some
7291   cases][1.6s].
7292
7293 Cargo
7294 -----
7295
7296 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
7297 * Cargo build scripts can specify their dependencies by emitting the
7298   [`rerun-if-changed`][1.6rr] key.
7299 * crates.io will reject publication of crates with dependencies that
7300   have a wildcard version constraint. Crates with wildcard
7301   dependencies were seen to cause a variety of problems, as described
7302   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
7303   warning.
7304 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
7305   release folder.  A variety of artifacts that Cargo failed to clean
7306   are now correctly deleted.
7307
7308 Misc
7309 ----
7310
7311 * The `unreachable_code` lint [warns when a function call's argument
7312   diverges][1.6dv].
7313 * The parser indicates [failures that may be caused by
7314   confusingly-similar Unicode characters][1.6uc]
7315 * Certain macro errors [are reported at definition time][1.6m], not
7316   expansion.
7317
7318 Compatibility Notes
7319 -------------------
7320
7321 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
7322   environment variable when locating crates. This was a pre-cargo
7323   feature for integrating with the package manager that was
7324   accidentally never removed.
7325 * [A number of bugs were fixed in the privacy checker][1.6p] that
7326   could cause previously-accepted code to break.
7327 * [Modules and unit/tuple structs may not share the same name][1.6ts].
7328 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
7329   struct pattern syntax (`Foo(..)`) can no longer be used to match
7330   unit structs. This is a warning now, but will become an error in
7331   future releases. Patterns that share the same name as a const are
7332   now an error.
7333 * A bug was fixed that causes [rustc not to apply default type
7334   parameters][1.6xc] when resolving certain method implementations of
7335   traits defined in other crates.
7336
7337 [1.6a]: https://github.com/rust-lang/rust/pull/29454
7338 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
7339 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
7340 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
7341 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
7342 [1.6co]: http://doc.rust-lang.org/core/index.html
7343 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
7344 [1.6f]: https://github.com/rust-lang/rust/pull/29129
7345 [1.6m]: https://github.com/rust-lang/rust/pull/29828
7346 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
7347 [1.6p]: https://github.com/rust-lang/rust/pull/29726
7348 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
7349 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
7350 [1.6s]: https://github.com/rust-lang/rust/pull/29675
7351 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
7352 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
7353 [1.6us]: https://github.com/rust-lang/rust/pull/29383
7354 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
7355 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
7356 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
7357 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
7358 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
7359 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
7360 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
7361 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
7362 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
7363 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
7364 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
7365 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
7366 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
7367 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
7368 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
7369 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
7370 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
7371 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
7372 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
7373 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
7374 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
7375 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
7376 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
7377 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
7378 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
7379 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
7380 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
7381 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
7382 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
7383 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
7384
7385
7386 Version 1.5.0 (2015-12-10)
7387 ==========================
7388
7389 * ~700 changes, numerous bugfixes
7390
7391 Highlights
7392 ----------
7393
7394 * Stabilized APIs:
7395   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
7396   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
7397   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
7398   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
7399   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
7400   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
7401   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
7402   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
7403   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
7404   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
7405   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
7406   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
7407   [`Path::read_link`], [`Path::symlink_metadata`],
7408   [`Utf8Error::valid_up_to`], [`Vec::resize`],
7409   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
7410   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
7411   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
7412   [`slice::split_first_mut`], [`slice::split_first`],
7413   [`slice::split_last_mut`], [`slice::split_last`],
7414   [`char::from_u32_unchecked`], [`fs::canonicalize`],
7415   [`str::MatchIndices`], [`str::RMatchIndices`],
7416   [`str::match_indices`], [`str::rmatch_indices`],
7417   [`str::slice_mut_unchecked`], [`string::ParseError`].
7418 * Rust applications hosted on crates.io can be installed locally to
7419   `~/.cargo/bin` with the [`cargo install`] command. Among other
7420   things this makes it easier to augment Cargo with new subcommands:
7421   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
7422   invoked as `cargo foo`.
7423 * Crates with wildcard (`*`) dependencies will [emit warnings when
7424   published][1.5w]. In 1.6 it will no longer be possible to publish
7425   crates with wildcard dependencies.
7426
7427 Breaking Changes
7428 ----------------
7429
7430 * The rules determining when a particular lifetime must outlive
7431   a particular value (known as '[dropck]') have been [modified
7432   to not rely on parametricity][1.5p].
7433 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
7434   and `Arc`][1.5a]. Because these smart pointer types implement
7435   `Deref`, this causes breakage in cases where the interior type
7436   contains methods of the same name.
7437 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
7438   that they could drop their content. Soundness fix.
7439 * All method invocations are [properly checked][1.5wf1] for
7440   [well-formedness][1.5wf2]. Soundness fix.
7441 * Traits whose supertraits contain `Self` are [not object
7442   safe][1.5o]. Soundness fix.
7443 * Target specifications support a [`no_default_libraries`][1.5nd]
7444   setting that controls whether `-nodefaultlibs` is passed to the
7445   linker, and in turn the `is_like_windows` setting no longer affects
7446   the `-nodefaultlibs` flag.
7447 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
7448 * The `#[inline]` and `#[repr]` attributes [can only appear
7449   in valid locations][1.5at].
7450 * Native libraries linked from the local crate are [passed to
7451   the linker before native libraries from upstream crates][1.5nl].
7452 * Two rarely-used attributes, `#[no_debug]` and
7453   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
7454 * Negation of unsigned integers, which has been a warning for
7455   several releases, [is now behind a feature gate and will
7456   generate errors][1.5nu].
7457 * The parser accidentally accepted visibility modifiers on
7458   enum variants, a bug [which has been fixed][1.5ev].
7459 * [A bug was fixed that allowed `use` statements to import unstable
7460   features][1.5use].
7461
7462 Language
7463 --------
7464
7465 * When evaluating expressions at compile-time that are not
7466   compile-time constants (const-evaluating expressions in non-const
7467   contexts), incorrect code such as overlong bitshifts and arithmetic
7468   overflow will [generate a warning instead of an error][1.5ce],
7469   delaying the error until runtime. This will allow the
7470   const-evaluator to be expanded in the future backwards-compatibly.
7471 * The `improper_ctypes` lint [no longer warns about using `isize` and
7472   `usize` in FFI][1.5ict].
7473
7474 Libraries
7475 ---------
7476
7477 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
7478   invariant][1.5c].
7479 * `Default` is [implemented for mutable slices][1.5d].
7480 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
7481 * There are now `From` conversions [between floating point
7482   types][1.5f] where the conversions are lossless.
7483 * There are now `From` conversions [between integer types][1.5i] where
7484   the conversions are lossless.
7485 * [`fs::Metadata` implements `Clone`][1.5fs].
7486 * The `parse` method [accepts a leading "+" when parsing
7487   integers][1.5pi].
7488 * [`AsMut` is implemented for `Vec`][1.5am].
7489 * The `clone_from` implementations for `String` and `BinaryHeap` [have
7490   been optimized][1.5cf] and no longer rely on the default impl.
7491 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
7492   `unsafe extern "C"` function types now [implement `Clone`,
7493   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
7494   `fmt::Debug` for up to 12 arguments][1.5fp].
7495 * [Dropping `Vec`s is much faster in unoptimized builds when the
7496   element types don't implement `Drop`][1.5dv].
7497 * A bug that caused in incorrect behavior when [combining `VecDeque`
7498   with zero-sized types][1.5vdz] was resolved.
7499 * [`PartialOrd` for slices is faster][1.5po].
7500
7501 Miscellaneous
7502 -------------
7503
7504 * [Crate metadata size was reduced by 20%][1.5md].
7505 * [Improvements to code generation reduced the size of libcore by 3.3
7506   MB and rustc's memory usage by 18MB][1.5m].
7507 * [Improvements to deref translation increased performance in
7508   unoptimized builds][1.5dr].
7509 * Various errors in trait resolution [are deduplicated to only be
7510   reported once][1.5te].
7511 * Rust has preliminary [support for rumprun kernels][1.5rr].
7512 * Rust has preliminary [support for NetBSD on amd64][1.5na].
7513
7514 [1.5use]: https://github.com/rust-lang/rust/pull/28364
7515 [1.5po]: https://github.com/rust-lang/rust/pull/28436
7516 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
7517 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
7518 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
7519 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
7520 [1.5md]: https://github.com/rust-lang/rust/pull/28521
7521 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
7522 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
7523 [1.5na]: https://github.com/rust-lang/rust/pull/28543
7524 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
7525 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
7526 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
7527 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
7528 [1.5te]: https://github.com/rust-lang/rust/pull/28645
7529 [1.5at]: https://github.com/rust-lang/rust/pull/28650
7530 [1.5am]: https://github.com/rust-lang/rust/pull/28663
7531 [1.5m]: https://github.com/rust-lang/rust/pull/28778
7532 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
7533 [1.5a]: https://github.com/rust-lang/rust/pull/28811
7534 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
7535 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
7536 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
7537 [1.5i]: https://github.com/rust-lang/rust/pull/28921
7538 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
7539 [1.5f]: https://github.com/rust-lang/rust/pull/29129
7540 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
7541 [1.5s]: https://github.com/rust-lang/rust/pull/29190
7542 [1.5d]: https://github.com/rust-lang/rust/pull/29245
7543 [1.5o]: https://github.com/rust-lang/rust/pull/29259
7544 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
7545 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7546 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
7547 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
7548 [1.5c]: https://github.com/rust-lang/rust/pull/29110
7549 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
7550 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
7551 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
7552 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
7553 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
7554 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
7555 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
7556 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
7557 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
7558 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
7559 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
7560 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
7561 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
7562 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
7563 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
7564 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
7565 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
7566 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
7567 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
7568 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
7569 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
7570 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
7571 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
7572 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
7573 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
7574 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
7575 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
7576 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
7577 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
7578 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
7579 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
7580 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
7581 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
7582 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
7583 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
7584 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
7585 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
7586 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
7587 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
7588 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
7589 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
7590 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
7591 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
7592 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
7593 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
7594 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
7595 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
7596 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
7597 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
7598 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
7599 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
7600 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
7601 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
7602 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
7603
7604 Version 1.4.0 (2015-10-29)
7605 ==========================
7606
7607 * ~1200 changes, numerous bugfixes
7608
7609 Highlights
7610 ----------
7611
7612 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
7613   GNU) are now supported and recommended for use.
7614
7615 Breaking Changes
7616 ----------------
7617
7618 * [Several changes have been made to fix type soundness and improve
7619   the behavior of associated types][sound]. See [RFC 1214]. Although
7620   we have mostly introduced these changes as warnings this release, to
7621   become errors next release, there are still some scenarios that will
7622   see immediate breakage.
7623 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
7624   line breaks in addition to `\n`][crlf].
7625 * [Loans of `'static` lifetime extend to the end of a function][stat].
7626 * [`str::parse` no longer introduces avoidable rounding error when
7627   parsing floating point numbers. Together with earlier changes to
7628   float formatting/output, "round trips" like f.to_string().parse()
7629   now preserve the value of f exactly. Additionally, leading plus
7630   signs are now accepted][fp3].
7631
7632
7633 Language
7634 --------
7635
7636 * `use` statements that import multiple items [can now rename
7637   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
7638 * [Binops work correctly on fat pointers][binfat].
7639 * `pub extern crate`, which does not behave as expected, [issues a
7640   warning][pec] until a better solution is found.
7641
7642 Libraries
7643 ---------
7644
7645 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
7646   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
7647   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
7648   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
7649   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
7650   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
7651   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
7652   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
7653   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
7654   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
7655   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
7656   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
7657   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
7658   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
7659   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
7660   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
7661   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
7662   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
7663   [`thread::sleep`].
7664 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
7665   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
7666   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
7667   `f64::from_str_radix`.
7668 * [Reverse-searching strings is faster with the 'two-way'
7669   algorithm][s].
7670 * [`std::io::copy` allows `?Sized` arguments][cc].
7671 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
7672   [override `count`, `nth` and `last` with an O(1)
7673   implementation][it].
7674 * [`Default` is implemented for arrays up to `[T; 32]`][d].
7675 * [`IntoRawFd` has been added to the Unix-specific prelude,
7676   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
7677   prelude][pr].
7678 * [`Extend<String>` and `FromIterator<String` are both implemented for
7679   `String`][es].
7680 * [`IntoIterator` is implemented for references to `Option` and
7681   `Result`][into2].
7682 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
7683   Copy`][ext] as part of [RFC 839]. This will cause type inference
7684   breakage in rare situations.
7685 * [`BinaryHeap` implements `Debug`][bh2].
7686 * [`Borrow` and `BorrowMut` are implemented for fixed-size
7687   arrays][bm].
7688 * [`extern fn`s with the "Rust" and "C" ABIs implement common
7689   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
7690 * [String comparison is faster][faststr].
7691 * `&mut T` where `T: std::fmt::Write` [also implements
7692   `std::fmt::Write`][mutw].
7693 * [A stable regression in `VecDeque::push_back` and other
7694   capacity-altering methods that caused panics for zero-sized types
7695   was fixed][vd].
7696 * [Function pointers implement traits for up to 12 parameters][fp2].
7697
7698 Miscellaneous
7699 -------------
7700
7701 * The compiler [no longer uses the 'morestack' feature to prevent
7702   stack overflow][mm]. Instead it uses guard pages and stack
7703   probes (though stack probes are not yet implemented on any platform
7704   but Windows).
7705 * [The compiler matches traits faster when projections are involved][p].
7706 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
7707   `usize`][ffi].
7708 * [Cargo now displays useful information about what its doing during
7709   `cargo update`][cu].
7710
7711 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
7712 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
7713 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
7714 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
7715 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
7716 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
7717 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
7718 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
7719 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
7720 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
7721 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
7722 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
7723 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
7724 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
7725 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
7726 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
7727 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
7728 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
7729 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
7730 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
7731 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
7732 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
7733 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
7734 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
7735 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
7736 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
7737 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
7738 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
7739 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
7740 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
7741 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
7742 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
7743 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
7744 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
7745 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
7746 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
7747 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
7748 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
7749 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
7750 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
7751 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
7752 [bh2]: https://github.com/rust-lang/rust/pull/28156
7753 [binfat]: https://github.com/rust-lang/rust/pull/28270
7754 [bm]: https://github.com/rust-lang/rust/pull/28197
7755 [cc]: https://github.com/rust-lang/rust/pull/27531
7756 [crlf]: https://github.com/rust-lang/rust/pull/28034
7757 [cu]: https://github.com/rust-lang/cargo/pull/1931
7758 [d]: https://github.com/rust-lang/rust/pull/27825
7759 [dep]: https://github.com/rust-lang/rust/pull/28339
7760 [es]: https://github.com/rust-lang/rust/pull/27956
7761 [ext]: https://github.com/rust-lang/rust/pull/28094
7762 [faststr]: https://github.com/rust-lang/rust/pull/28338
7763 [ffi]: https://github.com/rust-lang/rust/pull/28779
7764 [fp]: https://github.com/rust-lang/rust/pull/28268
7765 [fp2]: https://github.com/rust-lang/rust/pull/28560
7766 [fp3]: https://github.com/rust-lang/rust/pull/27307
7767 [i]: https://github.com/rust-lang/rust/pull/27451
7768 [into2]: https://github.com/rust-lang/rust/pull/28039
7769 [it]: https://github.com/rust-lang/rust/pull/27652
7770 [mm]: https://github.com/rust-lang/rust/pull/27338
7771 [mutw]: https://github.com/rust-lang/rust/pull/28368
7772 [sound]: https://github.com/rust-lang/rust/pull/27641
7773 [p]: https://github.com/rust-lang/rust/pull/27866
7774 [pec]: https://github.com/rust-lang/rust/pull/28486
7775 [pr]: https://github.com/rust-lang/rust/pull/27896
7776 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
7777 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7778 [s]: https://github.com/rust-lang/rust/pull/27474
7779 [stab]: https://github.com/rust-lang/rust/pull/28339
7780 [stat]: https://github.com/rust-lang/rust/pull/28321
7781 [vd]: https://github.com/rust-lang/rust/pull/28494
7782
7783 Version 1.3.0 (2015-09-17)
7784 ==============================
7785
7786 * ~900 changes, numerous bugfixes
7787
7788 Highlights
7789 ----------
7790
7791 * The [new object lifetime defaults][nold] have been [turned
7792   on][nold2] after a cycle of warnings about the change. Now types
7793   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
7794   being interpreted as `&'a Box<Trait+'a>` to `&'a
7795   Box<Trait+'static>`.
7796 * [The Rustonomicon][nom] is a new book in the official documentation
7797   that dives into writing unsafe Rust.
7798 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
7799   timekeeping is employed by other std APIs, as well as out-of-tree
7800   time crates.
7801
7802 Breaking Changes
7803 ----------------
7804
7805 * The [new object lifetime defaults][nold] have been [turned
7806   on][nold2] after a cycle of warnings about the change.
7807 * There is a known [regression][lr] in how object lifetime elision is
7808   interpreted, the proper solution for which is undetermined.
7809 * The `#[prelude_import]` attribute, an internal implementation
7810   detail, was accidentally stabilized previously. [It has been put
7811   behind the `prelude_import` feature gate][pi]. This change is
7812   believed to break no existing code.
7813 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
7814   [more sane for dynamically sized types][dst3]. Code that relied on
7815   the previous behavior is thought to be broken.
7816 * The `dropck` rules, which checks that destructors can't access
7817   destroyed values, [have been updated][dropck] to match the
7818   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
7819   cause some previously-compiling code to no longer build.
7820
7821 Language
7822 --------
7823
7824 * The [new object lifetime defaults][nold] have been [turned
7825   on][nold2] after a cycle of warnings about the change.
7826 * Semicolons may [now follow types and paths in
7827   macros](https://github.com/rust-lang/rust/pull/27000).
7828 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
7829   [more sane for dynamically sized types][dst3]. Code that relied on
7830   the previous behavior is not known to exist, and suspected to be
7831   broken.
7832 * `'static` variables [may now be recursive][st].
7833 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
7834   implementations correctly.
7835 * The `dropck` rules, which checks that destructors can't access
7836   destroyed values, [have been updated][dropck] to match the
7837   [RFC][dropckrfc].
7838
7839 Libraries
7840 ---------
7841
7842 * The [`Duration`] API, [has been stabilized][ds], as well as the
7843   `std::time` module, which presently contains only `Duration`.
7844 * `Box<str>` and `Box<[T]>` both implement `Clone`.
7845 * The owned C string, [`CString`], implements [`Borrow`] and the
7846   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
7847   these allow C strings to be borrowed and cloned in generic code.
7848 * [`CStr`] implements [`Debug`].
7849 * [`AtomicPtr`] implements [`Debug`].
7850 * [`Error`] trait objects [can be downcast to their concrete types][e]
7851   in many common configurations, using the [`is`], [`downcast`],
7852   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
7853   [`Any`] trait.
7854 * Searching for substrings now [employs the two-way algorithm][search]
7855   instead of doing a naive search. This gives major speedups to a
7856   number of methods, including [`contains`][sc], [`find`][sf],
7857   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
7858   [`ends_with`][sew] are also faster.
7859 * The performance of `PartialEq` for slices is [much faster][ps].
7860 * The [`Hash`] trait offers the default method, [`hash_slice`], which
7861   is overridden and optimized by the implementations for scalars.
7862 * The [`Hasher`] trait now has a number of specialized `write_*`
7863   methods for primitive types, for efficiency.
7864 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
7865   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
7866   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
7867   of [`std::error::Error::cause`][iec] also delegates to the inner
7868   error.
7869 * [`process::Child`][pc] gained the [`id`] method, which returns a
7870   `u32` representing the platform-specific process identifier.
7871 * The [`connect`] method on slices is deprecated, replaced by the new
7872   [`join`] method (note that both of these are on the *unstable*
7873   [`SliceConcatExt`] trait, but through the magic of the prelude are
7874   available to stable code anyway).
7875 * The [`Div`] operator is implemented for [`Wrapping`] types.
7876 * [`DerefMut` is implemented for `String`][dms].
7877 * Performance of SipHash (the default hasher for `HashMap`) is
7878   [better for long data][sh].
7879 * [`AtomicPtr`] implements [`Send`].
7880 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
7881   are now [specialized to use uninitialized buffers for increased
7882   performance][rte].
7883 * Lifetime parameters of foreign functions [are now resolved
7884   properly][f].
7885
7886 Misc
7887 ----
7888
7889 * Rust can now, with some coercion, [produce programs that run on
7890   Windows XP][xp], though XP is not considered a supported platform.
7891 * Porting Rust on Windows from the GNU toolchain to MSVC continues
7892   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
7893   recommended for use in 1.3, though should be fully-functional
7894   in the [64-bit 1.4 beta][b14].
7895 * On Fedora-based systems installation will [properly configure the
7896   dynamic linker][fl].
7897 * The compiler gained many new extended error descriptions, which can
7898   be accessed with the `--explain` flag.
7899 * The `dropck` pass, which checks that destructors can't access
7900   destroyed values, [has been rewritten][dropck]. This fixes some
7901   soundness holes, and as such will cause some previously-compiling
7902   code to no longer build.
7903 * `rustc` now uses [LLVM to write archive files where possible][ar].
7904   Eventually this will eliminate the compiler's dependency on the ar
7905   utility.
7906 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
7907   supported FreeBSD on x86_64).
7908 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
7909   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
7910   more strict.
7911 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
7912   will kill the process instead of leaking][nlp].
7913
7914 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
7915 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
7916 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
7917 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
7918 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
7919 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
7920 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
7921 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
7922 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
7923 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
7924 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
7925 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
7926 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
7927 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
7928 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
7929 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
7930 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
7931 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
7932 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
7933 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
7934 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
7935 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
7936 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
7937 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
7938 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
7939 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
7940 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
7941 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
7942 [ar]: https://github.com/rust-lang/rust/pull/26926
7943 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
7944 [dms]: https://github.com/rust-lang/rust/pull/26241
7945 [dropck]: https://github.com/rust-lang/rust/pull/27261
7946 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
7947 [ds]: https://github.com/rust-lang/rust/pull/26818
7948 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
7949 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
7950 [dst3]: https://github.com/rust-lang/rust/pull/27351
7951 [e]: https://github.com/rust-lang/rust/pull/24793
7952 [f]: https://github.com/rust-lang/rust/pull/26588
7953 [fb]: https://github.com/rust-lang/rust/pull/26959
7954 [fl]: https://github.com/rust-lang/rust-installer/pull/41
7955 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
7956 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
7957 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
7958 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
7959 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
7960 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
7961 [lic]: https://github.com/rust-lang/rust/pull/26583
7962 [lnu]: https://github.com/rust-lang/rust/pull/27026
7963 [lr]: https://github.com/rust-lang/rust/issues/27248
7964 [lum]: https://github.com/rust-lang/rust/pull/26378
7965 [lur]: https://github.com/rust-lang/rust/pull/26783
7966 [nlp]: https://github.com/rust-lang/rust/pull/27176
7967 [nold2]: https://github.com/rust-lang/rust/pull/27045
7968 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
7969 [nom]: http://doc.rust-lang.org/nightly/nomicon/
7970 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
7971 [pi]: https://github.com/rust-lang/rust/pull/26699
7972 [ps]: https://github.com/rust-lang/rust/pull/26884
7973 [rte]: https://github.com/rust-lang/rust/pull/26950
7974 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
7975 [search]: https://github.com/rust-lang/rust/pull/26327
7976 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
7977 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
7978 [sh]: https://github.com/rust-lang/rust/pull/27280
7979 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
7980 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
7981 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
7982 [st]: https://github.com/rust-lang/rust/pull/26630
7983 [win1]: https://github.com/rust-lang/rust/pull/26569
7984 [win2]: https://github.com/rust-lang/rust/pull/26741
7985 [win3]: https://github.com/rust-lang/rust/pull/26741
7986 [win4]: https://github.com/rust-lang/rust/pull/27210
7987 [xp]: https://github.com/rust-lang/rust/pull/26569
7988
7989 Version 1.2.0 (2015-08-07)
7990 ==========================
7991
7992 * ~1200 changes, numerous bugfixes
7993
7994 Highlights
7995 ----------
7996
7997 * [Dynamically-sized-type coercions][dst] allow smart pointer types
7998   like `Rc` to contain types without a fixed size, arrays and trait
7999   objects, finally enabling use of `Rc<[T]>` and completing the
8000   implementation of DST.
8001 * [Parallel codegen][parcodegen] is now working again, which can
8002   substantially speed up large builds in debug mode; It also gets
8003   another ~33% speedup when bootstrapping on a 4 core machine (using 8
8004   jobs). It's not enabled by default, but will be "in the near
8005   future". It can be activated with the `-C codegen-units=N` flag to
8006   `rustc`.
8007 * This is the first release with [experimental support for linking
8008   with the MSVC linker and lib C on Windows (instead of using the GNU
8009   variants via MinGW)][win]. It is yet recommended only for the most
8010   intrepid Rustaceans.
8011 * Benchmark compilations are showing a 30% improvement in
8012   bootstrapping over 1.1.
8013
8014 Breaking Changes
8015 ----------------
8016
8017 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
8018   unicode case mapping, which is a previously-planned change in
8019   behavior and considered a bugfix.
8020 * [`mem::align_of`] now specifies [the *minimum alignment* for
8021   T][align], which is usually the alignment programs are interested
8022   in, and the same value reported by clang's
8023   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
8024   break real code.
8025 * [The `#[packed]` attribute is no longer silently accepted by the
8026   compiler][packed]. This attribute did nothing and code that
8027   mentioned it likely did not work as intended.
8028 * Associated type defaults are [now behind the
8029   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
8030   defaults *did not work*, but could be mentioned syntactically. As
8031   such this breakage has minimal impact.
8032
8033 Language
8034 --------
8035
8036 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
8037   matching against dereferenceable values.
8038
8039 Libraries
8040 ---------
8041
8042 * The [`Extend`] trait, which grows a collection from an iterator, is
8043   implemented over iterators of references, for `String`, `Vec`,
8044   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
8045   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
8046 * The [`iter::once`] function returns an iterator that yields a single
8047   element, and [`iter::empty`] returns an iterator that yields no
8048   elements.
8049 * The [`matches`] and [`rmatches`] methods on `str` return iterators
8050   over substring matches.
8051 * [`Cell`] and [`RefCell`] both implement `Eq`.
8052 * A number of methods for wrapping arithmetic are added to the
8053   integral types, [`wrapping_div`], [`wrapping_rem`],
8054   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
8055   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
8056   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
8057   type.. It is illegal for the default arithmetic operations in Rust
8058   to overflow; the desire to wrap must be explicit.
8059 * The `{:#?}` formatting specifier [displays the alternate,
8060   pretty-printed][debugfmt] form of the `Debug` formatter. This
8061   feature was actually introduced prior to 1.0 with little
8062   fanfare.
8063 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
8064   for writing data to formatted strings, similar to [`io::Write`].
8065 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
8066   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
8067   are used by code generators to emit implementations of [`Debug`].
8068 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
8069   methods that convert case, following Unicode case mapping.
8070 * It is now easier to handle poisoned locks. The [`PoisonError`]
8071   type, returned by failing lock operations, exposes `into_inner`,
8072   `get_ref`, and `get_mut`, which all give access to the inner lock
8073   guard, and allow the poisoned lock to continue to operate. The
8074   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
8075   poisoned lock without attempting to take the lock.
8076 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
8077   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
8078   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
8079   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
8080   `ChildStderr`.
8081 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
8082   malformed input.
8083
8084 Misc
8085 ----
8086
8087 * `rustc` employs smarter heuristics for guessing at [typos].
8088 * `rustc` emits more efficient code for [no-op conversions between
8089   unsafe pointers][nop].
8090 * Fat pointers are now [passed in pairs of immediate arguments][fat],
8091   resulting in faster compile times and smaller code.
8092
8093 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
8094 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8095 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
8096 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
8097 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
8098 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
8099 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
8100 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
8101 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
8102 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
8103 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
8104 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
8105 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
8106 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
8107 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
8108 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
8109 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8110 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
8111 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
8112 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
8113 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
8114 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
8115 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
8116 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
8117 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
8118 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8119 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
8120 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
8121 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
8122 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
8123 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
8124 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
8125 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
8126 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8127 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8128 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
8129 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
8130 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
8131 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
8132 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
8133 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
8134 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8135 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
8136 [align]: https://github.com/rust-lang/rust/pull/25646
8137 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
8138 [typos]: https://github.com/rust-lang/rust/pull/26087
8139 [nop]: https://github.com/rust-lang/rust/pull/26336
8140 [fat]: https://github.com/rust-lang/rust/pull/26411
8141 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
8142 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
8143 [packed]: https://github.com/rust-lang/rust/pull/25541
8144 [ad]: https://github.com/rust-lang/rust/pull/27382
8145 [win]: https://github.com/rust-lang/rust/pull/25350
8146
8147 Version 1.1.0 (2015-06-25)
8148 =========================
8149
8150 * ~850 changes, numerous bugfixes
8151
8152 Highlights
8153 ----------
8154
8155 * The [`std::fs` module has been expanded][fs] to expand the set of
8156   functionality exposed:
8157   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
8158     don't incur a syscall on some platforms.
8159   * A `symlink_metadata` function has been added.
8160   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
8161     access to all underlying information.
8162 * The compiler now contains extended explanations of many errors. When an error
8163   with an explanation occurs the compiler suggests using the `--explain` flag
8164   to read the explanation. Error explanations are also [available online][err-index].
8165 * Thanks to multiple [improvements][sk] to [type checking][pre], as
8166   well as other work, the time to bootstrap the compiler decreased by
8167   32%.
8168
8169 Libraries
8170 ---------
8171
8172 * The [`str::split_whitespace`] method splits a string on unicode
8173   whitespace boundaries.
8174 * On both Windows and Unix, new extension traits provide conversion of
8175   I/O types to and from the underlying system handles. On Unix, these
8176   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
8177   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
8178   `TcpListener`, and `UpdSocket`. Further implementations for
8179   `std::process` will be stabilized later.
8180 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
8181   Windows, symlinks can be created with
8182   `std::os::windows::symlink_dir` and
8183   `std::os::windows::symlink_file`.
8184 * The `mpsc::Receiver` type can now be converted into an iterator with
8185   `into_iter` on the [`IntoIterator`] trait.
8186 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
8187   implementation of the [`From`] trait.
8188 * The `Debug` implementation for `RangeFull` [creates output that is
8189   more consistent with other implementations][rf].
8190 * [`Debug` is implemented for `File`][file].
8191 * The `Default` implementation for `Arc` [no longer requires `Sync +
8192   Send`][arc].
8193 * [The `Iterator` methods `count`, `nth`, and `last` have been
8194   overridden for slices to have O(1) performance instead of O(n)][si].
8195 * Incorrect handling of paths on Windows has been improved in both the
8196   compiler and the standard library.
8197 * [`AtomicPtr` gained a `Default` implementation][ap].
8198 * In accordance with Rust's policy on arithmetic overflow `abs` now
8199   [panics on overflow when debug assertions are enabled][abs].
8200 * The [`Cloned`] iterator, which was accidentally left unstable for
8201   1.0 [has been stabilized][c].
8202 * The [`Incoming`] iterator, which iterates over incoming TCP
8203   connections, and which was accidentally unnamable in 1.0, [is now
8204   properly exported][inc].
8205 * [`BinaryHeap`] no longer corrupts itself [when functions called by
8206   `sift_up` or `sift_down` panic][bh].
8207 * The [`split_off`] method of `LinkedList` [no longer corrupts
8208   the list in certain scenarios][ll].
8209
8210 Misc
8211 ----
8212
8213 * Type checking performance [has improved notably][sk] with
8214   [multiple improvements][pre].
8215 * The compiler [suggests code changes][ch] for more errors.
8216 * rustc and it's build system have experimental support for [building
8217   toolchains against MUSL][m] instead of glibc on Linux.
8218 * The compiler defines the `target_env` cfg value, which is used for
8219   distinguishing toolchains that are otherwise for the same
8220   platform. Presently this is set to `gnu` for common GNU Linux
8221   targets and for MinGW targets, and `musl` for MUSL Linux targets.
8222 * The [`cargo rustc`][crc] command invokes a build with custom flags
8223   to rustc.
8224 * [Android executables are always position independent][pie].
8225 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
8226   with `Drop`][drop].
8227
8228 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
8229 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8230 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8231 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
8232 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
8233 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
8234 [rf]: https://github.com/rust-lang/rust/pull/24491
8235 [err-index]: https://doc.rust-lang.org/error-index.html
8236 [sk]: https://github.com/rust-lang/rust/pull/24615
8237 [pre]: https://github.com/rust-lang/rust/pull/25323
8238 [file]: https://github.com/rust-lang/rust/pull/24598
8239 [ch]: https://github.com/rust-lang/rust/pull/24683
8240 [arc]: https://github.com/rust-lang/rust/pull/24695
8241 [si]: https://github.com/rust-lang/rust/pull/24701
8242 [ap]: https://github.com/rust-lang/rust/pull/24834
8243 [m]: https://github.com/rust-lang/rust/pull/24777
8244 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
8245 [crc]: https://github.com/rust-lang/cargo/pull/1568
8246 [pie]: https://github.com/rust-lang/rust/pull/24953
8247 [abs]: https://github.com/rust-lang/rust/pull/25441
8248 [c]: https://github.com/rust-lang/rust/pull/25496
8249 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
8250 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
8251 [inc]: https://github.com/rust-lang/rust/pull/25522
8252 [bh]: https://github.com/rust-lang/rust/pull/25856
8253 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
8254 [ll]: https://github.com/rust-lang/rust/pull/26022
8255 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
8256 [drop]: https://github.com/rust-lang/rust/pull/24935
8257
8258 Version 1.0.0 (2015-05-15)
8259 ========================
8260
8261 * ~1500 changes, numerous bugfixes
8262
8263 Highlights
8264 ----------
8265
8266 * The vast majority of the standard library is now `#[stable]`. It is
8267   no longer possible to use unstable features with a stable build of
8268   the compiler.
8269 * Many popular crates on [crates.io] now work on the stable release
8270   channel.
8271 * Arithmetic on basic integer types now [checks for overflow in debug
8272   builds][overflow].
8273
8274 Language
8275 --------
8276
8277 * Several [restrictions have been added to trait coherence][coh] in
8278   order to make it easier for upstream authors to change traits
8279   without breaking downstream code.
8280 * Digits of binary and octal literals are [lexed more eagerly][lex] to
8281   improve error messages and macro behavior. For example, `0b1234` is
8282   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
8283 * Trait bounds [are always invariant][inv], eliminating the need for
8284   the `PhantomFn` and `MarkerTrait` lang items, which have been
8285   removed.
8286 * ["-" is no longer a valid character in crate names][cr], the `extern crate
8287   "foo" as bar` syntax has been replaced with `extern crate foo as
8288   bar`, and Cargo now automatically translates "-" in *package* names
8289   to underscore for the crate name.
8290 * [Lifetime shadowing is an error][lt].
8291 * [`Send` no longer implies `'static`][send-rfc].
8292 * [UFCS now supports trait-less associated paths][moar-ufcs] like
8293   `MyType::default()`.
8294 * Primitive types [now have inherent methods][prim-inherent],
8295   obviating the need for extension traits like `SliceExt`.
8296 * Methods with `Self: Sized` in their `where` clause are [considered
8297   object-safe][self-sized], allowing many extension traits like
8298   `IteratorExt` to be merged into the traits they extended.
8299 * You can now [refer to associated types][assoc-where] whose
8300   corresponding trait bounds appear only in a `where` clause.
8301 * The final bits of [OIBIT landed][oibit-final], meaning that traits
8302   like `Send` and `Sync` are now library-defined.
8303 * A [Reflect trait][reflect] was introduced, which means that
8304   downcasting via the `Any` trait is effectively limited to concrete
8305   types. This helps retain the potentially-important "parametricity"
8306   property: generic code cannot behave differently for different type
8307   arguments except in minor ways.
8308 * The `unsafe_destructor` feature is now deprecated in favor of the
8309   [new `dropck`][dropck]. This change is a major reduction in unsafe
8310   code.
8311
8312 Libraries
8313 ---------
8314
8315 * The `thread_local` module [has been renamed to `std::thread`][th].
8316 * The methods of `IteratorExt` [have been moved to the `Iterator`
8317   trait itself][ie].
8318 * Several traits that implement Rust's conventions for type
8319   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
8320   [centralized in the `std::convert` module][con].
8321 * The `FromError` trait [was removed in favor of `From`][fe].
8322 * The basic sleep function [has moved to
8323   `std::thread::sleep_ms`][slp].
8324 * The `splitn` function now takes an `n` parameter that represents the
8325   number of items yielded by the returned iterator [instead of the
8326   number of 'splits'][spl].
8327 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
8328 * [Derived implementations of `PartialOrd` now order enums according
8329   to their explicitly-assigned discriminants][po].
8330 * [Methods for searching strings are generic over `Pattern`s][pat],
8331   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
8332   some others.
8333 * [In method resolution, object methods are resolved before inherent
8334   methods][meth].
8335 * [`String::from_str` has been deprecated in favor of the `From` impl,
8336   `String::from`][sf].
8337 * [`io::Error` implements `Sync`][ios].
8338 * [The `words` method on `&str` has been replaced with
8339   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
8340   a word?'
8341 * The new path and IO modules are complete and `#[stable]`. This
8342   was the major library focus for this cycle.
8343 * The path API was [revised][path-normalize] to normalize `.`,
8344   adjusting the tradeoffs in favor of the most common usage.
8345 * A large number of remaining APIs in `std` were also stabilized
8346   during this cycle; about 75% of the non-deprecated API surface
8347   is now stable.
8348 * The new [string pattern API][string-pattern] landed, which makes
8349   the string slice API much more internally consistent and flexible.
8350 * A new set of [generic conversion traits][conversion] replaced
8351   many existing ad hoc traits.
8352 * Generic numeric traits were [completely removed][num-traits]. This
8353   was made possible thanks to inherent methods for primitive types,
8354   and the removal gives maximal flexibility for designing a numeric
8355   hierarchy in the future.
8356 * The `Fn` traits are now related via [inheritance][fn-inherit]
8357   and provide ergonomic [blanket implementations][fn-blanket].
8358 * The `Index` and `IndexMut` traits were changed to
8359   [take the index by value][index-value], enabling code like
8360   `hash_map["string"]` to work.
8361 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
8362   `Copy` data is known to be `Clone` as well.
8363
8364 Misc
8365 ----
8366
8367 * Many errors now have extended explanations that can be accessed with
8368   the `--explain` flag to `rustc`.
8369 * Many new examples have been added to the standard library
8370   documentation.
8371 * rustdoc has received a number of improvements focused on completion
8372   and polish.
8373 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
8374 * Much headway was made on ecosystem-wide CI, making it possible
8375   to [compare builds for breakage][ci-compare].
8376
8377
8378 [crates.io]: http://crates.io
8379 [clo]: https://github.com/rust-lang/rust/pull/24034
8380 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
8381 [con]: https://github.com/rust-lang/rust/pull/23875
8382 [cr]: https://github.com/rust-lang/rust/pull/23419
8383 [fe]: https://github.com/rust-lang/rust/pull/23879
8384 [ie]: https://github.com/rust-lang/rust/pull/23300
8385 [inv]: https://github.com/rust-lang/rust/pull/23938
8386 [ios]: https://github.com/rust-lang/rust/pull/24133
8387 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
8388 [lt]: https://github.com/rust-lang/rust/pull/24057
8389 [meth]: https://github.com/rust-lang/rust/pull/24056
8390 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
8391 [po]: https://github.com/rust-lang/rust/pull/24270
8392 [sf]: https://github.com/rust-lang/rust/pull/24517
8393 [slp]: https://github.com/rust-lang/rust/pull/23949
8394 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
8395 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
8396 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
8397 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
8398 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
8399 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
8400 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
8401 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
8402 [self-sized]: https://github.com/rust-lang/rust/pull/22301
8403 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
8404 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
8405 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
8406 [reflect]: https://github.com/rust-lang/rust/pull/23712
8407 [conversion]: https://github.com/rust-lang/rfcs/pull/529
8408 [num-traits]: https://github.com/rust-lang/rust/pull/23549
8409 [index-value]: https://github.com/rust-lang/rust/pull/23601
8410 [dropck]: https://github.com/rust-lang/rfcs/pull/769
8411 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
8412 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
8413 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
8414 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
8415 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
8416
8417
8418 Version 1.0.0-alpha.2 (2015-02-20)
8419 =====================================
8420
8421 * ~1300 changes, numerous bugfixes
8422
8423 * Highlights
8424
8425     * The various I/O modules were [overhauled][io-rfc] to reduce
8426       unnecessary abstractions and provide better interoperation with
8427       the underlying platform. The old `io` module remains temporarily
8428       at `std::old_io`.
8429     * The standard library now [participates in feature gating][feat],
8430       so use of unstable libraries now requires a `#![feature(...)]`
8431       attribute. The impact of this change is [described on the
8432       forum][feat-forum]. [RFC][feat-rfc].
8433
8434 * Language
8435
8436     * `for` loops [now operate on the `IntoIterator` trait][into],
8437       which eliminates the need to call `.iter()`, etc. to iterate
8438       over collections. There are some new subtleties to remember
8439       though regarding what sort of iterators various types yield, in
8440       particular that `for foo in bar { }` yields values from a move
8441       iterator, destroying the original collection. [RFC][into-rfc].
8442     * Objects now have [default lifetime bounds][obj], so you don't
8443       have to write `Box<Trait+'static>` when you don't care about
8444       storing references. [RFC][obj-rfc].
8445     * In types that implement `Drop`, [lifetimes must outlive the
8446       value][drop]. This will soon make it possible to safely
8447       implement `Drop` for types where `#[unsafe_destructor]` is now
8448       required. Read the [gorgeous RFC][drop-rfc] for details.
8449     * The fully qualified <T as Trait>::X syntax lets you set the Self
8450       type for a trait method or associated type. [RFC][ufcs-rfc].
8451     * References to types that implement `Deref<U>` now [automatically
8452       coerce to references][deref] to the dereferenced type `U`,
8453       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
8454       should eliminate many unsightly uses of `&*`, as when converting
8455       from references to vectors into references to
8456       slices. [RFC][deref-rfc].
8457     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
8458       `|:|`) is obsolete and closure kind is inferred from context.
8459     * [`Self` is a keyword][Self].
8460
8461 * Libraries
8462
8463     * The `Show` and `String` formatting traits [have been
8464       renamed][fmt] to `Debug` and `Display` to more clearly reflect
8465       their related purposes. Automatically getting a string
8466       conversion to use with `format!("{:?}", something_to_debug)` is
8467       now written `#[derive(Debug)]`.
8468     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
8469       OsStr}`, provide strings in platform-specific encodings for easier
8470       interop with system APIs. [RFC][osstr-rfc].
8471     * The `boxed::into_raw` and `Box::from_raw` functions [convert
8472       between `Box<T>` and `*mut T`][boxraw], a common pattern for
8473       creating raw pointers.
8474
8475 * Tooling
8476
8477     * Certain long error messages of the form 'expected foo found bar'
8478       are now [split neatly across multiple
8479       lines][multiline]. Examples in the PR.
8480     * On Unix Rust can be [uninstalled][un] by running
8481       `/usr/local/lib/rustlib/uninstall.sh`.
8482     * The `#[rustc_on_unimplemented]` attribute, requiring the
8483       'on_unimplemented' feature, lets rustc [display custom error
8484       messages when a trait is expected to be implemented for a type
8485       but is not][onun].
8486
8487 * Misc
8488
8489     * Rust is tested against a [LALR grammar][lalr], which parses
8490       almost all the Rust files that rustc does.
8491
8492 [boxraw]: https://github.com/rust-lang/rust/pull/21318
8493 [close]: https://github.com/rust-lang/rust/pull/21843
8494 [deref]: https://github.com/rust-lang/rust/pull/21351
8495 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
8496 [drop]: https://github.com/rust-lang/rust/pull/21972
8497 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8498 [feat]: https://github.com/rust-lang/rust/pull/21248
8499 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
8500 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
8501 [fmt]: https://github.com/rust-lang/rust/pull/21457
8502 [into]: https://github.com/rust-lang/rust/pull/20790
8503 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
8504 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
8505 [lalr]: https://github.com/rust-lang/rust/pull/21452
8506 [multiline]: https://github.com/rust-lang/rust/pull/19870
8507 [obj]: https://github.com/rust-lang/rust/pull/22230
8508 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
8509 [onun]: https://github.com/rust-lang/rust/pull/20889
8510 [osstr]: https://github.com/rust-lang/rust/pull/21488
8511 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
8512 [Self]: https://github.com/rust-lang/rust/pull/22158
8513 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
8514 [un]: https://github.com/rust-lang/rust/pull/22256
8515
8516
8517 Version 1.0.0-alpha (2015-01-09)
8518 ==================================
8519
8520   * ~2400 changes, numerous bugfixes
8521
8522   * Highlights
8523
8524     * The language itself is considered feature complete for 1.0,
8525       though there will be many usability improvements and bugfixes
8526       before the final release.
8527     * Nearly 50% of the public API surface of the standard library has
8528       been declared 'stable'. Those interfaces are unlikely to change
8529       before 1.0.
8530     * The long-running debate over integer types has been
8531       [settled][ints]: Rust will ship with types named `isize` and
8532       `usize`, rather than `int` and `uint`, for pointer-sized
8533       integers. Guidelines will be rolled out during the alpha cycle.
8534     * Most crates that are not `std` have been moved out of the Rust
8535       distribution into the Cargo ecosystem so they can evolve
8536       separately and don't need to be stabilized as quickly, including
8537       'time', 'getopts', 'num', 'regex', and 'term'.
8538     * Documentation continues to be expanded with more API coverage, more
8539       examples, and more in-depth explanations. The guides have been
8540       consolidated into [The Rust Programming Language][trpl].
8541     * "[Rust By Example][rbe]" is now maintained by the Rust team.
8542     * All official Rust binary installers now come with [Cargo], the
8543       Rust package manager.
8544
8545 * Language
8546
8547     * Closures have been [completely redesigned][unboxed] to be
8548       implemented in terms of traits, can now be used as generic type
8549       bounds and thus monomorphized and inlined, or via an opaque
8550       pointer (boxed) as in the old system. The new system is often
8551       referred to as 'unboxed' closures.
8552     * Traits now support [associated types][assoc], allowing families
8553       of related types to be defined together and used generically in
8554       powerful ways.
8555     * Enum variants are [namespaced by their type names][enum].
8556     * [`where` clauses][where] provide a more versatile and attractive
8557       syntax for specifying generic bounds, though the previous syntax
8558       remains valid.
8559     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
8560       numeric types.
8561     * Rust [no longer has a runtime][rt] of any description, and only
8562       supports OS threads, not green threads.
8563     * At long last, Rust has been overhauled for 'dynamically-sized
8564       types' ([DST]), which integrates 'fat pointers' (object types,
8565       arrays, and `str`) more deeply into the type system, making it
8566       more consistent.
8567     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
8568       `..j` that produce range types and which, when combined with the
8569       `Index` operator and multidispatch, leads to a convenient slice
8570       notation, `[i..j]`.
8571     * The new range syntax revealed an ambiguity in the fixed-length
8572       array syntax, so now fixed length arrays [are written `[T;
8573       N]`][arrays].
8574     * The `Copy` trait is no longer implemented automatically. Unsafe
8575       pointers no longer implement `Sync` and `Send` so types
8576       containing them don't automatically either. `Sync` and `Send`
8577       are now 'unsafe traits' so one can "forcibly" implement them via
8578       `unsafe impl` if a type confirms to the requirements for them
8579       even though the internals do not (e.g. structs containing unsafe
8580       pointers like `Arc`). These changes are intended to prevent some
8581       footguns and are collectively known as [opt-in built-in
8582       traits][oibit] (though `Sync` and `Send` will soon become pure
8583       library types unknown to the compiler).
8584     * Operator traits now take their operands [by value][ops], and
8585       comparison traits can use multidispatch to compare one type
8586       against multiple other types, allowing e.g. `String` to be
8587       compared with `&str`.
8588     * `if let` and `while let` are no longer feature-gated.
8589     * Rust has adopted a more [uniform syntax for escaping unicode
8590       characters][unicode].
8591     * `macro_rules!` [has been declared stable][mac]. Though it is a
8592       flawed system it is sufficiently popular that it must be usable
8593       for 1.0. Effort has gone into [future-proofing][mac-future] it
8594       in ways that will allow other macro systems to be developed in
8595       parallel, and won't otherwise impact the evolution of the
8596       language.
8597     * The prelude has been [pared back significantly][prelude] such
8598       that it is the minimum necessary to support the most pervasive
8599       code patterns, and through [generalized where clauses][where]
8600       many of the prelude extension traits have been consolidated.
8601     * Rust's rudimentary reflection [has been removed][refl], as it
8602       incurred too much code generation for little benefit.
8603     * [Struct variants][structvars] are no longer feature-gated.
8604     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
8605       known as 'higher-ranked trait bounds', this crucially allows
8606       unboxed closures to work.
8607     * Macros invocations surrounded by parens or square brackets and
8608       not terminated by a semicolon are [parsed as
8609       expressions][macros], which makes expressions like `vec![1i32,
8610       2, 3].len()` work as expected.
8611     * Trait objects now implement their traits automatically, and
8612       traits that can be coerced to objects now must be [object
8613       safe][objsafe].
8614     * Automatically deriving traits is now done with `#[derive(...)]`
8615       not `#[deriving(...)]` for [consistency with other naming
8616       conventions][derive].
8617     * Importing the containing module or enum at the same time as
8618       items or variants they contain is [now done with `self` instead
8619       of `mod`][self], as in use `foo::{self, bar}`
8620     * Glob imports are no longer feature-gated.
8621     * The `box` operator and `box` patterns have been feature-gated
8622       pending a redesign. For now unique boxes should be allocated
8623       like other containers, with `Box::new`.
8624
8625 * Libraries
8626
8627     * A [series][coll1] of [efforts][coll2] to establish
8628       [conventions][coll3] for collections types has resulted in API
8629       improvements throughout the standard library.
8630     * New [APIs for error handling][err] provide ergonomic interop
8631       between error types, and [new conventions][err-conv] describe
8632       more clearly the recommended error handling strategies in Rust.
8633     * The `fail!` macro has been renamed to [`panic!`][panic] so that
8634       it is easier to discuss failure in the context of error handling
8635       without making clarifications as to whether you are referring to
8636       the 'fail' macro or failure more generally.
8637     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
8638       syscall when available.
8639     * The 'serialize' crate has been renamed 'rustc-serialize' and
8640       moved out of the distribution to Cargo. Although it is widely
8641       used now, it is expected to be superseded in the near future.
8642     * The `Show` formatter, typically implemented with
8643       `#[derive(Show)]` is [now requested with the `{:?}`
8644       specifier][show] and is intended for use by all types, for uses
8645       such as `println!` debugging. The new `String` formatter must be
8646       implemented by hand, uses the `{}` specifier, and is intended
8647       for full-fidelity conversions of things that can logically be
8648       represented as strings.
8649
8650 * Tooling
8651
8652     * [Flexible target specification][flex] allows rustc's code
8653       generation to be configured to support otherwise-unsupported
8654       platforms.
8655     * Rust comes with rust-gdb and rust-lldb scripts that launch their
8656       respective debuggers with Rust-appropriate pretty-printing.
8657     * The Windows installation of Rust is distributed with the
8658       MinGW components currently required to link binaries on that
8659       platform.
8660
8661 * Misc
8662
8663     * Nullable enum optimizations have been extended to more types so
8664       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
8665       space than the inner types themselves.
8666     * Work has begun on supporting AArch64.
8667
8668 [Cargo]: https://crates.io
8669 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
8670 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
8671 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
8672 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
8673 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
8674 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
8675 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
8676 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
8677 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
8678 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
8679 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
8680 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
8681 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
8682 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
8683 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
8684 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
8685 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
8686 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
8687 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
8688 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
8689 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
8690 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
8691 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
8692 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
8693 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
8694 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
8695 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
8696 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
8697 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
8698 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
8699 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
8700 [trpl]: https://doc.rust-lang.org/book/index.html
8701 [rbe]: http://rustbyexample.com/
8702
8703
8704 Version 0.12.0 (2014-10-09)
8705 =============================
8706
8707   * ~1900 changes, numerous bugfixes
8708
8709   * Highlights
8710
8711     * The introductory documentation (now called The Rust Guide) has
8712       been completely rewritten, as have a number of supplementary
8713       guides.
8714     * Rust's package manager, Cargo, continues to improve and is
8715       sometimes considered to be quite awesome.
8716     * Many API's in `std` have been reviewed and updated for
8717       consistency with the in-development Rust coding
8718       guidelines. The standard library documentation tracks
8719       stabilization progress.
8720     * Minor libraries have been moved out-of-tree to the rust-lang org
8721       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
8722       be installed with Cargo.
8723     * Lifetime elision allows lifetime annotations to be left off of
8724       function declarations in many common scenarios.
8725     * Rust now works on 64-bit Windows.
8726
8727   * Language
8728     * Indexing can be overloaded with the `Index` and `IndexMut`
8729       traits.
8730     * The `if let` construct takes a branch only if the `let` pattern
8731       matches, currently behind the 'if_let' feature gate.
8732     * 'where clauses', a more flexible syntax for specifying trait
8733       bounds that is more aesthetic, have been added for traits and
8734       free functions. Where clauses will in the future make it
8735       possible to constrain associated types, which would be
8736       impossible with the existing syntax.
8737     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
8738       the 'slicing_syntax' feature gate, and can be overloaded with
8739       the `Slice` or `SliceMut` traits.
8740     * The syntax for matching of sub-slices has been changed to use a
8741       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
8742       consistency with other uses of `..` and to future-proof
8743       potential additional uses of the syntax.
8744     * The syntax for matching inclusive ranges in patterns has changed
8745       from `0..3` to `0...4` to be consistent with the exclusive range
8746       syntax for slicing.
8747     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
8748       c]`) has been put behind the 'advanced_slice_patterns' feature
8749       gate and may be removed in the future.
8750     * Components of tuples and tuple structs can be extracted using
8751       the `value.0` syntax, currently behind the `tuple_indexing`
8752       feature gate.
8753     * The `#[crate_id]` attribute is no longer supported; versioning
8754       is handled by the package manager.
8755     * Renaming crate imports are now written `extern crate foo as bar`
8756       instead of `extern crate bar = foo`.
8757     * Renaming use statements are now written `use foo as bar` instead
8758       of `use bar = foo`.
8759     * `let` and `match` bindings and argument names in macros are now
8760       hygienic.
8761     * The new, more efficient, closure types ('unboxed closures') have
8762       been added under a feature gate, 'unboxed_closures'. These will
8763       soon replace the existing closure types, once higher-ranked
8764       trait lifetimes are added to the language.
8765     * `move` has been added as a keyword, for indicating closures
8766       that capture by value.
8767     * Mutation and assignment is no longer allowed in pattern guards.
8768     * Generic structs and enums can now have trait bounds.
8769     * The `Share` trait is now called `Sync` to free up the term
8770       'shared' to refer to 'shared reference' (the default reference
8771       type.
8772     * Dynamically-sized types have been mostly implemented,
8773       unifying the behavior of fat-pointer types with the rest of the
8774       type system.
8775     * As part of dynamically-sized types, the `Sized` trait has been
8776       introduced, which qualifying types implement by default, and
8777       which type parameters expect by default. To specify that a type
8778       parameter does not need to be sized, write `<Sized? T>`. Most
8779       types are `Sized`, notable exceptions being unsized arrays
8780       (`[T]`) and trait types.
8781     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
8782     * Lifetime bounds can now be applied to type parameters and object
8783       types.
8784     * The old, reference counted GC type, `Gc<T>` which was once
8785       denoted by the `@` sigil, has finally been removed. GC will be
8786       revisited in the future.
8787
8788   * Libraries
8789     * Library documentation has been improved for a number of modules.
8790     * Bit-vectors, collections::bitv has been modernized.
8791     * The url crate is deprecated in favor of
8792       http://github.com/servo/rust-url, which can be installed with
8793       Cargo.
8794     * Most I/O stream types can be cloned and subsequently closed from
8795       a different thread.
8796     * A `std::time::Duration` type has been added for use in I/O
8797       methods that rely on timers, as well as in the 'time' crate's
8798       `Timespec` arithmetic.
8799     * The runtime I/O abstraction layer that enabled the green thread
8800       scheduler to do non-thread-blocking I/O has been removed, along
8801       with the libuv-based implementation employed by the green thread
8802       scheduler. This will greatly simplify the future I/O work.
8803     * `collections::btree` has been rewritten to have a more
8804       idiomatic and efficient design.
8805
8806   * Tooling
8807     * rustdoc output now indicates the stability levels of API's.
8808     * The `--crate-name` flag can specify the name of the crate
8809       being compiled, like `#[crate_name]`.
8810     * The `-C metadata` specifies additional metadata to hash into
8811       symbol names, and `-C extra-filename` specifies additional
8812       information to put into the output filename, for use by the
8813       package manager for versioning.
8814     * debug info generation has continued to improve and should be
8815       more reliable under both gdb and lldb.
8816     * rustc has experimental support for compiling in parallel
8817       using the `-C codegen-units` flag.
8818     * rustc no longer encodes rpath information into binaries by
8819       default.
8820
8821   * Misc
8822     * Stack usage has been optimized with LLVM lifetime annotations.
8823     * Official Rust binaries on Linux are more compatible with older
8824       kernels and distributions, built on CentOS 5.10.
8825
8826
8827 Version 0.11.0 (2014-07-02)
8828 ==========================
8829
8830   * ~1700 changes, numerous bugfixes
8831
8832   * Language
8833     * ~[T] has been removed from the language. This type is superseded by
8834       the Vec<T> type.
8835     * ~str has been removed from the language. This type is superseded by
8836       the String type.
8837     * ~T has been removed from the language. This type is superseded by the
8838       Box<T> type.
8839     * @T has been removed from the language. This type is superseded by the
8840       standard library's std::gc::Gc<T> type.
8841     * Struct fields are now all private by default.
8842     * Vector indices and shift amounts are both required to be a `uint`
8843       instead of any integral type.
8844     * Byte character, byte string, and raw byte string literals are now all
8845       supported by prefixing the normal literal with a `b`.
8846     * Multiple ABIs are no longer allowed in an ABI string
8847     * The syntax for lifetimes on closures/procedures has been tweaked
8848       slightly: `<'a>|A, B|: 'b + K -> T`
8849     * Floating point modulus has been removed from the language; however it
8850       is still provided by a library implementation.
8851     * Private enum variants are now disallowed.
8852     * The `priv` keyword has been removed from the language.
8853     * A closure can no longer be invoked through a &-pointer.
8854     * The `use foo, bar, baz;` syntax has been removed from the language.
8855     * The transmute intrinsic no longer works on type parameters.
8856     * Statics now allow blocks/items in their definition.
8857     * Trait bounds are separated from objects with + instead of : now.
8858     * Objects can no longer be read while they are mutably borrowed.
8859     * The address of a static is now marked as insignificant unless the
8860       #[inline(never)] attribute is placed it.
8861     * The #[unsafe_destructor] attribute is now behind a feature gate.
8862     * Struct literals are no longer allowed in ambiguous positions such as
8863       if, while, match, and for..in.
8864     * Declaration of lang items and intrinsics are now feature-gated by
8865       default.
8866     * Integral literals no longer default to `int`, and floating point
8867       literals no longer default to `f64`. Literals must be suffixed with an
8868       appropriate type if inference cannot determine the type of the
8869       literal.
8870     * The Box<T> type is no longer implicitly borrowed to &mut T.
8871     * Procedures are now required to not capture borrowed references.
8872
8873   * Libraries
8874     * The standard library is now a "facade" over a number of underlying
8875       libraries. This means that development on the standard library should
8876       be speedier due to smaller crates, as well as a clearer line between
8877       all dependencies.
8878     * A new library, libcore, lives under the standard library's facade
8879       which is Rust's "0-assumption" library, suitable for embedded and
8880       kernel development for example.
8881     * A regex crate has been added to the standard distribution. This crate
8882       includes statically compiled regular expressions.
8883     * The unwrap/unwrap_err methods on Result require a Show bound for
8884       better error messages.
8885     * The return types of the std::comm primitives have been centralized
8886       around the Result type.
8887     * A number of I/O primitives have gained the ability to time out their
8888       operations.
8889     * A number of I/O primitives have gained the ability to close their
8890       reading/writing halves to cancel pending operations.
8891     * Reverse iterator methods have been removed in favor of `rev()` on
8892       their forward-iteration counterparts.
8893     * A bitflags! macro has been added to enable easy interop with C and
8894       management of bit flags.
8895     * A debug_assert! macro is now provided which is disabled when
8896       `--cfg ndebug` is passed to the compiler.
8897     * A graphviz crate has been added for creating .dot files.
8898     * The std::cast module has been migrated into std::mem.
8899     * The std::local_data api has been migrated from freestanding functions
8900       to being based on methods.
8901     * The Pod trait has been renamed to Copy.
8902     * jemalloc has been added as the default allocator for types.
8903     * The API for allocating memory has been changed to use proper alignment
8904       and sized deallocation
8905     * Connecting a TcpStream or binding a TcpListener is now based on a
8906       string address and a u16 port. This allows connecting to a hostname as
8907       opposed to an IP.
8908     * The Reader trait now contains a core method, read_at_least(), which
8909       correctly handles many repeated 0-length reads.
8910     * The process-spawning API is now centered around a builder-style
8911       Command struct.
8912     * The :? printing qualifier has been moved from the standard library to
8913       an external libdebug crate.
8914     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
8915       have been renamed to Eq/Ord.
8916     * The select/plural methods have been removed from format!. The escapes
8917       for { and } have also changed from \{ and \} to {{ and }},
8918       respectively.
8919     * The TaskBuilder API has been re-worked to be a true builder, and
8920       extension traits for spawning native/green tasks have been added.
8921
8922   * Tooling
8923     * All breaking changes to the language or libraries now have their
8924       commit message annotated with `[breaking-change]` to allow for easy
8925       discovery of breaking changes.
8926     * The compiler will now try to suggest how to annotate lifetimes if a
8927       lifetime-related error occurs.
8928     * Debug info continues to be improved greatly with general bug fixes and
8929       better support for situations like link time optimization (LTO).
8930     * Usage of syntax extensions when cross-compiling has been fixed.
8931     * Functionality equivalent to GCC & Clang's -ffunction-sections,
8932       -fdata-sections and --gc-sections has been enabled by default
8933     * The compiler is now stricter about where it will load module files
8934       from when a module is declared via `mod foo;`.
8935     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
8936       Syntax extensions are now discovered via a "plugin registrar" type
8937       which will be extended in the future to other various plugins.
8938     * Lints have been restructured to allow for dynamically loadable lints.
8939     * A number of rustdoc improvements:
8940       * The HTML output has been visually redesigned.
8941       * Markdown is now powered by hoedown instead of sundown.
8942       * Searching heuristics have been greatly improved.
8943       * The search index has been reduced in size by a great amount.
8944       * Cross-crate documentation via `pub use` has been greatly improved.
8945       * Primitive types are now hyperlinked and documented.
8946     * Documentation has been moved from static.rust-lang.org/doc to
8947       doc.rust-lang.org
8948     * A new sandbox, play.rust-lang.org, is available for running and
8949       sharing rust code examples on-line.
8950     * Unused attributes are now more robustly warned about.
8951     * The dead_code lint now warns about unused struct fields.
8952     * Cross-compiling to iOS is now supported.
8953     * Cross-compiling to mipsel is now supported.
8954     * Stability attributes are now inherited by default and no longer apply
8955       to intra-crate usage, only inter-crate usage.
8956     * Error message related to non-exhaustive match expressions have been
8957       greatly improved.
8958
8959
8960 Version 0.10 (2014-04-03)
8961 =========================
8962
8963   * ~1500 changes, numerous bugfixes
8964
8965   * Language
8966     * A new RFC process is now in place for modifying the language.
8967     * Patterns with `@`-pointers have been removed from the language.
8968     * Patterns with unique vectors (`~[T]`) have been removed from the
8969       language.
8970     * Patterns with unique strings (`~str`) have been removed from the
8971       language.
8972     * `@str` has been removed from the language.
8973     * `@[T]` has been removed from the language.
8974     * `@self` has been removed from the language.
8975     * `@Trait` has been removed from the language.
8976     * Headers on `~` allocations which contain `@` boxes inside the type for
8977       reference counting have been removed.
8978     * The semantics around the lifetimes of temporary expressions have changed,
8979       see #3511 and #11585 for more information.
8980     * Cross-crate syntax extensions are now possible, but feature gated. See
8981       #11151 for more information. This includes both `macro_rules!` macros as
8982       well as syntax extensions such as `format!`.
8983     * New lint modes have been added, and older ones have been turned on to be
8984       warn-by-default.
8985       * Unnecessary parentheses
8986       * Uppercase statics
8987       * Camel Case types
8988       * Uppercase variables
8989       * Publicly visible private types
8990       * `#[deriving]` with raw pointers
8991     * Unsafe functions can no longer be coerced to closures.
8992     * Various obscure macros such as `log_syntax!` are now behind feature gates.
8993     * The `#[simd]` attribute is now behind a feature gate.
8994     * Visibility is no longer allowed on `extern crate` statements, and
8995       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
8996     * Trailing commas are now allowed in argument lists and tuple patterns.
8997     * The `do` keyword has been removed, it is now a reserved keyword.
8998     * Default type parameters have been implemented, but are feature gated.
8999     * Borrowed variables through captures in closures are now considered soundly.
9000     * `extern mod` is now `extern crate`
9001     * The `Freeze` trait has been removed.
9002     * The `Share` trait has been added for types that can be shared among
9003       threads.
9004     * Labels in macros are now hygienic.
9005     * Expression/statement macro invocations can be delimited with `{}` now.
9006     * Treatment of types allowed in `static mut` locations has been tweaked.
9007     * The `*` and `.` operators are now overloadable through the `Deref` and
9008       `DerefMut` traits.
9009     * `~Trait` and `proc` no longer have `Send` bounds by default.
9010     * Partial type hints are now supported with the `_` type marker.
9011     * An `Unsafe` type was introduced for interior mutability. It is now
9012       considered undefined to transmute from `&T` to `&mut T` without using the
9013       `Unsafe` type.
9014     * The #[linkage] attribute was implemented for extern statics/functions.
9015     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
9016     * `Pod` was renamed to `Copy`.
9017
9018   * Libraries
9019     * The `libextra` library has been removed. It has now been decomposed into
9020       component libraries with smaller and more focused nuggets of
9021       functionality. The full list of libraries can be found on the
9022       documentation index page.
9023     * std: `std::condition` has been removed. All I/O errors are now propagated
9024       through the `Result` type. In order to assist with error handling, a
9025       `try!` macro for unwrapping errors with an early return and a lint for
9026       unused results has been added. See #12039 for more information.
9027     * std: The `vec` module has been renamed to `slice`.
9028     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
9029       This will become the only growable vector in the future.
9030     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
9031       are now found at `std::io::BufferedReader` instead of
9032       `std::io::buffered::BufferedReader`.
9033     * std: `print` and `println` are no longer in the prelude, the `print!` and
9034       `println!` macros are intended to be used instead.
9035     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
9036       attempts to statically prevent cycles.
9037     * std: The standard distribution is adopting the policy of pushing failure
9038       to the user rather than failing in libraries. Many functions (such as
9039       `slice::last()`) now return `Option<T>` instead of `T` + failing.
9040     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
9041       deriving mode: `#[deriving(Show)]`.
9042     * std: `ToStr` is now implemented for all types implementing `Show`.
9043     * std: The formatting trait methods now take `&self` instead of `&T`
9044     * std: The `invert()` method on iterators has been renamed to `rev()`
9045     * std: `std::num` has seen a reduction in the genericity of its traits,
9046       consolidating functionality into a few core traits.
9047     * std: Backtraces are now printed on task failure if the environment
9048       variable `RUST_BACKTRACE` is present.
9049     * std: Naming conventions for iterators have been standardized. More details
9050       can be found on the wiki's style guide.
9051     * std: `eof()` has been removed from the `Reader` trait. Specific types may
9052       still implement the function.
9053     * std: Networking types are now cloneable to allow simultaneous reads/writes.
9054     * std: `assert_approx_eq!` has been removed
9055     * std: The `e` and `E` formatting specifiers for floats have been added to
9056       print them in exponential notation.
9057     * std: The `Times` trait has been removed
9058     * std: Indications of variance and opting out of builtin bounds is done
9059       through marker types in `std::kinds::marker` now
9060     * std: `hash` has been rewritten, `IterBytes` has been removed, and
9061       `#[deriving(Hash)]` is now possible.
9062     * std: `SharedChan` has been removed, `Sender` is now cloneable.
9063     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
9064     * std: `Chan::new` is now `channel()`.
9065     * std: A new synchronous channel type has been implemented.
9066     * std: A `select!` macro is now provided for selecting over `Receiver`s.
9067     * std: `hashmap` and `trie` have been moved to `libcollections`
9068     * std: `run` has been rolled into `io::process`
9069     * std: `assert_eq!` now uses `{}` instead of `{:?}`
9070     * std: The equality and comparison traits have seen some reorganization.
9071     * std: `rand` has moved to `librand`.
9072     * std: `to_{lower,upper}case` has been implemented for `char`.
9073     * std: Logging has been moved to `liblog`.
9074     * collections: `HashMap` has been rewritten for higher performance and less
9075       memory usage.
9076     * native: The default runtime is now `libnative`. If `libgreen` is desired,
9077       it can be booted manually. The runtime guide has more information and
9078       examples.
9079     * native: All I/O functionality except signals has been implemented.
9080     * green: Task spawning with `libgreen` has been optimized with stack caching
9081       and various trimming of code.
9082     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
9083     * sync: The `extra::sync` module has been updated to modern rust (and moved
9084       to the `sync` library), tweaking and improving various interfaces while
9085       dropping redundant functionality.
9086     * sync: A new `Barrier` type has been added to the `sync` library.
9087     * sync: An efficient mutex for native and green tasks has been implemented.
9088     * serialize: The `base64` module has seen some improvement. It treats
9089       newlines better, has non-string error values, and has seen general
9090       cleanup.
9091     * fourcc: A `fourcc!` macro was introduced
9092     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
9093       hexadecimal literal.
9094
9095   * Tooling
9096     * `rustpkg` has been deprecated and removed from the main repository. Its
9097       replacement, `cargo`, is under development.
9098     * Nightly builds of rust are now available
9099     * The memory usage of rustc has been improved many times throughout this
9100       release cycle.
9101     * The build process supports disabling rpath support for the rustc binary
9102       itself.
9103     * Code generation has improved in some cases, giving more information to the
9104       LLVM optimization passes to enable more extensive optimizations.
9105     * Debuginfo compatibility with lldb on OSX has been restored.
9106     * The master branch is now gated on an android bot, making building for
9107       android much more reliable.
9108     * Output flags have been centralized into one `--emit` flag.
9109     * Crate type flags have been centralized into one `--crate-type` flag.
9110     * Codegen flags have been consolidated behind a `-C` flag.
9111     * Linking against outdated crates now has improved error messages.
9112     * Error messages with lifetimes will often suggest how to annotate the
9113       function to fix the error.
9114     * Many more types are documented in the standard library, and new guides
9115       were written.
9116     * Many `rustdoc` improvements:
9117       * code blocks are syntax highlighted.
9118       * render standalone markdown files.
9119       * the --test flag tests all code blocks by default.
9120       * exported macros are displayed.
9121       * re-exported types have their documentation inlined at the location of the
9122         first re-export.
9123       * search works across crates that have been rendered to the same output
9124         directory.
9125
9126
9127 Version 0.9 (2014-01-09)
9128 ==========================
9129
9130    * ~1800 changes, numerous bugfixes
9131
9132    * Language
9133       * The `float` type has been removed. Use `f32` or `f64` instead.
9134       * A new facility for enabling experimental features (feature gating) has
9135         been added, using the crate-level `#[feature(foo)]` attribute.
9136       * Managed boxes (@) are now behind a feature gate
9137         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
9138         standard library's `Gc` or `Rc` types instead.
9139       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
9140       * Jumping back to the top of a loop is now done with `continue` instead of
9141         `loop`.
9142       * Strings can no longer be mutated through index assignment.
9143       * Raw strings can be created via the basic `r"foo"` syntax or with matched
9144         hash delimiters, as in `r###"foo"###`.
9145       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
9146         called once.
9147       * The `&fn` type is now written `|args| -> ret` to match the literal form.
9148       * `@fn`s have been removed.
9149       * `do` only works with procs in order to make it obvious what the cost
9150         of `do` is.
9151       * Single-element tuple-like structs can no longer be dereferenced to
9152         obtain the inner value. A more comprehensive solution for overloading
9153         the dereference operator will be provided in the future.
9154       * The `#[link(...)]` attribute has been replaced with
9155         `#[crate_id = "name#vers"]`.
9156       * Empty `impl`s must be terminated with empty braces and may not be
9157         terminated with a semicolon.
9158       * Keywords are no longer allowed as lifetime names; the `self` lifetime
9159         no longer has any special meaning.
9160       * The old `fmt!` string formatting macro has been removed.
9161       * `printf!` and `printfln!` (old-style formatting) removed in favor of
9162         `print!` and `println!`.
9163       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
9164       * The `extern mod foo (name = "bar")` syntax has been removed. Use
9165         `extern mod foo = "bar"` instead.
9166       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
9167       * Macros can have attributes.
9168       * Macros can expand to items with attributes.
9169       * Macros can expand to multiple items.
9170       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
9171       * Comments may be nested.
9172       * Values automatically coerce to trait objects they implement, without
9173         an explicit `as`.
9174       * Enum discriminants are no longer an entire word but as small as needed to
9175         contain all the variants. The `repr` attribute can be used to override
9176         the discriminant size, as in `#[repr(int)]` for integer-sized, and
9177         `#[repr(C)]` to match C enums.
9178       * Non-string literals are not allowed in attributes (they never worked).
9179       * The FFI now supports variadic functions.
9180       * Octal numeric literals, as in `0o7777`.
9181       * The `concat!` syntax extension performs compile-time string concatenation.
9182       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
9183         removed as Rust no longer uses segmented stacks.
9184       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
9185       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
9186         not `*`; ignoring remaining fields of a struct is also done with `..`,
9187         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
9188       * `rustc` supports the "win64" calling convention via `extern "win64"`.
9189       * `rustc` supports the "system" calling convention, which defaults to the
9190         preferred convention for the target platform, "stdcall" on 32-bit Windows,
9191         "C" elsewhere.
9192       * The `type_overflow` lint (default: warn) checks literals for overflow.
9193       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
9194       * The `attribute_usage` lint (default: warn) warns about unknown
9195         attributes.
9196       * The `unknown_features` lint (default: warn) warns about unknown
9197         feature gates.
9198       * The `dead_code` lint (default: warn) checks for dead code.
9199       * Rust libraries can be linked statically to one another
9200       * `#[link_args]` is behind the `link_args` feature gate.
9201       * Native libraries are now linked with `#[link(name = "foo")]`
9202       * Native libraries can be statically linked to a rust crate
9203         (`#[link(name = "foo", kind = "static")]`).
9204       * Native OS X frameworks are now officially supported
9205         (`#[link(name = "foo", kind = "framework")]`).
9206       * The `#[thread_local]` attribute creates thread-local (not task-local)
9207         variables. Currently behind the `thread_local` feature gate.
9208       * The `return` keyword may be used in closures.
9209       * Types that can be copied via a memcpy implement the `Pod` kind.
9210       * The `cfg` attribute can now be used on struct fields and enum variants.
9211
9212    * Libraries
9213       * std: The `option` and `result` API's have been overhauled to make them
9214         simpler, more consistent, and more composable.
9215       * std: The entire `std::io` module has been replaced with one that is
9216         more comprehensive and that properly interfaces with the underlying
9217         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
9218         implemented.
9219       * std: `io::util` contains a number of useful implementations of
9220         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
9221         `ZeroReader`, `TeeReader`.
9222       * std: The reference counted pointer type `extra::rc` moved into std.
9223       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
9224         just a wrapper around it).
9225       * std: The `Either` type has been removed.
9226       * std: `fmt::Default` can be implemented for any type to provide default
9227         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
9228       * std: The `rand` API continues to be tweaked.
9229       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
9230         on failure in gdb, is now named `rust_fail`.
9231       * std: The `each_key` and `each_value` methods on `HashMap` have been
9232         replaced by the `keys` and `values` iterators.
9233       * std: Functions dealing with type size and alignment have moved from the
9234         `sys` module to the `mem` module.
9235       * std: The `path` module was written and API changed.
9236       * std: `str::from_utf8` has been changed to cast instead of allocate.
9237       * std: `starts_with` and `ends_with` methods added to vectors via the
9238         `ImmutableEqVector` trait, which is in the prelude.
9239       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
9240         if the index is out of bounds.
9241       * std: Task failure no longer propagates between tasks, as the model was
9242         complex, expensive, and incompatible with thread-based tasks.
9243       * std: The `Any` type can be used for dynamic typing.
9244       * std: `~Any` can be passed to the `fail!` macro and retrieved via
9245         `task::try`.
9246       * std: Methods that produce iterators generally do not have an `_iter`
9247         suffix now.
9248       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
9249         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
9250       * std: `util::ignore` renamed to `prelude::drop`.
9251       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
9252         trait.
9253       * std: `vec::raw` has seen a lot of cleanup and API changes.
9254       * std: The standard library no longer includes any C++ code, and very
9255         minimal C, eliminating the dependency on libstdc++.
9256       * std: Runtime scheduling and I/O functionality has been factored out into
9257         extensible interfaces and is now implemented by two different crates:
9258         libnative, for native threading and I/O; and libgreen, for green threading
9259         and I/O. This paves the way for using the standard library in more limited
9260         embedded environments.
9261       * std: The `comm` module has been rewritten to be much faster, have a
9262         simpler, more consistent API, and to work for both native and green
9263         threading.
9264       * std: All libuv dependencies have been moved into the rustuv crate.
9265       * native: New implementations of runtime scheduling on top of OS threads.
9266       * native: New native implementations of TCP, UDP, file I/O, process spawning,
9267         and other I/O.
9268       * green: The green thread scheduler and message passing types are almost
9269         entirely lock-free.
9270       * extra: The `flatpipes` module had bitrotted and was removed.
9271       * extra: All crypto functions have been removed and Rust now has a policy of
9272         not reimplementing crypto in the standard library. In the future crypto
9273         will be provided by external crates with bindings to established libraries.
9274       * extra: `c_vec` has been modernized.
9275       * extra: The `sort` module has been removed. Use the `sort` method on
9276         mutable slices.
9277
9278    * Tooling
9279       * The `rust` and `rusti` commands have been removed, due to lack of
9280         maintenance.
9281       * `rustdoc` was completely rewritten.
9282       * `rustdoc` can test code examples in documentation.
9283       * `rustpkg` can test packages with the argument, 'test'.
9284       * `rustpkg` supports arbitrary dependencies, including C libraries.
9285       * `rustc`'s support for generating debug info is improved again.
9286       * `rustc` has better error reporting for unbalanced delimiters.
9287       * `rustc`'s JIT support was removed due to bitrot.
9288       * Executables and static libraries can be built with LTO (-Z lto)
9289       * `rustc` adds a `--dep-info` flag for communicating dependencies to
9290         build tools.
9291
9292
9293 Version 0.8 (2013-09-26)
9294 ============================
9295
9296    * ~2200 changes, numerous bugfixes
9297
9298    * Language
9299       * The `for` loop syntax has changed to work with the `Iterator` trait.
9300       * At long last, unwinding works on Windows.
9301       * Default methods are ready for use.
9302       * Many trait inheritance bugs fixed.
9303       * Owned and borrowed trait objects work more reliably.
9304       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
9305       * rustc can omit emission of code for the `debug!` macro if it is passed
9306         `--cfg ndebug`
9307       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
9308         for foo.rs, then foo/mod.rs, and will generate an error when both are
9309         present.
9310       * Strings no longer contain trailing nulls. The new `std::c_str` module
9311         provides new mechanisms for converting to C strings.
9312       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
9313       * The FFI has been overhauled such that foreign functions are called directly,
9314         instead of through a stack-switching wrapper.
9315       * Calling a foreign function must be done through a Rust function with the
9316         `#[fixed_stack_segment]` attribute.
9317       * The `externfn!` macro can be used to declare both a foreign function and
9318         a `#[fixed_stack_segment]` wrapper at once.
9319       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
9320       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
9321       * `priv` is disallowed everywhere except for struct fields and enum variants.
9322       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
9323       * `ref` bindings in irrefutable patterns work correctly now.
9324       * `char` is now prevented from containing invalid code points.
9325       * Casting to `bool` is no longer allowed.
9326       * `\0` is now accepted as an escape in chars and strings.
9327       * `yield` is a reserved keyword.
9328       * `typeof` is a reserved keyword.
9329       * Crates may be imported by URL with `extern mod foo = "url";`.
9330       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
9331       * Static vectors can be initialized with repeating elements,
9332         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
9333       * Static structs can be initialized with functional record update,
9334         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
9335       * `cfg!` can be used to conditionally execute code based on the crate
9336         configuration, similarly to `#[cfg(...)]`.
9337       * The `unnecessary_qualification` lint detects unneeded module
9338         prefixes (default: allow).
9339       * Arithmetic operations have been implemented on the SIMD types in
9340         `std::unstable::simd`.
9341       * Exchange allocation headers were removed, reducing memory usage.
9342       * `format!` implements a completely new, extensible, and higher-performance
9343         string formatting system. It will replace `fmt!`.
9344       * `print!` and `println!` write formatted strings (using the `format!`
9345         extension) to stdout.
9346       * `write!` and `writeln!` write formatted strings (using the `format!`
9347         extension) to the new Writers in `std::rt::io`.
9348       * The library section in which a function or static is placed may
9349         be specified with `#[link_section = "..."]`.
9350       * The `proto!` syntax extension for defining bounded message protocols
9351         was removed.
9352       * `macro_rules!` is hygienic for `let` declarations.
9353       * The `#[export_name]` attribute specifies the name of a symbol.
9354       * `unreachable!` can be used to indicate unreachable code, and fails
9355         if executed.
9356
9357    * Libraries
9358       * std: Transitioned to the new runtime, written in Rust.
9359       * std: Added an experimental I/O library, `rt::io`, based on the new
9360         runtime.
9361       * std: A new generic `range` function was added to the prelude, replacing
9362         `uint::range` and friends.
9363       * std: `range_rev` no longer exists. Since range is an iterator it can be
9364         reversed with `range(lo, hi).invert()`.
9365       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
9366         renamed to `unwrap_or`.
9367       * std: The `iterator` module was renamed to `iter`.
9368       * std: Integral types now support the `checked_add`, `checked_sub`, and
9369         `checked_mul` operations for detecting overflow.
9370       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
9371         consistency.
9372       * std: Methods are standardizing on conventions for casting methods:
9373         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
9374         and cheap casts.
9375       * std: The `CString` type in `c_str` provides new ways to convert to and
9376         from C strings.
9377       * std: `DoubleEndedIterator` can yield elements in two directions.
9378       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
9379         two splices.
9380       * std: `str::from_bytes` renamed to `str::from_utf8`.
9381       * std: `pop_opt` and `shift_opt` methods added to vectors.
9382       * std: The task-local data interface no longer uses @, and keys are
9383         no longer function pointers.
9384       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
9385       * std: Added `SharedPort` to `comm`.
9386       * std: `Eq` has a default method for `ne`; only `eq` is required
9387         in implementations.
9388       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
9389         is required in implementations.
9390       * std: `is_utf8` performance is improved, impacting many string functions.
9391       * std: `os::MemoryMap` provides cross-platform mmap.
9392       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
9393         are not 'in-bounds' are considered undefined.
9394       * std: Many freestanding functions in `vec` removed in favor of methods.
9395       * std: Many freestanding functions on scalar types removed in favor of
9396         methods.
9397       * std: Many options to task builders were removed since they don't make
9398         sense in the new scheduler design.
9399       * std: More containers implement `FromIterator` so can be created by the
9400         `collect` method.
9401       * std: More complete atomic types in `unstable::atomics`.
9402       * std: `comm::PortSet` removed.
9403       * std: Mutating methods in the `Set` and `Map` traits have been moved into
9404         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
9405         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
9406         default implementations.
9407       * std: Various `from_str` functions were removed in favor of a generic
9408         `from_str` which is available in the prelude.
9409       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
9410       * extra: `dlist`, the doubly-linked list was modernized.
9411       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
9412       * extra: Added `glob` module, replacing `std::os::glob`.
9413       * extra: `rope` was removed.
9414       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
9415       * extra: `net`, and `timer` were removed. The experimental replacements
9416         are `std::rt::io::net` and `std::rt::io::timer`.
9417       * extra: Iterators implemented for `SmallIntMap`.
9418       * extra: Iterators implemented for `Bitv` and `BitvSet`.
9419       * extra: `SmallIntSet` removed. Use `BitvSet`.
9420       * extra: Performance of JSON parsing greatly improved.
9421       * extra: `semver` updated to SemVer 2.0.0.
9422       * extra: `term` handles more terminals correctly.
9423       * extra: `dbg` module removed.
9424       * extra: `par` module removed.
9425       * extra: `future` was cleaned up, with some method renames.
9426       * extra: Most free functions in `getopts` were converted to methods.
9427
9428    * Other
9429       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
9430       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
9431         similarly to gcc's `--march` flag.
9432       * rustc's performance compiling small crates is much better.
9433       * rustpkg has received many improvements.
9434       * rustpkg supports git tags as package IDs.
9435       * rustpkg builds into target-specific directories so it can be used for
9436         cross-compiling.
9437       * The number of concurrent test tasks is controlled by the environment
9438         variable RUST_TEST_TASKS.
9439       * The test harness can now report metrics for benchmarks.
9440       * All tools have man pages.
9441       * Programs compiled with `--test` now support the `-h` and `--help` flags.
9442       * The runtime uses jemalloc for allocations.
9443       * Segmented stacks are temporarily disabled as part of the transition to
9444         the new runtime. Stack overflows are possible!
9445       * A new documentation backend, rustdoc_ng, is available for use. It is
9446         still invoked through the normal `rustdoc` command.
9447
9448
9449 Version 0.7 (2013-07-03)
9450 =======================
9451
9452    * ~2000 changes, numerous bugfixes
9453
9454    * Language
9455       * `impl`s no longer accept a visibility qualifier. Put them on methods
9456         instead.
9457       * The borrow checker has been rewritten with flow-sensitivity, fixing
9458         many bugs and inconveniences.
9459       * The `self` parameter no longer implicitly means `&'self self`,
9460         and can be explicitly marked with a lifetime.
9461       * Overloadable compound operators (`+=`, etc.) have been temporarily
9462         removed due to bugs.
9463       * The `for` loop protocol now requires `for`-iterators to return `bool`
9464         so they compose better.
9465       * The `Durable` trait is replaced with the `'static` bounds.
9466       * Trait default methods work more often.
9467       * Structs with the `#[packed]` attribute have byte alignment and
9468         no padding between fields.
9469       * Type parameters bound by `Copy` must now be copied explicitly with
9470         the `copy` keyword.
9471       * It is now illegal to move out of a dereferenced unsafe pointer.
9472       * `Option<~T>` is now represented as a nullable pointer.
9473       * `@mut` does dynamic borrow checks correctly.
9474       * The `main` function is only detected at the topmost level of the crate.
9475         The `#[main]` attribute is still valid anywhere.
9476       * Struct fields may no longer be mutable. Use inherited mutability.
9477       * The `#[no_send]` attribute makes a type that would otherwise be
9478         `Send`, not.
9479       * The `#[no_freeze]` attribute makes a type that would otherwise be
9480         `Freeze`, not.
9481       * Unbounded recursion will abort the process after reaching the limit
9482         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
9483       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
9484         are never implicitly copyable.
9485       * `#[static_assert]` makes compile-time assertions about static bools.
9486       * At long last, 'argument modes' no longer exist.
9487       * The rarely used `use mod` statement no longer exists.
9488
9489    * Syntax extensions
9490       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
9491         argument list.
9492       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
9493         `Rand`, `Zero` and `ToStr` can all be automatically derived with
9494         `#[deriving(...)]`.
9495       * The `bytes!` macro returns a vector of bytes for string, u8, char,
9496         and unsuffixed integer literals.
9497
9498    * Libraries
9499       * The `core` crate was renamed to `std`.
9500       * The `std` crate was renamed to `extra`.
9501       * More and improved documentation.
9502       * std: `iterator` module for external iterator objects.
9503       * Many old-style (internal, higher-order function) iterators replaced by
9504         implementations of `Iterator`.
9505       * std: Many old internal vector and string iterators,
9506         incl. `any`, `all`. removed.
9507       * std: The `finalize` method of `Drop` renamed to `drop`.
9508       * std: The `drop` method now takes `&mut self` instead of `&self`.
9509       * std: The prelude no longer re-exports any modules, only types and traits.
9510       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
9511         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
9512       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
9513         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
9514       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
9515         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
9516       * std: Many types implement `Clone`.
9517       * std: `path` type renamed to `Path`.
9518       * std: `mut` module and `Mut` type removed.
9519       * std: Many standalone functions removed in favor of methods and iterators
9520         in `vec`, `str`. In the future methods will also work as functions.
9521       * std: `reinterpret_cast` removed. Use `transmute`.
9522       * std: ascii string handling in `std::ascii`.
9523       * std: `Rand` is implemented for ~/@.
9524       * std: `run` module for spawning processes overhauled.
9525       * std: Various atomic types added to `unstable::atomic`.
9526       * std: Various types implement `Zero`.
9527       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
9528       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
9529       * std: Added `os::mkdir_recursive`.
9530       * std: Added `os::glob` function performs filesystems globs.
9531       * std: `FuzzyEq` renamed to `ApproxEq`.
9532       * std: `Map` now defines `pop` and `swap` methods.
9533       * std: `Cell` constructors converted to static methods.
9534       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
9535       * extra: `flate` module moved from `std` to `extra`.
9536       * extra: `fileinput` module for iterating over a series of files.
9537       * extra: `Complex` number type and `complex` module.
9538       * extra: `Rational` number type and `rational` module.
9539       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
9540       * extra: `term` uses terminfo now, is more correct.
9541       * extra: `arc` functions converted to methods.
9542       * extra: Implementation of fixed output size variations of SHA-2.
9543
9544    * Tooling
9545       * `unused_variables` lint mode for unused variables (default: warn).
9546       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
9547         (default: warn).
9548       * `unused_mut` lint mode for identifying unused `mut` qualifiers
9549         (default: warn).
9550       * `dead_assignment` lint mode for unread variables (default: warn).
9551       * `unnecessary_allocation` lint mode detects some heap allocations that are
9552         immediately borrowed so could be written without allocating (default: warn).
9553       * `missing_doc` lint mode (default: allow).
9554       * `unreachable_code` lint mode (default: warn).
9555       * The `rusti` command has been rewritten and a number of bugs addressed.
9556       * rustc outputs in color on more terminals.
9557       * rustc accepts a `--link-args` flag to pass arguments to the linker.
9558       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
9559       * Compiling with `-g` will make the binary record information about
9560         dynamic borrowcheck failures for debugging.
9561       * rustdoc has a nicer stylesheet.
9562       * Various improvements to rustdoc.
9563       * Improvements to rustpkg (see the detailed release notes).
9564
9565
9566 Version 0.6 (2013-04-03)
9567 ========================
9568
9569    * ~2100 changes, numerous bugfixes
9570
9571    * Syntax changes
9572       * The self type parameter in traits is now spelled `Self`
9573       * The `self` parameter in trait and impl methods must now be explicitly
9574         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
9575       * Static methods no longer require the `static` keyword and instead
9576         are distinguished by the lack of a `self` parameter
9577       * Replaced the `Durable` trait with the `'static` lifetime
9578       * The old closure type syntax with the trailing sigil has been
9579         removed in favor of the more consistent leading sigil
9580       * `super` is a keyword, and may be prefixed to paths
9581       * Trait bounds are separated with `+` instead of whitespace
9582       * Traits are implemented with `impl Trait for Type`
9583         instead of `impl Type: Trait`
9584       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
9585       * The `export` keyword has finally been removed
9586       * The `move` keyword has been removed (see "Semantic changes")
9587       * The interior mutability qualifier on vectors, `[mut T]`, has been
9588         removed. Use `&mut [T]`, etc.
9589       * `mut` is no longer valid in `~mut T`. Use inherited mutability
9590       * `fail` is no longer a keyword. Use `fail!()`
9591       * `assert` is no longer a keyword. Use `assert!()`
9592       * `log` is no longer a keyword. use `debug!`, etc.
9593       * 1-tuples may be represented as `(T,)`
9594       * Struct fields may no longer be `mut`. Use inherited mutability,
9595         `@mut T`, `core::mut` or `core::cell`
9596       * `extern mod { ... }` is no longer valid syntax for foreign
9597         function modules. Use extern blocks: `extern { ... }`
9598       * Newtype enums removed. Use tuple-structs.
9599       * Trait implementations no longer support visibility modifiers
9600       * Pattern matching over vectors improved and expanded
9601       * `const` renamed to `static` to correspond to lifetime name,
9602         and make room for future `static mut` unsafe mutable globals.
9603       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
9604       * `Clone` implementations can be automatically generated with
9605         `#[deriving(Clone)]`
9606       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
9607         instead of `foo as Bar`.
9608       * Fixed length vector types are now written as `[int, .. 3]`
9609         instead of `[int * 3]`.
9610       * Fixed length vector types can express the length as a constant
9611         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
9612
9613    * Semantic changes
9614       * Types with owned pointers or custom destructors move by default,
9615         eliminating the `move` keyword
9616       * All foreign functions are considered unsafe
9617       * &mut is now unaliasable
9618       * Writes to borrowed @mut pointers are prevented dynamically
9619       * () has size 0
9620       * The name of the main function can be customized using #[main]
9621       * The default type of an inferred closure is &fn instead of @fn
9622       * `use` statements may no longer be "chained" - they cannot import
9623         identifiers imported by previous `use` statements
9624       * `use` statements are crate relative, importing from the "top"
9625         of the crate by default. Paths may be prefixed with `super::`
9626         or `self::` to change the search behavior.
9627       * Method visibility is inherited from the implementation declaration
9628       * Structural records have been removed
9629       * Many more types can be used in static items, including enums
9630         'static-lifetime pointers and vectors
9631       * Pattern matching over vectors improved and expanded
9632       * Typechecking of closure types has been overhauled to
9633         improve inference and eliminate unsoundness
9634       * Macros leave scope at the end of modules, unless that module is
9635         tagged with #[macro_escape]
9636
9637    * Libraries
9638       * Added big integers to `std::bigint`
9639       * Removed `core::oldcomm` module
9640       * Added pipe-based `core::comm` module
9641       * Numeric traits have been reorganized under `core::num`
9642       * `vec::slice` finally returns a slice
9643       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
9644       * Containers reorganized around traits in `core::container`
9645       * `core::dvec` removed, `~[T]` is a drop-in replacement
9646       * `core::send_map` renamed to `core::hashmap`
9647       * `std::map` removed; replaced with `core::hashmap`
9648       * `std::treemap` reimplemented as an owned balanced tree
9649       * `std::deque` and `std::smallintmap` reimplemented as owned containers
9650       * `core::trie` added as a fast ordered map for integer keys
9651       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
9652       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
9653         overload the comparison operators, whereas `TotalOrd` is used
9654         by certain container types
9655
9656    * Other
9657       * Replaced the 'cargo' package manager with 'rustpkg'
9658       * Added all-purpose 'rust' tool
9659       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
9660       * rustc now *attempts* to offer spelling suggestions
9661       * Improved support for ARM and Android
9662       * Preliminary MIPS backend
9663       * Improved foreign function ABI implementation for x86, x86_64
9664       * Various memory usage improvements
9665       * Rust code may be embedded in foreign code under limited circumstances
9666       * Inline assembler supported by new asm!() syntax extension.
9667
9668
9669 Version 0.5 (2012-12-21)
9670 ===========================
9671
9672    * ~900 changes, numerous bugfixes
9673
9674    * Syntax changes
9675       * Removed `<-` move operator
9676       * Completed the transition from the `#fmt` extension syntax to `fmt!`
9677       * Removed old fixed length vector syntax - `[T]/N`
9678       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
9679       * Macros may now expand to items and statements
9680       * `a.b()` is always parsed as a method call, never as a field projection
9681       * `Eq` and `IterBytes` implementations can be automatically generated
9682         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
9683       * Removed the special crate language for `.rc` files
9684       * Function arguments may consist of any irrefutable pattern
9685
9686    * Semantic changes
9687       * `&` and `~` pointers may point to objects
9688       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
9689       * Enum variants may be structs
9690       * Destructors can be added to all nominal types with the Drop trait
9691       * Structs and nullary enum variants may be constants
9692       * Values that cannot be implicitly copied are now automatically moved
9693         without writing `move` explicitly
9694       * `&T` may now be coerced to `*T`
9695       * Coercions happen in `let` statements as well as function calls
9696       * `use` statements now take crate-relative paths
9697       * The module and type namespaces have been merged so that static
9698         method names can be resolved under the trait in which they are
9699         declared
9700
9701    * Improved support for language features
9702       * Trait inheritance works in many scenarios
9703       * More support for explicit self arguments in methods - `self`, `&self`
9704         `@self`, and `~self` all generally work as expected
9705       * Static methods work in more situations
9706       * Experimental: Traits may declare default methods for the implementations
9707         to use
9708
9709    * Libraries
9710       * New condition handling system in `core::condition`
9711       * Timsort added to `std::sort`
9712       * New priority queue, `std::priority_queue`
9713       * Pipes for serializable types, `std::flatpipes'
9714       * Serialization overhauled to be trait-based
9715       * Expanded `getopts` definitions
9716       * Moved futures to `std`
9717       * More functions are pure now
9718       * `core::comm` renamed to `oldcomm`. Still deprecated
9719       * `rustdoc` and `cargo` are libraries now
9720
9721    * Misc
9722       * Added a preliminary REPL, `rusti`
9723       * License changed from MIT to dual MIT/APL2
9724
9725
9726 Version 0.4 (2012-10-15)
9727 ==========================
9728
9729    * ~2000 changes, numerous bugfixes
9730
9731    * Syntax
9732       * All keywords are now strict and may not be used as identifiers anywhere
9733       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
9734         'of', 'with', 'to', 'class'.
9735       * Classes are replaced with simpler structs
9736       * Explicit method self types
9737       * `ret` became `return` and `alt` became `match`
9738       * `import` is now `use`; `use is now `extern mod`
9739       * `extern mod { ... }` is now `extern { ... }`
9740       * `use mod` is the recommended way to import modules
9741       * `pub` and `priv` replace deprecated export lists
9742       * The syntax of `match` pattern arms now uses fat arrow (=>)
9743       * `main` no longer accepts an args vector; use `os::args` instead
9744
9745    * Semantics
9746       * Trait implementations are now coherent, ala Haskell typeclasses
9747       * Trait methods may be static
9748       * Argument modes are deprecated
9749       * Borrowed pointers are much more mature and recommended for use
9750       * Strings and vectors in the static region are stored in constant memory
9751       * Typestate was removed
9752       * Resolution rewritten to be more reliable
9753       * Support for 'dual-mode' data structures (freezing and thawing)
9754
9755    * Libraries
9756       * Most binary operators can now be overloaded via the traits in
9757         `core::ops'
9758       * `std::net::url` for representing URLs
9759       * Sendable hash maps in `core::send_map`
9760       * `core::task' gained a (currently unsafe) task-local storage API
9761
9762    * Concurrency
9763       * An efficient new intertask communication primitive called the pipe,
9764         along with a number of higher-level channel types, in `core::pipes`
9765       * `std::arc`, an atomically reference counted, immutable, shared memory
9766         type
9767       * `std::sync`, various exotic synchronization tools based on arcs and pipes
9768       * Futures are now based on pipes and sendable
9769       * More robust linked task failure
9770       * Improved task builder API
9771
9772    * Other
9773       * Improved error reporting
9774       * Preliminary JIT support
9775       * Preliminary work on precise GC
9776       * Extensive architectural improvements to rustc
9777       * Begun a transition away from buggy C++-based reflection (shape) code to
9778         Rust-based (visitor) code
9779       * All hash functions and tables converted to secure, randomized SipHash
9780
9781
9782 Version 0.3  (2012-07-12)
9783 ========================
9784
9785    * ~1900 changes, numerous bugfixes
9786
9787    * New coding conveniences
9788       * Integer-literal suffix inference
9789       * Per-item control over warnings, errors
9790       * #[cfg(windows)] and #[cfg(unix)] attributes
9791       * Documentation comments
9792       * More compact closure syntax
9793       * 'do' expressions for treating higher-order functions as
9794         control structures
9795       * *-patterns (wildcard extended to all constructor fields)
9796
9797    * Semantic cleanup
9798       * Name resolution pass and exhaustiveness checker rewritten
9799       * Region pointers and borrow checking supersede alias
9800         analysis
9801       * Init-ness checking is now provided by a region-based liveness
9802         pass instead of the typestate pass; same for last-use analysis
9803       * Extensive work on region pointers
9804
9805    * Experimental new language features
9806       * Slices and fixed-size, interior-allocated vectors
9807       * #!-comments for lang versioning, shell execution
9808       * Destructors and iface implementation for classes;
9809         type-parameterized classes and class methods
9810       * 'const' type kind for types that can be used to implement
9811         shared-memory concurrency patterns
9812
9813    * Type reflection
9814
9815    * Removal of various obsolete features
9816       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
9817                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
9818
9819       * Constructs: do-while loops ('do' repurposed), fn binding,
9820                     resources (replaced by destructors)
9821
9822    * Compiler reorganization
9823       * Syntax-layer of compiler split into separate crate
9824       * Clang (from LLVM project) integrated into build
9825       * Typechecker split into sub-modules
9826
9827    * New library code
9828       * New time functions
9829       * Extension methods for many built-in types
9830       * Arc: atomic-refcount read-only / exclusive-use shared cells
9831       * Par: parallel map and search routines
9832       * Extensive work on libuv interface
9833       * Much vector code moved to libraries
9834       * Syntax extensions: #line, #col, #file, #mod, #stringify,
9835         #include, #include_str, #include_bin
9836
9837    * Tool improvements
9838       * Cargo automatically resolves dependencies
9839
9840
9841 Version 0.2  (2012-03-29)
9842 =========================
9843
9844    * >1500 changes, numerous bugfixes
9845
9846    * New docs and doc tooling
9847
9848    * New port: FreeBSD x86_64
9849
9850    * Compilation model enhancements
9851       * Generics now specialized, multiply instantiated
9852       * Functions now inlined across separate crates
9853
9854    * Scheduling, stack and threading fixes
9855       * Noticeably improved message-passing performance
9856       * Explicit schedulers
9857       * Callbacks from C
9858       * Helgrind clean
9859
9860    * Experimental new language features
9861       * Operator overloading
9862       * Region pointers
9863       * Classes
9864
9865    * Various language extensions
9866       * C-callback function types: 'crust fn ...'
9867       * Infinite-loop construct: 'loop { ... }'
9868       * Shorten 'mutable' to 'mut'
9869       * Required mutable-local qualifier: 'let mut ...'
9870       * Basic glob-exporting: 'export foo::*;'
9871       * Alt now exhaustive, 'alt check' for runtime-checked
9872       * Block-function form of 'for' loop, with 'break' and 'ret'.
9873
9874    * New library code
9875       * AST quasi-quote syntax extension
9876       * Revived libuv interface
9877       * New modules: core::{future, iter}, std::arena
9878       * Merged per-platform std::{os*, fs*} to core::{libc, os}
9879       * Extensive cleanup, regularization in libstd, libcore
9880
9881
9882 Version 0.1  (2012-01-20)
9883 ===============================
9884
9885    * Most language features work, including:
9886       * Unique pointers, unique closures, move semantics
9887       * Interface-constrained generics
9888       * Static interface dispatch
9889       * Stack growth
9890       * Multithread task scheduling
9891       * Typestate predicates
9892       * Failure unwinding, destructors
9893       * Pattern matching and destructuring assignment
9894       * Lightweight block-lambda syntax
9895       * Preliminary macro-by-example
9896
9897    * Compiler works with the following configurations:
9898       * Linux: x86 and x86_64 hosts and targets
9899       * macOS: x86 and x86_64 hosts and targets
9900       * Windows: x86 hosts and targets
9901
9902    * Cross compilation / multi-target configuration supported.
9903
9904    * Preliminary API-documentation and package-management tools included.
9905
9906 Known issues:
9907
9908    * Documentation is incomplete.
9909
9910    * Performance is below intended target.
9911
9912    * Standard library APIs are subject to extensive change, reorganization.
9913
9914    * Language-level versioning is not yet operational - future code will
9915      break unexpectedly.