RELEASES.md

   1 Version 1.58.1 (2022-01-19)
   2 ===========================
   3
   4 * Fix race condition in `std::fs::remove_dir_all` ([CVE-2022-21658])
   5 * [Handle captured arguments in the `useless_format` Clippy lint][clippy/8295]
   6 * [Move `non_send_fields_in_send_ty` Clippy lint to nursery][clippy/8075]
   7 * [Fix wrong error message displayed when some imports are missing][91254]
   8 * [Fix rustfmt not formatting generated files from stdin][92912]
   9
  10 [CVE-2022-21658]: https://www.cve.org/CVERecord?id=CVE-2022-21658
  11 [91254]: https://github.com/rust-lang/rust/pull/91254
  12 [92912]: https://github.com/rust-lang/rust/pull/92912
  13 [clippy/8075]: https://github.com/rust-lang/rust-clippy/pull/8075
  14 [clippy/8295]: https://github.com/rust-lang/rust-clippy/pull/8295
  15
  16 Version 1.58.0 (2022-01-13)
  17 ==========================
  18
  19 Language
  20 --------
  21
  22 - [Format strings can now capture arguments simply by writing `{ident}` in the string.][90473] This works in all macros accepting format strings. Support for this in `panic!` (`panic!("{ident}")`) requires the 2021 edition; panic invocations in previous editions that appear to be trying to use this will result in a warning lint about not having the intended effect.
  23 - [`*const T` pointers can now be dereferenced in const contexts.][89551]
  24 - [The rules for when a generic struct implements `Unsize` have been relaxed.][90417]
  25
  26 Compiler
  27 --------
  28
  29 - [Add LLVM CFI support to the Rust compiler][89652]
  30 - [Stabilize -Z strip as -C strip][90058]. Note that while release builds already don't add debug symbols for the code you compile, the compiled standard library that ships with Rust includes debug symbols, so you may want to use the `strip` option to remove these symbols to produce smaller release binaries. Note that this release only includes support in rustc, not directly in cargo.
  31 - [Add support for LLVM coverage mapping format versions 5 and 6][91207]
  32 - [Emit LLVM optimization remarks when enabled with `-Cremark`][90833]
  33 - [Update the minimum external LLVM to 12][90175]
  34 - [Add `x86_64-unknown-none` at Tier 3*][89062]
  35 - [Build musl dist artifacts with debuginfo enabled][90733]. When building release binaries using musl, you may want to use the newly stabilized strip option to remove these debug symbols, reducing the size of your binaries.
  36 - [Don't abort compilation after giving a lint error][87337]
  37 - [Error messages point at the source of trait bound obligations in more places][89580]
  38
  39 \* Refer to Rust's [platform support page][platform-support-doc] for more
  40    information on Rust's tiered platform support.
  41
  42 Libraries
  43 ---------
  44
  45 - [All remaining functions in the standard library have `#[must_use]` annotations where appropriate][89692], producing a warning when ignoring their return value. This helps catch mistakes such as expecting a function to mutate a value in place rather than return a new value.
  46 - [Paths are automatically canonicalized on Windows for operations that support it][89174]
  47 - [Re-enable debug checks for `copy` and `copy_nonoverlapping`][90041]
  48 - [Implement `RefUnwindSafe` for `Rc<T>`][87467]
  49 - [Make RSplit<T, P>: Clone not require T: Clone][90117]
  50 - [Implement `Termination` for `Result<Infallible, E>`][88601]. This allows writing `fn main() -> Result<Infallible, ErrorType>`, for a program whose successful exits never involve returning from `main` (for instance, a program that calls `exit`, or that uses `exec` to run another program).
  51
  52 Stabilized APIs
  53 ---------------
  54
  55 - [`Metadata::is_symlink`]
  56 - [`Path::is_symlink`]
  57 - [`{integer}::saturating_div`]
  58 - [`Option::unwrap_unchecked`]
  59 - [`Result::unwrap_unchecked`]
  60 - [`Result::unwrap_err_unchecked`]
  61 - [`File::options`]
  62
  63 These APIs are now usable in const contexts:
  64
  65 - [`Duration::new`]
  66 - [`Duration::checked_add`]
  67 - [`Duration::saturating_add`]
  68 - [`Duration::checked_sub`]
  69 - [`Duration::saturating_sub`]
  70 - [`Duration::checked_mul`]
  71 - [`Duration::saturating_mul`]
  72 - [`Duration::checked_div`]
  73
  74 Cargo
  75 -----
  76
  77 - [Add --message-format for install command][cargo/10107]
  78 - [Warn when alias shadows external subcommand][cargo/10082]
  79
  80 Rustdoc
  81 -------
  82
  83 - [Show all Deref implementations recursively in rustdoc][90183]
  84 - [Use computed visibility in rustdoc][88447]
  85
  86 Compatibility Notes
  87 -------------------
  88
  89 - [Try all stable method candidates first before trying unstable ones][90329]. This change ensures that adding new nightly-only methods to the Rust standard library will not break code invoking methods of the same name from traits outside the standard library.
  90 - Windows: [`std::process::Command` will no longer search the current directory for executables.][87704]
  91 - [All proc-macro backward-compatibility lints are now deny-by-default.][88041]
  92 - [proc_macro: Append .0 to unsuffixed float if it would otherwise become int token][90297]
  93 - [Refactor weak symbols in std::sys::unix][90846]. This optimizes accesses to glibc functions, by avoiding the use of dlopen. This does not increase the [minimum expected version of glibc](https://doc.rust-lang.org/nightly/rustc/platform-support.html). However, software distributions that use symbol versions to detect library dependencies, and which take weak symbols into account in that analysis, may detect rust binaries as requiring newer versions of glibc.
  94 - [rustdoc now rejects some unexpected semicolons in doctests][91026]
  95
  96 Internal Changes
  97 ----------------
  98
  99 These changes provide no direct user facing benefits, but represent significant
 100 improvements to the internals and overall performance of rustc
 101 and related tools.
 102
 103 - [Implement coherence checks for negative trait impls][90104]
 104 - [Add rustc lint, warning when iterating over hashmaps][89558]
 105 - [Optimize live point computation][90491]
 106 - [Enable verification for 1/32nd of queries loaded from disk][90361]
 107 - [Implement version of normalize_erasing_regions that allows for normalization failure][91255]
 108
 109 [87337]: https://github.com/rust-lang/rust/pull/87337/
 110 [87467]: https://github.com/rust-lang/rust/pull/87467/
 111 [87704]: https://github.com/rust-lang/rust/pull/87704/
 112 [88041]: https://github.com/rust-lang/rust/pull/88041/
 113 [88447]: https://github.com/rust-lang/rust/pull/88447/
 114 [88601]: https://github.com/rust-lang/rust/pull/88601/
 115 [89062]: https://github.com/rust-lang/rust/pull/89062/
 116 [89174]: https://github.com/rust-lang/rust/pull/89174/
 117 [89551]: https://github.com/rust-lang/rust/pull/89551/
 118 [89558]: https://github.com/rust-lang/rust/pull/89558/
 119 [89580]: https://github.com/rust-lang/rust/pull/89580/
 120 [89652]: https://github.com/rust-lang/rust/pull/89652/
 121 [90041]: https://github.com/rust-lang/rust/pull/90041/
 122 [90058]: https://github.com/rust-lang/rust/pull/90058/
 123 [90104]: https://github.com/rust-lang/rust/pull/90104/
 124 [90117]: https://github.com/rust-lang/rust/pull/90117/
 125 [90175]: https://github.com/rust-lang/rust/pull/90175/
 126 [90183]: https://github.com/rust-lang/rust/pull/90183/
 127 [90297]: https://github.com/rust-lang/rust/pull/90297/
 128 [90329]: https://github.com/rust-lang/rust/pull/90329/
 129 [90361]: https://github.com/rust-lang/rust/pull/90361/
 130 [90417]: https://github.com/rust-lang/rust/pull/90417/
 131 [90473]: https://github.com/rust-lang/rust/pull/90473/
 132 [90491]: https://github.com/rust-lang/rust/pull/90491/
 133 [90733]: https://github.com/rust-lang/rust/pull/90733/
 134 [90833]: https://github.com/rust-lang/rust/pull/90833/
 135 [90846]: https://github.com/rust-lang/rust/pull/90846/
 136 [91026]: https://github.com/rust-lang/rust/pull/91026/
 137 [91207]: https://github.com/rust-lang/rust/pull/91207/
 138 [91255]: https://github.com/rust-lang/rust/pull/91255/
 139 [cargo/10082]: https://github.com/rust-lang/cargo/pull/10082/
 140 [cargo/10107]: https://github.com/rust-lang/cargo/pull/10107/
 141 [`Metadata::is_symlink`]: https://doc.rust-lang.org/stable/std/fs/struct.Metadata.html#method.is_symlink
 142 [`Path::is_symlink`]: https://doc.rust-lang.org/stable/std/path/struct.Path.html#method.is_symlink
 143 [`{integer}::saturating_div`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.saturating_div
 144 [`Option::unwrap_unchecked`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.unwrap_unchecked
 145 [`Result::unwrap_unchecked`]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.unwrap_unchecked
 146 [`Result::unwrap_err_unchecked`]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.unwrap_err_unchecked
 147 [`File::options`]: https://doc.rust-lang.org/stable/std/fs/struct.File.html#method.options
 148 [`Duration::new`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.new
 149
 150 Version 1.57.0 (2021-12-02)
 151 ==========================
 152
 153 Language
 154 --------
 155
 156 - [Macro attributes may follow `#[derive]` and will see the original (pre-`cfg`) input.][87220]
 157 - [Accept curly-brace macros in expressions, like `m!{ .. }.method()` and `m!{ .. }?`.][88690]
 158 - [Allow panicking in constant evaluation.][89508]
 159 - [Ignore derived `Clone` and `Debug` implementations during dead code analysis.][85200]
 160
 161 Compiler
 162 --------
 163
 164 - [Create more accurate debuginfo for vtables.][89597]
 165 - [Add `armv6k-nintendo-3ds` at Tier 3\*.][88529]
 166 - [Add `armv7-unknown-linux-uclibceabihf` at Tier 3\*.][88952]
 167 - [Add `m68k-unknown-linux-gnu` at Tier 3\*.][88321]
 168 - [Add SOLID targets at Tier 3\*:][86191] `aarch64-kmc-solid_asp3`, `armv7a-kmc-solid_asp3-eabi`, `armv7a-kmc-solid_asp3-eabihf`
 169
 170 \* Refer to Rust's [platform support page][platform-support-doc] for more
 171    information on Rust's tiered platform support.
 172
 173 Libraries
 174 ---------
 175
 176 - [Avoid allocations and copying in `Vec::leak`][89337]
 177 - [Add `#[repr(i8)]` to `Ordering`][89507]
 178 - [Optimize `File::read_to_end` and `read_to_string`][89582]
 179 - [Update to Unicode 14.0][89614]
 180 - [Many more functions are marked `#[must_use]`][89692], producing a warning
 181   when ignoring their return value. This helps catch mistakes such as expecting
 182   a function to mutate a value in place rather than return a new value.
 183
 184 Stabilised APIs
 185 ---------------
 186
 187 - [`[T; N]::as_mut_slice`][`array::as_mut_slice`]
 188 - [`[T; N]::as_slice`][`array::as_slice`]
 189 - [`collections::TryReserveError`]
 190 - [`HashMap::try_reserve`]
 191 - [`HashSet::try_reserve`]
 192 - [`String::try_reserve`]
 193 - [`String::try_reserve_exact`]
 194 - [`Vec::try_reserve`]
 195 - [`Vec::try_reserve_exact`]
 196 - [`VecDeque::try_reserve`]
 197 - [`VecDeque::try_reserve_exact`]
 198 - [`Iterator::map_while`]
 199 - [`iter::MapWhile`]
 200 - [`proc_macro::is_available`]
 201 - [`Command::get_program`]
 202 - [`Command::get_args`]
 203 - [`Command::get_envs`]
 204 - [`Command::get_current_dir`]
 205 - [`CommandArgs`]
 206 - [`CommandEnvs`]
 207
 208 These APIs are now usable in const contexts:
 209
 210 - [`hint::unreachable_unchecked`]
 211
 212 Cargo
 213 -----
 214
 215 - [Stabilize custom profiles][cargo/9943]
 216
 217 Compatibility notes
 218 -------------------
 219
 220 - [Ignore derived `Clone` and `Debug` implementations during dead code analysis.][85200]
 221   This will break some builds that set `#![deny(dead_code)]`.
 222
 223 Internal changes
 224 ----------------
 225 These changes provide no direct user facing benefits, but represent significant
 226 improvements to the internals and overall performance of rustc
 227 and related tools.
 228
 229 - [Added an experimental backend for codegen with `libgccjit`.][87260]
 230
 231 [85200]: https://github.com/rust-lang/rust/pull/85200/
 232 [86191]: https://github.com/rust-lang/rust/pull/86191/
 233 [87220]: https://github.com/rust-lang/rust/pull/87220/
 234 [87260]: https://github.com/rust-lang/rust/pull/87260/
 235 [88321]: https://github.com/rust-lang/rust/pull/88321/
 236 [88529]: https://github.com/rust-lang/rust/pull/88529/
 237 [88690]: https://github.com/rust-lang/rust/pull/88690/
 238 [88952]: https://github.com/rust-lang/rust/pull/88952/
 239 [89337]: https://github.com/rust-lang/rust/pull/89337/
 240 [89507]: https://github.com/rust-lang/rust/pull/89507/
 241 [89508]: https://github.com/rust-lang/rust/pull/89508/
 242 [89582]: https://github.com/rust-lang/rust/pull/89582/
 243 [89597]: https://github.com/rust-lang/rust/pull/89597/
 244 [89614]: https://github.com/rust-lang/rust/pull/89614/
 245 [89692]: https://github.com/rust-lang/rust/issues/89692/
 246 [cargo/9943]: https://github.com/rust-lang/cargo/pull/9943/
 247 [`array::as_mut_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_mut_slice
 248 [`array::as_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_slice
 249 [`collections::TryReserveError`]: https://doc.rust-lang.org/std/collections/struct.TryReserveError.html
 250 [`HashMap::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_map/struct.HashMap.html#method.try_reserve
 251 [`HashSet::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_set/struct.HashSet.html#method.try_reserve
 252 [`String::try_reserve`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve
 253 [`String::try_reserve_exact`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve_exact
 254 [`Vec::try_reserve`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve
 255 [`Vec::try_reserve_exact`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve_exact
 256 [`VecDeque::try_reserve`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve
 257 [`VecDeque::try_reserve_exact`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve_exact
 258 [`Iterator::map_while`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.map_while
 259 [`iter::MapWhile`]: https://doc.rust-lang.org/std/iter/struct.MapWhile.html
 260 [`proc_macro::is_available`]: https://doc.rust-lang.org/proc_macro/fn.is_available.html
 261 [`Command::get_program`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_program
 262 [`Command::get_args`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_args
 263 [`Command::get_envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_envs
 264 [`Command::get_current_dir`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_current_dir
 265 [`CommandArgs`]: https://doc.rust-lang.org/std/process/struct.CommandArgs.html
 266 [`CommandEnvs`]: https://doc.rust-lang.org/std/process/struct.CommandEnvs.html
 267
 268 Version 1.56.1 (2021-11-01)
 269 ===========================
 270
 271 - New lints to detect the presence of bidirectional-override Unicode
 272   codepoints in the compiled source code ([CVE-2021-42574])
 273
 274 [CVE-2021-42574]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-42574
 275
 276 Version 1.56.0 (2021-10-21)
 277 ========================
 278
 279 Language
 280 --------
 281
 282 - [The 2021 Edition is now stable.][rust#88100]
 283   See [the edition guide][rust-2021-edition-guide] for more details.
 284 - [The pattern in `binding @ pattern` can now also introduce new bindings.][rust#85305]
 285 - [Union field access is permitted in `const fn`.][rust#85769]
 286
 287 [rust-2021-edition-guide]: https://doc.rust-lang.org/nightly/edition-guide/rust-2021/index.html
 288
 289 Compiler
 290 --------
 291
 292 - [Upgrade to LLVM 13.][rust#87570]
 293 - [Support memory, address, and thread sanitizers on aarch64-unknown-freebsd.][rust#88023]
 294 - [Allow specifying a deployment target version for all iOS targets][rust#87699]
 295 - [Warnings can be forced on with `--force-warn`.][rust#87472]
 296   This feature is primarily intended for usage by `cargo fix`, rather than end users.
 297 - [Promote `aarch64-apple-ios-sim` to Tier 2\*.][rust#87760]
 298 - [Add `powerpc-unknown-freebsd` at Tier 3\*.][rust#87370]
 299 - [Add `riscv32imc-esp-espidf` at Tier 3\*.][rust#87666]
 300
 301 \* Refer to Rust's [platform support page][platform-support-doc] for more
 302 information on Rust's tiered platform support.
 303
 304 Libraries
 305 ---------
 306
 307 - [Allow writing of incomplete UTF-8 sequences via stdout/stderr on Windows.][rust#83342]
 308   The Windows console still requires valid Unicode, but this change allows
 309   splitting a UTF-8 character across multiple write calls. This allows, for
 310   instance, programs that just read and write data buffers (e.g. copying a file
 311   to stdout) without regard for Unicode or character boundaries.
 312 - [Prefer `AtomicU{64,128}` over Mutex for Instant backsliding protection.][rust#83093]
 313   For this use case, atomics scale much better under contention.
 314 - [Implement `Extend<(A, B)>` for `(Extend<A>, Extend<B>)`][rust#85835]
 315 - [impl Default, Copy, Clone for std::io::Sink and std::io::Empty][rust#86744]
 316 - [`impl From<[(K, V); N]>` for all collections.][rust#84111]
 317 - [Remove `P: Unpin` bound on impl Future for Pin.][rust#81363]
 318 - [Treat invalid environment variable names as non-existent.][rust#86183]
 319   Previously, the environment functions would panic if given a variable name
 320   with an internal null character or equal sign (`=`). Now, these functions will
 321   just treat such names as non-existent variables, since the OS cannot represent
 322   the existence of a variable with such a name.
 323
 324 Stabilised APIs
 325 ---------------
 326
 327 - [`std::os::unix::fs::chroot`]
 328 - [`UnsafeCell::raw_get`]
 329 - [`BufWriter::into_parts`]
 330 - [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]
 331   These APIs were previously stable in `std`, but are now also available in `core`.
 332 - [`Vec::shrink_to`]
 333 - [`String::shrink_to`]
 334 - [`OsString::shrink_to`]
 335 - [`PathBuf::shrink_to`]
 336 - [`BinaryHeap::shrink_to`]
 337 - [`VecDeque::shrink_to`]
 338 - [`HashMap::shrink_to`]
 339 - [`HashSet::shrink_to`]
 340
 341 These APIs are now usable in const contexts:
 342
 343 - [`std::mem::transmute`]
 344 - [`[T]::first`][`slice::first`]
 345 - [`[T]::split_first`][`slice::split_first`]
 346 - [`[T]::last`][`slice::last`]
 347 - [`[T]::split_last`][`slice::split_last`]
 348
 349 Cargo
 350 -----
 351
 352 - [Cargo supports specifying a minimum supported Rust version in Cargo.toml.][`rust-version`]
 353   This has no effect at present on dependency version selection.
 354   We encourage crates to specify their minimum supported Rust version, and we encourage CI systems
 355   that support Rust code to include a crate's specified minimum version in the test matrix for that
 356   crate by default.
 357
 358 Compatibility notes
 359 -------------------
 360
 361 - [Update to new argument parsing rules on Windows.][rust#87580]
 362   This adjusts Rust's standard library to match the behavior of the standard
 363   libraries for C/C++. The rules have changed slightly over time, and this PR
 364   brings us to the latest set of rules (changed in 2008).
 365 - [Disallow the aapcs calling convention on aarch64][rust#88399]
 366   This was already not supported by LLVM; this change surfaces this lack of
 367   support with a better error message.
 368 - [Make `SEMICOLON_IN_EXPRESSIONS_FROM_MACROS` warn by default][rust#87385]
 369 - [Warn when an escaped newline skips multiple lines.][rust#87671]
 370 - [Calls to `libc::getpid` / `std::process::id` from `Command::pre_exec`
 371    may return different values on glibc <= 2.24.][rust#81825]
 372    Rust now invokes the `clone3` system call directly, when available, to use new functionality
 373    available via that system call. Older versions of glibc cache the result of `getpid`, and only
 374    update that cache when calling glibc's clone/fork functions, so a direct system call bypasses
 375    that cache update. glibc 2.25 and newer no longer cache `getpid` for exactly this reason.
 376
 377 Internal changes
 378 ----------------
 379 These changes provide no direct user facing benefits, but represent significant
 380 improvements to the internals and overall performance of rustc
 381 and related tools.
 382
 383 - [LLVM is compiled with PGO in published x86_64-unknown-linux-gnu artifacts.][rust#88069]
 384   This improves the performance of most Rust builds.
 385 - [Unify representation of macros in internal data structures.][rust#88019]
 386   This change fixes a host of bugs with the handling of macros by the compiler,
 387   as well as rustdoc.
 388
 389 [`std::os::unix::fs::chroot`]: https://doc.rust-lang.org/stable/std/os/unix/fs/fn.chroot.html
 390 [`UnsafeCell::raw_get`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.raw_get
 391 [`BufWriter::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.BufWriter.html#method.into_parts
 392 [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]: https://github.com/rust-lang/rust/pull/84662
 393 [`Vec::shrink_to`]: https://doc.rust-lang.org/stable/std/vec/struct.Vec.html#method.shrink_to
 394 [`String::shrink_to`]: https://doc.rust-lang.org/stable/std/string/struct.String.html#method.shrink_to
 395 [`OsString::shrink_to`]: https://doc.rust-lang.org/stable/std/ffi/struct.OsString.html#method.shrink_to
 396 [`PathBuf::shrink_to`]: https://doc.rust-lang.org/stable/std/path/struct.PathBuf.html#method.shrink_to
 397 [`BinaryHeap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.BinaryHeap.html#method.shrink_to
 398 [`VecDeque::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.VecDeque.html#method.shrink_to
 399 [`HashMap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_map/struct.HashMap.html#method.shrink_to
 400 [`HashSet::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_set/struct.HashSet.html#method.shrink_to
 401 [`std::mem::transmute`]: https://doc.rust-lang.org/stable/std/mem/fn.transmute.html
 402 [`slice::first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.first
 403 [`slice::split_first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_first
 404 [`slice::last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.last
 405 [`slice::split_last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_last
 406 [`rust-version`]: https://doc.rust-lang.org/nightly/cargo/reference/manifest.html#the-rust-version-field
 407 [rust#87671]: https://github.com/rust-lang/rust/pull/87671
 408 [rust#86183]: https://github.com/rust-lang/rust/pull/86183
 409 [rust#87385]: https://github.com/rust-lang/rust/pull/87385
 410 [rust#88100]: https://github.com/rust-lang/rust/pull/88100
 411 [rust#85305]: https://github.com/rust-lang/rust/pull/85305
 412 [rust#88069]: https://github.com/rust-lang/rust/pull/88069
 413 [rust#87472]: https://github.com/rust-lang/rust/pull/87472
 414 [rust#87699]: https://github.com/rust-lang/rust/pull/87699
 415 [rust#87570]: https://github.com/rust-lang/rust/pull/87570
 416 [rust#88023]: https://github.com/rust-lang/rust/pull/88023
 417 [rust#87760]: https://github.com/rust-lang/rust/pull/87760
 418 [rust#87370]: https://github.com/rust-lang/rust/pull/87370
 419 [rust#87580]: https://github.com/rust-lang/rust/pull/87580
 420 [rust#83342]: https://github.com/rust-lang/rust/pull/83342
 421 [rust#83093]: https://github.com/rust-lang/rust/pull/83093
 422 [rust#85835]: https://github.com/rust-lang/rust/pull/85835
 423 [rust#86744]: https://github.com/rust-lang/rust/pull/86744
 424 [rust#81363]: https://github.com/rust-lang/rust/pull/81363
 425 [rust#84111]: https://github.com/rust-lang/rust/pull/84111
 426 [rust#85769]: https://github.com/rust-lang/rust/pull/85769#issuecomment-854363720
 427 [rust#88399]: https://github.com/rust-lang/rust/pull/88399
 428 [rust#81825]: https://github.com/rust-lang/rust/pull/81825#issuecomment-808406918
 429 [rust#88019]: https://github.com/rust-lang/rust/pull/88019
 430 [rust#87666]: https://github.com/rust-lang/rust/pull/87666
 431
 432 Version 1.55.0 (2021-09-09)
 433 ============================
 434
 435 Language
 436 --------
 437 - [You can now write open "from" range patterns (`X..`), which will start at `X` and
 438   will end at the maximum value of the integer.][83918]
 439 - [You can now explicitly import the prelude of different editions
 440   through `std::prelude` (e.g. `use std::prelude::rust_2021::*;`).][86294]
 441
 442 Compiler
 443 --------
 444 - [Added tier 3\* support for `powerpc64le-unknown-freebsd`.][83572]
 445
 446 \* Refer to Rust's [platform support page][platform-support-doc] for more
 447    information on Rust's tiered platform support.
 448
 449 Libraries
 450 ---------
 451
 452 - [Updated std's float parsing to use the Eisel-Lemire algorithm.][86761]
 453   These improvements should in general provide faster string parsing of floats,
 454   no longer reject certain valid floating point values, and reduce
 455   the produced code size for non-stripped artifacts.
 456 - [`string::Drain` now implements `AsRef<str>` and `AsRef<[u8]>`.][86858]
 457
 458 Stabilised APIs
 459 ---------------
 460
 461 - [`Bound::cloned`]
 462 - [`Drain::as_str`]
 463 - [`IntoInnerError::into_error`]
 464 - [`IntoInnerError::into_parts`]
 465 - [`MaybeUninit::assume_init_mut`]
 466 - [`MaybeUninit::assume_init_ref`]
 467 - [`MaybeUninit::write`]
 468 - [`array::map`]
 469 - [`ops::ControlFlow`]
 470 - [`x86::_bittest`]
 471 - [`x86::_bittestandcomplement`]
 472 - [`x86::_bittestandreset`]
 473 - [`x86::_bittestandset`]
 474 - [`x86_64::_bittest64`]
 475 - [`x86_64::_bittestandcomplement64`]
 476 - [`x86_64::_bittestandreset64`]
 477 - [`x86_64::_bittestandset64`]
 478
 479 The following previously stable functions are now `const`.
 480
 481 - [`str::from_utf8_unchecked`]
 482
 483
 484 Cargo
 485 -----
 486 - [Cargo will now deduplicate compiler diagnostics to the terminal when invoking
 487   rustc in parallel such as when using `cargo test`.][cargo/9675]
 488 - [The package definition in `cargo metadata` now includes the `"default_run"`
 489   field from the manifest.][cargo/9550]
 490 - [Added `cargo d` as an alias for `cargo doc`.][cargo/9680]
 491 - [Added `{lib}` as formatting option for `cargo tree` to print the `"lib_name"`
 492   of packages.][cargo/9663]
 493
 494 Rustdoc
 495 -------
 496 - [Added "Go to item on exact match" search option.][85876]
 497 - [The "Implementors" section on traits no longer shows redundant
 498   method definitions.][85970]
 499 - [Trait implementations are toggled open by default.][86260] This should make the
 500   implementations more searchable by tools like `CTRL+F` in your browser.
 501 - [Intra-doc links should now correctly resolve associated items (e.g. methods)
 502   through type aliases.][86334]
 503 - [Traits which are marked with `#[doc(hidden)]` will no longer appear in the
 504   "Trait Implementations" section.][86513]
 505
 506
 507 Compatibility Notes
 508 -------------------
 509 - [std functions that return an `io::Error` will no longer use the
 510   `ErrorKind::Other` variant.][85746] This is to better reflect that these
 511   kinds of errors could be categorised [into newer more specific `ErrorKind`
 512   variants][79965], and that they do not represent a user error.
 513 - [Using environment variable names with `process::Command` on Windows now
 514   behaves as expected.][85270] Previously using envionment variables with
 515   `Command` would cause them to be ASCII-uppercased.
 516 - [Rustdoc will now warn on using rustdoc lints that aren't prefixed
 517   with `rustdoc::`][86849]
 518 - `RUSTFLAGS` is no longer set for build scripts. Build scripts
 519   should use `CARGO_ENCODED_RUSTFLAGS` instead. See the
 520   [documentation](https://doc.rust-lang.org/nightly/cargo/reference/environment-variables.html#environment-variables-cargo-sets-for-build-scripts)
 521   for more details.
 522
 523 [86849]: https://github.com/rust-lang/rust/pull/86849
 524 [86513]: https://github.com/rust-lang/rust/pull/86513
 525 [86334]: https://github.com/rust-lang/rust/pull/86334
 526 [86260]: https://github.com/rust-lang/rust/pull/86260
 527 [85970]: https://github.com/rust-lang/rust/pull/85970
 528 [85876]: https://github.com/rust-lang/rust/pull/85876
 529 [83572]: https://github.com/rust-lang/rust/pull/83572
 530 [86294]: https://github.com/rust-lang/rust/pull/86294
 531 [86858]: https://github.com/rust-lang/rust/pull/86858
 532 [86761]: https://github.com/rust-lang/rust/pull/86761
 533 [85746]: https://github.com/rust-lang/rust/pull/85746
 534 [85270]: https://github.com/rust-lang/rust/pull/85270
 535 [83918]: https://github.com/rust-lang/rust/pull/83918
 536 [79965]: https://github.com/rust-lang/rust/pull/79965
 537 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
 538 [cargo/9675]: https://github.com/rust-lang/cargo/pull/9675
 539 [cargo/9550]: https://github.com/rust-lang/cargo/pull/9550
 540 [cargo/9680]: https://github.com/rust-lang/cargo/pull/9680
 541 [`array::map`]: https://doc.rust-lang.org/stable/std/primitive.array.html#method.map
 542 [`Bound::cloned`]: https://doc.rust-lang.org/stable/std/ops/enum.Bound.html#method.cloned
 543 [`Drain::as_str`]: https://doc.rust-lang.org/stable/std/string/struct.Drain.html#method.as_str
 544 [`IntoInnerError::into_error`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_error
 545 [`IntoInnerError::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_parts
 546 [`MaybeUninit::assume_init_mut`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_mut
 547 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
 548 [`MaybeUninit::write`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.write
 549 [`ops::ControlFlow`]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html
 550 [`str::from_utf8_unchecked`]: https://doc.rust-lang.org/stable/std/str/fn.from_utf8_unchecked.html
 551 [`x86::_bittest`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittest.html
 552 [`x86::_bittestandcomplement`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandcomplement.html
 553 [`x86::_bittestandreset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandreset.html
 554 [`x86::_bittestandset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandset.html
 555 [`x86_64::_bittest64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittest64.html
 556 [`x86_64::_bittestandcomplement64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandcomplement64.html
 557 [`x86_64::_bittestandreset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandreset64.html
 558 [`x86_64::_bittestandset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandset64.html
 559
 560
 561 Version 1.54.0 (2021-07-29)
 562 ============================
 563
 564 Language
 565 -----------------------
 566
 567 - [You can now use macros for values in some built-in attributes.][83366]
 568   This primarily allows you to call macros within the `#[doc]` attribute. For
 569   example, to include external documentation in your crate, you can now write
 570   the following:
 571   ```rust
 572   #![doc = include_str!("README.md")]
 573   ```
 574
 575 - [You can now cast between unsized slice types (and types which contain
 576   unsized slices) in `const fn`.][85078]
 577 - [You can now use multiple generic lifetimes with `impl Trait` where the
 578    lifetimes don't explicitly outlive another.][84701] In code this means
 579    that you can now have `impl Trait<'a, 'b>` where as before you could
 580    only have `impl Trait<'a, 'b> where 'b: 'a`.
 581
 582 Compiler
 583 -----------------------
 584
 585 - [Rustc will now search for custom JSON targets in
 586   `/lib/rustlib/<target-triple>/target.json` where `/` is the "sysroot"
 587   directory.][83800] You can find your sysroot directory by running
 588   `rustc --print sysroot`.
 589 - [Added `wasm` as a `target_family` for WebAssembly platforms.][84072]
 590 - [You can now use `#[target_feature]` on safe functions when targeting
 591   WebAssembly platforms.][84988]
 592 - [Improved debugger output for enums on Windows MSVC platforms.][85292]
 593 - [Added tier 3\* support for `bpfel-unknown-none`
 594    and `bpfeb-unknown-none`.][79608]
 595 - [`-Zmutable-noalias=yes`][82834] is enabled by default when using LLVM 12 or above.
 596
 597 \* Refer to Rust's [platform support page][platform-support-doc] for more
 598    information on Rust's tiered platform support.
 599
 600 Libraries
 601 -----------------------
 602
 603 - [`panic::panic_any` will now `#[track_caller]`.][85745]
 604 - [Added `OutOfMemory` as a variant of `io::ErrorKind`.][84744]
 605 - [ `proc_macro::Literal` now implements `FromStr`.][84717]
 606 - [The implementations of vendor intrinsics in core::arch have been
 607    significantly refactored.][83278] The main user-visible changes are
 608    a 50% reduction in the size of libcore.rlib and stricter validation
 609    of constant operands passed to intrinsics. The latter is technically
 610    a breaking change, but allows Rust to more closely match the C vendor
 611    intrinsics API.
 612
 613 Stabilized APIs
 614 ---------------
 615
 616 - [`BTreeMap::into_keys`]
 617 - [`BTreeMap::into_values`]
 618 - [`HashMap::into_keys`]
 619 - [`HashMap::into_values`]
 620 - [`arch::wasm32`]
 621 - [`VecDeque::binary_search`]
 622 - [`VecDeque::binary_search_by`]
 623 - [`VecDeque::binary_search_by_key`]
 624 - [`VecDeque::partition_point`]
 625
 626 Cargo
 627 -----
 628
 629 - [Added the `--prune <spec>` option to `cargo-tree` to remove a package from
 630   the dependency graph.][cargo/9520]
 631 - [Added the `--depth` option to `cargo-tree` to print only to a certain depth
 632   in the tree ][cargo/9499]
 633 - [Added the `no-proc-macro` value to `cargo-tree --edges` to hide procedural
 634   macro dependencies.][cargo/9488]
 635 - [A new environment variable named `CARGO_TARGET_TMPDIR` is available.][cargo/9375]
 636   This variable points to a directory that integration tests and benches
 637   can use as a "scratchpad" for testing filesystem operations.
 638
 639 Compatibility Notes
 640 -------------------
 641 - [Mixing Option and Result via `?` is no longer permitted in closures for inferred types.][86831]
 642 - [Previously unsound code is no longer permitted where different constructors in branches
 643   could require different lifetimes.][85574]
 644 - As previously mentioned the [`std::arch` instrinsics now uses stricter const checking][83278]
 645   than before and may reject some previously accepted code.
 646 - [`i128` multiplication on Cortex M0+ platforms currently unconditionally causes overflow
 647    when compiled with `codegen-units = 1`.][86063]
 648
 649 [85574]: https://github.com/rust-lang/rust/issues/85574
 650 [86831]: https://github.com/rust-lang/rust/issues/86831
 651 [86063]: https://github.com/rust-lang/rust/issues/86063
 652 [79608]: https://github.com/rust-lang/rust/pull/79608
 653 [84988]: https://github.com/rust-lang/rust/pull/84988
 654 [84701]: https://github.com/rust-lang/rust/pull/84701
 655 [84072]: https://github.com/rust-lang/rust/pull/84072
 656 [85745]: https://github.com/rust-lang/rust/pull/85745
 657 [84744]: https://github.com/rust-lang/rust/pull/84744
 658 [85078]: https://github.com/rust-lang/rust/pull/85078
 659 [84717]: https://github.com/rust-lang/rust/pull/84717
 660 [83800]: https://github.com/rust-lang/rust/pull/83800
 661 [83366]: https://github.com/rust-lang/rust/pull/83366
 662 [83278]: https://github.com/rust-lang/rust/pull/83278
 663 [85292]: https://github.com/rust-lang/rust/pull/85292
 664 [82834]: https://github.com/rust-lang/rust/pull/82834
 665 [cargo/9520]: https://github.com/rust-lang/cargo/pull/9520
 666 [cargo/9499]: https://github.com/rust-lang/cargo/pull/9499
 667 [cargo/9488]: https://github.com/rust-lang/cargo/pull/9488
 668 [cargo/9375]: https://github.com/rust-lang/cargo/pull/9375
 669 [`BTreeMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_keys
 670 [`BTreeMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_values
 671 [`HashMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_keys
 672 [`HashMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_values
 673 [`arch::wasm32`]: https://doc.rust-lang.org/core/arch/wasm32/index.html
 674 [`VecDeque::binary_search`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search
 675 [`VecDeque::binary_search_by`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by
 676
 677 [`VecDeque::binary_search_by_key`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by_key
 678
 679 [`VecDeque::partition_point`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.partition_point
 680
 681 Version 1.53.0 (2021-06-17)
 682 ============================
 683
 684 Language
 685 -----------------------
 686 - [You can now use unicode for identifiers.][83799] This allows multilingual
 687   identifiers but still doesn't allow glyphs that are not considered characters
 688   such as `◆` or `🦀`. More specifically you can now use any identifier that
 689   matches the UAX #31 "Unicode Identifier and Pattern Syntax" standard. This
 690   is the same standard as languages like Python, however Rust uses NFC
 691   normalization which may be different from other languages.
 692 - [You can now specify "or patterns" inside pattern matches.][79278]
 693   Previously you could only use `|` (OR) on complete patterns. E.g.
 694   ```rust
 695   let x = Some(2u8);
 696   // Before
 697   matches!(x, Some(1) | Some(2));
 698   // Now
 699   matches!(x, Some(1 | 2));
 700   ```
 701 - [Added the `:pat_param` `macro_rules!` matcher.][83386] This matcher
 702   has the same semantics as the `:pat` matcher. This is to allow `:pat`
 703   to change semantics to being a pattern fragment in a future edition.
 704
 705 Compiler
 706 -----------------------
 707 - [Updated the minimum external LLVM version to LLVM 10.][83387]
 708 - [Added Tier 3\* support for the `wasm64-unknown-unknown` target.][80525]
 709 - [Improved debuginfo for closures and async functions on Windows MSVC.][83941]
 710
 711 \* Refer to Rust's [platform support page][platform-support-doc] for more
 712 information on Rust's tiered platform support.
 713
 714 Libraries
 715 -----------------------
 716 - [Abort messages will now forward to `android_set_abort_message` on
 717   Android platforms when available.][81469]
 718 - [`slice::IterMut<'_, T>` now implements `AsRef<[T]>`][82771]
 719 - [Arrays of any length now implement `IntoIterator`.][84147]
 720   Currently calling `.into_iter()` as a method on an array will
 721   return `impl Iterator<Item=&T>`, but this may change in a
 722   future edition to change `Item` to `T`. Calling `IntoIterator::into_iter`
 723   directly on arrays will provide `impl Iterator<Item=T>` as expected.
 724 - [`leading_zeros`, and `trailing_zeros` are now available on all
 725   `NonZero` integer types.][84082]
 726 - [`{f32, f64}::from_str` now parse and print special values
 727   (`NaN`, `-0`) according to IEEE 754.][78618]
 728 - [You can now index into slices using `(Bound<usize>, Bound<usize>)`.][77704]
 729 - [Add the `BITS` associated constant to all numeric types.][82565]
 730
 731 Stabilised APIs
 732 ---------------
 733 - [`AtomicBool::fetch_update`]
 734 - [`AtomicPtr::fetch_update`]
 735 - [`BTreeMap::retain`]
 736 - [`BTreeSet::retain`]
 737 - [`BufReader::seek_relative`]
 738 - [`DebugStruct::non_exhaustive`]
 739 - [`Duration::MAX`]
 740 - [`Duration::ZERO`]
 741 - [`Duration::is_zero`]
 742 - [`Duration::saturating_add`]
 743 - [`Duration::saturating_mul`]
 744 - [`Duration::saturating_sub`]
 745 - [`ErrorKind::Unsupported`]
 746 - [`Option::insert`]
 747 - [`Ordering::is_eq`]
 748 - [`Ordering::is_ge`]
 749 - [`Ordering::is_gt`]
 750 - [`Ordering::is_le`]
 751 - [`Ordering::is_lt`]
 752 - [`Ordering::is_ne`]
 753 - [`OsStr::is_ascii`]
 754 - [`OsStr::make_ascii_lowercase`]
 755 - [`OsStr::make_ascii_uppercase`]
 756 - [`OsStr::to_ascii_lowercase`]
 757 - [`OsStr::to_ascii_uppercase`]
 758 - [`Peekable::peek_mut`]
 759 - [`Rc::decrement_strong_count`]
 760 - [`Rc::increment_strong_count`]
 761 - [`Vec::extend_from_within`]
 762 - [`array::from_mut`]
 763 - [`array::from_ref`]
 764 - [`cmp::max_by_key`]
 765 - [`cmp::max_by`]
 766 - [`cmp::min_by_key`]
 767 - [`cmp::min_by`]
 768 - [`f32::is_subnormal`]
 769 - [`f64::is_subnormal`]
 770
 771 Cargo
 772 -----------------------
 773 - [Cargo now supports git repositories where the default `HEAD` branch is not
 774   "master".][cargo/9392] This also includes a switch to the version 3 `Cargo.lock` format
 775   which can handle default branches correctly.
 776 - [macOS targets now default to `unpacked` split-debuginfo.][cargo/9298]
 777 - [The `authors` field is no longer included in `Cargo.toml` for new
 778   projects.][cargo/9282]
 779
 780 Rustdoc
 781 -----------------------
 782 - [Added the `rustdoc::bare_urls` lint that warns when you have URLs
 783   without hyperlinks.][81764]
 784
 785 Compatibility Notes
 786 -------------------
 787 - [Implement token-based handling of attributes during expansion][82608]
 788 - [`Ipv4::from_str` will now reject octal format IP addresses in addition
 789   to rejecting hexadecimal IP addresses.][83652] The octal format can lead
 790   to confusion and potential security vulnerabilities and [is no
 791   longer recommended][ietf6943].
 792 - [The added `BITS` constant may conflict with external definitions.][85667]
 793   In particular, this was known to be a problem in the `lexical-core` crate,
 794   but they have published fixes for semantic versions 0.4 through 0.7. To
 795   update this dependency alone, use `cargo update -p lexical-core`.
 796 - Incremental compilation remains off by default, unless one uses the `RUSTC_FORCE_INCREMENTAL=1` environment variable added in 1.52.1.
 797
 798 Internal Only
 799 -------------
 800 These changes provide no direct user facing benefits, but represent significant
 801 improvements to the internals and overall performance of rustc and
 802 related tools.
 803
 804 - [Rework the `std::sys::windows::alloc` implementation.][83065]
 805 - [rustdoc: Don't enter an infer_ctxt in get_blanket_impls for impls that aren't blanket impls.][82864]
 806 - [rustdoc: Only look at blanket impls in `get_blanket_impls`][83681]
 807 - [Rework rustdoc const type][82873]
 808
 809 [85667]: https://github.com/rust-lang/rust/pull/85667
 810 [83386]: https://github.com/rust-lang/rust/pull/83386
 811 [82771]: https://github.com/rust-lang/rust/pull/82771
 812 [84147]: https://github.com/rust-lang/rust/pull/84147
 813 [84082]: https://github.com/rust-lang/rust/pull/84082
 814 [83799]: https://github.com/rust-lang/rust/pull/83799
 815 [83681]: https://github.com/rust-lang/rust/pull/83681
 816 [83652]: https://github.com/rust-lang/rust/pull/83652
 817 [83387]: https://github.com/rust-lang/rust/pull/83387
 818 [82873]: https://github.com/rust-lang/rust/pull/82873
 819 [82864]: https://github.com/rust-lang/rust/pull/82864
 820 [82608]: https://github.com/rust-lang/rust/pull/82608
 821 [82565]: https://github.com/rust-lang/rust/pull/82565
 822 [80525]: https://github.com/rust-lang/rust/pull/80525
 823 [79278]: https://github.com/rust-lang/rust/pull/79278
 824 [78618]: https://github.com/rust-lang/rust/pull/78618
 825 [77704]: https://github.com/rust-lang/rust/pull/77704
 826 [83941]: https://github.com/rust-lang/rust/pull/83941
 827 [83065]: https://github.com/rust-lang/rust/pull/83065
 828 [81764]: https://github.com/rust-lang/rust/pull/81764
 829 [81469]: https://github.com/rust-lang/rust/pull/81469
 830 [cargo/9298]: https://github.com/rust-lang/cargo/pull/9298
 831 [cargo/9282]: https://github.com/rust-lang/cargo/pull/9282
 832 [cargo/9392]: https://github.com/rust-lang/cargo/pull/9392
 833 [`AtomicBool::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicBool.html#method.fetch_update
 834 [`AtomicPtr::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicPtr.html#method.fetch_update
 835 [`BTreeMap::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.retain
 836 [`BTreeSet::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeSet.html#method.retain
 837 [`BufReader::seek_relative`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.seek_relative
 838 [`DebugStruct::non_exhaustive`]: https://doc.rust-lang.org/std/fmt/struct.DebugStruct.html#method.finish_non_exhaustive
 839 [`Duration::MAX`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
 840 [`Duration::ZERO`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.ZERO
 841 [`Duration::is_zero`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.is_zero
 842 [`Duration::saturating_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_add
 843 [`Duration::saturating_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_mul
 844 [`Duration::saturating_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_sub
 845 [`ErrorKind::Unsupported`]: https://doc.rust-lang.org/std/io/enum.ErrorKind.html#variant.Unsupported
 846 [`Option::insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.insert
 847 [`Ordering::is_eq`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_eq
 848 [`Ordering::is_ge`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ge
 849 [`Ordering::is_gt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_gt
 850 [`Ordering::is_le`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_le
 851 [`Ordering::is_lt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_lt
 852 [`Ordering::is_ne`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ne
 853 [`OsStr::is_ascii`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.is_ascii
 854 [`OsStr::make_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_lowercase
 855 [`OsStr::make_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_uppercase
 856 [`OsStr::to_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_lowercase
 857 [`OsStr::to_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_uppercase
 858 [`Peekable::peek_mut`]: https://doc.rust-lang.org/std/iter/struct.Peekable.html#method.peek_mut
 859 [`Rc::decrement_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
 860 [`Rc::increment_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
 861 [`Vec::extend_from_within`]: https://doc.rust-lang.org/beta/std/vec/struct.Vec.html#method.extend_from_within
 862 [`array::from_mut`]: https://doc.rust-lang.org/beta/std/array/fn.from_mut.html
 863 [`array::from_ref`]: https://doc.rust-lang.org/beta/std/array/fn.from_ref.html
 864 [`cmp::max_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by_key.html
 865 [`cmp::max_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by.html
 866 [`cmp::min_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by_key.html
 867 [`cmp::min_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by.html
 868 [`f32::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
 869 [`f64::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
 870 [ietf6943]: https://datatracker.ietf.org/doc/html/rfc6943#section-3.1.1
 871
 872
 873 Version 1.52.1 (2021-05-10)
 874 ============================
 875
 876 This release disables incremental compilation, unless the user has explicitly
 877 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
 878
 879 This is due to the widespread, and frequently occuring, breakage encountered by
 880 Rust users due to newly enabled incremental verification in 1.52.0. Notably,
 881 Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
 882 newly added incremental verification are still present in past stable versions,
 883 and are not yet fixed on any channel. These bugs can lead to miscompilation of
 884 Rust binaries.
 885
 886 These problems only affect incremental builds, so release builds with Cargo
 887 should not be affected unless the user has explicitly opted into incremental.
 888 Debug and check builds are affected.
 889
 890 See [84970] for more details.
 891
 892 [84970]: https://github.com/rust-lang/rust/issues/84970
 893
 894 Version 1.52.0 (2021-05-06)
 895 ============================
 896
 897 Language
 898 --------
 899 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
 900   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
 901   is allowed by default, and may become a warning or hard error in a
 902   future edition.
 903 - [You can now cast mutable references to arrays to a pointer of the same type as
 904   the element.][81479]
 905
 906 Compiler
 907 --------
 908 - [Upgraded the default LLVM to LLVM 12.][81451]
 909
 910 Added tier 3\* support for the following targets.
 911
 912 - [`s390x-unknown-linux-musl`][82166]
 913 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
 914 - [`powerpc-unknown-openbsd`][82733]
 915
 916 \* Refer to Rust's [platform support page][platform-support-doc] for more
 917 information on Rust's tiered platform support.
 918
 919 Libraries
 920 ---------
 921 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
 922 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
 923 - [`Arc<impl Error>` now implements `error::Error`.][80553]
 924 - [All integer division and remainder operations are now `const`.][80962]
 925
 926 Stabilised APIs
 927 -------------
 928 - [`Arguments::as_str`]
 929 - [`char::MAX`]
 930 - [`char::REPLACEMENT_CHARACTER`]
 931 - [`char::UNICODE_VERSION`]
 932 - [`char::decode_utf16`]
 933 - [`char::from_digit`]
 934 - [`char::from_u32_unchecked`]
 935 - [`char::from_u32`]
 936 - [`slice::partition_point`]
 937 - [`str::rsplit_once`]
 938 - [`str::split_once`]
 939
 940 The following previously stable APIs are now `const`.
 941
 942 - [`char::len_utf8`]
 943 - [`char::len_utf16`]
 944 - [`char::to_ascii_uppercase`]
 945 - [`char::to_ascii_lowercase`]
 946 - [`char::eq_ignore_ascii_case`]
 947 - [`u8::to_ascii_uppercase`]
 948 - [`u8::to_ascii_lowercase`]
 949 - [`u8::eq_ignore_ascii_case`]
 950
 951 Rustdoc
 952 -------
 953 - [Rustdoc lints are now treated as a tool lint, meaning that
 954   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
 955   Using the old style is still allowed, and will become a warning in
 956   a future release.
 957 - [Rustdoc now supports argument files.][82261]
 958 - [Rustdoc now generates smart punctuation for documentation.][79423]
 959 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
 960   ```markdown
 961   - [x] Complete
 962   - [ ] Todo
 963   ```
 964
 965 Misc
 966 ----
 967 - [You can now pass multiple filters to tests.][81356] E.g.
 968   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
 969 - [Rustup now distributes PDB symbols for the `std` library on Windows,
 970   allowing you to see `std` symbols when debugging.][82218]
 971
 972 Internal Only
 973 -------------
 974 These changes provide no direct user facing benefits, but represent significant
 975 improvements to the internals and overall performance of rustc and
 976 related tools.
 977
 978 - [Check the result cache before the DepGraph when ensuring queries][81855]
 979 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
 980 - [Only store a LocalDefId in some HIR nodes][81611]
 981 - [Store HIR attributes in a side table][79519]
 982
 983 Compatibility Notes
 984 -------------------
 985 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
 986 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
 987 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
 988 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
 989   languages in code blocks.][78429]
 990 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
 991 - [Changes in how proc macros handle whitespace may lead to panics when used
 992   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
 993 - [Turn `#[derive]` into a regular macro attribute][79078]
 994
 995 [84136]: https://github.com/rust-lang/rust/issues/84136
 996 [80763]: https://github.com/rust-lang/rust/pull/80763
 997 [82166]: https://github.com/rust-lang/rust/pull/82166
 998 [82121]: https://github.com/rust-lang/rust/pull/82121
 999 [81879]: https://github.com/rust-lang/rust/pull/81879
1000 [82261]: https://github.com/rust-lang/rust/pull/82261
1001 [82218]: https://github.com/rust-lang/rust/pull/82218
1002 [82216]: https://github.com/rust-lang/rust/pull/82216
1003 [82202]: https://github.com/rust-lang/rust/pull/82202
1004 [81855]: https://github.com/rust-lang/rust/pull/81855
1005 [81766]: https://github.com/rust-lang/rust/pull/81766
1006 [81744]: https://github.com/rust-lang/rust/pull/81744
1007 [81611]: https://github.com/rust-lang/rust/pull/81611
1008 [81479]: https://github.com/rust-lang/rust/pull/81479
1009 [81451]: https://github.com/rust-lang/rust/pull/81451
1010 [81356]: https://github.com/rust-lang/rust/pull/81356
1011 [80962]: https://github.com/rust-lang/rust/pull/80962
1012 [80553]: https://github.com/rust-lang/rust/pull/80553
1013 [80527]: https://github.com/rust-lang/rust/pull/80527
1014 [79519]: https://github.com/rust-lang/rust/pull/79519
1015 [79423]: https://github.com/rust-lang/rust/pull/79423
1016 [79208]: https://github.com/rust-lang/rust/pull/79208
1017 [78429]: https://github.com/rust-lang/rust/pull/78429
1018 [82733]: https://github.com/rust-lang/rust/pull/82733
1019 [82594]: https://github.com/rust-lang/rust/pull/82594
1020 [79078]: https://github.com/rust-lang/rust/pull/79078
1021 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
1022 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
1023 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
1024 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
1025 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
1026 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
1027 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
1028 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
1029 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
1030 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
1031 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
1032 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
1033 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
1034 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
1035 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
1036 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
1037 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
1038 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
1039 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
1040 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
1041 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
1042 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
1043
1044 Version 1.51.0 (2021-03-25)
1045 ============================
1046
1047 Language
1048 --------
1049 - [You can now parameterize items such as functions, traits, and `struct`s by constant
1050   values in addition to by types and lifetimes.][79135] Also known as "const generics"
1051   E.g. you can now write the following. Note: Only values of primitive integers,
1052   `bool`, or `char` types are currently permitted.
1053   ```rust
1054   struct GenericArray<T, const LENGTH: usize> {
1055       inner: [T; LENGTH]
1056   }
1057
1058   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
1059       const fn last(&self) -> Option<&T> {
1060           if LENGTH == 0 {
1061               None
1062           } else {
1063               Some(&self.inner[LENGTH - 1])
1064           }
1065       }
1066   }
1067   ```
1068
1069
1070 Compiler
1071 --------
1072
1073 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
1074   This option controls whether debug information is split across multiple files
1075   or packed into a single file. **Note** This option is unstable on other platforms.
1076 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
1077   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
1078 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
1079 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
1080
1081 \* Refer to Rust's [platform support page][platform-support-doc] for more
1082 information on Rust's tiered platform support.
1083
1084 Libraries
1085 ---------
1086
1087 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
1088 - [`str` now implements `AsMut<str>`.][80279]
1089 - [`u64` and `u128` now implement `From<char>`.][79502]
1090 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
1091 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
1092 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
1093 - [`io::Empty` now implements `io::Seek`.][78044]
1094 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
1095   `T: ?Sized` types.][80764]
1096 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
1097
1098
1099 Stabilized APIs
1100 ---------------
1101
1102 - [`Arc::decrement_strong_count`]
1103 - [`Arc::increment_strong_count`]
1104 - [`Once::call_once_force`]
1105 - [`Peekable::next_if_eq`]
1106 - [`Peekable::next_if`]
1107 - [`Seek::stream_position`]
1108 - [`array::IntoIter`]
1109 - [`panic::panic_any`]
1110 - [`ptr::addr_of!`]
1111 - [`ptr::addr_of_mut!`]
1112 - [`slice::fill_with`]
1113 - [`slice::split_inclusive_mut`]
1114 - [`slice::split_inclusive`]
1115 - [`slice::strip_prefix`]
1116 - [`slice::strip_suffix`]
1117 - [`str::split_inclusive`]
1118 - [`sync::OnceState`]
1119 - [`task::Wake`]
1120 - [`VecDeque::range`]
1121 - [`VecDeque::range_mut`]
1122
1123 Cargo
1124 -----
1125 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
1126   codegen option.][cargo/9112]
1127 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
1128   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
1129   to avoid unifying features of dependencies where that unification could be unwanted.
1130   Such as using the same dependency with a `std` feature in a build scripts and
1131   proc-macros, while using the `no-std` feature in the final binary. See the
1132   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
1133
1134 Rustdoc
1135 -------
1136
1137 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
1138 - [You can now provide a `--default-theme` flag which sets the default theme to use for
1139   documentation.][79642]
1140
1141 Various improvements to intra-doc links:
1142
1143 - [You can link to non-path primitives such as `slice`.][80181]
1144 - [You can link to associated items.][74489]
1145 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
1146
1147 Misc
1148 ----
1149 - [You can now pass `--include-ignored` to tests (e.g. with
1150   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
1151
1152 Compatibility Notes
1153 -------------------
1154
1155 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
1156 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
1157   could fail.][80579]
1158 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
1159   for the distributed artifacts.][81521]
1160     - `armv5te-unknown-linux-gnueabi`
1161     - `sparc64-unknown-linux-gnu`
1162     - `thumbv7neon-unknown-linux-gnueabihf`
1163     - `armv7-unknown-linux-gnueabi`
1164     - `x86_64-unknown-linux-gnux32`
1165 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
1166
1167 Internal Only
1168 -------------
1169
1170 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
1171
1172 [79135]: https://github.com/rust-lang/rust/pull/79135
1173 [74489]: https://github.com/rust-lang/rust/pull/74489
1174 [76934]: https://github.com/rust-lang/rust/pull/76934
1175 [79570]: https://github.com/rust-lang/rust/pull/79570
1176 [80181]: https://github.com/rust-lang/rust/pull/80181
1177 [79642]: https://github.com/rust-lang/rust/pull/79642
1178 [80945]: https://github.com/rust-lang/rust/pull/80945
1179 [80279]: https://github.com/rust-lang/rust/pull/80279
1180 [80053]: https://github.com/rust-lang/rust/pull/80053
1181 [79502]: https://github.com/rust-lang/rust/pull/79502
1182 [75180]: https://github.com/rust-lang/rust/pull/75180
1183 [81521]: https://github.com/rust-lang/rust/pull/81521
1184 [80968]: https://github.com/rust-lang/rust/pull/80968
1185 [80959]: https://github.com/rust-lang/rust/pull/80959
1186 [80718]: https://github.com/rust-lang/rust/pull/80718
1187 [80653]: https://github.com/rust-lang/rust/pull/80653
1188 [80579]: https://github.com/rust-lang/rust/pull/80579
1189 [79998]: https://github.com/rust-lang/rust/pull/79998
1190 [78044]: https://github.com/rust-lang/rust/pull/78044
1191 [81455]: https://github.com/rust-lang/rust/pull/81455
1192 [80764]: https://github.com/rust-lang/rust/pull/80764
1193 [80749]: https://github.com/rust-lang/rust/pull/80749
1194 [80662]: https://github.com/rust-lang/rust/pull/80662
1195 [79134]: https://github.com/rust-lang/rust/pull/79134
1196 [80966]: https://github.com/rust-lang/rust/pull/80966
1197 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
1198 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
1199 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
1200 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
1201 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
1202 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
1203 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
1204 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
1205 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
1206 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
1207 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
1208 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
1209 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
1210 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
1211 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
1212 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
1213 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
1214 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
1215 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
1216 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
1217 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
1218 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
1219 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
1220
1221 Version 1.50.0 (2021-02-11)
1222 ============================
1223
1224 Language
1225 -----------------------
1226 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
1227   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
1228 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
1229
1230 Compiler
1231 -----------------------
1232 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
1233 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
1234 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
1235 - [Dropped support for all cloudabi targets.][78439]
1236
1237 \* Refer to Rust's [platform support page][platform-support-doc] for more
1238 information on Rust's tiered platform support.
1239
1240 Libraries
1241 -----------------------
1242
1243 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
1244 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
1245 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
1246   This value cannot be a valid file descriptor, and now means `Option<File>` takes
1247   up the same amount of space as `File`.
1248
1249 Stabilized APIs
1250 ---------------
1251
1252 - [`bool::then`]
1253 - [`btree_map::Entry::or_insert_with_key`]
1254 - [`f32::clamp`]
1255 - [`f64::clamp`]
1256 - [`hash_map::Entry::or_insert_with_key`]
1257 - [`Ord::clamp`]
1258 - [`RefCell::take`]
1259 - [`slice::fill`]
1260 - [`UnsafeCell::get_mut`]
1261
1262 The following previously stable methods are now `const`.
1263
1264 - [`IpAddr::is_ipv4`]
1265 - [`IpAddr::is_ipv6`]
1266 - [`IpAddr::is_unspecified`]
1267 - [`IpAddr::is_loopback`]
1268 - [`IpAddr::is_multicast`]
1269 - [`Ipv4Addr::octets`]
1270 - [`Ipv4Addr::is_loopback`]
1271 - [`Ipv4Addr::is_private`]
1272 - [`Ipv4Addr::is_link_local`]
1273 - [`Ipv4Addr::is_multicast`]
1274 - [`Ipv4Addr::is_broadcast`]
1275 - [`Ipv4Addr::is_documentation`]
1276 - [`Ipv4Addr::to_ipv6_compatible`]
1277 - [`Ipv4Addr::to_ipv6_mapped`]
1278 - [`Ipv6Addr::segments`]
1279 - [`Ipv6Addr::is_unspecified`]
1280 - [`Ipv6Addr::is_loopback`]
1281 - [`Ipv6Addr::is_multicast`]
1282 - [`Ipv6Addr::to_ipv4`]
1283 - [`Layout::size`]
1284 - [`Layout::align`]
1285 - [`Layout::from_size_align`]
1286 - `pow` for all integer types.
1287 - `checked_pow` for all integer types.
1288 - `saturating_pow` for all integer types.
1289 - `wrapping_pow` for all integer types.
1290 - `next_power_of_two` for all unsigned integer types.
1291 - `checked_next_power_of_two` for all unsigned integer types.
1292
1293 Cargo
1294 -----------------------
1295
1296 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
1297   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
1298 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
1299   contents of that directory for changes.][cargo/8973]
1300 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
1301
1302 Misc
1303 ----
1304
1305 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
1306 - [Running tests will now print the total time taken to execute.][75752]
1307
1308 Compatibility Notes
1309 -------------------
1310
1311 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
1312   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
1313 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
1314   unhygenic `macro_rules!` macros.][79472]
1315 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
1316   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
1317 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
1318 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
1319   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
1320 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
1321
1322 [74989]: https://github.com/rust-lang/rust/pull/74989
1323 [79261]: https://github.com/rust-lang/rust/pull/79261
1324 [79896]: https://github.com/rust-lang/rust/pull/79896
1325 [79484]: https://github.com/rust-lang/rust/pull/79484
1326 [79472]: https://github.com/rust-lang/rust/pull/79472
1327 [79270]: https://github.com/rust-lang/rust/pull/79270
1328 [79003]: https://github.com/rust-lang/rust/pull/79003
1329 [78864]: https://github.com/rust-lang/rust/pull/78864
1330 [78636]: https://github.com/rust-lang/rust/pull/78636
1331 [78439]: https://github.com/rust-lang/rust/pull/78439
1332 [78343]: https://github.com/rust-lang/rust/pull/78343
1333 [78296]: https://github.com/rust-lang/rust/pull/78296
1334 [78068]: https://github.com/rust-lang/rust/pull/78068
1335 [75752]: https://github.com/rust-lang/rust/pull/75752
1336 [74699]: https://github.com/rust-lang/rust/pull/74699
1337 [78142]: https://github.com/rust-lang/rust/pull/78142
1338 [77484]: https://github.com/rust-lang/rust/pull/77484
1339 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
1340 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
1341 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
1342 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
1343 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
1344 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
1345 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
1346 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
1347 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
1348 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
1349 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
1350 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
1351 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
1352 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
1353 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
1354 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
1355 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
1356 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
1357 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
1358 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
1359 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
1360 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
1361 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
1362 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
1363 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
1364 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
1365 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
1366 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
1367 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
1368 [`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
1369 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
1370 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
1371 [`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
1372 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
1373
1374
1375 Version 1.49.0 (2020-12-31)
1376 ============================
1377
1378 Language
1379 -----------------------
1380
1381 - [Unions can now implement `Drop`, and you can now have a field in a union
1382   with `ManuallyDrop<T>`.][77547]
1383 - [You can now cast uninhabited enums to integers.][76199]
1384 - [You can now bind by reference and by move in patterns.][76119] This
1385   allows you to selectively borrow individual components of a type. E.g.
1386   ```rust
1387   #[derive(Debug)]
1388   struct Person {
1389       name: String,
1390       age: u8,
1391   }
1392
1393   let person = Person {
1394       name: String::from("Alice"),
1395       age: 20,
1396   };
1397
1398   // `name` is moved out of person, but `age` is referenced.
1399   let Person { name, ref age } = person;
1400   println!("{} {}", name, age);
1401   ```
1402
1403 Compiler
1404 -----------------------
1405
1406 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
1407 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
1408 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
1409 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
1410 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
1411 - [Output from threads spawned in tests is now captured.][78227]
1412 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
1413
1414 \* Refer to Rust's [platform support page][platform-support-doc] for more
1415 information on Rust's tiered platform support.
1416
1417 Libraries
1418 -----------------------
1419
1420 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
1421 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
1422
1423 Stabilized APIs
1424 ---------------
1425
1426 - [`slice::select_nth_unstable`]
1427 - [`slice::select_nth_unstable_by`]
1428 - [`slice::select_nth_unstable_by_key`]
1429
1430 The following previously stable methods are now `const`.
1431
1432 - [`Poll::is_ready`]
1433 - [`Poll::is_pending`]
1434
1435 Cargo
1436 -----------------------
1437 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
1438 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
1439 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
1440   variable will be set if the crate being built is one the user selected to build, either
1441   with `-p` or through defaults.
1442 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
1443
1444
1445 Compatibility Notes
1446 -------------------
1447
1448 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
1449 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
1450 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
1451   Previously such invalid or unused attributes could be ignored.
1452 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
1453   read [this post about the changes][rustdoc-ws-post] for more details.
1454 - [Trait bounds are no longer inferred for associated types.][79904]
1455
1456 Internal Only
1457 -------------
1458 These changes provide no direct user facing benefits, but represent significant
1459 improvements to the internals and overall performance of rustc and
1460 related tools.
1461
1462 - [rustc's internal crates are now compiled using the `initial-exec` Thread
1463   Local Storage model.][78201]
1464 - [Calculate visibilities once in resolve.][78077]
1465 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
1466 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
1467
1468
1469 [75991]: https://github.com/rust-lang/rust/pull/75991
1470 [78951]: https://github.com/rust-lang/rust/pull/78951
1471 [78848]: https://github.com/rust-lang/rust/pull/78848
1472 [78746]: https://github.com/rust-lang/rust/pull/78746
1473 [78376]: https://github.com/rust-lang/rust/pull/78376
1474 [78228]: https://github.com/rust-lang/rust/pull/78228
1475 [78227]: https://github.com/rust-lang/rust/pull/78227
1476 [78201]: https://github.com/rust-lang/rust/pull/78201
1477 [78109]: https://github.com/rust-lang/rust/pull/78109
1478 [78077]: https://github.com/rust-lang/rust/pull/78077
1479 [77997]: https://github.com/rust-lang/rust/pull/77997
1480 [77703]: https://github.com/rust-lang/rust/pull/77703
1481 [77547]: https://github.com/rust-lang/rust/pull/77547
1482 [77015]: https://github.com/rust-lang/rust/pull/77015
1483 [76199]: https://github.com/rust-lang/rust/pull/76199
1484 [76119]: https://github.com/rust-lang/rust/pull/76119
1485 [75914]: https://github.com/rust-lang/rust/pull/75914
1486 [79004]: https://github.com/rust-lang/rust/pull/79004
1487 [78676]: https://github.com/rust-lang/rust/pull/78676
1488 [79904]: https://github.com/rust-lang/rust/issues/79904
1489 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
1490 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
1491 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
1492 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
1493 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
1494 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
1495 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
1496 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
1497 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
1498 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
1499
1500 Version 1.48.0 (2020-11-19)
1501 ==========================
1502
1503 Language
1504 --------
1505
1506 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
1507   is still rejected *semantically*, but can now be parsed by procedural macros.
1508
1509 Compiler
1510 --------
1511 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
1512   `rustc` whether to link its own C runtime and libraries or to rely on a external
1513   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
1514 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
1515   Note: If you're using cargo you must explicitly pass the `--target` flag.
1516 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
1517
1518 \* Refer to Rust's [platform support page][platform-support-doc] for more
1519 information on Rust's tiered platform support.
1520
1521 Libraries
1522 ---------
1523 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
1524   and `&Stderr`.][76275]
1525 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
1526 - [The `matches!` macro now supports having a trailing comma.][74880]
1527 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
1528 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
1529
1530 Stabilized APIs
1531 ---------------
1532 - [`slice::as_ptr_range`]
1533 - [`slice::as_mut_ptr_range`]
1534 - [`VecDeque::make_contiguous`]
1535 - [`future::pending`]
1536 - [`future::ready`]
1537
1538 The following previously stable methods are now `const fn`'s:
1539
1540 - [`Option::is_some`]
1541 - [`Option::is_none`]
1542 - [`Option::as_ref`]
1543 - [`Result::is_ok`]
1544 - [`Result::is_err`]
1545 - [`Result::as_ref`]
1546 - [`Ordering::reverse`]
1547 - [`Ordering::then`]
1548
1549 Cargo
1550 -----
1551
1552 Rustdoc
1553 -------
1554 - [You can now link to items in `rustdoc` using the intra-doc link
1555   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
1556   a link to `std::future`'s documentation. See ["Linking to items by
1557   name"][intradoc-links] for more information.
1558 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
1559   when searching through `rustdoc`'s UI.][75740]
1560
1561 Compatibility Notes
1562 -------------------
1563 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
1564   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
1565   promoted to `'static` lifetime any more inside `const fn`s.
1566 - [Associated type bindings on trait objects are now verified to meet the bounds
1567   declared on the trait when checking that they implement the trait.][27675]
1568 - [When trait bounds on associated types or opaque types are ambiguous, the
1569   compiler no longer makes an arbitrary choice on which bound to use.][54121]
1570 - [Fixed recursive nonterminals not being expanded in macros during
1571   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
1572   correctly handling recursive nonterminal tokens.
1573 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
1574 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
1575   in places where they have no effect.][73461]
1576 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
1577   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
1578 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
1579   disallow zero-initialization.][71274]
1580 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
1581 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
1582   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
1583   see the [`catch_unwind`] documentation for further information.
1584
1585
1586
1587 Internal Only
1588 -------------
1589 These changes provide no direct user facing benefits, but represent significant
1590 improvements to the internals and overall performance of rustc and
1591 related tools.
1592
1593 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
1594   You can continue building with `make` by setting `ninja=false` in
1595   your `config.toml`.
1596 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
1597 - [Made `ensure_sufficient_stack()` non-generic][76680]
1598
1599 [78143]: https://github.com/rust-lang/rust/issues/78143
1600 [76680]: https://github.com/rust-lang/rust/pull/76680/
1601 [76030]: https://github.com/rust-lang/rust/pull/76030/
1602 [70212]: https://github.com/rust-lang/rust/pull/70212/
1603 [27675]: https://github.com/rust-lang/rust/issues/27675/
1604 [54121]: https://github.com/rust-lang/rust/issues/54121/
1605 [71274]: https://github.com/rust-lang/rust/pull/71274/
1606 [77386]: https://github.com/rust-lang/rust/pull/77386/
1607 [77153]: https://github.com/rust-lang/rust/pull/77153/
1608 [77055]: https://github.com/rust-lang/rust/pull/77055/
1609 [76275]: https://github.com/rust-lang/rust/pull/76275/
1610 [76310]: https://github.com/rust-lang/rust/pull/76310/
1611 [76420]: https://github.com/rust-lang/rust/pull/76420/
1612 [76158]: https://github.com/rust-lang/rust/pull/76158/
1613 [75857]: https://github.com/rust-lang/rust/pull/75857/
1614 [75585]: https://github.com/rust-lang/rust/pull/75585/
1615 [75740]: https://github.com/rust-lang/rust/pull/75740/
1616 [75502]: https://github.com/rust-lang/rust/pull/75502/
1617 [74880]: https://github.com/rust-lang/rust/pull/74880/
1618 [74922]: https://github.com/rust-lang/rust/pull/74922/
1619 [74430]: https://github.com/rust-lang/rust/pull/74430/
1620 [74194]: https://github.com/rust-lang/rust/pull/74194/
1621 [73461]: https://github.com/rust-lang/rust/pull/73461/
1622 [73166]: https://github.com/rust-lang/rust/pull/73166/
1623 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
1624 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
1625 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
1626 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
1627 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
1628 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
1629 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
1630 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
1631 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
1632 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
1633 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
1634 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
1635 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
1636 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
1637 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
1638
1639
1640 Version 1.47.0 (2020-10-08)
1641 ==========================
1642
1643 Language
1644 --------
1645 - [Closures will now warn when not used.][74869]
1646
1647 Compiler
1648 --------
1649 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
1650   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
1651   platforms.
1652 - [Upgraded to LLVM 11.][73526]
1653 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
1654 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
1655 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
1656
1657 \* Refer to Rust's [platform support page][platform-support-doc] for more
1658 information on Rust's tiered platform support.
1659
1660 Libraries
1661 ---------
1662 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
1663 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
1664   those of length less than 33.][74060]
1665 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
1666 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
1667   `PartialEq`, and `PartialOrd`.][73583]
1668
1669 Stabilized APIs
1670 ---------------
1671 - [`Ident::new_raw`]
1672 - [`Range::is_empty`]
1673 - [`RangeInclusive::is_empty`]
1674 - [`Result::as_deref`]
1675 - [`Result::as_deref_mut`]
1676 - [`Vec::leak`]
1677 - [`pointer::offset_from`]
1678 - [`f32::TAU`]
1679 - [`f64::TAU`]
1680
1681 The following previously stable APIs have now been made const.
1682
1683 - [The `new` method for all `NonZero` integers.][73858]
1684 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
1685   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
1686   methods for all integers.][73858]
1687 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
1688   signed integers.][73858]
1689 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
1690   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
1691   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
1692   `is_ascii_control` methods for `char` and `u8`.][73858]
1693
1694 Cargo
1695 -----
1696 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
1697   You can override this by setting the following in your `Cargo.toml`.
1698   ```toml
1699   [profile.release.build-override]
1700   opt-level = 3
1701   ```
1702 - [`cargo-help` will now display man pages for commands rather just the
1703   `--help` text.][cargo/8456]
1704 - [`cargo-metadata` now emits a `test` field indicating if a target has
1705   tests enabled.][cargo/8478]
1706 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
1707 - [`cargo-publish` will now use an alternative registry by default if it's the
1708   only registry specified in `package.publish`.][cargo/8571]
1709
1710 Misc
1711 ----
1712 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
1713   type based search.][75366]
1714 - [Added the Ayu theme to rustdoc.][71237]
1715
1716 Compatibility Notes
1717 -------------------
1718 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
1719 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
1720 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
1721   help to preserve more span information.][73084] These changes may cause
1722   compiliation errors if your macro was unhygenic or didn't correctly handle
1723   `Delimiter::None`.
1724 - [Moved support for the CloudABI target to tier 3.][75568]
1725 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
1726 - [Added the `rustc-docs` component.][75560] This allows you to install
1727   and read the documentation for the compiler internal APIs. (Currently only
1728   available for `x86_64-unknown-linux-gnu`.)
1729
1730 Internal Only
1731 --------
1732
1733 - [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.
1734
1735 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
1736 [75048]: https://github.com/rust-lang/rust/pull/75048/
1737 [74163]: https://github.com/rust-lang/rust/pull/74163/
1738 [71237]: https://github.com/rust-lang/rust/pull/71237/
1739 [74869]: https://github.com/rust-lang/rust/pull/74869/
1740 [73858]: https://github.com/rust-lang/rust/pull/73858/
1741 [75716]: https://github.com/rust-lang/rust/pull/75716/
1742 [75560]: https://github.com/rust-lang/rust/pull/75560/
1743 [75568]: https://github.com/rust-lang/rust/pull/75568/
1744 [75366]: https://github.com/rust-lang/rust/pull/75366/
1745 [75204]: https://github.com/rust-lang/rust/pull/75204/
1746 [74650]: https://github.com/rust-lang/rust/pull/74650/
1747 [74419]: https://github.com/rust-lang/rust/pull/74419/
1748 [73964]: https://github.com/rust-lang/rust/pull/73964/
1749 [74021]: https://github.com/rust-lang/rust/pull/74021/
1750 [74060]: https://github.com/rust-lang/rust/pull/74060/
1751 [73893]: https://github.com/rust-lang/rust/pull/73893/
1752 [73526]: https://github.com/rust-lang/rust/pull/73526/
1753 [73583]: https://github.com/rust-lang/rust/pull/73583/
1754 [73084]: https://github.com/rust-lang/rust/pull/73084/
1755 [73197]: https://github.com/rust-lang/rust/pull/73197/
1756 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
1757 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
1758 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
1759 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
1760 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
1761 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
1762 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
1763 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
1764 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
1765 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
1766 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
1767 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
1768 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
1769 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
1770
1771
1772 Version 1.46.0 (2020-08-27)
1773 ==========================
1774
1775 Language
1776 --------
1777 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
1778 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
1779   const functions.][73862]
1780 - [The `#[track_caller]` attribute can now be added to functions to use the
1781   function's caller's location information for panic messages.][72445]
1782 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
1783   `x.0.0` over `(x.0).0`.
1784 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
1785   You currently can't use `mem::transmute` in constant functions.
1786
1787 Compiler
1788 --------
1789 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
1790 - [Enabled static "Position Independent Executables" by default
1791   for `x86_64-unknown-linux-musl`.][70740]
1792
1793 Libraries
1794 ---------
1795 - [`mem::forget` is now a `const fn`.][73887]
1796 - [`String` now implements `From<char>`.][73466]
1797 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
1798   integer types.][73032]
1799 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
1800 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
1801   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
1802 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
1803 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
1804 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
1805
1806 Stabilized APIs
1807 ---------------
1808 - [`Option::zip`]
1809 - [`vec::Drain::as_slice`]
1810
1811 Cargo
1812 -----
1813 Added a number of new environment variables that are now available when
1814 compiling your crate.
1815
1816 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
1817   the specific binary being compiled and the name of the crate.
1818 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
1819 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
1820
1821 Compatibility Notes
1822 -------------------
1823 - [The target configuration option `abi_blacklist` has been renamed
1824   to `unsupported_abis`.][74150] The old name will still continue to work.
1825 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
1826   This was previously accepted but will become a hard error in a future release.
1827 - [Rustc will fail to compile if you have a struct with
1828   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
1829   allowed on `enum`s.
1830 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
1831   ensure that spans have the correct information, and may cause breakage if you
1832   were relying on receiving spans with dummy information.
1833 - [The InnoSetup installer for Windows is no longer available.][72569] This was
1834   a legacy installer that was replaced by a MSI installer a few years ago but
1835   was still being built.
1836 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
1837 - [Rustc will no longer accept overlapping trait implementations that only
1838   differ in how the lifetime was bound.][72493]
1839 - [Rustc now correctly relates the lifetime of an existential associated
1840   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
1841   you to pass a shorter lifetime than expected.
1842 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
1843   The library will need to be installed for `rustc` to work, even though we
1844   expect it to be already available on most systems.
1845 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
1846   under QEMU.][74820]
1847 - [Pretty printing of some tokens in procedural macros changed.][75453] The
1848   exact output returned by rustc's pretty printing is an unstable
1849   implementation detail: we recommend any macro relying on it to switch to a
1850   more robust parsing system.
1851
1852 [75453]: https://github.com/rust-lang/rust/issues/75453/
1853 [74820]: https://github.com/rust-lang/rust/issues/74820/
1854 [74420]: https://github.com/rust-lang/rust/issues/74420/
1855 [74109]: https://github.com/rust-lang/rust/pull/74109/
1856 [74150]: https://github.com/rust-lang/rust/pull/74150/
1857 [73862]: https://github.com/rust-lang/rust/pull/73862/
1858 [73887]: https://github.com/rust-lang/rust/pull/73887/
1859 [73466]: https://github.com/rust-lang/rust/pull/73466/
1860 [73516]: https://github.com/rust-lang/rust/pull/73516/
1861 [73293]: https://github.com/rust-lang/rust/pull/73293/
1862 [73007]: https://github.com/rust-lang/rust/pull/73007/
1863 [73032]: https://github.com/rust-lang/rust/pull/73032/
1864 [72920]: https://github.com/rust-lang/rust/pull/72920/
1865 [72569]: https://github.com/rust-lang/rust/pull/72569/
1866 [72583]: https://github.com/rust-lang/rust/pull/72583/
1867 [72584]: https://github.com/rust-lang/rust/pull/72584/
1868 [72717]: https://github.com/rust-lang/rust/pull/72717/
1869 [72437]: https://github.com/rust-lang/rust/pull/72437/
1870 [72445]: https://github.com/rust-lang/rust/pull/72445/
1871 [72486]: https://github.com/rust-lang/rust/pull/72486/
1872 [72493]: https://github.com/rust-lang/rust/pull/72493/
1873 [72331]: https://github.com/rust-lang/rust/pull/72331/
1874 [71896]: https://github.com/rust-lang/rust/pull/71896/
1875 [71660]: https://github.com/rust-lang/rust/pull/71660/
1876 [71322]: https://github.com/rust-lang/rust/pull/71322/
1877 [70740]: https://github.com/rust-lang/rust/pull/70740/
1878 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
1879 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
1880 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
1881 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
1882 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
1883
1884
1885 Version 1.45.2 (2020-08-03)
1886 ==========================
1887
1888 * [Fix bindings in tuple struct patterns][74954]
1889 * [Fix track_caller integration with trait objects][74784]
1890
1891 [74954]: https://github.com/rust-lang/rust/issues/74954
1892 [74784]: https://github.com/rust-lang/rust/issues/74784
1893
1894
1895 Version 1.45.1 (2020-07-30)
1896 ==========================
1897
1898 * [Fix const propagation with references.][73613]
1899 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1900 * [Avoid spurious implicit region bound.][74509]
1901 * [Install clippy on x.py install][74457]
1902
1903 [73613]: https://github.com/rust-lang/rust/pull/73613
1904 [73078]: https://github.com/rust-lang/rust/issues/73078
1905 [74509]: https://github.com/rust-lang/rust/pull/74509
1906 [74457]: https://github.com/rust-lang/rust/pull/74457
1907
1908
1909 Version 1.45.0 (2020-07-16)
1910 ==========================
1911
1912 Language
1913 --------
1914 - [Out of range float to int conversions using `as` has been defined as a saturating
1915   conversion.][71269] This was previously undefined behaviour, but you can use the
1916    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
1917    may be desirable in rare performance sensitive situations.
1918 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
1919   using `u64`.][70705]
1920 - [Function like procedural macros can now be used in expression, pattern, and  statement
1921   positions.][68717] This means you can now use a function-like procedural macro
1922   anywhere you can use a declarative (`macro_rules!`) macro.
1923
1924 Compiler
1925 --------
1926 - [You can now override individual target features through the `target-feature`
1927   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
1928   equivalent to `-C target-feature=+avx2,+fma`.
1929 - [Added the `force-unwind-tables` flag.][69984] This option allows
1930   rustc to always generate unwind tables regardless of panic strategy.
1931 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
1932   to include LLVM bitcode into generated `rlib`s (this is on by default).
1933 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
1934 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
1935 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
1936 - [Upgraded to LLVM 10.][67759]
1937
1938 \* Refer to Rust's [platform support page][platform-support-doc] for more
1939 information on Rust's tiered platform support.
1940
1941
1942 Libraries
1943 ---------
1944 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
1945   and `Ord`.][72239]
1946 - [`proc_macro::TokenStream` now implements `Default`.][72234]
1947 - [You can now use `char` with
1948   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
1949   a range of codepoints.][72413] E.g.
1950   you can now write the following;
1951   ```rust
1952   for ch in 'a'..='z' {
1953       print!("{}", ch);
1954   }
1955   println!();
1956   // Prints "abcdefghijklmnopqrstuvwxyz"
1957   ```
1958 - [`OsString` now implements `FromStr`.][71662]
1959 - [The `saturating_neg` method has been added to all signed integer primitive
1960   types, and the `saturating_abs` method has been added for all integer
1961   primitive types.][71886]
1962 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
1963   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
1964   or `Path`.][71447]
1965 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
1966 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
1967   integer types.][69813]
1968 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
1969   integer types.][72324]
1970 - [The `fetch_update` method has been added to all atomic integer types.][71843]
1971
1972 Stabilized APIs
1973 ---------------
1974 - [`Arc::as_ptr`]
1975 - [`BTreeMap::remove_entry`]
1976 - [`Rc::as_ptr`]
1977 - [`rc::Weak::as_ptr`]
1978 - [`rc::Weak::from_raw`]
1979 - [`rc::Weak::into_raw`]
1980 - [`str::strip_prefix`]
1981 - [`str::strip_suffix`]
1982 - [`sync::Weak::as_ptr`]
1983 - [`sync::Weak::from_raw`]
1984 - [`sync::Weak::into_raw`]
1985 - [`char::UNICODE_VERSION`]
1986 - [`Span::resolved_at`]
1987 - [`Span::located_at`]
1988 - [`Span::mixed_site`]
1989 - [`unix::process::CommandExt::arg0`]
1990
1991 Cargo
1992 -----
1993
1994 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
1995   time.][cargo/8066]
1996
1997 Misc
1998 ----
1999 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
2000   `~~outdated information~~` becomes "~~outdated information~~".
2001 - [Added an emoji to Rustdoc's deprecated API message.][72014]
2002
2003 Compatibility Notes
2004 -------------------
2005 - [Trying to self initialize a static value (that is creating a value using
2006   itself) is unsound and now causes a compile error.][71140]
2007 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
2008   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
2009 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
2010   previously undocumented and not intended for public use. Rustdoc still provides
2011   a non-zero exit code on errors.
2012 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
2013   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
2014   flags while cargo is adding `embed-bitcode` itself. The recommended way to
2015   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
2016   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
2017
2018 Internals Only
2019 --------------
2020 - [Make clippy a git subtree instead of a git submodule][70655]
2021 - [Unify the undo log of all snapshot types][69464]
2022
2023 [71848]: https://github.com/rust-lang/rust/issues/71848/
2024 [73420]: https://github.com/rust-lang/rust/issues/73420/
2025 [72324]: https://github.com/rust-lang/rust/pull/72324/
2026 [71843]: https://github.com/rust-lang/rust/pull/71843/
2027 [71886]: https://github.com/rust-lang/rust/pull/71886/
2028 [72234]: https://github.com/rust-lang/rust/pull/72234/
2029 [72239]: https://github.com/rust-lang/rust/pull/72239/
2030 [72397]: https://github.com/rust-lang/rust/pull/72397/
2031 [72413]: https://github.com/rust-lang/rust/pull/72413/
2032 [72014]: https://github.com/rust-lang/rust/pull/72014/
2033 [72062]: https://github.com/rust-lang/rust/pull/72062/
2034 [72094]: https://github.com/rust-lang/rust/pull/72094/
2035 [72133]: https://github.com/rust-lang/rust/pull/72133/
2036 [67759]: https://github.com/rust-lang/rust/pull/67759/
2037 [71900]: https://github.com/rust-lang/rust/pull/71900/
2038 [71928]: https://github.com/rust-lang/rust/pull/71928/
2039 [71662]: https://github.com/rust-lang/rust/pull/71662/
2040 [71716]: https://github.com/rust-lang/rust/pull/71716/
2041 [71447]: https://github.com/rust-lang/rust/pull/71447/
2042 [71269]: https://github.com/rust-lang/rust/pull/71269/
2043 [71095]: https://github.com/rust-lang/rust/pull/71095/
2044 [71140]: https://github.com/rust-lang/rust/pull/71140/
2045 [70655]: https://github.com/rust-lang/rust/pull/70655/
2046 [70705]: https://github.com/rust-lang/rust/pull/70705/
2047 [69984]: https://github.com/rust-lang/rust/pull/69984/
2048 [69813]: https://github.com/rust-lang/rust/pull/69813/
2049 [69464]: https://github.com/rust-lang/rust/pull/69464/
2050 [68717]: https://github.com/rust-lang/rust/pull/68717/
2051 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
2052 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
2053 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
2054 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
2055 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
2056 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
2057 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
2058 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
2059 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
2060 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
2061 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
2062 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
2063 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
2064 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
2065 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
2066 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
2067 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
2068
2069
2070 Version 1.44.1 (2020-06-18)
2071 ===========================
2072
2073 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
2074 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
2075 * [Fix crashes when finding backtrace on macOS.][71397]
2076 * [Clippy applies lint levels into different files.][clippy/5356]
2077
2078 [71397]: https://github.com/rust-lang/rust/issues/71397
2079 [73078]: https://github.com/rust-lang/rust/issues/73078
2080 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
2081 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
2082
2083
2084 Version 1.44.0 (2020-06-04)
2085 ==========================
2086
2087 Language
2088 --------
2089 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
2090 - [Added the `unused_braces` lint.][70081]
2091
2092 **Syntax-only changes**
2093
2094 - [Expansion-driven outline module parsing][69838]
2095 ```rust
2096 #[cfg(FALSE)]
2097 mod foo {
2098     mod bar {
2099         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
2100     }
2101 }
2102 ```
2103
2104 These are still rejected semantically, so you will likely receive an error but
2105 these changes can be seen and parsed by macros and conditional compilation.
2106
2107 Compiler
2108 --------
2109 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
2110   Additionally when in incremental mode rustc defaults to 256 codegen units.
2111 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
2112   a panic is thrown.][67502]
2113 - [Added tier 3\* support for the `aarch64-unknown-none` and
2114   `aarch64-unknown-none-softfloat` targets.][68334]
2115 - [Added tier 3 support for `arm64-apple-tvos` and
2116   `x86_64-apple-tvos` targets.][68191]
2117
2118
2119 Libraries
2120 ---------
2121 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
2122   `vec![]` to be able to be used in `const` contexts.
2123 - [`convert::Infallible` now implements `Hash`.][70281]
2124 - [`OsString` now implements `DerefMut` and `IndexMut` returning
2125   a `&mut OsStr`.][70048]
2126 - [Unicode 13 is now supported.][69929]
2127 - [`String` now implements `From<&mut str>`.][69661]
2128 - [`IoSlice` now implements `Copy`.][69403]
2129 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
2130 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
2131 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
2132   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
2133   integer types.][69373]
2134
2135 Stabilized APIs
2136 ---------------
2137 - [`PathBuf::with_capacity`]
2138 - [`PathBuf::capacity`]
2139 - [`PathBuf::clear`]
2140 - [`PathBuf::reserve`]
2141 - [`PathBuf::reserve_exact`]
2142 - [`PathBuf::shrink_to_fit`]
2143 - [`f32::to_int_unchecked`]
2144 - [`f64::to_int_unchecked`]
2145 - [`Layout::align_to`]
2146 - [`Layout::pad_to_align`]
2147 - [`Layout::array`]
2148 - [`Layout::extend`]
2149
2150 Cargo
2151 -----
2152 - [Added the `cargo tree` command which will print a tree graph of
2153   your dependencies.][cargo/8062] E.g.
2154   ```
2155     mdbook v0.3.2 (/Users/src/rust/mdbook)
2156   ├── ammonia v3.0.0
2157   │   ├── html5ever v0.24.0
2158   │   │   ├── log v0.4.8
2159   │   │   │   └── cfg-if v0.1.9
2160   │   │   ├── mac v0.1.1
2161   │   │   └── markup5ever v0.9.0
2162   │   │       ├── log v0.4.8 (*)
2163   │   │       ├── phf v0.7.24
2164   │   │       │   └── phf_shared v0.7.24
2165   │   │       │       ├── siphasher v0.2.3
2166   │   │       │       └── unicase v1.4.2
2167   │   │       │           [build-dependencies]
2168   │   │       │           └── version_check v0.1.5
2169   ...
2170   ```
2171   You can also display dependencies on multiple versions of the same crate with
2172   `cargo tree -d` (short for `cargo tree --duplicates`).
2173
2174 Misc
2175 ----
2176 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
2177   the version in the sidebar.][69494]
2178
2179 Compatibility Notes
2180 -------------------
2181 - [Rustc now correctly generates static libraries on Windows GNU targets with
2182   the `.a` extension, rather than the previous `.lib`.][70937]
2183 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
2184 - [The `file_name` property in JSON output of macro errors now points the actual
2185   source file rather than the previous format of `<NAME macros>`.][70969]
2186   **Note:** this may not point to a file that actually exists on the user's system.
2187 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
2188 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
2189   not allow zero initialization such as `NonZeroU8`.][66059] This was
2190   previously a warning.
2191 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
2192   operator has been defined as a saturating operation.][71269] This was previously
2193   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
2194   continue using the current behaviour, which may be desirable in rare performance
2195   sensitive situations.
2196
2197 Internal Only
2198 -------------
2199 These changes provide no direct user facing benefits, but represent significant
2200 improvements to the internals and overall performance of rustc and
2201 related tools.
2202
2203 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
2204 - [Replace big JS dict with JSON parsing.][71250]
2205
2206 [69373]: https://github.com/rust-lang/rust/pull/69373/
2207 [66059]: https://github.com/rust-lang/rust/pull/66059/
2208 [68191]: https://github.com/rust-lang/rust/pull/68191/
2209 [68899]: https://github.com/rust-lang/rust/pull/68899/
2210 [71147]: https://github.com/rust-lang/rust/pull/71147/
2211 [71250]: https://github.com/rust-lang/rust/pull/71250/
2212 [70937]: https://github.com/rust-lang/rust/pull/70937/
2213 [70969]: https://github.com/rust-lang/rust/pull/70969/
2214 [70632]: https://github.com/rust-lang/rust/pull/70632/
2215 [70281]: https://github.com/rust-lang/rust/pull/70281/
2216 [70345]: https://github.com/rust-lang/rust/pull/70345/
2217 [70048]: https://github.com/rust-lang/rust/pull/70048/
2218 [70081]: https://github.com/rust-lang/rust/pull/70081/
2219 [70156]: https://github.com/rust-lang/rust/pull/70156/
2220 [71269]: https://github.com/rust-lang/rust/pull/71269/
2221 [69838]: https://github.com/rust-lang/rust/pull/69838/
2222 [69929]: https://github.com/rust-lang/rust/pull/69929/
2223 [69661]: https://github.com/rust-lang/rust/pull/69661/
2224 [69778]: https://github.com/rust-lang/rust/pull/69778/
2225 [69494]: https://github.com/rust-lang/rust/pull/69494/
2226 [69403]: https://github.com/rust-lang/rust/pull/69403/
2227 [69033]: https://github.com/rust-lang/rust/pull/69033/
2228 [68692]: https://github.com/rust-lang/rust/pull/68692/
2229 [68334]: https://github.com/rust-lang/rust/pull/68334/
2230 [67502]: https://github.com/rust-lang/rust/pull/67502/
2231 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
2232 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
2233 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
2234 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
2235 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
2236 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
2237 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
2238 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
2239 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
2240 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
2241 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
2242 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
2243 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
2244
2245
2246 Version 1.43.1 (2020-05-07)
2247 ===========================
2248
2249 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
2250 * [Fixed the stabilization of AVX-512 features.][71473]
2251 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
2252
2253 [71430]: https://github.com/rust-lang/rust/pull/71430
2254 [71473]: https://github.com/rust-lang/rust/issues/71473
2255 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
2256
2257
2258 Version 1.43.0 (2020-04-23)
2259 ==========================
2260
2261 Language
2262 --------
2263 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
2264   the type inferred correctly.][68129]
2265 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
2266
2267 **Syntax only changes**
2268 - [Allow `type Foo: Ord` syntactically.][69361]
2269 - [Fuse associated and extern items up to defaultness.][69194]
2270 - [Syntactically allow `self` in all `fn` contexts.][68764]
2271 - [Merge `fn` syntax + cleanup item parsing.][68728]
2272 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
2273   For example, you may now write:
2274   ```rust
2275   macro_rules! mac_trait {
2276       ($i:item) => {
2277           trait T { $i }
2278       }
2279   }
2280   mac_trait! {
2281       fn foo() {}
2282   }
2283   ```
2284
2285 These are still rejected *semantically*, so you will likely receive an error but
2286 these changes can be seen and parsed by macros and
2287 conditional compilation.
2288
2289
2290 Compiler
2291 --------
2292 - [You can now pass multiple lint flags to rustc to override the previous
2293   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
2294   everything in the `unused` lint group except `unused-variables` which
2295   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
2296   everything in the `unused` lint group **including** `unused-variables` since
2297   the allow flag is specified before the deny flag (and therefore overridden).
2298 - [rustc will now prefer your system MinGW libraries over its bundled libraries
2299   if they are available on `windows-gnu`.][67429]
2300 - [rustc now buffers errors/warnings printed in JSON.][69227]
2301
2302 Libraries
2303 ---------
2304 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
2305   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
2306   respectively.][69538] **Note** These conversions are only available when `N`
2307   is `0..=32`.
2308 - [You can now use associated constants on floats and integers directly, rather
2309   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
2310   `f32::NAN` with no imports.
2311 - [`u8::is_ascii` is now `const`.][68984]
2312 - [`String` now implements `AsMut<str>`.][68742]
2313 - [Added the `primitive` module to `std` and `core`.][67637] This module
2314   reexports Rust's primitive types. This is mainly useful in macros
2315   where you want avoid these types being shadowed.
2316 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
2317 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
2318
2319 Stabilized APIs
2320 ---------------
2321 - [`Once::is_completed`]
2322 - [`f32::LOG10_2`]
2323 - [`f32::LOG2_10`]
2324 - [`f64::LOG10_2`]
2325 - [`f64::LOG2_10`]
2326 - [`iter::once_with`]
2327
2328 Cargo
2329 -----
2330 - [You can now set config `[profile]`s in your `.cargo/config`, or through
2331   your environment.][cargo/7823]
2332 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
2333   executable path when running integration tests or benchmarks.][cargo/7697]
2334   `<name>` is the name of your binary as-is e.g. If you wanted the executable
2335   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
2336
2337 Misc
2338 ----
2339 - [Certain checks in the `const_err` lint were deemed unrelated to const
2340   evaluation][69185], and have been moved to the `unconditional_panic` and
2341   `arithmetic_overflow` lints.
2342
2343 Compatibility Notes
2344 -------------------
2345
2346 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
2347   has been a warning since 1.36.0.
2348 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
2349   led to some instances being accepted, and now correctly emits a hard error.
2350
2351 [69340]: https://github.com/rust-lang/rust/pull/69340
2352
2353 Internal Only
2354 -------------
2355 These changes provide no direct user facing benefits, but represent significant
2356 improvements to the internals and overall performance of `rustc` and
2357 related tools.
2358
2359 - [All components are now built with `opt-level=3` instead of `2`.][67878]
2360 - [Improved how rustc generates drop code.][67332]
2361 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
2362 - [traits: preallocate 2 Vecs of known initial size][69022]
2363 - [Avoid exponential behaviour when relating types][68772]
2364 - [Skip `Drop` terminators for enum variants without drop glue][68943]
2365 - [Improve performance of coherence checks][68966]
2366 - [Deduplicate types in the generator witness][68672]
2367 - [Invert control in struct_lint_level.][68725]
2368
2369 [67332]: https://github.com/rust-lang/rust/pull/67332/
2370 [67429]: https://github.com/rust-lang/rust/pull/67429/
2371 [67637]: https://github.com/rust-lang/rust/pull/67637/
2372 [67642]: https://github.com/rust-lang/rust/pull/67642/
2373 [67878]: https://github.com/rust-lang/rust/pull/67878/
2374 [67885]: https://github.com/rust-lang/rust/pull/67885/
2375 [68129]: https://github.com/rust-lang/rust/pull/68129/
2376 [68672]: https://github.com/rust-lang/rust/pull/68672/
2377 [68725]: https://github.com/rust-lang/rust/pull/68725/
2378 [68728]: https://github.com/rust-lang/rust/pull/68728/
2379 [68738]: https://github.com/rust-lang/rust/pull/68738/
2380 [68742]: https://github.com/rust-lang/rust/pull/68742/
2381 [68764]: https://github.com/rust-lang/rust/pull/68764/
2382 [68772]: https://github.com/rust-lang/rust/pull/68772/
2383 [68943]: https://github.com/rust-lang/rust/pull/68943/
2384 [68952]: https://github.com/rust-lang/rust/pull/68952/
2385 [68966]: https://github.com/rust-lang/rust/pull/68966/
2386 [68984]: https://github.com/rust-lang/rust/pull/68984/
2387 [69022]: https://github.com/rust-lang/rust/pull/69022/
2388 [69185]: https://github.com/rust-lang/rust/pull/69185/
2389 [69194]: https://github.com/rust-lang/rust/pull/69194/
2390 [69201]: https://github.com/rust-lang/rust/pull/69201/
2391 [69227]: https://github.com/rust-lang/rust/pull/69227/
2392 [69548]: https://github.com/rust-lang/rust/pull/69548/
2393 [69256]: https://github.com/rust-lang/rust/pull/69256/
2394 [69361]: https://github.com/rust-lang/rust/pull/69361/
2395 [69366]: https://github.com/rust-lang/rust/pull/69366/
2396 [69538]: https://github.com/rust-lang/rust/pull/69538/
2397 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
2398 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
2399 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
2400 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
2401 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
2402 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
2403 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
2404 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
2405
2406
2407 Version 1.42.0 (2020-03-12)
2408 ==========================
2409
2410 Language
2411 --------
2412 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
2413   ```rust
2414   fn foo(words: &[&str]) {
2415       match words {
2416           ["Hello", "World", "!", ..] => println!("Hello World!"),
2417           ["Foo", "Bar", ..] => println!("Baz"),
2418           rest => println!("{:?}", rest),
2419       }
2420   }
2421   ```
2422 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
2423   that you can create an enum that has the exact layout and ABI of the type
2424   it contains.
2425 - [You can now use outer attribute procedural macros on inline modules.][64273]
2426 - [There are some *syntax-only* changes:][67131]
2427    - `default` is syntactically allowed before items in `trait` definitions.
2428    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
2429      leave out their bodies in favor of `;`.
2430    - Bounds on associated types in `impl`s are now syntactically allowed
2431      (e.g. `type Foo: Ord;`).
2432    - `...` (the C-variadic type) may occur syntactically directly as the type of
2433       any function parameter.
2434
2435   These are still rejected *semantically*, so you will likely receive an error
2436   but these changes can be seen and parsed by procedural macros and
2437   conditional compilation.
2438
2439 Compiler
2440 --------
2441 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
2442 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
2443 - [`Option::{expect,unwrap}` and
2444    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
2445    pointing to the location where they were called, rather than
2446    `core`'s internals. ][67887]
2447
2448 \* Refer to Rust's [platform support page][platform-support-doc] for more
2449 information on Rust's tiered platform support.
2450
2451 Libraries
2452 ---------
2453 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
2454 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
2455    to implement `Sized`.][67935]
2456 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
2457 - [`Layout::new` is now `const`.][66254]
2458 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
2459
2460
2461 Stabilized APIs
2462 ---------------
2463 - [`CondVar::wait_while`]
2464 - [`CondVar::wait_timeout_while`]
2465 - [`DebugMap::key`]
2466 - [`DebugMap::value`]
2467 - [`ManuallyDrop::take`]
2468 - [`matches!`]
2469 - [`ptr::slice_from_raw_parts_mut`]
2470 - [`ptr::slice_from_raw_parts`]
2471
2472 Cargo
2473 -----
2474 - [You no longer need to include `extern crate proc_macro;` to be able to
2475   `use proc_macro;` in the `2018` edition.][cargo/7700]
2476
2477 Compatibility Notes
2478 -------------------
2479 - [`Error::description` has been deprecated, and its use will now produce a
2480   warning.][66919] It's recommended to use `Display`/`to_string` instead.
2481
2482 [68253]: https://github.com/rust-lang/rust/pull/68253/
2483 [68348]: https://github.com/rust-lang/rust/pull/68348/
2484 [67935]: https://github.com/rust-lang/rust/pull/67935/
2485 [68339]: https://github.com/rust-lang/rust/pull/68339/
2486 [68122]: https://github.com/rust-lang/rust/pull/68122/
2487 [64273]: https://github.com/rust-lang/rust/pull/64273/
2488 [67712]: https://github.com/rust-lang/rust/pull/67712/
2489 [67887]: https://github.com/rust-lang/rust/pull/67887/
2490 [67131]: https://github.com/rust-lang/rust/pull/67131/
2491 [67233]: https://github.com/rust-lang/rust/pull/67233/
2492 [66899]: https://github.com/rust-lang/rust/pull/66899/
2493 [66919]: https://github.com/rust-lang/rust/pull/66919/
2494 [66254]: https://github.com/rust-lang/rust/pull/66254/
2495 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
2496 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
2497 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
2498 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
2499 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
2500 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
2501 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
2502 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
2503 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
2504
2505
2506 Version 1.41.1 (2020-02-27)
2507 ===========================
2508
2509 * [Always check types of static items][69145]
2510 * [Always check lifetime bounds of `Copy` impls][69145]
2511 * [Fix miscompilation in callers of `Layout::repeat`][69225]
2512
2513 [69225]: https://github.com/rust-lang/rust/issues/69225
2514 [69145]: https://github.com/rust-lang/rust/pull/69145
2515
2516
2517 Version 1.41.0 (2020-01-30)
2518 ===========================
2519
2520 Language
2521 --------
2522
2523 - [You can now pass type parameters to foreign items when implementing
2524   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
2525 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
2526   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
2527   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
2528 - [You can now use any valid identifier in a `format_args` macro.][66847]
2529   Previously identifiers starting with an underscore were not allowed.
2530 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
2531   enum variants.][66183] These are still rejected semantically, but
2532   can be seen and parsed by procedural macros and conditional compilation.
2533 - [You can now define a Rust `extern "C"` function with `Box<T>` and use `T*` as the corresponding
2534   type on the C side.][62514] Please see [the documentation][box-memory-layout] for more information,
2535   including the important caveat about preferring to avoid `Box<T>` in Rust signatures for functions defined in C.
2536
2537 [box-memory-layout]: https://doc.rust-lang.org/std/boxed/index.html#memory-layout
2538
2539 Compiler
2540 --------
2541
2542 - [Rustc will now warn if you have unused loop `'label`s.][66325]
2543 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
2544 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
2545 - [You can now pass an arguments file passing the `@path` syntax
2546   to rustc.][66172] Note that the format differs somewhat from what is
2547   found in other tooling; please see [the documentation][argfile-docs] for
2548   more information.
2549 - [You can now provide `--extern` flag without a path, indicating that it is
2550   available from the search path or specified with an `-L` flag.][64882]
2551
2552 \* Refer to Rust's [platform support page][platform-support-doc] for more
2553 information on Rust's tiered platform support.
2554
2555 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
2556
2557 Libraries
2558 ---------
2559
2560 - [The `core::panic` module is now stable.][66771] It was already stable
2561   through `std`.
2562 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
2563   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
2564 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
2565
2566 Stabilized APIs
2567 ---------------
2568
2569 - [`Result::map_or`]
2570 - [`Result::map_or_else`]
2571 - [`std::rc::Weak::weak_count`]
2572 - [`std::rc::Weak::strong_count`]
2573 - [`std::sync::Weak::weak_count`]
2574 - [`std::sync::Weak::strong_count`]
2575
2576 Cargo
2577 -----
2578
2579 - [Cargo will now document all the private items for binary crates
2580   by default.][cargo/7593]
2581 - [`cargo-install` will now reinstall the package if it detects that it is out
2582   of date.][cargo/7560]
2583 - [Cargo.lock now uses a more git friendly format that should help to reduce
2584   merge conflicts.][cargo/7579]
2585 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
2586   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
2587   optimisation level to `2` for debug builds. You can also use
2588   `[profile.<profile>.build-override]` to override build scripts and
2589   their dependencies.
2590
2591 Misc
2592 ----
2593
2594 - [You can now specify `edition` in documentation code blocks to compile the block
2595   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
2596   should be compiled the 2018 edition of Rust.
2597 - [You can now provide custom themes to rustdoc with `--theme`, and check the
2598   current theme with `--check-theme`.][54733]
2599 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
2600
2601 Compatibility Notes
2602 -------------------
2603
2604 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
2605   Apple targets.][apple-32bit-drop] This means that the source code is still
2606   available to build, but the targets are no longer being tested and release
2607   binaries for those platforms will no longer be distributed by the Rust project.
2608   Please refer to the linked blog post for more information.
2609
2610 [54733]: https://github.com/rust-lang/rust/pull/54733/
2611 [61351]: https://github.com/rust-lang/rust/pull/61351/
2612 [62514]: https://github.com/rust-lang/rust/pull/62514/
2613 [67255]: https://github.com/rust-lang/rust/pull/67255/
2614 [66661]: https://github.com/rust-lang/rust/pull/66661/
2615 [66771]: https://github.com/rust-lang/rust/pull/66771/
2616 [66847]: https://github.com/rust-lang/rust/pull/66847/
2617 [66238]: https://github.com/rust-lang/rust/pull/66238/
2618 [66277]: https://github.com/rust-lang/rust/pull/66277/
2619 [66325]: https://github.com/rust-lang/rust/pull/66325/
2620 [66172]: https://github.com/rust-lang/rust/pull/66172/
2621 [66183]: https://github.com/rust-lang/rust/pull/66183/
2622 [65879]: https://github.com/rust-lang/rust/pull/65879/
2623 [65013]: https://github.com/rust-lang/rust/pull/65013/
2624 [64882]: https://github.com/rust-lang/rust/pull/64882/
2625 [64325]: https://github.com/rust-lang/rust/pull/64325/
2626 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
2627 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
2628 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
2629 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
2630 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
2631 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
2632 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
2633 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
2634 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
2635 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
2636 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
2637
2638 Version 1.40.0 (2019-12-19)
2639 ===========================
2640
2641 Language
2642 --------
2643 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
2644   `const` contexts.][65188] e.g.
2645
2646   ```rust
2647   pub struct Point(i32, i32);
2648
2649   const ORIGIN: Point = {
2650       let constructor = Point;
2651
2652       constructor(0, 0)
2653   };
2654   ```
2655
2656 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
2657   indicate that there may be variants or fields added in the future.][64639]
2658   For example this requires adding a wild-card branch (`_ => {}`) to any match
2659   statements on a non-exhaustive `enum`. [(RFC 2008)]
2660 - [You can now use function-like procedural macros in `extern` blocks and in
2661   type positions.][63931] e.g. `type Generated = macro!();`
2662 - [Function-like and attribute procedural macros can now emit
2663   `macro_rules!` items, so you can now have your macros generate macros.][64035]
2664 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
2665   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
2666   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
2667
2668 Compiler
2669 --------
2670 - [Added tier 3 support\* for the
2671   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
2672 - [Added tier 3 support for the
2673   `aarch64-unknown-none-softfloat` target.][64589]
2674 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
2675   `mips64el-unknown-linux-muslabi64` targets.][65843]
2676
2677 \* Refer to Rust's [platform support page][platform-support-doc] for more
2678   information on Rust's tiered platform support.
2679
2680 Libraries
2681 ---------
2682 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
2683
2684 Stabilized APIs
2685 ---------------
2686 - [`BTreeMap::get_key_value`]
2687 - [`HashMap::get_key_value`]
2688 - [`Option::as_deref_mut`]
2689 - [`Option::as_deref`]
2690 - [`Option::flatten`]
2691 - [`UdpSocket::peer_addr`]
2692 - [`f32::to_be_bytes`]
2693 - [`f32::to_le_bytes`]
2694 - [`f32::to_ne_bytes`]
2695 - [`f64::to_be_bytes`]
2696 - [`f64::to_le_bytes`]
2697 - [`f64::to_ne_bytes`]
2698 - [`f32::from_be_bytes`]
2699 - [`f32::from_le_bytes`]
2700 - [`f32::from_ne_bytes`]
2701 - [`f64::from_be_bytes`]
2702 - [`f64::from_le_bytes`]
2703 - [`f64::from_ne_bytes`]
2704 - [`mem::take`]
2705 - [`slice::repeat`]
2706 - [`todo!`]
2707
2708 Cargo
2709 -----
2710 - [Cargo will now always display warnings, rather than only on
2711   fresh builds.][cargo/7450]
2712 - [Feature flags (except `--all-features`) passed to a virtual workspace will
2713   now produce an error.][cargo/7507] Previously these flags were ignored.
2714 - [You can now publish `dev-dependencies` without including
2715   a `version`.][cargo/7333]
2716
2717 Misc
2718 ----
2719 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
2720   when running documentation tests with `rustdoc`.][63803]
2721
2722 Compatibility Notes
2723 -------------------
2724 - [As previously announced, any previous NLL warnings in the 2015 edition are
2725   now hard errors.][64221]
2726 - [The `include!` macro will now warn if it failed to include the
2727   entire file.][64284] The `include!` macro unintentionally only includes the
2728   first _expression_ in a file, and this can be unintuitive. This will become
2729   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
2730 - [Using `#[inline]` on function prototypes and consts now emits a warning under
2731   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
2732   or `extern` blocks now correctly emits a hard error.
2733
2734 [65294]: https://github.com/rust-lang/rust/pull/65294/
2735 [66103]: https://github.com/rust-lang/rust/pull/66103/
2736 [65843]: https://github.com/rust-lang/rust/pull/65843/
2737 [65188]: https://github.com/rust-lang/rust/pull/65188/
2738 [65092]: https://github.com/rust-lang/rust/pull/65092/
2739 [64589]: https://github.com/rust-lang/rust/pull/64589/
2740 [64639]: https://github.com/rust-lang/rust/pull/64639/
2741 [64221]: https://github.com/rust-lang/rust/pull/64221/
2742 [64284]: https://github.com/rust-lang/rust/pull/64284/
2743 [63931]: https://github.com/rust-lang/rust/pull/63931/
2744 [64035]: https://github.com/rust-lang/rust/pull/64035/
2745 [63674]: https://github.com/rust-lang/rust/pull/63674/
2746 [63803]: https://github.com/rust-lang/rust/pull/63803/
2747 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
2748 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
2749 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
2750 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
2751 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
2752 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
2753 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
2754 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
2755 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
2756 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
2757 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
2758 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
2759 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
2760 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
2761 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
2762 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
2763 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
2764 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
2765 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
2766 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
2767 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
2768 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
2769 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
2770 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
2771 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
2772
2773
2774 Version 1.39.0 (2019-11-07)
2775 ===========================
2776
2777 Language
2778 --------
2779 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
2780   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
2781 - [You can now use certain attributes on function, closure, and function pointer
2782   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
2783   `deny`, `forbid` as well as inert helper attributes used by procedural macro
2784   attributes applied to items. e.g.
2785   ```rust
2786   fn len(
2787       #[cfg(windows)] slice: &[u16],
2788       #[cfg(not(windows))] slice: &[u8],
2789   ) -> usize {
2790       slice.len()
2791   }
2792   ```
2793 - [You can now take shared references to bind-by-move patterns in the `if` guards
2794   of `match` arms.][63118] e.g.
2795   ```rust
2796   fn main() {
2797       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
2798
2799       match array {
2800           nums
2801   //      ---- `nums` is bound by move.
2802               if nums.iter().sum::<u8>() == 10
2803   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
2804           => {
2805               drop(nums);
2806   //          ----------- Legal as `nums` was bound by move and so we have ownership.
2807           }
2808           _ => unreachable!(),
2809       }
2810   }
2811   ```
2812
2813
2814
2815 Compiler
2816 --------
2817 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
2818 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
2819 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
2820   **Note** Cargo currently doesn't use this feature. Refer to
2821   [cargo#7315][cargo/7315] to track this feature's progress.
2822 - [You can now pass `--show-output` argument to test binaries to print the
2823   output of successful tests.][62600]
2824
2825
2826 \* Refer to Rust's [platform support page][platform-support-doc] for more
2827 information on Rust's tiered platform support.
2828
2829 Libraries
2830 ---------
2831 - [`Vec::new` and `String::new` are now `const` functions.][64028]
2832 - [`LinkedList::new` is now a `const` function.][63684]
2833 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
2834 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
2835   now `const`.][63786]
2836
2837 Stabilized APIs
2838 ---------------
2839 - [`Pin::into_inner`]
2840 - [`Instant::checked_duration_since`]
2841 - [`Instant::saturating_duration_since`]
2842
2843 Cargo
2844 -----
2845 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
2846 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
2847   `--all` is now deprecated.
2848
2849 Misc
2850 ----
2851 - [You can now pass `-Clinker` to rustdoc to control the linker used
2852   for compiling doctests.][63834]
2853
2854 Compatibility Notes
2855 -------------------
2856 - [Code that was previously accepted by the old borrow checker, but rejected by
2857   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
2858   previously a warning, and will also become a hard error in the Rust 2015
2859   edition in the 1.40.0 release.
2860 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
2861   run tests.][63827] This should improve performance when running a large
2862   amount of doctests.
2863 - [The `try!` macro will now issue a deprecation warning.][62672] It is
2864   recommended to use the `?` operator instead.
2865 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
2866   returned `0.0`.
2867
2868 [62600]: https://github.com/rust-lang/rust/pull/62600/
2869 [62672]: https://github.com/rust-lang/rust/pull/62672/
2870 [63118]: https://github.com/rust-lang/rust/pull/63118/
2871 [63209]: https://github.com/rust-lang/rust/pull/63209/
2872 [63402]: https://github.com/rust-lang/rust/pull/63402/
2873 [63565]: https://github.com/rust-lang/rust/pull/63565/
2874 [63595]: https://github.com/rust-lang/rust/pull/63595/
2875 [63684]: https://github.com/rust-lang/rust/pull/63684/
2876 [63698]: https://github.com/rust-lang/rust/pull/63698/
2877 [63770]: https://github.com/rust-lang/rust/pull/63770/
2878 [63786]: https://github.com/rust-lang/rust/pull/63786/
2879 [63827]: https://github.com/rust-lang/rust/pull/63827/
2880 [63834]: https://github.com/rust-lang/rust/pull/63834/
2881 [64010]: https://github.com/rust-lang/rust/pull/64010/
2882 [64028]: https://github.com/rust-lang/rust/pull/64028/
2883 [64334]: https://github.com/rust-lang/rust/pull/64334/
2884 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
2885 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
2886 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
2887 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
2888 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
2889 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
2890
2891 Version 1.38.0 (2019-09-26)
2892 ==========================
2893
2894 Language
2895 --------
2896 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
2897 - [The `#[deprecated]` attribute can now be used on macros.][62042]
2898
2899 Compiler
2900 --------
2901 - [Added pipelined compilation support to `rustc`.][62766] This will
2902   improve compilation times in some cases. For further information please refer
2903   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
2904 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
2905   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
2906   `x86_64-uwp-windows-msvc` targets.][60260]
2907 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
2908   `armv7-unknown-linux-musleabi` targets.][63107]
2909 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
2910 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
2911 - [Upgraded to LLVM 9.][62592]
2912
2913 \* Refer to Rust's [platform support page][platform-support-doc] for more
2914 information on Rust's tiered platform support.
2915
2916 Libraries
2917 ---------
2918 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
2919 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
2920   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
2921   is available at `std::clone::Clone`). This also makes all built-in macros
2922   available in `std`/`core` root. e.g. `std::include_bytes!`.
2923 - [`str::Chars` now implements `Debug`.][63000]
2924 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
2925 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
2926 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
2927 - [Added euclidean remainder and division operations (`div_euclid`,
2928   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
2929   `overflowing`, and `wrapping` versions are available for all
2930   integer primitives.
2931 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
2932   `PartialEq`.][61491]
2933 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
2934
2935 Stabilized APIs
2936 ---------------
2937 - [`<*const T>::cast`]
2938 - [`<*mut T>::cast`]
2939 - [`Duration::as_secs_f32`]
2940 - [`Duration::as_secs_f64`]
2941 - [`Duration::div_f32`]
2942 - [`Duration::div_f64`]
2943 - [`Duration::from_secs_f32`]
2944 - [`Duration::from_secs_f64`]
2945 - [`Duration::mul_f32`]
2946 - [`Duration::mul_f64`]
2947 - [`any::type_name`]
2948
2949 Cargo
2950 -----
2951 - [Added pipelined compilation support to `cargo`.][cargo/7143]
2952 - [You can now pass the `--features` option multiple times to enable
2953   multiple features.][cargo/7084]
2954
2955 Rustdoc
2956 -------
2957
2958 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
2959
2960 Misc
2961 ----
2962 - [`rustc` will now warn about some incorrect uses of
2963   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
2964
2965 Compatibility Notes
2966 -------------------
2967 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
2968   1.38.0.
2969 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
2970   issues][62896] with certain crates such as libc.
2971
2972 [60260]: https://github.com/rust-lang/rust/pull/60260/
2973 [61457]: https://github.com/rust-lang/rust/pull/61457/
2974 [61491]: https://github.com/rust-lang/rust/pull/61491/
2975 [61884]: https://github.com/rust-lang/rust/pull/61884/
2976 [61953]: https://github.com/rust-lang/rust/pull/61953/
2977 [62042]: https://github.com/rust-lang/rust/pull/62042/
2978 [62528]: https://github.com/rust-lang/rust/pull/62528/
2979 [62583]: https://github.com/rust-lang/rust/pull/62583/
2980 [62735]: https://github.com/rust-lang/rust/pull/62735/
2981 [62766]: https://github.com/rust-lang/rust/pull/62766/
2982 [62784]: https://github.com/rust-lang/rust/pull/62784/
2983 [62592]: https://github.com/rust-lang/rust/pull/62592/
2984 [62785]: https://github.com/rust-lang/rust/issues/62785/
2985 [62814]: https://github.com/rust-lang/rust/pull/62814/
2986 [62896]: https://github.com/rust-lang/rust/issues/62896/
2987 [63000]: https://github.com/rust-lang/rust/pull/63000/
2988 [63056]: https://github.com/rust-lang/rust/pull/63056/
2989 [63107]: https://github.com/rust-lang/rust/pull/63107/
2990 [63346]: https://github.com/rust-lang/rust/pull/63346/
2991 [63421]: https://github.com/rust-lang/rust/pull/63421/
2992 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
2993 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
2994 [63048]: https://github.com/rust-lang/rust/pull/63048
2995 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2996 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2997 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
2998 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
2999 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
3000 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
3001 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
3002 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
3003 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
3004 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
3005 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
3006 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
3007 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
3008
3009 Version 1.37.0 (2019-08-15)
3010 ==========================
3011
3012 Language
3013 --------
3014 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
3015   [`Box`][62228], or an [array][62235] and unused.
3016 - [You can now use the `cfg` and `cfg_attr` attributes on
3017   generic parameters.][61547]
3018 - [You can now use enum variants through type alias.][61682] e.g. You can
3019   write the following:
3020   ```rust
3021   type MyOption = Option<u8>;
3022
3023   fn increment_or_zero(x: MyOption) -> u8 {
3024       match x {
3025           MyOption::Some(y) => y + 1,
3026           MyOption::None => 0,
3027       }
3028   }
3029   ```
3030 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
3031   `const _: u32 = 5;`.
3032 - [You can now use `#[repr(align(X)]` on enums.][61229]
3033 - [The  `?` Kleene macro operator is now available in the
3034   2015 edition.][60932]
3035
3036 Compiler
3037 --------
3038 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
3039   and `-C profile-use` flags.][61268] For more information on how to use profile
3040   guided optimization, please refer to the [rustc book][rustc-book-pgo].
3041 - [The `rust-lldb` wrapper script should now work again.][61827]
3042
3043 Libraries
3044 ---------
3045 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
3046
3047 Stabilized APIs
3048 ---------------
3049 - [`BufReader::buffer`]
3050 - [`BufWriter::buffer`]
3051 - [`Cell::from_mut`]
3052 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
3053 - [`DoubleEndedIterator::nth_back`]
3054 - [`Option::xor`]
3055 - [`Wrapping::reverse_bits`]
3056 - [`i128::reverse_bits`]
3057 - [`i16::reverse_bits`]
3058 - [`i32::reverse_bits`]
3059 - [`i64::reverse_bits`]
3060 - [`i8::reverse_bits`]
3061 - [`isize::reverse_bits`]
3062 - [`slice::copy_within`]
3063 - [`u128::reverse_bits`]
3064 - [`u16::reverse_bits`]
3065 - [`u32::reverse_bits`]
3066 - [`u64::reverse_bits`]
3067 - [`u8::reverse_bits`]
3068 - [`usize::reverse_bits`]
3069
3070 Cargo
3071 -----
3072 - [`Cargo.lock` files are now included by default when publishing executable crates
3073   with executables.][cargo/7026]
3074 - [You can now specify `default-run="foo"` in `[package]` to specify the
3075   default executable to use for `cargo run`.][cargo/7056]
3076
3077 Misc
3078 ----
3079
3080 Compatibility Notes
3081 -------------------
3082 - [Using `...` for inclusive range patterns will now warn by default.][61342]
3083   Please transition your code to using the `..=` syntax for inclusive
3084   ranges instead.
3085 - [Using a trait object without the `dyn` will now warn by default.][61203]
3086   Please transition your code to use `dyn Trait` for trait objects instead.
3087
3088 [62228]: https://github.com/rust-lang/rust/pull/62228/
3089 [62235]: https://github.com/rust-lang/rust/pull/62235/
3090 [61802]: https://github.com/rust-lang/rust/pull/61802/
3091 [61827]: https://github.com/rust-lang/rust/pull/61827/
3092 [61547]: https://github.com/rust-lang/rust/pull/61547/
3093 [61682]: https://github.com/rust-lang/rust/pull/61682/
3094 [61268]: https://github.com/rust-lang/rust/pull/61268/
3095 [61342]: https://github.com/rust-lang/rust/pull/61342/
3096 [61347]: https://github.com/rust-lang/rust/pull/61347/
3097 [61100]: https://github.com/rust-lang/rust/pull/61100/
3098 [61203]: https://github.com/rust-lang/rust/pull/61203/
3099 [61229]: https://github.com/rust-lang/rust/pull/61229/
3100 [60932]: https://github.com/rust-lang/rust/pull/60932/
3101 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
3102 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
3103 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
3104 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
3105 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
3106 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
3107 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
3108 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
3109 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
3110 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
3111 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
3112 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
3113 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
3114 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
3115 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
3116 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
3117 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
3118 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
3119 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
3120 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
3121 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
3122 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
3123 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
3124
3125
3126 Version 1.36.0 (2019-07-04)
3127 ==========================
3128
3129 Language
3130 --------
3131 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
3132 - [The order of traits in trait objects no longer affects the semantics of that
3133   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
3134   `dyn fmt::Debug + Send`, where this was previously not the case.
3135
3136 Libraries
3137 ---------
3138 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
3139 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
3140 - [`mem::needs_drop` is now available as a const fn.][60364]
3141 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
3142 - [`String` now implements `BorrowMut<str>`.][60404]
3143 - [`io::Cursor` now implements `Default`.][60234]
3144 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
3145 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
3146   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
3147   environment has access to heap memory allocation.
3148 - [`String` now implements `From<&String>`.][59825]
3149 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
3150   return a tuple of each argument when there is multiple arguments.
3151 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
3152   not used.][59648]
3153
3154 Stabilized APIs
3155 ---------------
3156 - [`VecDeque::rotate_left`]
3157 - [`VecDeque::rotate_right`]
3158 - [`Iterator::copied`]
3159 - [`io::IoSlice`]
3160 - [`io::IoSliceMut`]
3161 - [`Read::read_vectored`]
3162 - [`Write::write_vectored`]
3163 - [`str::as_mut_ptr`]
3164 - [`mem::MaybeUninit`]
3165 - [`pointer::align_offset`]
3166 - [`future::Future`]
3167 - [`task::Context`]
3168 - [`task::RawWaker`]
3169 - [`task::RawWakerVTable`]
3170 - [`task::Waker`]
3171 - [`task::Poll`]
3172
3173 Cargo
3174 -----
3175 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
3176 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
3177
3178 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
3179
3180 Clippy
3181 ------
3182 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
3183
3184 Misc
3185 ----
3186
3187 Compatibility Notes
3188 -------------------
3189 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
3190   longer recommended, and will be deprecated in 1.39.0.
3191
3192 [60318]: https://github.com/rust-lang/rust/pull/60318/
3193 [60364]: https://github.com/rust-lang/rust/pull/60364/
3194 [60370]: https://github.com/rust-lang/rust/pull/60370/
3195 [60404]: https://github.com/rust-lang/rust/pull/60404/
3196 [60234]: https://github.com/rust-lang/rust/pull/60234/
3197 [60244]: https://github.com/rust-lang/rust/pull/60244/
3198 [58623]: https://github.com/rust-lang/rust/pull/58623/
3199 [59648]: https://github.com/rust-lang/rust/pull/59648/
3200 [59675]: https://github.com/rust-lang/rust/pull/59675/
3201 [59825]: https://github.com/rust-lang/rust/pull/59825/
3202 [59826]: https://github.com/rust-lang/rust/pull/59826/
3203 [59445]: https://github.com/rust-lang/rust/pull/59445/
3204 [59114]: https://github.com/rust-lang/rust/pull/59114/
3205 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
3206 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
3207 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
3208 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
3209 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
3210 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
3211 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
3212 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
3213 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
3214 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
3215 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
3216 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
3217 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
3218 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
3219 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
3220 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
3221 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
3222 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
3223 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
3224 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
3225
3226
3227 Version 1.35.0 (2019-05-23)
3228 ==========================
3229
3230 Language
3231 --------
3232 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
3233   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
3234 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
3235   ```rust
3236   unsafe fn call_unsafe(func: unsafe fn()) {
3237       func()
3238   }
3239
3240   pub fn main() {
3241       unsafe { call_unsafe(|| {}); }
3242   }
3243   ```
3244
3245
3246 Compiler
3247 --------
3248 - [Added the `armv6-unknown-freebsd-gnueabihf` and
3249   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
3250 - [Added the `wasm32-unknown-wasi` target.][59464]
3251
3252
3253 Libraries
3254 ---------
3255 - [`Thread` will now show its ID in `Debug` output.][59460]
3256 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
3257 - [`alloc::System` now implements `Default`.][59451]
3258 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
3259   last field.][59076]
3260 - [`char::{ToLowercase, ToUppercase}` now
3261   implement `ExactSizeIterator`.][58778]
3262 - [All `NonZero` numeric types now implement `FromStr`.][58717]
3263 - [Removed the `Read` trait bounds
3264   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
3265 - [You can now call the `dbg!` macro without any parameters to print the file
3266   and line where it is called.][57847]
3267 - [In place ASCII case conversions are now up to 4× faster.][59283]
3268   e.g. `str::make_ascii_lowercase`
3269 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
3270   and `Send`.][58369]
3271
3272 Stabilized APIs
3273 ---------------
3274 - [`f32::copysign`]
3275 - [`f64::copysign`]
3276 - [`RefCell::replace_with`]
3277 - [`RefCell::map_split`]
3278 - [`ptr::hash`]
3279 - [`Range::contains`]
3280 - [`RangeFrom::contains`]
3281 - [`RangeTo::contains`]
3282 - [`RangeInclusive::contains`]
3283 - [`RangeToInclusive::contains`]
3284 - [`Option::copied`]
3285
3286 Cargo
3287 -----
3288 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
3289   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
3290   platform specific.
3291
3292 Misc
3293 ----
3294 - [The Rust toolchain is now available natively for musl based distros.][58575]
3295
3296 [59460]: https://github.com/rust-lang/rust/pull/59460/
3297 [59464]: https://github.com/rust-lang/rust/pull/59464/
3298 [59500]: https://github.com/rust-lang/rust/pull/59500/
3299 [59512]: https://github.com/rust-lang/rust/pull/59512/
3300 [59580]: https://github.com/rust-lang/rust/pull/59580/
3301 [59283]: https://github.com/rust-lang/rust/pull/59283/
3302 [59451]: https://github.com/rust-lang/rust/pull/59451/
3303 [59076]: https://github.com/rust-lang/rust/pull/59076/
3304 [58778]: https://github.com/rust-lang/rust/pull/58778/
3305 [58717]: https://github.com/rust-lang/rust/pull/58717/
3306 [58369]: https://github.com/rust-lang/rust/pull/58369/
3307 [58423]: https://github.com/rust-lang/rust/pull/58423/
3308 [58080]: https://github.com/rust-lang/rust/pull/58080/
3309 [57847]: https://github.com/rust-lang/rust/pull/57847/
3310 [58575]: https://github.com/rust-lang/rust/pull/58575
3311 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
3312 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
3313 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
3314 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
3315 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
3316 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
3317 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
3318 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
3319 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
3320 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
3321 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
3322 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
3323
3324 Version 1.34.2 (2019-05-14)
3325 ===========================
3326
3327 * [Destabilize the `Error::type_id` function due to a security
3328    vulnerability][60785] ([CVE-2019-12083])
3329
3330 [60785]: https://github.com/rust-lang/rust/pull/60785
3331 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
3332
3333 Version 1.34.1 (2019-04-25)
3334 ===========================
3335
3336 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
3337 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
3338 * [Fix Clippy panic when checking some macros][clippy/3805]
3339
3340 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
3341 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
3342 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
3343
3344 Version 1.34.0 (2019-04-11)
3345 ==========================
3346
3347 Language
3348 --------
3349 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
3350   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
3351   but had no effect.
3352 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
3353   `#[attr{}]` procedural macros.][57367]
3354 - [You can now write `extern crate self as foo;`][57407] to import your
3355   crate's root into the extern prelude.
3356
3357
3358 Compiler
3359 --------
3360 - [You can now target `riscv64imac-unknown-none-elf` and
3361   `riscv64gc-unknown-none-elf`.][58406]
3362 - [You can now enable linker plugin LTO optimisations with
3363   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
3364   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
3365   boundaries.
3366 - [You can now target `powerpc64-unknown-freebsd`.][57809]
3367
3368
3369 Libraries
3370 ---------
3371 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
3372   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
3373   the `Hash` trait to create an iterator.
3374 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
3375   methods.][58421] Most notably you no longer require the `Ord` trait to create
3376   an iterator.
3377 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
3378   for all numeric types.][58044]
3379 - [Indexing a `str` is now generic over all types that
3380   implement `SliceIndex<str>`.][57604]
3381 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
3382   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
3383   produce a warning if their returning type is unused.
3384 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
3385   `overflowing_pow` are now available for all numeric types.][57873] These are
3386   equivalent to methods such as `wrapping_add` for the `pow` operation.
3387
3388
3389 Stabilized APIs
3390 ---------------
3391
3392 #### std & core
3393 * [`Any::type_id`]
3394 * [`Error::type_id`]
3395 * [`atomic::AtomicI16`]
3396 * [`atomic::AtomicI32`]
3397 * [`atomic::AtomicI64`]
3398 * [`atomic::AtomicI8`]
3399 * [`atomic::AtomicU16`]
3400 * [`atomic::AtomicU32`]
3401 * [`atomic::AtomicU64`]
3402 * [`atomic::AtomicU8`]
3403 * [`convert::Infallible`]
3404 * [`convert::TryFrom`]
3405 * [`convert::TryInto`]
3406 * [`iter::from_fn`]
3407 * [`iter::successors`]
3408 * [`num::NonZeroI128`]
3409 * [`num::NonZeroI16`]
3410 * [`num::NonZeroI32`]
3411 * [`num::NonZeroI64`]
3412 * [`num::NonZeroI8`]
3413 * [`num::NonZeroIsize`]
3414 * [`slice::sort_by_cached_key`]
3415 * [`str::escape_debug`]
3416 * [`str::escape_default`]
3417 * [`str::escape_unicode`]
3418 * [`str::split_ascii_whitespace`]
3419
3420 #### std
3421 * [`Instant::checked_add`]
3422 * [`Instant::checked_sub`]
3423 * [`SystemTime::checked_add`]
3424 * [`SystemTime::checked_sub`]
3425
3426 Cargo
3427 -----
3428 - [You can now use alternative registries to crates.io.][cargo/6654]
3429
3430 Misc
3431 ----
3432 - [You can now use the `?` operator in your documentation tests without manually
3433   adding `fn main() -> Result<(), _> {}`.][56470]
3434
3435 Compatibility Notes
3436 -------------------
3437 - [`Command::before_exec` is being replaced by the unsafe method
3438   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
3439 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
3440   can now use `const` functions in `static` variables.
3441
3442 [58370]: https://github.com/rust-lang/rust/pull/58370/
3443 [58406]: https://github.com/rust-lang/rust/pull/58406/
3444 [58421]: https://github.com/rust-lang/rust/pull/58421/
3445 [58166]: https://github.com/rust-lang/rust/pull/58166/
3446 [58044]: https://github.com/rust-lang/rust/pull/58044/
3447 [58057]: https://github.com/rust-lang/rust/pull/58057/
3448 [58059]: https://github.com/rust-lang/rust/pull/58059/
3449 [57809]: https://github.com/rust-lang/rust/pull/57809/
3450 [57873]: https://github.com/rust-lang/rust/pull/57873/
3451 [57604]: https://github.com/rust-lang/rust/pull/57604/
3452 [57367]: https://github.com/rust-lang/rust/pull/57367/
3453 [57407]: https://github.com/rust-lang/rust/pull/57407/
3454 [57425]: https://github.com/rust-lang/rust/pull/57425/
3455 [57106]: https://github.com/rust-lang/rust/pull/57106/
3456 [56470]: https://github.com/rust-lang/rust/pull/56470/
3457 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
3458 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
3459 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
3460 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
3461 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
3462 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
3463 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
3464 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
3465 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
3466 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
3467 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
3468 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
3469 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
3470 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
3471 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
3472 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
3473 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
3474 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
3475 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
3476 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
3477 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
3478 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
3479 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
3480 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
3481 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
3482 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
3483 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
3484 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
3485 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
3486 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
3487 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
3488
3489
3490 Version 1.33.0 (2019-02-28)
3491 ==========================
3492
3493 Language
3494 --------
3495 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
3496   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
3497 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
3498   E.g. You can have match statement on a `u8` that covers `0..=255` and
3499   you would no longer be required to have a `_ => unreachable!()` case.
3500 - [You can now have multiple patterns in `if let` and `while let`
3501   expressions.][57532] You can do this with the same syntax as a `match`
3502   expression. E.g.
3503   ```rust
3504   enum Creature {
3505       Crab(String),
3506       Lobster(String),
3507       Person(String),
3508   }
3509
3510   fn main() {
3511       let state = Creature::Crab("Ferris");
3512
3513       if let Creature::Crab(name) | Creature::Person(name) = state {
3514           println!("This creature's name is: {}", name);
3515       }
3516   }
3517   ```
3518 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
3519   this feature will by default produce a warning as this behaviour can be
3520   unintuitive. E.g. `if let _ = 5 {}`
3521 - [You can now use `let` bindings, assignments, expression statements,
3522   and irrefutable pattern destructuring in const functions.][57175]
3523 - [You can now call unsafe const functions.][57067] E.g.
3524   ```rust
3525   const unsafe fn foo() -> i32 { 5 }
3526   const fn bar() -> i32 {
3527       unsafe { foo() }
3528   }
3529   ```
3530 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
3531   E.g. `#[cfg_attr(all(), must_use, optimize)]`
3532 - [You can now specify a specific alignment with the `#[repr(packed)]`
3533   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
3534   with an alignment of 2 bytes and a size of 6 bytes.
3535 - [You can now import an item from a module as an `_`.][56303] This allows you to
3536   import a trait's impls, and not have the name in the namespace. E.g.
3537   ```rust
3538   use std::io::Read as _;
3539
3540   // Allowed as there is only one `Read` in the module.
3541   pub trait Read {}
3542   ```
3543 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
3544
3545 Compiler
3546 --------
3547 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
3548   command line argument.][56351]
3549 - [The minimum required LLVM version has been bumped to 6.0.][56642]
3550 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
3551 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
3552   tier 2 support.][57130] Visit the [platform support][platform-support] page for
3553   information on Rust's platform support.
3554 - [Added support for the `thumbv7neon-linux-androideabi` and
3555   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
3556 - [Added support for the `x86_64-unknown-uefi` target.][56769]
3557
3558 Libraries
3559 ---------
3560 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
3561   functions for all numeric types.][57566]
3562 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
3563   are now `const` functions for all numeric types.][57105]
3564 - [The methods `is_positive` and `is_negative` are now `const` functions for
3565   all signed numeric types.][57105]
3566 - [The `get` method for all `NonZero` types is now `const`.][57167]
3567 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
3568   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
3569   numeric types.][57234]
3570 - [`Ipv4Addr::new` is now a `const` function][57234]
3571
3572 Stabilized APIs
3573 ---------------
3574 - [`unix::FileExt::read_exact_at`]
3575 - [`unix::FileExt::write_all_at`]
3576 - [`Option::transpose`]
3577 - [`Result::transpose`]
3578 - [`convert::identity`]
3579 - [`pin::Pin`]
3580 - [`marker::Unpin`]
3581 - [`marker::PhantomPinned`]
3582 - [`Vec::resize_with`]
3583 - [`VecDeque::resize_with`]
3584 - [`Duration::as_millis`]
3585 - [`Duration::as_micros`]
3586 - [`Duration::as_nanos`]
3587
3588
3589 Cargo
3590 -----
3591 - [You can now publish crates that require a feature flag to compile with
3592   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
3593 - [Cargo should now rebuild a crate if a file was modified during the initial
3594   build.][cargo/6484]
3595
3596 Compatibility Notes
3597 -------------------
3598 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
3599   are now deprecated in the standard library, and their usage will now produce a warning.
3600   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
3601   methods instead.
3602 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
3603   downcasting.
3604 - [Libtest no longer creates a new thread for each test when
3605   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
3606
3607 [56243]: https://github.com/rust-lang/rust/pull/56243
3608 [56303]: https://github.com/rust-lang/rust/pull/56303/
3609 [56351]: https://github.com/rust-lang/rust/pull/56351/
3610 [56362]: https://github.com/rust-lang/rust/pull/56362
3611 [56642]: https://github.com/rust-lang/rust/pull/56642/
3612 [56769]: https://github.com/rust-lang/rust/pull/56769/
3613 [56805]: https://github.com/rust-lang/rust/pull/56805
3614 [56947]: https://github.com/rust-lang/rust/pull/56947/
3615 [57049]: https://github.com/rust-lang/rust/pull/57049/
3616 [57067]: https://github.com/rust-lang/rust/pull/57067/
3617 [57105]: https://github.com/rust-lang/rust/pull/57105
3618 [57130]: https://github.com/rust-lang/rust/pull/57130/
3619 [57167]: https://github.com/rust-lang/rust/pull/57167/
3620 [57175]: https://github.com/rust-lang/rust/pull/57175/
3621 [57234]: https://github.com/rust-lang/rust/pull/57234/
3622 [57332]: https://github.com/rust-lang/rust/pull/57332/
3623 [57465]: https://github.com/rust-lang/rust/pull/57465/
3624 [57532]: https://github.com/rust-lang/rust/pull/57532/
3625 [57535]: https://github.com/rust-lang/rust/pull/57535/
3626 [57566]: https://github.com/rust-lang/rust/pull/57566/
3627 [57615]: https://github.com/rust-lang/rust/pull/57615/
3628 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
3629 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
3630 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
3631 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
3632 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
3633 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
3634 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
3635 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
3636 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
3637 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
3638 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
3639 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
3640 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
3641 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
3642 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
3643 [platform-support]: https://forge.rust-lang.org/platform-support.html
3644
3645 Version 1.32.0 (2019-01-17)
3646 ==========================
3647
3648 Language
3649 --------
3650 #### 2018 edition
3651 - [You can now use the `?` operator in macro definitions.][56245] The `?`
3652   operator allows you to specify zero or one repetitions similar to the `*` and
3653   `+` operators.
3654 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
3655   now always resolve to the item (`enum`, `struct`, etc.) available in the
3656   module if present, before resolving to a external crate or an item the prelude.][56759]
3657   E.g.
3658   ```rust
3659   enum Color { Red, Green, Blue }
3660
3661   use Color::*;
3662   ```
3663
3664 #### All editions
3665 - [You can now match against `PhantomData<T>` types.][55837]
3666 - [You can now match against literals in macros with the `literal`
3667   specifier.][56072] This will match against a literal of any type.
3668   E.g. `1`, `'A'`, `"Hello World"`
3669 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
3670   ```rust
3671   struct Point(i32, i32);
3672
3673   impl Point {
3674       pub fn new(x: i32, y: i32) -> Self {
3675           Self(x, y)
3676       }
3677
3678       pub fn is_origin(&self) -> bool {
3679           match self {
3680               Self(0, 0) => true,
3681               _ => false,
3682           }
3683       }
3684   }
3685   ```
3686 - [Self can also now be used in type definitions.][56366] E.g.
3687   ```rust
3688   enum List<T>
3689   where
3690       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
3691   {
3692       Nil,
3693       Cons(T, Box<Self>) // likewise here
3694   }
3695   ```
3696 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
3697   a `impl Trait` or `dyn Trait` is returned and unused in the program.
3698
3699 Compiler
3700 --------
3701 - [The default allocator has changed from jemalloc to the default allocator on
3702   your system.][55238] The compiler itself on Linux & macOS will still use
3703   jemalloc, but programs compiled with it will use the system allocator.
3704 - [Added the `aarch64-pc-windows-msvc` target.][55702]
3705
3706 Libraries
3707 ---------
3708 - [`PathBuf` now implements `FromStr`.][55148]
3709 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
3710 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
3711   easily debug expressions in your rust program. E.g.
3712   ```rust
3713   let a = 2;
3714   let b = dbg!(a * 2) + 1;
3715   //      ^-- prints: [src/main.rs:4] a * 2 = 4
3716   assert_eq!(b, 5);
3717   ```
3718
3719 The following APIs are now `const` functions and can be used in a
3720 `const` context.
3721
3722 - [`Cell::as_ptr`]
3723 - [`UnsafeCell::get`]
3724 - [`char::is_ascii`]
3725 - [`iter::empty`]
3726 - [`ManuallyDrop::new`]
3727 - [`ManuallyDrop::into_inner`]
3728 - [`RangeInclusive::start`]
3729 - [`RangeInclusive::end`]
3730 - [`NonNull::as_ptr`]
3731 - [`slice::as_ptr`]
3732 - [`str::as_ptr`]
3733 - [`Duration::as_secs`]
3734 - [`Duration::subsec_millis`]
3735 - [`Duration::subsec_micros`]
3736 - [`Duration::subsec_nanos`]
3737 - [`CStr::as_ptr`]
3738 - [`Ipv4Addr::is_unspecified`]
3739 - [`Ipv6Addr::new`]
3740 - [`Ipv6Addr::octets`]
3741
3742 Stabilized APIs
3743 ---------------
3744 - [`i8::to_be_bytes`]
3745 - [`i8::to_le_bytes`]
3746 - [`i8::to_ne_bytes`]
3747 - [`i8::from_be_bytes`]
3748 - [`i8::from_le_bytes`]
3749 - [`i8::from_ne_bytes`]
3750 - [`i16::to_be_bytes`]
3751 - [`i16::to_le_bytes`]
3752 - [`i16::to_ne_bytes`]
3753 - [`i16::from_be_bytes`]
3754 - [`i16::from_le_bytes`]
3755 - [`i16::from_ne_bytes`]
3756 - [`i32::to_be_bytes`]
3757 - [`i32::to_le_bytes`]
3758 - [`i32::to_ne_bytes`]
3759 - [`i32::from_be_bytes`]
3760 - [`i32::from_le_bytes`]
3761 - [`i32::from_ne_bytes`]
3762 - [`i64::to_be_bytes`]
3763 - [`i64::to_le_bytes`]
3764 - [`i64::to_ne_bytes`]
3765 - [`i64::from_be_bytes`]
3766 - [`i64::from_le_bytes`]
3767 - [`i64::from_ne_bytes`]
3768 - [`i128::to_be_bytes`]
3769 - [`i128::to_le_bytes`]
3770 - [`i128::to_ne_bytes`]
3771 - [`i128::from_be_bytes`]
3772 - [`i128::from_le_bytes`]
3773 - [`i128::from_ne_bytes`]
3774 - [`isize::to_be_bytes`]
3775 - [`isize::to_le_bytes`]
3776 - [`isize::to_ne_bytes`]
3777 - [`isize::from_be_bytes`]
3778 - [`isize::from_le_bytes`]
3779 - [`isize::from_ne_bytes`]
3780 - [`u8::to_be_bytes`]
3781 - [`u8::to_le_bytes`]
3782 - [`u8::to_ne_bytes`]
3783 - [`u8::from_be_bytes`]
3784 - [`u8::from_le_bytes`]
3785 - [`u8::from_ne_bytes`]
3786 - [`u16::to_be_bytes`]
3787 - [`u16::to_le_bytes`]
3788 - [`u16::to_ne_bytes`]
3789 - [`u16::from_be_bytes`]
3790 - [`u16::from_le_bytes`]
3791 - [`u16::from_ne_bytes`]
3792 - [`u32::to_be_bytes`]
3793 - [`u32::to_le_bytes`]
3794 - [`u32::to_ne_bytes`]
3795 - [`u32::from_be_bytes`]
3796 - [`u32::from_le_bytes`]
3797 - [`u32::from_ne_bytes`]
3798 - [`u64::to_be_bytes`]
3799 - [`u64::to_le_bytes`]
3800 - [`u64::to_ne_bytes`]
3801 - [`u64::from_be_bytes`]
3802 - [`u64::from_le_bytes`]
3803 - [`u64::from_ne_bytes`]
3804 - [`u128::to_be_bytes`]
3805 - [`u128::to_le_bytes`]
3806 - [`u128::to_ne_bytes`]
3807 - [`u128::from_be_bytes`]
3808 - [`u128::from_le_bytes`]
3809 - [`u128::from_ne_bytes`]
3810 - [`usize::to_be_bytes`]
3811 - [`usize::to_le_bytes`]
3812 - [`usize::to_ne_bytes`]
3813 - [`usize::from_be_bytes`]
3814 - [`usize::from_le_bytes`]
3815 - [`usize::from_ne_bytes`]
3816
3817 Cargo
3818 -----
3819 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
3820 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
3821
3822 Misc
3823 ----
3824 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
3825
3826 Compatibility Notes
3827 -------------------
3828 - [The argument types for AVX's
3829   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
3830   been changed from `*const` to `*mut` as the previous implementation
3831   was unsound.
3832
3833
3834 [55148]: https://github.com/rust-lang/rust/pull/55148/
3835 [55238]: https://github.com/rust-lang/rust/pull/55238/
3836 [55280]: https://github.com/rust-lang/rust/pull/55280/
3837 [55610]: https://github.com/rust-lang/rust/pull/55610/
3838 [55663]: https://github.com/rust-lang/rust/pull/55663/
3839 [55702]: https://github.com/rust-lang/rust/pull/55702/
3840 [55837]: https://github.com/rust-lang/rust/pull/55837/
3841 [55843]: https://github.com/rust-lang/rust/pull/55843/
3842 [56072]: https://github.com/rust-lang/rust/pull/56072/
3843 [56245]: https://github.com/rust-lang/rust/pull/56245/
3844 [56365]: https://github.com/rust-lang/rust/pull/56365/
3845 [56366]: https://github.com/rust-lang/rust/pull/56366/
3846 [56395]: https://github.com/rust-lang/rust/pull/56395/
3847 [56759]: https://github.com/rust-lang/rust/pull/56759/
3848 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
3849 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
3850 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
3851 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
3852 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
3853 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3854 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3855 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
3856 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
3857 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
3858 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
3859 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
3860 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
3861 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
3862 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
3863 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
3864 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
3865 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
3866 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
3867 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
3868 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
3869 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
3870 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
3871 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
3872 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
3873 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
3874 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
3875 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
3876 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
3877 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
3878 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
3879 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
3880 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
3881 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
3882 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
3883 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
3884 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
3885 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
3886 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
3887 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
3888 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
3889 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
3890 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
3891 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
3892 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
3893 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
3894 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
3895 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
3896 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
3897 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
3898 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
3899 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
3900 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
3901 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
3902 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
3903 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
3904 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
3905 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
3906 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
3907 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
3908 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
3909 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
3910 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
3911 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
3912 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
3913 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
3914 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
3915 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
3916 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
3917 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
3918 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
3919 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
3920 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
3921 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
3922 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
3923 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
3924 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
3925 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
3926 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
3927 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
3928 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
3929 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
3930 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
3931 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
3932 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
3933 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
3934 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
3935 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
3936 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
3937 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
3938 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
3939 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
3940 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
3941
3942
3943 Version 1.31.1 (2018-12-20)
3944 ===========================
3945
3946 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
3947 - [Fix broken go-to-definition in RLS][rls/1171]
3948 - [Fix infinite loop on hover in RLS][rls/1170]
3949
3950 [56562]: https://github.com/rust-lang/rust/pull/56562
3951 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
3952 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
3953
3954 Version 1.31.0 (2018-12-06)
3955 ==========================
3956
3957 Language
3958 --------
3959 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
3960 - [New lifetime elision rules now allow for eliding lifetimes in functions and
3961   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
3962   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
3963   in structs.
3964 - [You can now define and use `const` functions.][54835] These are currently
3965   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
3966   [language reference][const-reference] for what exactly is available.
3967 - [You can now use tool lints, which allow you to scope lints from external
3968   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
3969 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
3970   a crate, not just in exported functions.][54451]
3971 - [You can now use parentheses in pattern matches.][54497]
3972
3973 Compiler
3974 --------
3975 - [Updated musl to 1.1.20][54430]
3976
3977 Libraries
3978 ---------
3979 - [You can now convert `num::NonZero*` types to their raw equivalents using the
3980   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
3981 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
3982   into `Option<&mut T>` using the `From` trait.][53218]
3983 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
3984
3985
3986 Stabilized APIs
3987 ---------------
3988 - [`slice::align_to`]
3989 - [`slice::align_to_mut`]
3990 - [`slice::chunks_exact`]
3991 - [`slice::chunks_exact_mut`]
3992 - [`slice::rchunks`]
3993 - [`slice::rchunks_mut`]
3994 - [`slice::rchunks_exact`]
3995 - [`slice::rchunks_exact_mut`]
3996 - [`Option::replace`]
3997
3998 Cargo
3999 -----
4000 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
4001 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
4002   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
4003
4004 [52813]: https://github.com/rust-lang/rust/pull/52813/
4005 [53218]: https://github.com/rust-lang/rust/pull/53218/
4006 [54057]: https://github.com/rust-lang/rust/pull/54057/
4007 [54240]: https://github.com/rust-lang/rust/pull/54240/
4008 [54430]: https://github.com/rust-lang/rust/pull/54430/
4009 [54451]: https://github.com/rust-lang/rust/pull/54451/
4010 [54497]: https://github.com/rust-lang/rust/pull/54497/
4011 [54778]: https://github.com/rust-lang/rust/pull/54778/
4012 [54835]: https://github.com/rust-lang/rust/pull/54835/
4013 [54870]: https://github.com/rust-lang/rust/pull/54870/
4014 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
4015 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
4016 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
4017 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
4018 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
4019 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
4020 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
4021 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
4022 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
4023 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
4024 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
4025 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
4026 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
4027 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
4028
4029 Version 1.30.1 (2018-11-08)
4030 ===========================
4031
4032 - [Fixed overflow ICE in rustdoc][54199]
4033 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
4034
4035 [54199]: https://github.com/rust-lang/rust/pull/54199
4036 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
4037
4038 Version 1.30.0 (2018-10-25)
4039 ==========================
4040
4041 Language
4042 --------
4043 - [Procedural macros are now available.][52081] These kinds of macros allow for
4044   more powerful code generation. There is a [new chapter available][proc-macros]
4045   in the Rust Programming Language book that goes further in depth.
4046 - [You can now use keywords as identifiers using the raw identifiers
4047   syntax (`r#`),][53236] e.g. `let r#for = true;`
4048 - [Using anonymous parameters in traits is now deprecated with a warning and
4049   will be a hard error in the 2018 edition.][53272]
4050 - [You can now use `crate` in paths.][54404] This allows you to refer to the
4051   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
4052 - [Using a external crate no longer requires being prefixed with `::`.][54404]
4053   Previously, using a external crate in a module without a use statement
4054   required `let json = ::serde_json::from_str(foo);` but can now be written
4055   as `let json = serde_json::from_str(foo);`.
4056 - [You can now apply the `#[used]` attribute to static items to prevent the
4057   compiler from optimising them away, even if they appear to be unused,][51363]
4058   e.g. `#[used] static FOO: u32 = 1;`
4059 - [You can now import and reexport macros from other crates with the `use`
4060   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
4061   the root module of the crate. If your macro relies on calling other local
4062   macros, it is recommended to export with the
4063   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
4064   those macros.
4065 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
4066   using the `vis` specifier.][53370]
4067 - [Non-macro attributes now allow all forms of literals, not just
4068   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
4069   write `#[attr(true)]`.
4070 - [You can now specify a function to handle a panic in the Rust runtime with the
4071   `#[panic_handler]` attribute.][51366]
4072
4073 Compiler
4074 --------
4075 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
4076 - [Added the `aarch64-unknown-netbsd` target][53165]
4077 - [Upgraded to LLVM 8.][53611]
4078
4079 Libraries
4080 ---------
4081 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
4082
4083 Stabilized APIs
4084 ---------------
4085 - [`Ipv4Addr::BROADCAST`]
4086 - [`Ipv4Addr::LOCALHOST`]
4087 - [`Ipv4Addr::UNSPECIFIED`]
4088 - [`Ipv6Addr::LOCALHOST`]
4089 - [`Ipv6Addr::UNSPECIFIED`]
4090 - [`Iterator::find_map`]
4091
4092   The following methods are replacement methods for `trim_left`, `trim_right`,
4093   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
4094   in 1.33.0:
4095 - [`str::trim_end_matches`]
4096 - [`str::trim_end`]
4097 - [`str::trim_start_matches`]
4098 - [`str::trim_start`]
4099
4100 Cargo
4101 ----
4102 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
4103 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
4104   equivalent to calling `rustdoc --error-format=json`.
4105 - [Cargo will now provide a progress bar for builds.][cargo/5995]
4106
4107 Misc
4108 ----
4109 - [`rustdoc` allows you to specify what edition to treat your code as with the
4110   `--edition` option.][54057]
4111 - [`rustdoc` now has the `--color` (specify whether to output color) and
4112   `--error-format` (specify error format, e.g. `json`) options.][53003]
4113 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
4114   debug symbols.][53774]
4115 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
4116   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
4117
4118 [50911]: https://github.com/rust-lang/rust/pull/50911/
4119 [51363]: https://github.com/rust-lang/rust/pull/51363/
4120 [51366]: https://github.com/rust-lang/rust/pull/51366/
4121 [52081]: https://github.com/rust-lang/rust/pull/52081/
4122 [53003]: https://github.com/rust-lang/rust/pull/53003/
4123 [53033]: https://github.com/rust-lang/rust/pull/53033/
4124 [53044]: https://github.com/rust-lang/rust/pull/53044/
4125 [53165]: https://github.com/rust-lang/rust/pull/53165/
4126 [53611]: https://github.com/rust-lang/rust/pull/53611/
4127 [53236]: https://github.com/rust-lang/rust/pull/53236/
4128 [53272]: https://github.com/rust-lang/rust/pull/53272/
4129 [53370]: https://github.com/rust-lang/rust/pull/53370/
4130 [53459]: https://github.com/rust-lang/rust/pull/53459/
4131 [53774]: https://github.com/rust-lang/rust/pull/53774/
4132 [53822]: https://github.com/rust-lang/rust/pull/53822/
4133 [54057]: https://github.com/rust-lang/rust/pull/54057/
4134 [54404]: https://github.com/rust-lang/rust/pull/54404/
4135 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
4136 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
4137 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
4138 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
4139
4140 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
4141 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
4142 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
4143 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
4144 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
4145 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
4146 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
4147 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
4148 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
4149 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
4150
4151
4152 Version 1.29.2 (2018-10-11)
4153 ===========================
4154
4155 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
4156 - The `rls-preview` component on the windows-gnu targets has been restored.
4157
4158 [54639]: https://github.com/rust-lang/rust/pull/54639
4159
4160
4161 Version 1.29.1 (2018-09-25)
4162 ===========================
4163
4164 Security Notes
4165 --------------
4166
4167 - The standard library's `str::repeat` function contained an out of bounds write
4168   caused by an integer overflow. This has been fixed by deterministically
4169   panicking when an overflow happens.
4170
4171   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
4172   us.
4173
4174
4175 Version 1.29.0 (2018-09-13)
4176 ==========================
4177
4178 Compiler
4179 --------
4180 - [Bumped minimum LLVM version to 5.0.][51899]
4181 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
4182 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
4183 - [Upgraded to LLVM 7.][51966]
4184
4185 Libraries
4186 ---------
4187 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
4188 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
4189 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
4190 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
4191   for `&str`.][51178]
4192 - [`Cell<T>` now allows `T` to be unsized.][50494]
4193 - [`SocketAddr` is now stable on Redox.][52656]
4194
4195 Stabilized APIs
4196 ---------------
4197 - [`Arc::downcast`]
4198 - [`Iterator::flatten`]
4199 - [`Rc::downcast`]
4200
4201 Cargo
4202 -----
4203 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
4204   `--locked` to disable this behavior.
4205 - [`cargo-install` will now allow you to cross compile an install
4206   using `--target`.][cargo/5614]
4207 - [Added the `cargo-fix` subcommand to automatically move project code from
4208   2015 edition to 2018.][cargo/5723]
4209 - [`cargo doc` can now optionally document private types using the
4210   `--document-private-items` flag.][cargo/5543]
4211
4212 Misc
4213 ----
4214 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
4215   the specified level to that level.][52354] For example `--cap-lints warn`
4216   will demote `deny` and `forbid` lints to `warn`.
4217 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
4218   fails and `101` if there is a panic.][52197]
4219 - [A preview of clippy has been made available through rustup.][51122]
4220   You can install the preview with `rustup component add clippy-preview`.
4221
4222 Compatibility Notes
4223 -------------------
4224 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
4225   Use `str::get_unchecked(begin..end)` instead.
4226 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
4227   Consider using the `home_dir` function from
4228   https://crates.io/crates/dirs instead.
4229 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
4230 - [`cfg` attributes and `--cfg` command line flags are now more
4231   strictly validated.][53893]
4232
4233 [53893]: https://github.com/rust-lang/rust/pull/53893/
4234 [52861]: https://github.com/rust-lang/rust/pull/52861/
4235 [51966]: https://github.com/rust-lang/rust/pull/51966/
4236 [52656]: https://github.com/rust-lang/rust/pull/52656/
4237 [52239]: https://github.com/rust-lang/rust/pull/52239/
4238 [52330]: https://github.com/rust-lang/rust/pull/52330/
4239 [52354]: https://github.com/rust-lang/rust/pull/52354/
4240 [52402]: https://github.com/rust-lang/rust/pull/52402/
4241 [52197]: https://github.com/rust-lang/rust/pull/52197/
4242 [51807]: https://github.com/rust-lang/rust/pull/51807/
4243 [51899]: https://github.com/rust-lang/rust/pull/51899/
4244 [51912]: https://github.com/rust-lang/rust/pull/51912/
4245 [51619]: https://github.com/rust-lang/rust/pull/51619/
4246 [51656]: https://github.com/rust-lang/rust/pull/51656/
4247 [51178]: https://github.com/rust-lang/rust/pull/51178/
4248 [51122]: https://github.com/rust-lang/rust/pull/51122
4249 [50494]: https://github.com/rust-lang/rust/pull/50494/
4250 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
4251 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
4252 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
4253 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
4254 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
4255 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
4256 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
4257
4258
4259 Version 1.28.0 (2018-08-02)
4260 ===========================
4261
4262 Language
4263 --------
4264 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
4265   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
4266   the inner type across Foreign Function Interface (FFI) boundaries.
4267 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
4268   and can now be used as identifiers.][51196]
4269 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
4270   stable.][51241] This will allow users to specify a global allocator for
4271   their program.
4272 - [Unit test functions marked with the `#[test]` attribute can now return
4273   `Result<(), E: Debug>` in addition to `()`.][51298]
4274 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
4275   allows macros to easily target lifetimes.
4276
4277 Compiler
4278 --------
4279 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
4280   prioritise making smaller binary sizes. `z` is the same as `s` with the
4281   exception that it does not vectorise loops, which typically results in an even
4282   smaller binary.
4283 - [The short error format is now stable.][49546] Specified with
4284   `--error-format=short` this option will provide a more compressed output of
4285   rust error messages.
4286 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
4287 - [Reduced the number of allocations in the macro parser.][50855] This can
4288   improve compile times of macro heavy crates on average by 5%.
4289
4290 Libraries
4291 ---------
4292 - [Implemented `Default` for `&mut str`.][51306]
4293 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
4294 - [Implemented `Extend` for `()`.][50234]
4295 - [The `Debug` implementation of `time::Duration` should now be more easily
4296   human readable.][50364] Previously a `Duration` of one second would printed as
4297   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
4298 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
4299   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
4300   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
4301   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
4302   for `PathBuf`.][50170]
4303 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
4304   and `Wrapping<i128>`.][50465]
4305 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
4306   possible.][51050] This can provide up to a 40% speed increase.
4307 - [Improved error messages when using `format!`.][50610]
4308
4309 Stabilized APIs
4310 ---------------
4311 - [`Iterator::step_by`]
4312 - [`Path::ancestors`]
4313 - [`SystemTime::UNIX_EPOCH`]
4314 - [`alloc::GlobalAlloc`]
4315 - [`alloc::Layout`]
4316 - [`alloc::LayoutErr`]
4317 - [`alloc::System`]
4318 - [`alloc::alloc`]
4319 - [`alloc::alloc_zeroed`]
4320 - [`alloc::dealloc`]
4321 - [`alloc::realloc`]
4322 - [`alloc::handle_alloc_error`]
4323 - [`btree_map::Entry::or_default`]
4324 - [`fmt::Alignment`]
4325 - [`hash_map::Entry::or_default`]
4326 - [`iter::repeat_with`]
4327 - [`num::NonZeroUsize`]
4328 - [`num::NonZeroU128`]
4329 - [`num::NonZeroU16`]
4330 - [`num::NonZeroU32`]
4331 - [`num::NonZeroU64`]
4332 - [`num::NonZeroU8`]
4333 - [`ops::RangeBounds`]
4334 - [`slice::SliceIndex`]
4335 - [`slice::from_mut`]
4336 - [`slice::from_ref`]
4337 - [`{Any + Send + Sync}::downcast_mut`]
4338 - [`{Any + Send + Sync}::downcast_ref`]
4339 - [`{Any + Send + Sync}::is`]
4340
4341 Cargo
4342 -----
4343 - [Cargo will now no longer allow you to publish crates with build scripts that
4344   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
4345   considered to be immutable.
4346
4347 Misc
4348 ----
4349 - [The `suggestion_applicability` field in `rustc`'s json output is now
4350   stable.][50486] This will allow dev tools to check whether a code suggestion
4351   would apply to them.
4352
4353 Compatibility Notes
4354 -------------------
4355 - [Rust will consider trait objects with duplicated constraints to be the same
4356   type as without the duplicated constraint.][51276] For example the below code will
4357   now fail to compile.
4358   ```rust
4359   trait Trait {}
4360
4361   impl Trait + Send {
4362       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
4363   }
4364
4365   impl Trait + Send + Send {
4366       fn test(&self) { println!("two"); }
4367   }
4368   ```
4369
4370 [49546]: https://github.com/rust-lang/rust/pull/49546/
4371 [50143]: https://github.com/rust-lang/rust/pull/50143/
4372 [50170]: https://github.com/rust-lang/rust/pull/50170/
4373 [50234]: https://github.com/rust-lang/rust/pull/50234/
4374 [50265]: https://github.com/rust-lang/rust/pull/50265/
4375 [50364]: https://github.com/rust-lang/rust/pull/50364/
4376 [50385]: https://github.com/rust-lang/rust/pull/50385/
4377 [50465]: https://github.com/rust-lang/rust/pull/50465/
4378 [50486]: https://github.com/rust-lang/rust/pull/50486/
4379 [50554]: https://github.com/rust-lang/rust/pull/50554/
4380 [50610]: https://github.com/rust-lang/rust/pull/50610/
4381 [50855]: https://github.com/rust-lang/rust/pull/50855/
4382 [51050]: https://github.com/rust-lang/rust/pull/51050/
4383 [51196]: https://github.com/rust-lang/rust/pull/51196/
4384 [51241]: https://github.com/rust-lang/rust/pull/51241/
4385 [51276]: https://github.com/rust-lang/rust/pull/51276/
4386 [51298]: https://github.com/rust-lang/rust/pull/51298/
4387 [51306]: https://github.com/rust-lang/rust/pull/51306/
4388 [51562]: https://github.com/rust-lang/rust/pull/51562/
4389 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
4390 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
4391 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
4392 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
4393 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
4394 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
4395 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
4396 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
4397 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
4398 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
4399 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
4400 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
4401 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
4402 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
4403 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
4404 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
4405 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
4406 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
4407 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
4408 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
4409 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
4410 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
4411 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
4412 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
4413 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
4414 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
4415 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
4416 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
4417 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
4418 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
4419
4420 Version 1.27.2 (2018-07-20)
4421 ===========================
4422
4423 Compatibility Notes
4424 -------------------
4425
4426 - The borrow checker was fixed to avoid potential unsoundness when using
4427   match ergonomics: [#52213][52213].
4428
4429 [52213]: https://github.com/rust-lang/rust/issues/52213
4430
4431 Version 1.27.1 (2018-07-10)
4432 ===========================
4433
4434 Security Notes
4435 --------------
4436
4437 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
4438   when running, which enabled executing code as some other user on a
4439   given machine. This release fixes that vulnerability; you can read
4440   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
4441
4442   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
4443
4444 Compatibility Notes
4445 -------------------
4446
4447 - The borrow checker was fixed to avoid an additional potential unsoundness when using
4448   match ergonomics: [#51415][51415], [#49534][49534].
4449
4450 [51415]: https://github.com/rust-lang/rust/issues/51415
4451 [49534]: https://github.com/rust-lang/rust/issues/49534
4452 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
4453 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
4454
4455 Version 1.27.0 (2018-06-21)
4456 ==========================
4457
4458 Language
4459 --------
4460 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
4461   be used as an identifier.
4462 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
4463   bare `Trait` syntax, and should make it clearer when being used in tandem with
4464   `impl Trait` because it is equivalent to the following syntax:
4465   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
4466   `Box<Trait> == Box<dyn Trait>`.
4467 - [Attributes on generic parameters such as types and lifetimes are
4468   now stable.][48851] e.g.
4469   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
4470 - [The `#[must_use]` attribute can now also be used on functions as well as
4471   types.][48925] It provides a lint that by default warns users when the
4472   value returned by a function has not been used.
4473
4474 Compiler
4475 --------
4476 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
4477
4478 Libraries
4479 ---------
4480 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
4481   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
4482   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
4483   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
4484   the `cfg` attribute.
4485 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
4486   std are now available in core.][49896]
4487 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
4488   to `Self`.][49630]
4489 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
4490   that the operation isn't done in place.
4491 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
4492   the `#[must_use]` attribute][49533] to warn about unused potentially
4493   expensive allocations.
4494
4495 Stabilized APIs
4496 ---------------
4497 - [`DoubleEndedIterator::rfind`]
4498 - [`DoubleEndedIterator::rfold`]
4499 - [`DoubleEndedIterator::try_rfold`]
4500 - [`Duration::from_micros`]
4501 - [`Duration::from_nanos`]
4502 - [`Duration::subsec_micros`]
4503 - [`Duration::subsec_millis`]
4504 - [`HashMap::remove_entry`]
4505 - [`Iterator::try_fold`]
4506 - [`Iterator::try_for_each`]
4507 - [`NonNull::cast`]
4508 - [`Option::filter`]
4509 - [`String::replace_range`]
4510 - [`Take::set_limit`]
4511 - [`hint::unreachable_unchecked`]
4512 - [`os::unix::process::parent_id`]
4513 - [`ptr::swap_nonoverlapping`]
4514 - [`slice::rsplit_mut`]
4515 - [`slice::rsplit`]
4516 - [`slice::swap_with_slice`]
4517
4518 Cargo
4519 -----
4520 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
4521   `readme`, and `repository` fields.][cargo/5386]
4522 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
4523 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
4524   a different directory than `target` for placing compilation artifacts.
4525 - [Cargo will be adding automatic target inference for binaries, benchmarks,
4526   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
4527   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
4528   where cargo would infer a binary, Cargo will produce a warning. You can
4529   disable this feature ahead of time by setting any of the following to false:
4530   `autobins`, `autobenches`, `autoexamples`, `autotests`.
4531 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
4532   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
4533
4534 Misc
4535 ----
4536 - [Added “The Rustc book” into the official documentation.][49707]
4537   [“The Rustc book”] documents and teaches how to use the rustc compiler.
4538 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
4539
4540 Compatibility Notes
4541 -------------------
4542 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
4543   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
4544   compile, `"".is_empty()` will still compile.
4545 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
4546   will only print the inner type.][48553] E.g.
4547   `print!("{:?}", AtomicBool::new(true))` will print `true`,
4548   not `AtomicBool(true)`.
4549 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
4550   could enter higher numbers but they were not supported by LLVM. Up to 512MB
4551   alignment should cover all use cases.
4552 - The `.description()` method on the `std::error::Error` trait
4553   [has been soft-deprecated][50163]. It is no longer required to implement it.
4554
4555 [48553]: https://github.com/rust-lang/rust/pull/48553/
4556 [48851]: https://github.com/rust-lang/rust/pull/48851/
4557 [48925]: https://github.com/rust-lang/rust/pull/48925/
4558 [49533]: https://github.com/rust-lang/rust/pull/49533/
4559 [49623]: https://github.com/rust-lang/rust/pull/49623/
4560 [49630]: https://github.com/rust-lang/rust/pull/49630/
4561 [49664]: https://github.com/rust-lang/rust/pull/49664/
4562 [49699]: https://github.com/rust-lang/rust/pull/49699/
4563 [49707]: https://github.com/rust-lang/rust/pull/49707/
4564 [49896]: https://github.com/rust-lang/rust/pull/49896/
4565 [49968]: https://github.com/rust-lang/rust/pull/49968/
4566 [50163]: https://github.com/rust-lang/rust/pull/50163
4567 [50177]: https://github.com/rust-lang/rust/pull/50177/
4568 [50378]: https://github.com/rust-lang/rust/pull/50378/
4569 [50423]: https://github.com/rust-lang/rust/pull/50423/
4570 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
4571 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
4572 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
4573 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
4574 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
4575 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
4576 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
4577 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
4578 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
4579 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
4580 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
4581 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
4582 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
4583 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
4584 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
4585 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
4586 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
4587 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
4588 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
4589 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
4590 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
4591 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4592 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
4593 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
4594 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
4595 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
4596 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
4597 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
4598 [“The Rustc book”]: https://doc.rust-lang.org/rustc
4599
4600
4601 Version 1.26.2 (2018-06-05)
4602 ==========================
4603
4604 Compatibility Notes
4605 -------------------
4606
4607 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
4608
4609 [51117]: https://github.com/rust-lang/rust/issues/51117
4610
4611
4612 Version 1.26.1 (2018-05-29)
4613 ==========================
4614
4615 Tools
4616 -----
4617
4618 - [RLS now works on Windows.][50646]
4619 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
4620
4621
4622 Compatibility Notes
4623 --------
4624
4625 - [`fn main() -> impl Trait` no longer works for non-Termination
4626   trait.][50656]
4627   This reverts an accidental stabilization.
4628 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
4629 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
4630
4631 [50646]: https://github.com/rust-lang/rust/issues/50646
4632 [50656]: https://github.com/rust-lang/rust/pull/50656
4633 [50812]: https://github.com/rust-lang/rust/pull/50812
4634 [50950]: https://github.com/rust-lang/rust/issues/50950
4635 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
4636
4637 Version 1.26.0 (2018-05-10)
4638 ==========================
4639
4640 Language
4641 --------
4642 - [Closures now implement `Copy` and/or `Clone` if all captured variables
4643   implement either or both traits.][49299]
4644 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
4645 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
4646   lifetime can be elided.][49458]
4647 - [`impl Trait` is now stable allowing you to have abstract types in returns
4648    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
4649   `fn open(path: impl AsRef<Path>)`.
4650 - [Pattern matching will now automatically apply dereferences.][49394]
4651 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
4652 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
4653 - [A lot of operations are now available in a const context.][46882] E.g. You
4654   can now index into constant arrays, reference and dereference into constants,
4655   and use tuple struct constructors.
4656 - [Fixed entry slice patterns are now stable.][48516] E.g.
4657   ```rust
4658   let points = [1, 2, 3, 4];
4659   match points {
4660       [1, 2, 3, 4] => println!("All points were sequential."),
4661       _ => println!("Not all points were sequential."),
4662   }
4663   ```
4664
4665
4666 Compiler
4667 --------
4668 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
4669 - [Fixed exponential projection complexity on nested types.][48296]
4670   This can provide up to a ~12% reduction in compile times for certain crates.
4671 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
4672   to remap path prefixes outputted by the compiler.
4673 - [Added `powerpc-unknown-netbsd` target.][48281]
4674
4675 Libraries
4676 ---------
4677 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
4678 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
4679   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
4680 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
4681 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
4682 - [`ascii::escape_default` is now available in libcore.][48735]
4683 - [Trailing commas are now supported in std and core macros.][48056]
4684 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
4685 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
4686
4687 Stabilized APIs
4688 ---------------
4689 - [`*const T::add`]
4690 - [`*const T::copy_to_nonoverlapping`]
4691 - [`*const T::copy_to`]
4692 - [`*const T::read_unaligned`]
4693 - [`*const T::read_volatile`]
4694 - [`*const T::read`]
4695 - [`*const T::sub`]
4696 - [`*const T::wrapping_add`]
4697 - [`*const T::wrapping_sub`]
4698 - [`*mut T::add`]
4699 - [`*mut T::copy_to_nonoverlapping`]
4700 - [`*mut T::copy_to`]
4701 - [`*mut T::read_unaligned`]
4702 - [`*mut T::read_volatile`]
4703 - [`*mut T::read`]
4704 - [`*mut T::replace`]
4705 - [`*mut T::sub`]
4706 - [`*mut T::swap`]
4707 - [`*mut T::wrapping_add`]
4708 - [`*mut T::wrapping_sub`]
4709 - [`*mut T::write_bytes`]
4710 - [`*mut T::write_unaligned`]
4711 - [`*mut T::write_volatile`]
4712 - [`*mut T::write`]
4713 - [`Box::leak`]
4714 - [`FromUtf8Error::as_bytes`]
4715 - [`LocalKey::try_with`]
4716 - [`Option::cloned`]
4717 - [`btree_map::Entry::and_modify`]
4718 - [`fs::read_to_string`]
4719 - [`fs::read`]
4720 - [`fs::write`]
4721 - [`hash_map::Entry::and_modify`]
4722 - [`iter::FusedIterator`]
4723 - [`ops::RangeInclusive`]
4724 - [`ops::RangeToInclusive`]
4725 - [`process::id`]
4726 - [`slice::rotate_left`]
4727 - [`slice::rotate_right`]
4728 - [`String::retain`]
4729
4730
4731 Cargo
4732 -----
4733 - [Cargo will now output path to custom commands when `-v` is
4734   passed with `--list`][cargo/5041]
4735 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
4736
4737 Misc
4738 ----
4739 - [The second edition of "The Rust Programming Language" book is now recommended
4740   over the first.][48404]
4741
4742 Compatibility Notes
4743 -------------------
4744
4745 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
4746   syntax is now invalid.
4747   ```
4748   use std::ops::Fn as dyn;
4749   fn g(_: Box<dyn(std::fmt::Debug)>) {}
4750   ```
4751 - [The result of dereferences are no longer promoted to `'static`.][47408]
4752   e.g.
4753   ```rust
4754   fn main() {
4755       const PAIR: &(i32, i32) = &(0, 1);
4756       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
4757   }
4758   ```
4759 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
4760 - [`".e0"` will now no longer parse as `0.0` and will instead cause
4761   an error.][48235]
4762 - [Removed hoedown from rustdoc.][48274]
4763 - [Bounds on higher-kinded lifetimes a hard error.][48326]
4764
4765 [46882]: https://github.com/rust-lang/rust/pull/46882
4766 [47379]: https://github.com/rust-lang/rust/pull/47379
4767 [47408]: https://github.com/rust-lang/rust/pull/47408
4768 [47813]: https://github.com/rust-lang/rust/pull/47813
4769 [48056]: https://github.com/rust-lang/rust/pull/48056
4770 [48125]: https://github.com/rust-lang/rust/pull/48125
4771 [48235]: https://github.com/rust-lang/rust/pull/48235
4772 [48274]: https://github.com/rust-lang/rust/pull/48274
4773 [48281]: https://github.com/rust-lang/rust/pull/48281
4774 [48296]: https://github.com/rust-lang/rust/pull/48296
4775 [48326]: https://github.com/rust-lang/rust/pull/48326
4776 [48359]: https://github.com/rust-lang/rust/pull/48359
4777 [48404]: https://github.com/rust-lang/rust/pull/48404
4778 [48481]: https://github.com/rust-lang/rust/pull/48481
4779 [48516]: https://github.com/rust-lang/rust/pull/48516
4780 [48628]: https://github.com/rust-lang/rust/pull/48628
4781 [48629]: https://github.com/rust-lang/rust/pull/48629
4782 [48657]: https://github.com/rust-lang/rust/pull/48657
4783 [48735]: https://github.com/rust-lang/rust/pull/48735
4784 [48978]: https://github.com/rust-lang/rust/pull/48978
4785 [49101]: https://github.com/rust-lang/rust/pull/49101
4786 [49109]: https://github.com/rust-lang/rust/pull/49109
4787 [49162]: https://github.com/rust-lang/rust/pull/49162
4788 [49255]: https://github.com/rust-lang/rust/pull/49255
4789 [49299]: https://github.com/rust-lang/rust/pull/49299
4790 [49305]: https://github.com/rust-lang/rust/pull/49305
4791 [49394]: https://github.com/rust-lang/rust/pull/49394
4792 [49458]: https://github.com/rust-lang/rust/pull/49458
4793 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
4794 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
4795 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
4796 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
4797 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
4798 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
4799 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
4800 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
4801 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
4802 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
4803 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
4804 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
4805 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
4806 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
4807 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
4808 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
4809 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
4810 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
4811 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
4812 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
4813 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
4814 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
4815 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
4816 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
4817 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
4818 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
4819 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
4820 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
4821 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
4822 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
4823 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
4824 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
4825 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
4826 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
4827 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
4828 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
4829 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4830 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
4831 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
4832 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
4833 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
4834 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
4835
4836
4837 Version 1.25.0 (2018-03-29)
4838 ==========================
4839
4840 Language
4841 --------
4842 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
4843 - [You can now use nested groups of imports.][47948]
4844   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
4845 - [You can now have `|` at the start of a match arm.][47947] e.g.
4846 ```rust
4847 enum Foo { A, B, C }
4848
4849 fn main() {
4850     let x = Foo::A;
4851     match x {
4852         | Foo::A
4853         | Foo::B => println!("AB"),
4854         | Foo::C => println!("C"),
4855     }
4856 }
4857 ```
4858
4859 Compiler
4860 --------
4861 - [Upgraded to LLVM 6.][47828]
4862 - [Added `-C lto=val` option.][47521]
4863 - [Added `i586-unknown-linux-musl` target][47282]
4864
4865 Libraries
4866 ---------
4867 - [Impl Send for `process::Command` on Unix.][47760]
4868 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
4869 - [`UnsafeCell::into_inner` is now safe.][47204]
4870 - [Implement libstd for CloudABI.][47268]
4871 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
4872 - [Implement `AsRef<Path>` for Component][46985]
4873 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
4874 - [Moved `Duration` to libcore.][46666]
4875
4876 Stabilized APIs
4877 ---------------
4878 - [`Location::column`]
4879 - [`ptr::NonNull`]
4880
4881 The following functions can now be used in a constant expression.
4882 eg. `static MINUTE: Duration = Duration::from_secs(60);`
4883 - [`Duration::new`][47300]
4884 - [`Duration::from_secs`][47300]
4885 - [`Duration::from_millis`][47300]
4886
4887 Cargo
4888 -----
4889 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
4890 - [`cargo new` now defaults to creating a binary crate, instead of a
4891   library crate.][cargo/5029]
4892
4893 Misc
4894 ----
4895 - [Rust by example is now shipped with new releases][46196]
4896
4897 Compatibility Notes
4898 -------------------
4899 - [Deprecated `net::lookup_host`.][47510]
4900 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
4901 - The borrow checker was sometimes incorrectly permitting overlapping borrows
4902   around indexing operations (see [#47349][47349]). This has been fixed (which also
4903   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
4904 - [Removed deprecated unstable attribute `#[simd]`.][47251]
4905
4906 [33903]: https://github.com/rust-lang/rust/pull/33903
4907 [47947]: https://github.com/rust-lang/rust/pull/47947
4908 [47948]: https://github.com/rust-lang/rust/pull/47948
4909 [47760]: https://github.com/rust-lang/rust/pull/47760
4910 [47790]: https://github.com/rust-lang/rust/pull/47790
4911 [47828]: https://github.com/rust-lang/rust/pull/47828
4912 [47398]: https://github.com/rust-lang/rust/pull/47398
4913 [47510]: https://github.com/rust-lang/rust/pull/47510
4914 [47521]: https://github.com/rust-lang/rust/pull/47521
4915 [47204]: https://github.com/rust-lang/rust/pull/47204
4916 [47251]: https://github.com/rust-lang/rust/pull/47251
4917 [47268]: https://github.com/rust-lang/rust/pull/47268
4918 [47282]: https://github.com/rust-lang/rust/pull/47282
4919 [47300]: https://github.com/rust-lang/rust/pull/47300
4920 [47349]: https://github.com/rust-lang/rust/pull/47349
4921 [46931]: https://github.com/rust-lang/rust/pull/46931
4922 [46985]: https://github.com/rust-lang/rust/pull/46985
4923 [47006]: https://github.com/rust-lang/rust/pull/47006
4924 [46830]: https://github.com/rust-lang/rust/pull/46830
4925 [46095]: https://github.com/rust-lang/rust/pull/46095
4926 [46666]: https://github.com/rust-lang/rust/pull/46666
4927 [46196]: https://github.com/rust-lang/rust/pull/46196
4928 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
4929 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
4930 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
4931 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
4932 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
4933
4934
4935 Version 1.24.1 (2018-03-01)
4936 ==========================
4937
4938  - [Do not abort when unwinding through FFI][48251]
4939  - [Emit UTF-16 files for linker arguments on Windows][48318]
4940  - [Make the error index generator work again][48308]
4941  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
4942
4943 [48251]: https://github.com/rust-lang/rust/issues/48251
4944 [48308]: https://github.com/rust-lang/rust/issues/48308
4945 [48318]: https://github.com/rust-lang/rust/issues/48318
4946 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
4947
4948
4949 Version 1.24.0 (2018-02-15)
4950 ==========================
4951
4952 Language
4953 --------
4954 - [External `sysv64` ffi is now available.][46528]
4955   eg. `extern "sysv64" fn foo () {}`
4956
4957 Compiler
4958 --------
4959 - [rustc now uses 16 codegen units by default for release builds.][46910]
4960   For the fastest builds, utilize `codegen-units=1`.
4961 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
4962 - [Add `aarch64-unknown-openbsd` support][46760]
4963
4964 Libraries
4965 ---------
4966 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
4967   improvement in performance in the majority of cases.
4968 - [`OsStr`'s `Debug` implementation is now lossless and consistent
4969   with Windows.][46798]
4970 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
4971 - [impl `From<bool>` for `AtomicBool`][46293]
4972 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
4973 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
4974 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
4975 - [float::from_bits now just uses transmute.][46012] This provides
4976   some optimisations from LLVM.
4977 - [Copied `AsciiExt` methods onto `char`][46077]
4978 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
4979 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
4980 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
4981 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
4982
4983 Stabilized APIs
4984 ---------------
4985 - [`RefCell::replace`]
4986 - [`RefCell::swap`]
4987 - [`atomic::spin_loop_hint`]
4988
4989 The following functions can now be used in a constant expression.
4990 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
4991
4992 - [`AtomicBool::new`][46287]
4993 - [`AtomicUsize::new`][46287]
4994 - [`AtomicIsize::new`][46287]
4995 - [`AtomicPtr::new`][46287]
4996 - [`Cell::new`][46287]
4997 - [`{integer}::min_value`][46287]
4998 - [`{integer}::max_value`][46287]
4999 - [`mem::size_of`][46287]
5000 - [`mem::align_of`][46287]
5001 - [`ptr::null`][46287]
5002 - [`ptr::null_mut`][46287]
5003 - [`RefCell::new`][46287]
5004 - [`UnsafeCell::new`][46287]
5005
5006 Cargo
5007 -----
5008 - [Added a `workspace.default-members` config that
5009   overrides implied `--all` in virtual workspaces.][cargo/4743]
5010 - [Enable incremental by default on development builds.][cargo/4817] Also added
5011   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
5012   per-project or global basis respectively.
5013
5014 Misc
5015 ----
5016
5017 Compatibility Notes
5018 -------------------
5019 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
5020 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
5021   in accordance with IETF RFC 4291 §2.2.
5022 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
5023 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
5024   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
5025 - [Leading zeros in tuple struct members is now an error][47084]
5026 - [`column!()` macro is one-based instead of zero-based][46977]
5027 - [`fmt::Arguments` can no longer be shared across threads][45198]
5028 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
5029 - [Cargo sets a different working directory for the compiler][cargo/4788]
5030
5031 [44884]: https://github.com/rust-lang/rust/pull/44884
5032 [45198]: https://github.com/rust-lang/rust/pull/45198
5033 [45506]: https://github.com/rust-lang/rust/pull/45506
5034 [45990]: https://github.com/rust-lang/rust/pull/45990
5035 [46012]: https://github.com/rust-lang/rust/pull/46012
5036 [46077]: https://github.com/rust-lang/rust/pull/46077
5037 [46094]: https://github.com/rust-lang/rust/pull/46094
5038 [46284]: https://github.com/rust-lang/rust/pull/46284
5039 [46287]: https://github.com/rust-lang/rust/pull/46287
5040 [46293]: https://github.com/rust-lang/rust/pull/46293
5041 [46528]: https://github.com/rust-lang/rust/pull/46528
5042 [46671]: https://github.com/rust-lang/rust/pull/46671
5043 [46713]: https://github.com/rust-lang/rust/pull/46713
5044 [46735]: https://github.com/rust-lang/rust/pull/46735
5045 [46760]: https://github.com/rust-lang/rust/pull/46760
5046 [46798]: https://github.com/rust-lang/rust/pull/46798
5047 [46828]: https://github.com/rust-lang/rust/pull/46828
5048 [46831]: https://github.com/rust-lang/rust/pull/46831
5049 [46833]: https://github.com/rust-lang/rust/pull/46833
5050 [46910]: https://github.com/rust-lang/rust/pull/46910
5051 [46977]: https://github.com/rust-lang/rust/pull/46977
5052 [47018]: https://github.com/rust-lang/rust/pull/47018
5053 [47080]: https://github.com/rust-lang/rust/pull/47080
5054 [47084]: https://github.com/rust-lang/rust/pull/47084
5055 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
5056 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
5057 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
5058 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
5059 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
5060 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
5061
5062
5063 Version 1.23.0 (2018-01-04)
5064 ==========================
5065
5066 Language
5067 --------
5068 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
5069 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
5070   Which should fix some confusing errors in some operations.
5071
5072 Compiler
5073 --------
5074 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
5075   undefined behavior.][45920]
5076 - [rustc now suggests renaming import if names clash.][45660]
5077 - [Display errors/warnings correctly when there are zero-width or
5078   wide characters.][45711]
5079 - [rustc now avoids unnecessary copies of arguments that are
5080   simple bindings][45380] This should improve memory usage on average by 5-10%.
5081 - [Updated musl used to build musl rustc to 1.1.17][45393]
5082
5083 Libraries
5084 ---------
5085 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
5086 - [Implement Hash for raw pointers to unsized types][45483]
5087 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
5088 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
5089 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
5090 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
5091   and `<*mut T>::as_mut`][44932]
5092 - [Optimized `Thread::{park, unpark}` implementation][45524]
5093 - [Improved `SliceExt::binary_search` performance.][45333]
5094 - [impl `FromIterator<()>` for `()`][45379]
5095 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
5096   is now deprecated.
5097
5098 Stabilized APIs
5099 ---------------
5100
5101 Cargo
5102 -----
5103 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
5104   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
5105 - [Added unit test checking to `cargo check`][cargo/4592]
5106 - [Cargo now lets you install a specific version
5107   using `cargo install --version`][cargo/4637]
5108
5109 Misc
5110 ----
5111 - [Releases now ship with the Cargo book documentation.][45692]
5112 - [rustdoc now prints rendering warnings on every run.][45324]
5113
5114 Compatibility Notes
5115 -------------------
5116 - [Changes have been made to type equality to make it more correct,
5117   in rare cases this could break some code.][45853] [Tracking issue for
5118   further information][45852]
5119 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
5120 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
5121   Android 9, the minimum supported version is Android 14.
5122 - [Bumped the minimum LLVM to 3.9][45326]
5123
5124 [44042]: https://github.com/rust-lang/rust/pull/44042
5125 [44932]: https://github.com/rust-lang/rust/pull/44932
5126 [45267]: https://github.com/rust-lang/rust/pull/45267
5127 [45324]: https://github.com/rust-lang/rust/pull/45324
5128 [45326]: https://github.com/rust-lang/rust/pull/45326
5129 [45333]: https://github.com/rust-lang/rust/pull/45333
5130 [45379]: https://github.com/rust-lang/rust/pull/45379
5131 [45380]: https://github.com/rust-lang/rust/pull/45380
5132 [45393]: https://github.com/rust-lang/rust/pull/45393
5133 [45435]: https://github.com/rust-lang/rust/pull/45435
5134 [45483]: https://github.com/rust-lang/rust/pull/45483
5135 [45524]: https://github.com/rust-lang/rust/pull/45524
5136 [45571]: https://github.com/rust-lang/rust/pull/45571
5137 [45580]: https://github.com/rust-lang/rust/pull/45580
5138 [45610]: https://github.com/rust-lang/rust/pull/45610
5139 [45660]: https://github.com/rust-lang/rust/pull/45660
5140 [45692]: https://github.com/rust-lang/rust/pull/45692
5141 [45711]: https://github.com/rust-lang/rust/pull/45711
5142 [45772]: https://github.com/rust-lang/rust/pull/45772
5143 [45852]: https://github.com/rust-lang/rust/issues/45852
5144 [45853]: https://github.com/rust-lang/rust/pull/45853
5145 [45887]: https://github.com/rust-lang/rust/pull/45887
5146 [45920]: https://github.com/rust-lang/rust/pull/45920
5147 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
5148 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
5149 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
5150
5151
5152 Version 1.22.1 (2017-11-22)
5153 ==========================
5154
5155 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
5156
5157 [46183]: https://github.com/rust-lang/rust/pull/46183
5158
5159 Version 1.22.0 (2017-11-22)
5160 ==========================
5161
5162 Language
5163 --------
5164 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
5165 - [Now accepts underscores in unicode escapes][43716]
5166 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
5167 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
5168
5169 Compiler
5170 --------
5171 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
5172 - [rustc will no longer inline in codegen units when compiling for debug][45075]
5173   This should decrease compile times for debug builds.
5174 - [strict memory alignment now enabled on ARMv6][45094]
5175 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
5176
5177 Libraries
5178 ---------
5179 - [Allow atomic operations up to 32 bits
5180   on `armv5te_unknown_linux_gnueabi`][44978]
5181 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
5182 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
5183 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
5184 - [Properly detect overflow in `Instant += Duration`.][44220]
5185 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
5186 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
5187 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
5188
5189 Stabilized APIs
5190 ---------------
5191
5192 Cargo
5193 -----
5194 - [Cargo will now build multi file examples in subdirectories of the `examples`
5195   folder that have a `main.rs` file.][cargo/4496]
5196 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
5197   the old format will continue to work and can be updated with `cargo update`.
5198 - [Now supports vendoring git repositories][cargo/3992]
5199
5200 Misc
5201 ----
5202 - [`libbacktrace` is now available on Apple platforms.][44251]
5203 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
5204   This now lets you specify that a given code example will fail to compile.
5205
5206 Compatibility Notes
5207 -------------------
5208 - [The minimum Android version that rustc can build for has been bumped
5209   to `4.0` from `2.3`][45656]
5210 - [Allowing `T op= &T` for numeric types has broken some type
5211   inference cases][45480]
5212
5213
5214 [42526]: https://github.com/rust-lang/rust/pull/42526
5215 [43716]: https://github.com/rust-lang/rust/pull/43716
5216 [43949]: https://github.com/rust-lang/rust/pull/43949
5217 [44015]: https://github.com/rust-lang/rust/pull/44015
5218 [44220]: https://github.com/rust-lang/rust/pull/44220
5219 [44251]: https://github.com/rust-lang/rust/pull/44251
5220 [44287]: https://github.com/rust-lang/rust/pull/44287
5221 [44303]: https://github.com/rust-lang/rust/pull/44303
5222 [44456]: https://github.com/rust-lang/rust/pull/44456
5223 [44466]: https://github.com/rust-lang/rust/pull/44466
5224 [44895]: https://github.com/rust-lang/rust/pull/44895
5225 [44966]: https://github.com/rust-lang/rust/pull/44966
5226 [44978]: https://github.com/rust-lang/rust/pull/44978
5227 [45041]: https://github.com/rust-lang/rust/pull/45041
5228 [45064]: https://github.com/rust-lang/rust/pull/45064
5229 [45075]: https://github.com/rust-lang/rust/pull/45075
5230 [45094]: https://github.com/rust-lang/rust/pull/45094
5231 [45095]: https://github.com/rust-lang/rust/pull/45095
5232 [45480]: https://github.com/rust-lang/rust/issues/45480
5233 [45656]: https://github.com/rust-lang/rust/pull/45656
5234 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
5235 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
5236 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
5237
5238
5239
5240
5241
5242
5243 Version 1.21.0 (2017-10-12)
5244 ==========================
5245
5246 Language
5247 --------
5248 - [You can now use static references for literals.][43838]
5249   Example:
5250   ```rust
5251   fn main() {
5252       let x: &'static u32 = &0;
5253   }
5254   ```
5255 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
5256   Example:
5257   ```rust
5258   my_macro!(Vec<i32>::new); // Always worked
5259   my_macro!(Vec::<i32>::new); // Now works
5260   ```
5261
5262 Compiler
5263 --------
5264 - [Upgraded jemalloc to 4.5.0][43911]
5265 - [Enabled unwinding panics on Redox][43917]
5266 - [Now runs LLVM in parallel during translation phase.][43506]
5267   This should reduce peak memory usage.
5268
5269 Libraries
5270 ---------
5271 - [Generate builtin impls for `Clone` for all arrays and tuples that
5272   are `T: Clone`][43690]
5273 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
5274 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
5275   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
5276
5277 Stabilized APIs
5278 ---------------
5279
5280 [`std::mem::discriminant`]
5281
5282 Cargo
5283 -----
5284 - [You can now call `cargo install` with multiple package names][cargo/4216]
5285 - [Cargo commands inside a virtual workspace will now implicitly
5286   pass `--all`][cargo/4335]
5287 - [Added a `[patch]` section to `Cargo.toml` to handle
5288   prepublication dependencies][cargo/4123] [RFC 1969]
5289 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
5290   like patterns][cargo/4270]
5291 - [Added the `--all-targets` option][cargo/4400]
5292 - [Using required dependencies as a feature is now deprecated and emits
5293   a warning][cargo/4364]
5294
5295
5296 Misc
5297 ----
5298 - [Cargo docs are moving][43916]
5299   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
5300 - [The rustdoc book is now available][43863]
5301   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
5302 - [Added a preview of RLS has been made available through rustup][44204]
5303   Install with `rustup component add rls-preview`
5304 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
5305   Previously only showed `std::os::unix`.
5306
5307 Compatibility Notes
5308 -------------------
5309 - [Changes in method matching against higher-ranked types][43880] This may cause
5310   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
5311 - [rustc's JSON error output's byte position start at top of file.][42973]
5312   Was previously relative to the rustc's internal `CodeMap` struct which
5313   required the unstable library `libsyntax` to correctly use.
5314 - [`unused_results` lint no longer ignores booleans][43728]
5315
5316 [42565]: https://github.com/rust-lang/rust/pull/42565
5317 [42973]: https://github.com/rust-lang/rust/pull/42973
5318 [43348]: https://github.com/rust-lang/rust/pull/43348
5319 [43459]: https://github.com/rust-lang/rust/pull/43459
5320 [43506]: https://github.com/rust-lang/rust/pull/43506
5321 [43540]: https://github.com/rust-lang/rust/pull/43540
5322 [43690]: https://github.com/rust-lang/rust/pull/43690
5323 [43728]: https://github.com/rust-lang/rust/pull/43728
5324 [43838]: https://github.com/rust-lang/rust/pull/43838
5325 [43863]: https://github.com/rust-lang/rust/pull/43863
5326 [43880]: https://github.com/rust-lang/rust/pull/43880
5327 [43911]: https://github.com/rust-lang/rust/pull/43911
5328 [43916]: https://github.com/rust-lang/rust/pull/43916
5329 [43917]: https://github.com/rust-lang/rust/pull/43917
5330 [44204]: https://github.com/rust-lang/rust/pull/44204
5331 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
5332 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
5333 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5334 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
5335 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
5336 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
5337 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
5338 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
5339 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
5340
5341 Version 1.20.0 (2017-08-31)
5342 ===========================
5343
5344 Language
5345 --------
5346 - [Associated constants are now stabilised.][42809]
5347 - [A lot of macro bugs are now fixed.][42913]
5348
5349 Compiler
5350 --------
5351
5352 - [Struct fields are now properly coerced to the expected field type.][42807]
5353 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
5354   `wasm32-experimental-emscripten` target.
5355 - [Changed some of the error messages to be more helpful.][42033]
5356 - [Add support for RELRO(RELocation Read-Only) for platforms that support
5357   it.][43170]
5358 - [rustc now reports the total number of errors on compilation failure][43015]
5359   previously this was only the number of errors in the pass that failed.
5360 - [Expansion in rustc has been sped up 29x.][42533]
5361 - [added `msp430-none-elf` target.][43099]
5362 - [rustc will now suggest one-argument enum variant to fix type mismatch when
5363   applicable][43178]
5364 - [Fixes backtraces on Redox][43228]
5365 - [rustc now identifies different versions of same crate when absolute paths of
5366   different types match in an error message.][42826]
5367
5368 Libraries
5369 ---------
5370
5371
5372 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
5373 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
5374   tuples.][43011]
5375 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
5376   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
5377 - [Impl `Clone` for `DefaultHasher`.][42799]
5378 - [Impl `Sync` for `SyncSender`.][42397]
5379 - [Impl `FromStr` for `char`][42271]
5380 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
5381   NaN.][42431]
5382 - [allow messages in the `unimplemented!()` macro.][42155]
5383   ie. `unimplemented!("Waiting for 1.21 to be stable")`
5384 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
5385 - [Upgrade to Unicode 10.0.0][42999]
5386 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
5387 - [Skip the main thread's manual stack guard on Linux][43072]
5388 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in *O*(1) time][43077]
5389 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
5390   previously 2^15.
5391 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
5392
5393 Stabilized APIs
5394 ---------------
5395
5396 - [`CStr::into_c_string`]
5397 - [`CString::as_c_str`]
5398 - [`CString::into_boxed_c_str`]
5399 - [`Chain::get_mut`]
5400 - [`Chain::get_ref`]
5401 - [`Chain::into_inner`]
5402 - [`Option::get_or_insert_with`]
5403 - [`Option::get_or_insert`]
5404 - [`OsStr::into_os_string`]
5405 - [`OsString::into_boxed_os_str`]
5406 - [`Take::get_mut`]
5407 - [`Take::get_ref`]
5408 - [`Utf8Error::error_len`]
5409 - [`char::EscapeDebug`]
5410 - [`char::escape_debug`]
5411 - [`compile_error!`]
5412 - [`f32::from_bits`]
5413 - [`f32::to_bits`]
5414 - [`f64::from_bits`]
5415 - [`f64::to_bits`]
5416 - [`mem::ManuallyDrop`]
5417 - [`slice::sort_unstable_by_key`]
5418 - [`slice::sort_unstable_by`]
5419 - [`slice::sort_unstable`]
5420 - [`str::from_boxed_utf8_unchecked`]
5421 - [`str::as_bytes_mut`]
5422 - [`str::as_bytes_mut`]
5423 - [`str::from_utf8_mut`]
5424 - [`str::from_utf8_unchecked_mut`]
5425 - [`str::get_mut`]
5426 - [`str::get_unchecked_mut`]
5427 - [`str::get_unchecked`]
5428 - [`str::get`]
5429 - [`str::into_boxed_bytes`]
5430
5431
5432 Cargo
5433 -----
5434 - [Cargo API token location moved from `~/.cargo/config` to
5435   `~/.cargo/credentials`.][cargo/3978]
5436 - [Cargo will now build `main.rs` binaries that are in sub-directories of
5437   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
5438   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
5439 - [You can now specify version of a binary when installed through
5440   `cargo install` using `--vers`.][cargo/4229]
5441 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
5442   failure.][cargo/4248]
5443 - [Changed the convention around which file is the crate root.][cargo/4259]
5444
5445 Compatibility Notes
5446 -------------------
5447
5448 - [Functions with `'static` in their return types will now not be as usable as
5449   if they were using lifetime parameters instead.][42417]
5450 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
5451   takes the sign of NaN into account where previously didn't.][42430]
5452
5453 [42033]: https://github.com/rust-lang/rust/pull/42033
5454 [42155]: https://github.com/rust-lang/rust/pull/42155
5455 [42271]: https://github.com/rust-lang/rust/pull/42271
5456 [42397]: https://github.com/rust-lang/rust/pull/42397
5457 [42417]: https://github.com/rust-lang/rust/pull/42417
5458 [42430]: https://github.com/rust-lang/rust/pull/42430
5459 [42431]: https://github.com/rust-lang/rust/pull/42431
5460 [42533]: https://github.com/rust-lang/rust/pull/42533
5461 [42571]: https://github.com/rust-lang/rust/pull/42571
5462 [42613]: https://github.com/rust-lang/rust/pull/42613
5463 [42799]: https://github.com/rust-lang/rust/pull/42799
5464 [42807]: https://github.com/rust-lang/rust/pull/42807
5465 [42809]: https://github.com/rust-lang/rust/pull/42809
5466 [42822]: https://github.com/rust-lang/rust/pull/42822
5467 [42826]: https://github.com/rust-lang/rust/pull/42826
5468 [42854]: https://github.com/rust-lang/rust/pull/42854
5469 [42913]: https://github.com/rust-lang/rust/pull/42913
5470 [42999]: https://github.com/rust-lang/rust/pull/42999
5471 [43011]: https://github.com/rust-lang/rust/pull/43011
5472 [43015]: https://github.com/rust-lang/rust/pull/43015
5473 [43072]: https://github.com/rust-lang/rust/pull/43072
5474 [43077]: https://github.com/rust-lang/rust/pull/43077
5475 [43097]: https://github.com/rust-lang/rust/pull/43097
5476 [43099]: https://github.com/rust-lang/rust/pull/43099
5477 [43170]: https://github.com/rust-lang/rust/pull/43170
5478 [43178]: https://github.com/rust-lang/rust/pull/43178
5479 [43185]: https://github.com/rust-lang/rust/pull/43185
5480 [43228]: https://github.com/rust-lang/rust/pull/43228
5481 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
5482 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
5483 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
5484 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
5485 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
5486 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
5487 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
5488 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
5489 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
5490 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
5491 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
5492 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
5493 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
5494 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
5495 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
5496 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
5497 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
5498 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
5499 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
5500 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
5501 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
5502 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
5503 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
5504 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
5505 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
5506 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
5507 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
5508 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
5509 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
5510 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
5511 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
5512 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
5513 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
5514 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
5515 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
5516 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
5517 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
5518 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
5519
5520
5521 Version 1.19.0 (2017-07-20)
5522 ===========================
5523
5524 Language
5525 --------
5526
5527 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
5528   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
5529 - [Macro recursion limit increased to 1024 from 64.][41676]
5530 - [Added lint for detecting unused macros.][41907]
5531 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
5532   For example: `let x = loop { break 7; };`
5533 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
5534   contain `Copy` types and cannot have a `Drop` implementation.
5535   Example: `union Foo { bar: u8, baz: usize }`
5536 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
5537   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
5538
5539 Compiler
5540 --------
5541
5542 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
5543 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
5544   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
5545   you should use `--target armv7-linux-androideabi`.
5546 - [Fixed ICE when removing a source file between compilation sessions.][41873]
5547 - [Minor optimisation of string operations.][42037]
5548 - [Compiler error message is now `aborting due to previous error(s)` instead of
5549   `aborting due to N previous errors`][42150] This was previously inaccurate and
5550   would only count certain kinds of errors.
5551 - [The compiler now supports Visual Studio 2017][42225]
5552 - [The compiler is now built against LLVM 4.0.1 by default][42948]
5553 - [Added a lot][42264] of [new error codes][42302]
5554 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
5555   libraries with C Run-time Libraries(CRT) to be statically linked.
5556 - [Fixed various ARM codegen bugs][42740]
5557
5558 Libraries
5559 ---------
5560
5561 - [`String` now implements `FromIterator<Cow<'a, str>>` and
5562   `Extend<Cow<'a, str>>`][41449]
5563 - [`Vec` now implements `From<&mut [T]>`][41530]
5564 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
5565 - [`SplitWhitespace` now implements `Clone`][41659]
5566 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
5567   1.5x faster][41764]
5568 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
5569   macros, but for printing to stderr.
5570
5571 Stabilized APIs
5572 ---------------
5573
5574 - [`OsString::shrink_to_fit`]
5575 - [`cmp::Reverse`]
5576 - [`Command::envs`]
5577 - [`thread::ThreadId`]
5578
5579 Cargo
5580 -----
5581
5582 - [Build scripts can now add environment variables to the environment
5583   the crate is being compiled in.
5584   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
5585 - [Subcommands now replace the current process rather than spawning a new
5586   child process][cargo/3970]
5587 - [Workspace members can now accept glob file patterns][cargo/3979]
5588 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
5589   the members in a given workspace.][cargo/3988]
5590 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
5591 - [Target directory path is now in the cargo metadata][cargo/4022]
5592 - [Cargo no longer checks out a local working directory for the
5593   crates.io index][cargo/4026] This should provide smaller file size for the
5594   registry, and improve cloning times, especially on Windows machines.
5595 - [Added an `--exclude` option for excluding certain packages when using the
5596   `--all` option][cargo/4031]
5597 - [Cargo will now automatically retry when receiving a 5xx error
5598   from crates.io][cargo/4032]
5599 - [The `--features` option now accepts multiple comma or space
5600   delimited values.][cargo/4084]
5601 - [Added support for custom target specific runners][cargo/3954]
5602
5603 Misc
5604 ----
5605
5606 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
5607   Windows Debugger.
5608 - [Rust will now release XZ compressed packages][rust-installer/57]
5609 - [rustup will now prefer to download rust packages with
5610   XZ compression][rustup/1100] over GZip packages.
5611 - [Added the ability to escape `#` in rust documentation][41785] By adding
5612   additional `#`'s ie. `##` is now `#`
5613
5614 Compatibility Notes
5615 -------------------
5616
5617 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
5618 - [`-Z` flags are now no longer allowed to be used on the stable
5619   compiler.][41751] This has been a warning for a year previous to this.
5620 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
5621   longer works][42844]. Users should migrate to the built-in `check`
5622   command, which has been available since 1.16.
5623 - [Ending a float literal with `._` is now a hard error.
5624   Example: `42._` .][41946]
5625 - [Any use of a private `extern crate` outside of its module is now a
5626   hard error.][36886] This was previously a warning.
5627 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
5628   relative while the `::` prefix makes a path absolute, but was ignored and the
5629   path was relative regardless.
5630 - [Floating point constants in match patterns is now a hard error][36890]
5631   This was previously a warning.
5632 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
5633   match patterns is now a hard error][36891] This was previously a warning.
5634 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
5635   a warning.
5636 - [From the pound escape, lines consisting of multiple `#`s are
5637   now visible][41785]
5638 - [It is an error to re-export private enum variants][42460]. This is
5639   known to break a number of crates that depend on an older version of
5640   mustache.
5641 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
5642   to use it to find the linker, and the build will fail where it did
5643   not previously][42607]
5644
5645 [36886]: https://github.com/rust-lang/rust/issues/36886
5646 [36888]: https://github.com/rust-lang/rust/issues/36888
5647 [36890]: https://github.com/rust-lang/rust/issues/36890
5648 [36891]: https://github.com/rust-lang/rust/issues/36891
5649 [36892]: https://github.com/rust-lang/rust/issues/36892
5650 [37406]: https://github.com/rust-lang/rust/issues/37406
5651 [39983]: https://github.com/rust-lang/rust/pull/39983
5652 [41145]: https://github.com/rust-lang/rust/pull/41145
5653 [41192]: https://github.com/rust-lang/rust/pull/41192
5654 [41258]: https://github.com/rust-lang/rust/pull/41258
5655 [41370]: https://github.com/rust-lang/rust/pull/41370
5656 [41449]: https://github.com/rust-lang/rust/pull/41449
5657 [41530]: https://github.com/rust-lang/rust/pull/41530
5658 [41624]: https://github.com/rust-lang/rust/pull/41624
5659 [41656]: https://github.com/rust-lang/rust/pull/41656
5660 [41659]: https://github.com/rust-lang/rust/pull/41659
5661 [41676]: https://github.com/rust-lang/rust/pull/41676
5662 [41751]: https://github.com/rust-lang/rust/pull/41751
5663 [41764]: https://github.com/rust-lang/rust/pull/41764
5664 [41785]: https://github.com/rust-lang/rust/pull/41785
5665 [41873]: https://github.com/rust-lang/rust/pull/41873
5666 [41907]: https://github.com/rust-lang/rust/pull/41907
5667 [41946]: https://github.com/rust-lang/rust/pull/41946
5668 [42016]: https://github.com/rust-lang/rust/pull/42016
5669 [42037]: https://github.com/rust-lang/rust/pull/42037
5670 [42068]: https://github.com/rust-lang/rust/pull/42068
5671 [42150]: https://github.com/rust-lang/rust/pull/42150
5672 [42162]: https://github.com/rust-lang/rust/pull/42162
5673 [42225]: https://github.com/rust-lang/rust/pull/42225
5674 [42264]: https://github.com/rust-lang/rust/pull/42264
5675 [42302]: https://github.com/rust-lang/rust/pull/42302
5676 [42460]: https://github.com/rust-lang/rust/issues/42460
5677 [42607]: https://github.com/rust-lang/rust/issues/42607
5678 [42740]: https://github.com/rust-lang/rust/pull/42740
5679 [42844]: https://github.com/rust-lang/rust/issues/42844
5680 [42948]: https://github.com/rust-lang/rust/pull/42948
5681 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
5682 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
5683 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
5684 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
5685 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
5686 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
5687 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
5688 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
5689 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
5690 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
5691 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
5692 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
5693 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
5694 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
5695 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
5696 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
5697 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
5698 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
5699 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
5700 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
5701 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
5702 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
5703
5704
5705 Version 1.18.0 (2017-06-08)
5706 ===========================
5707
5708 Language
5709 --------
5710
5711 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
5712   make the item visible to just that module tree. Also accepts the keyword
5713   `crate` to make something public to the whole crate but not users of the
5714   library. Example: `pub(crate) mod utils;`. [RFC 1422].
5715 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
5716   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
5717 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
5718   types like `Write + Send`, trailing `+` are now supported in trait objects,
5719   and better error reporting for trait objects starting with `?Sized`.
5720 - [0e+10 is now a valid floating point literal][40589]
5721 - [Now warns if you bind a lifetime parameter to 'static][40734]
5722 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
5723   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
5724   representation in some cases.][40377]
5725
5726 Compiler
5727 --------
5728
5729 - [rustc can now emit mir with `--emit mir`][39891]
5730 - [Improved LLVM IR for trivial functions][40367]
5731 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
5732 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
5733   opportunities found through profiling
5734 - [Improved backtrace formatting when panicking][38165]
5735
5736 Libraries
5737 ---------
5738
5739 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
5740   iterator hasn't been advanced the original `Vec` is reassembled with no actual
5741   iteration or reallocation.
5742 - [Simplified HashMap Bucket interface][40561] provides performance
5743   improvements for iterating and cloning.
5744 - [Specialize Vec::from_elem to use calloc][40409]
5745 - [Fixed Race condition in fs::create_dir_all][39799]
5746 - [No longer caching stdio on Windows][40516]
5747 - [Optimized insertion sort in slice][40807] insertion sort in some cases
5748   2.50%~ faster and in one case now 12.50% faster.
5749 - [Optimized `AtomicBool::fetch_nand`][41143]
5750
5751 Stabilized APIs
5752 ---------------
5753
5754 - [`Child::try_wait`]
5755 - [`HashMap::retain`]
5756 - [`HashSet::retain`]
5757 - [`PeekMut::pop`]
5758 - [`TcpStream::peek`]
5759 - [`UdpSocket::peek`]
5760 - [`UdpSocket::peek_from`]
5761
5762 Cargo
5763 -----
5764
5765 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
5766   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
5767 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
5768 - [Added Android build support][cargo/3885]
5769 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
5770   of a certain type, for example `cargo build --bins` will build all
5771   binaries.
5772 - [Added support for haiku][cargo/3952]
5773
5774 Misc
5775 ----
5776
5777 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
5778 - [Rust now uses the official cross compiler for NetBSD][40612]
5779 - [rustdoc now accepts `#` at the start of files][40828]
5780 - [Fixed jemalloc support for musl][41168]
5781
5782 Compatibility Notes
5783 -------------------
5784
5785 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
5786   always placed after the sign if it exists and before the digits. With the `#`
5787   flag the zeroes are placed after the prefix and before the digits.
5788 - [Due to the struct field optimisation][40377], using `transmute` on structs
5789   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
5790   always been undefined behavior, but is now more likely to break in practice.
5791 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
5792   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
5793   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
5794 - [Overlapping inherent `impl`s are now a hard error][40728]
5795 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
5796 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
5797   `out.asm` and `out.ll` instead of only one of the filetypes.
5798 - [ calling a function that returns `Self` will no longer work][41805] when
5799   the size of `Self` cannot be statically determined.
5800 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
5801   this has caused a few regressions namely:
5802
5803   - Changed the link order of local static/dynamic libraries (respecting the
5804     order on given rather than having the compiler reorder).
5805   - Changed how MinGW is linked, native code linked to dynamic libraries
5806     may require manually linking to the gcc support library (for the native
5807     code itself)
5808
5809 [38165]: https://github.com/rust-lang/rust/pull/38165
5810 [39799]: https://github.com/rust-lang/rust/pull/39799
5811 [39891]: https://github.com/rust-lang/rust/pull/39891
5812 [40043]: https://github.com/rust-lang/rust/pull/40043
5813 [40241]: https://github.com/rust-lang/rust/pull/40241
5814 [40338]: https://github.com/rust-lang/rust/pull/40338
5815 [40367]: https://github.com/rust-lang/rust/pull/40367
5816 [40377]: https://github.com/rust-lang/rust/pull/40377
5817 [40409]: https://github.com/rust-lang/rust/pull/40409
5818 [40516]: https://github.com/rust-lang/rust/pull/40516
5819 [40556]: https://github.com/rust-lang/rust/pull/40556
5820 [40561]: https://github.com/rust-lang/rust/pull/40561
5821 [40589]: https://github.com/rust-lang/rust/pull/40589
5822 [40612]: https://github.com/rust-lang/rust/pull/40612
5823 [40723]: https://github.com/rust-lang/rust/pull/40723
5824 [40728]: https://github.com/rust-lang/rust/pull/40728
5825 [40731]: https://github.com/rust-lang/rust/pull/40731
5826 [40734]: https://github.com/rust-lang/rust/pull/40734
5827 [40805]: https://github.com/rust-lang/rust/pull/40805
5828 [40807]: https://github.com/rust-lang/rust/pull/40807
5829 [40828]: https://github.com/rust-lang/rust/pull/40828
5830 [40870]: https://github.com/rust-lang/rust/pull/40870
5831 [41085]: https://github.com/rust-lang/rust/pull/41085
5832 [41143]: https://github.com/rust-lang/rust/pull/41143
5833 [41168]: https://github.com/rust-lang/rust/pull/41168
5834 [41270]: https://github.com/rust-lang/rust/issues/41270
5835 [41469]: https://github.com/rust-lang/rust/pull/41469
5836 [41805]: https://github.com/rust-lang/rust/issues/41805
5837 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
5838 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
5839 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
5840 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
5841 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
5842 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
5843 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
5844 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
5845 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
5846 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
5847 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
5848 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
5849 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
5850 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
5851
5852
5853 Version 1.17.0 (2017-04-27)
5854 ===========================
5855
5856 Language
5857 --------
5858
5859 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
5860 * [Fields of structs may be initialized without duplicating the field/variable
5861   names][39761]. [RFC 1682]
5862 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
5863 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5864   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
5865   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
5866   `'b`. Soundness fix.
5867 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
5868 * [Static variables may contain references to other statics][40027]
5869
5870 Compiler
5871 --------
5872
5873 * [Exit quickly on only `--emit dep-info`][40336]
5874 * [Make `-C relocation-model` more correctly determine whether the linker
5875   creates a position-independent executable][40245]
5876 * [Add `-C overflow-checks` to directly control whether integer overflow
5877   panics][40037]
5878 * [The rustc type checker now checks items on demand instead of in a single
5879   in-order pass][40008]. This is mostly an internal refactoring in support of
5880   future work, including incremental type checking, but also resolves [RFC
5881   1647], allowing `Self` to appear in `impl` `where` clauses.
5882 * [Optimize vtable loads][39995]
5883 * [Turn off vectorization for Emscripten targets][39990]
5884 * [Provide suggestions for unknown macros imported with `use`][39953]
5885 * [Fix ICEs in path resolution][39939]
5886 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
5887 * [Add clearer error message using `&str + &str`][39116]
5888
5889 Stabilized APIs
5890 ---------------
5891
5892 * [`Arc::into_raw`]
5893 * [`Arc::from_raw`]
5894 * [`Arc::ptr_eq`]
5895 * [`Rc::into_raw`]
5896 * [`Rc::from_raw`]
5897 * [`Rc::ptr_eq`]
5898 * [`Ordering::then`]
5899 * [`Ordering::then_with`]
5900 * [`BTreeMap::range`]
5901 * [`BTreeMap::range_mut`]
5902 * [`collections::Bound`]
5903 * [`process::abort`]
5904 * [`ptr::read_unaligned`]
5905 * [`ptr::write_unaligned`]
5906 * [`Result::expect_err`]
5907 * [`Cell::swap`]
5908 * [`Cell::replace`]
5909 * [`Cell::into_inner`]
5910 * [`Cell::take`]
5911
5912 Libraries
5913 ---------
5914
5915 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
5916 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
5917 * [`String` implements `FromIterator<&char>`][40028]
5918 * `Box` [implements][40009] a number of new conversions:
5919   `From<Box<str>> for String`,
5920   `From<Box<[T]>> for Vec<T>`,
5921   `From<Box<CStr>> for CString`,
5922   `From<Box<OsStr>> for OsString`,
5923   `From<Box<Path>> for PathBuf`,
5924   `Into<Box<str>> for String`,
5925   `Into<Box<[T]>> for Vec<T>`,
5926   `Into<Box<CStr>> for CString`,
5927   `Into<Box<OsStr>> for OsString`,
5928   `Into<Box<Path>> for PathBuf`,
5929   `Default for Box<str>`,
5930   `Default for Box<CStr>`,
5931   `Default for Box<OsStr>`,
5932   `From<&CStr> for Box<CStr>`,
5933   `From<&OsStr> for Box<OsStr>`,
5934   `From<&Path> for Box<Path>`
5935 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
5936 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
5937 * [Slightly optimize `slice::sort`][39538]
5938 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
5939 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
5940   `Box<str>` implements `From<&str>`][39438]
5941 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
5942   `From<(I, u16)> where I: Into<IpAddr>`][39372]
5943 * [`format!` estimates the needed capacity before writing a string][39356]
5944 * [Support unprivileged symlink creation in Windows][38921]
5945 * [`PathBuf` implements `Default`][38764]
5946 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
5947 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
5948   and poor hash functions.
5949
5950 Cargo
5951 -----
5952
5953 * [Add `cargo check --all`][cargo/3731]
5954 * [Add an option to ignore SSL revocation checking][cargo/3699]
5955 * [Add `cargo run --package`][cargo/3691]
5956 * [Add `required_features`][cargo/3667]
5957 * [Assume `build.rs` is a build script][cargo/3664]
5958 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
5959
5960 Misc
5961 ----
5962
5963 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
5964   `rustbook`][39633]
5965 * [The "Unstable Book" documents nightly-only features][ubook]
5966 * [Improve the style of the sidebar in rustdoc output][40265]
5967 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
5968 * [Fix MSP430 breakage due to `i128`][40257]
5969 * [Preliminary Solaris/SPARCv9 support][39903]
5970 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
5971   run without installing the MSVC runtime.
5972 * [`rustdoc --test` includes file names in test names][39788]
5973 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
5974   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
5975 * [Initial support for `aarch64-unknown-freebsd`][39491]
5976 * [Initial support for `i686-unknown-netbsd`][39426]
5977 * [This release no longer includes the old makefile build system][39431]. Rust
5978   is built with a custom build system, written in Rust, and with Cargo.
5979 * [Add Debug implementations for libcollection structs][39002]
5980 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
5981 * [`--test-threads=0` produces an error][38945]
5982 * [`rustup` installs documentation by default][40526]
5983 * [The Rust source includes NatVis visualizations][39843]. These can be used by
5984   WinDbg and Visual Studio to improve the debugging experience.
5985
5986 Compatibility Notes
5987 -------------------
5988
5989 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
5990   workaround, either use MSVC 2015 or run vcvars.bat.
5991 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5992   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
5993   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
5994   fix.
5995 * [`format!` and `Display::to_string` panic if an underlying formatting
5996   implementation returns an error][40117]. Previously the error was silently
5997   ignored. It is incorrect for `write_fmt` to return an error when writing
5998   to a string.
5999 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
6000   crates were marked stable and could be accessed from the stable toolchain.
6001 * [Rust git source no longer includes vendored crates][39728]. Those that need
6002   to build with vendored crates should build from release tarballs.
6003 * [Fix inert attributes from `proc_macro_derives`][39572]
6004 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
6005   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
6006   build system.
6007 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
6008   existing code generally ignores the type of dead-code unless a type-hint is
6009   provided; this can cause surprising inference interactions particularly around
6010   defaulting. The new code uniformly ignores the result type of dead-code.
6011 * [Tuple-struct constructors with private fields are no longer visible][38932]
6012 * [Lifetime parameters that do not appear in the arguments are now considered
6013   early-bound][38897], resolving a soundness bug (#[32330]). The
6014   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
6015   April of 2016.
6016 * [rustdoc: fix doctests with non-feature crate attributes][38161]
6017 * [Make transmuting from fn item types to pointer-sized types a hard
6018   error][34198]
6019
6020 [27787]: https://github.com/rust-lang/rust/issues/27787
6021 [32330]: https://github.com/rust-lang/rust/issues/32330
6022 [34198]: https://github.com/rust-lang/rust/pull/34198
6023 [38161]: https://github.com/rust-lang/rust/pull/38161
6024 [38368]: https://github.com/rust-lang/rust/pull/38368
6025 [38584]: https://github.com/rust-lang/rust/issues/38584
6026 [38661]: https://github.com/rust-lang/rust/pull/38661
6027 [38764]: https://github.com/rust-lang/rust/pull/38764
6028 [38864]: https://github.com/rust-lang/rust/issues/38864
6029 [38897]: https://github.com/rust-lang/rust/pull/38897
6030 [38921]: https://github.com/rust-lang/rust/pull/38921
6031 [38932]: https://github.com/rust-lang/rust/pull/38932
6032 [38945]: https://github.com/rust-lang/rust/pull/38945
6033 [38981]: https://github.com/rust-lang/rust/pull/38981
6034 [39002]: https://github.com/rust-lang/rust/pull/39002
6035 [39116]: https://github.com/rust-lang/rust/pull/39116
6036 [39193]: https://github.com/rust-lang/rust/pull/39193
6037 [39265]: https://github.com/rust-lang/rust/pull/39265
6038 [39356]: https://github.com/rust-lang/rust/pull/39356
6039 [39372]: https://github.com/rust-lang/rust/pull/39372
6040 [39426]: https://github.com/rust-lang/rust/pull/39426
6041 [39431]: https://github.com/rust-lang/rust/pull/39431
6042 [39438]: https://github.com/rust-lang/rust/pull/39438
6043 [39440]: https://github.com/rust-lang/rust/pull/39440
6044 [39485]: https://github.com/rust-lang/rust/pull/39485
6045 [39491]: https://github.com/rust-lang/rust/pull/39491
6046 [39518]: https://github.com/rust-lang/rust/pull/39518
6047 [39538]: https://github.com/rust-lang/rust/pull/39538
6048 [39572]: https://github.com/rust-lang/rust/pull/39572
6049 [39633]: https://github.com/rust-lang/rust/pull/39633
6050 [39642]: https://github.com/rust-lang/rust/pull/39642
6051 [39728]: https://github.com/rust-lang/rust/pull/39728
6052 [39761]: https://github.com/rust-lang/rust/pull/39761
6053 [39788]: https://github.com/rust-lang/rust/pull/39788
6054 [39793]: https://github.com/rust-lang/rust/pull/39793
6055 [39837]: https://github.com/rust-lang/rust/pull/39837
6056 [39843]: https://github.com/rust-lang/rust/pull/39843
6057 [39851]: https://github.com/rust-lang/rust/pull/39851
6058 [39903]: https://github.com/rust-lang/rust/pull/39903
6059 [39939]: https://github.com/rust-lang/rust/pull/39939
6060 [39953]: https://github.com/rust-lang/rust/pull/39953
6061 [39960]: https://github.com/rust-lang/rust/pull/39960
6062 [39990]: https://github.com/rust-lang/rust/pull/39990
6063 [39995]: https://github.com/rust-lang/rust/pull/39995
6064 [40008]: https://github.com/rust-lang/rust/pull/40008
6065 [40009]: https://github.com/rust-lang/rust/pull/40009
6066 [40027]: https://github.com/rust-lang/rust/pull/40027
6067 [40028]: https://github.com/rust-lang/rust/pull/40028
6068 [40037]: https://github.com/rust-lang/rust/pull/40037
6069 [40117]: https://github.com/rust-lang/rust/pull/40117
6070 [40166]: https://github.com/rust-lang/rust/pull/40166
6071 [40245]: https://github.com/rust-lang/rust/pull/40245
6072 [40257]: https://github.com/rust-lang/rust/pull/40257
6073 [40261]: https://github.com/rust-lang/rust/pull/40261
6074 [40265]: https://github.com/rust-lang/rust/pull/40265
6075 [40319]: https://github.com/rust-lang/rust/pull/40319
6076 [40336]: https://github.com/rust-lang/rust/pull/40336
6077 [40526]: https://github.com/rust-lang/rust/pull/40526
6078 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
6079 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
6080 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
6081 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
6082 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
6083 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
6084 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
6085 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
6086 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
6087 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
6088 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
6089 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
6090 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
6091 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
6092 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
6093 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
6094 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
6095 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
6096 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
6097 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
6098 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
6099 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
6100 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
6101 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
6102 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
6103 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
6104 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
6105 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
6106 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
6107 [ubook]: https://doc.rust-lang.org/unstable-book/
6108
6109
6110 Version 1.16.0 (2017-03-16)
6111 ===========================
6112
6113 Language
6114 --------
6115
6116 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6117 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6118   match patterns][38069]
6119 * [Clean up semantics of `self` in an import list][38313]
6120 * [`Self` may appear in `impl` headers][38920]
6121 * [`Self` may appear in struct expressions][39282]
6122
6123 Compiler
6124 --------
6125
6126 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
6127   a `.rmeta` file containing only crate metadata][38571]. This can be
6128   used by tools like the Rust Language Service to perform
6129   metadata-only builds.
6130 * [Levenshtein based typo suggestions now work in most places, while
6131   previously they worked only for fields and sometimes for local
6132   variables][38927]. Together with the overhaul of "no
6133   resolution"/"unexpected resolution" errors (#[38154]) they result in
6134   large and systematic improvement in resolution diagnostics.
6135 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
6136   `U`][38670]
6137 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
6138 * [`rustc` no longer attempts to provide "consider using an explicit
6139   lifetime" suggestions][37057]. They were inaccurate.
6140
6141 Stabilized APIs
6142 ---------------
6143
6144 * [`VecDeque::truncate`]
6145 * [`VecDeque::resize`]
6146 * [`String::insert_str`]
6147 * [`Duration::checked_add`]
6148 * [`Duration::checked_sub`]
6149 * [`Duration::checked_div`]
6150 * [`Duration::checked_mul`]
6151 * [`str::replacen`]
6152 * [`str::repeat`]
6153 * [`SocketAddr::is_ipv4`]
6154 * [`SocketAddr::is_ipv6`]
6155 * [`IpAddr::is_ipv4`]
6156 * [`IpAddr::is_ipv6`]
6157 * [`Vec::dedup_by`]
6158 * [`Vec::dedup_by_key`]
6159 * [`Result::unwrap_or_default`]
6160 * [`<*const T>::wrapping_offset`]
6161 * [`<*mut T>::wrapping_offset`]
6162 * `CommandExt::creation_flags`
6163 * [`File::set_permissions`]
6164 * [`String::split_off`]
6165
6166 Libraries
6167 ---------
6168
6169 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
6170   their argument by `Borrow` parameter][37761]
6171 * [All public types in std implement `Debug`][38006]
6172 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
6173 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
6174 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6175   Windows][38274]
6176 * [std: Fix partial writes in `LineWriter`][38062]
6177 * [std: Clamp max read/write sizes on Unix][38622]
6178 * [Use more specific panic message for `&str` slicing errors][38066]
6179 * [`TcpListener::set_only_v6` is deprecated][38304]. This
6180   functionality cannot be achieved in std currently.
6181 * [`writeln!`, like `println!`, now accepts a form with no string
6182   or formatting arguments, to just print a newline][38469]
6183 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
6184 * [Reduce the size of static data in `std_unicode::tables`][38781]
6185 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
6186   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
6187   `Display`][38909]
6188 * [`Duration` implements `Sum`][38712]
6189 * [`String` implements `ToSocketAddrs`][39048]
6190
6191 Cargo
6192 -----
6193
6194 * [The `cargo check` command does a type check of a project without
6195   building it][cargo/3296]
6196 * [crates.io will display CI badges from Travis and AppVeyor, if
6197   specified in Cargo.toml][cargo/3546]
6198 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
6199 * [Compilation profiles accept integer values for `debug`, in addition
6200   to `true` and `false`. These are passed to `rustc` as the value to
6201   `-C debuginfo`][cargo/3534]
6202 * [Implement `cargo --version --verbose`][cargo/3604]
6203 * [All builds now output 'dep-info' build dependencies compatible with
6204   make and ninja][cargo/3557]
6205 * [Build all workspace members with `build --all`][cargo/3511]
6206 * [Document all workspace members with `doc --all`][cargo/3515]
6207 * [Path deps outside workspace are not members][cargo/3443]
6208
6209 Misc
6210 ----
6211
6212 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
6213   the path to the Rust implementation][38589]
6214 * [The `armv7-linux-androideabi` target no longer enables NEON
6215   extensions, per Google's ABI guide][38413]
6216 * [The stock standard library can be compiled for Redox OS][38401]
6217 * [Rust has initial SPARC support][38726]. Tier 3. No builds
6218   available.
6219 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
6220   builds available.
6221 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
6222
6223 Compatibility Notes
6224 -------------------
6225
6226 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6227   match patterns][38069]
6228 * In this release, references to uninhabited types can not be
6229   pattern-matched. This was accidentally allowed in 1.15.
6230 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6231 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6232   Windows][38274]
6233 * [Clean up semantics of `self` in an import list][38313]
6234 * Reimplemented lifetime elision. This change was almost entirely compatible
6235   with existing code, but it did close a number of small bugs and loopholes,
6236   as well as being more accepting in some other [cases][41105].
6237
6238 [37057]: https://github.com/rust-lang/rust/pull/37057
6239 [37761]: https://github.com/rust-lang/rust/pull/37761
6240 [38006]: https://github.com/rust-lang/rust/pull/38006
6241 [38051]: https://github.com/rust-lang/rust/pull/38051
6242 [38062]: https://github.com/rust-lang/rust/pull/38062
6243 [38622]: https://github.com/rust-lang/rust/pull/38622
6244 [38066]: https://github.com/rust-lang/rust/pull/38066
6245 [38069]: https://github.com/rust-lang/rust/pull/38069
6246 [38131]: https://github.com/rust-lang/rust/pull/38131
6247 [38154]: https://github.com/rust-lang/rust/pull/38154
6248 [38274]: https://github.com/rust-lang/rust/pull/38274
6249 [38304]: https://github.com/rust-lang/rust/pull/38304
6250 [38313]: https://github.com/rust-lang/rust/pull/38313
6251 [38327]: https://github.com/rust-lang/rust/pull/38327
6252 [38401]: https://github.com/rust-lang/rust/pull/38401
6253 [38413]: https://github.com/rust-lang/rust/pull/38413
6254 [38469]: https://github.com/rust-lang/rust/pull/38469
6255 [38559]: https://github.com/rust-lang/rust/pull/38559
6256 [38571]: https://github.com/rust-lang/rust/pull/38571
6257 [38580]: https://github.com/rust-lang/rust/pull/38580
6258 [38589]: https://github.com/rust-lang/rust/pull/38589
6259 [38670]: https://github.com/rust-lang/rust/pull/38670
6260 [38712]: https://github.com/rust-lang/rust/pull/38712
6261 [38726]: https://github.com/rust-lang/rust/pull/38726
6262 [38781]: https://github.com/rust-lang/rust/pull/38781
6263 [38798]: https://github.com/rust-lang/rust/pull/38798
6264 [38909]: https://github.com/rust-lang/rust/pull/38909
6265 [38920]: https://github.com/rust-lang/rust/pull/38920
6266 [38927]: https://github.com/rust-lang/rust/pull/38927
6267 [39048]: https://github.com/rust-lang/rust/pull/39048
6268 [39282]: https://github.com/rust-lang/rust/pull/39282
6269 [39379]: https://github.com/rust-lang/rust/pull/39379
6270 [41105]: https://github.com/rust-lang/rust/issues/41105
6271 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6272 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6273 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
6274 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
6275 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
6276 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
6277 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
6278 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
6279 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
6280 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
6281 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
6282 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
6283 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
6284 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
6285 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
6286 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
6287 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
6288 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
6289 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
6290 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
6291 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
6292 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
6293 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
6294 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
6295 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
6296 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
6297 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
6298 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
6299 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
6300
6301
6302 Version 1.15.1 (2017-02-09)
6303 ===========================
6304
6305 * [Fix IntoIter::as_mut_slice's signature][39466]
6306 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
6307
6308 [39466]: https://github.com/rust-lang/rust/pull/39466
6309 [39523]: https://github.com/rust-lang/rust/pull/39523
6310
6311
6312 Version 1.15.0 (2017-02-02)
6313 ===========================
6314
6315 Language
6316 --------
6317
6318 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
6319   stable. This allows popular code-generating crates like Serde and Diesel to
6320   work ergonomically. [RFC 1681].
6321 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
6322   with curly braces][36868]. Part of [RFC 1506].
6323 * [A number of minor changes to name resolution have been activated][37127].
6324   They add up to more consistent semantics, allowing for future evolution of
6325   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6326   details of what is different. The breaking changes here have been transitioned
6327   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6328 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
6329   bounds][38279]
6330 * [`?Sized` can be used in `where` clauses][37791]
6331 * [There is now a limit on the size of monomorphized types and it can be
6332   modified with the `#![type_size_limit]` crate attribute, similarly to
6333   the `#![recursion_limit]` attribute][37789]
6334
6335 Compiler
6336 --------
6337
6338 * [On Windows, the compiler will apply dllimport attributes when linking to
6339   extern functions][37973]. Additional attributes and flags can control which
6340   library kind is linked and its name. [RFC 1717].
6341 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6342 * [The `--test` flag works with procedural macro crates][38107]
6343 * [Fix `extern "aapcs" fn` ABI][37814]
6344 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
6345 * [The `format!` expander recognizes incorrect `printf` and shell-style
6346   formatting directives and suggests the correct format][37613].
6347 * [Only report one error for all unused imports in an import list][37456]
6348
6349 Compiler Performance
6350 --------------------
6351
6352 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
6353 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
6354 * [Don't clone in `UnificationTable::probe`][37848]
6355 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
6356 * [Use small vectors in type walker][37760]
6357 * [Macro expansion performance was improved][37701]
6358 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
6359 * [Replace FNV with a faster hash function][37229]
6360
6361 Stabilized APIs
6362 ---------------
6363
6364 * [`std::iter::Iterator::min_by`]
6365 * [`std::iter::Iterator::max_by`]
6366 * [`std::os::*::fs::FileExt`]
6367 * [`std::sync::atomic::Atomic*::get_mut`]
6368 * [`std::sync::atomic::Atomic*::into_inner`]
6369 * [`std::vec::IntoIter::as_slice`]
6370 * [`std::vec::IntoIter::as_mut_slice`]
6371 * [`std::sync::mpsc::Receiver::try_iter`]
6372 * [`std::os::unix::process::CommandExt::before_exec`]
6373 * [`std::rc::Rc::strong_count`]
6374 * [`std::rc::Rc::weak_count`]
6375 * [`std::sync::Arc::strong_count`]
6376 * [`std::sync::Arc::weak_count`]
6377 * [`std::char::encode_utf8`]
6378 * [`std::char::encode_utf16`]
6379 * [`std::cell::Ref::clone`]
6380 * [`std::io::Take::into_inner`]
6381
6382 Libraries
6383 ---------
6384
6385 * [The standard sorting algorithm has been rewritten for dramatic performance
6386   improvements][38192]. It is a hybrid merge sort, drawing influences from
6387   Timsort. Previously it was a naive merge sort.
6388 * [`Iterator::nth` no longer has a `Sized` bound][38134]
6389 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
6390   performance.
6391 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
6392   and `char_indices().last()`][37882]
6393 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
6394 * [Chinese characters display correctly in `fmt::Debug`][37855]
6395 * [Derive `Default` for `Duration`][37699]
6396 * [Support creation of anonymous pipes on WinXP/2k][37677]
6397 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
6398 * [Don't pass overlapped handles to processes][38835]
6399
6400 Cargo
6401 -----
6402
6403 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6404   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6405   should instead check the variable at runtime with `std::env`. That the value
6406   was set at build time was a bug, and incorrect when cross-compiling. This
6407   change is known to cause breakage.
6408 * [Add `--all` flag to `cargo test`][cargo/3221]
6409 * [Compile statically against the MSVC CRT][cargo/3363]
6410 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
6411 * [Link OpenSSL statically on OSX][cargo/3311]
6412 * [Apply new fingerprinting to build dir outputs][cargo/3310]
6413 * [Test for bad path overrides with summaries][cargo/3336]
6414 * [Require `cargo install --vers` to take a semver version][cargo/3338]
6415 * [Fix retrying crate downloads for network errors][cargo/3348]
6416 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
6417 * [Emit more info on --message-format=json][cargo/3319]
6418 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
6419 * [Don't ignore errors in workspace manifest][cargo/3409]
6420 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
6421
6422 Tooling
6423 -------
6424
6425 * [Test runners (binaries built with `--test`) now support a `--list` argument
6426   that lists the tests it contains][38185]
6427 * [Test runners now support a `--exact` argument that makes the test filter
6428   match exactly, instead of matching only a substring of the test name][38181]
6429 * [rustdoc supports a `--playground-url` flag][37763]
6430 * [rustdoc provides more details about `#[should_panic]` errors][37749]
6431
6432 Misc
6433 ----
6434
6435 * [The Rust build system is now written in Rust][37817]. The Makefiles may
6436   continue to be used in this release by passing `--disable-rustbuild` to the
6437   configure script, but they will be deleted soon. Note that the new build
6438   system uses a different on-disk layout that will likely affect any scripts
6439   building Rust.
6440 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
6441   releases.
6442 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
6443 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
6444   releases.
6445
6446 Compatibility Notes
6447 -------------------
6448
6449 * [A number of minor changes to name resolution have been activated][37127].
6450   They add up to more consistent semantics, allowing for future evolution of
6451   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6452   details of what is different. The breaking changes here have been transitioned
6453   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6454 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6455   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6456   should instead check the variable at runtime with `std::env`. That the value
6457   was set at build time was a bug, and incorrect when cross-compiling. This
6458   change is known to cause breakage.
6459 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
6460   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
6461   1.10 and is now an error by default. It will become a hard error in the near
6462   future.
6463 * [The semantics relating modules to file system directories are changing in
6464   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
6465   lint, which is a warning in this release, and will become a hard error in the
6466   future.
6467 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6468 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
6469   the underlying iterator][37834]
6470
6471 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
6472 [33685]: https://github.com/rust-lang/rust/issues/33685
6473 [36868]: https://github.com/rust-lang/rust/pull/36868
6474 [37127]: https://github.com/rust-lang/rust/pull/37127
6475 [37229]: https://github.com/rust-lang/rust/pull/37229
6476 [37456]: https://github.com/rust-lang/rust/pull/37456
6477 [37527]: https://github.com/rust-lang/rust/pull/37527
6478 [37602]: https://github.com/rust-lang/rust/pull/37602
6479 [37613]: https://github.com/rust-lang/rust/pull/37613
6480 [37615]: https://github.com/rust-lang/rust/pull/37615
6481 [37636]: https://github.com/rust-lang/rust/pull/37636
6482 [37627]: https://github.com/rust-lang/rust/pull/37627
6483 [37642]: https://github.com/rust-lang/rust/pull/37642
6484 [37677]: https://github.com/rust-lang/rust/pull/37677
6485 [37699]: https://github.com/rust-lang/rust/pull/37699
6486 [37701]: https://github.com/rust-lang/rust/pull/37701
6487 [37705]: https://github.com/rust-lang/rust/pull/37705
6488 [37749]: https://github.com/rust-lang/rust/pull/37749
6489 [37760]: https://github.com/rust-lang/rust/pull/37760
6490 [37763]: https://github.com/rust-lang/rust/pull/37763
6491 [37764]: https://github.com/rust-lang/rust/pull/37764
6492 [37789]: https://github.com/rust-lang/rust/pull/37789
6493 [37791]: https://github.com/rust-lang/rust/pull/37791
6494 [37814]: https://github.com/rust-lang/rust/pull/37814
6495 [37817]: https://github.com/rust-lang/rust/pull/37817
6496 [37834]: https://github.com/rust-lang/rust/pull/37834
6497 [37848]: https://github.com/rust-lang/rust/pull/37848
6498 [37855]: https://github.com/rust-lang/rust/pull/37855
6499 [37882]: https://github.com/rust-lang/rust/pull/37882
6500 [37888]: https://github.com/rust-lang/rust/pull/37888
6501 [37973]: https://github.com/rust-lang/rust/pull/37973
6502 [37979]: https://github.com/rust-lang/rust/pull/37979
6503 [38086]: https://github.com/rust-lang/rust/pull/38086
6504 [38107]: https://github.com/rust-lang/rust/pull/38107
6505 [38117]: https://github.com/rust-lang/rust/pull/38117
6506 [38134]: https://github.com/rust-lang/rust/pull/38134
6507 [38146]: https://github.com/rust-lang/rust/pull/38146
6508 [38181]: https://github.com/rust-lang/rust/pull/38181
6509 [38182]: https://github.com/rust-lang/rust/pull/38182
6510 [38185]: https://github.com/rust-lang/rust/pull/38185
6511 [38192]: https://github.com/rust-lang/rust/pull/38192
6512 [38279]: https://github.com/rust-lang/rust/pull/38279
6513 [38835]: https://github.com/rust-lang/rust/pull/38835
6514 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6515 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
6516 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
6517 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
6518 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
6519 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
6520 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
6521 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
6522 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
6523 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
6524 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
6525 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
6526 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
6527 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
6528 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
6529 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
6530 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
6531 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
6532 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
6533 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
6534 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
6535 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
6536 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
6537 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
6538 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
6539 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
6540 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
6541 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
6542 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
6543 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
6544 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
6545 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
6546 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
6547 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
6548 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
6549 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
6550 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
6551
6552
6553 Version 1.14.0 (2016-12-22)
6554 ===========================
6555
6556 Language
6557 --------
6558
6559 * [`..` matches multiple tuple fields in enum variants, structs
6560   and tuples][36843]. [RFC 1492].
6561 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
6562 * [`use *` and `use ::*` both glob-import from the crate root][37367]
6563 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
6564   dereferencing][36822]
6565
6566 Compiler
6567 --------
6568
6569 * [Mark enums with non-zero discriminant as non-zero][37224]
6570 * [Lower-case `static mut` names are linted like other
6571   statics and consts][37162]
6572 * [Fix ICE on some macros in const integer positions
6573    (e.g. `[u8; m!()]`)][36819]
6574 * [Improve error message and snippet for "did you mean `x`"][36798]
6575 * [Add a panic-strategy field to the target specification][36794]
6576 * [Include LLVM version in `--version --verbose`][37200]
6577
6578 Compile-time Optimizations
6579 --------------------------
6580
6581 * [Improve macro expansion performance][37569]
6582 * [Shrink `Expr_::ExprInlineAsm`][37445]
6583 * [Replace all uses of SHA-256 with BLAKE2b][37439]
6584 * [Reduce the number of bytes hashed by `IchHasher`][37427]
6585 * [Avoid more allocations when compiling html5ever][37373]
6586 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
6587 * [Avoid some allocations in the macro parser][37318]
6588 * [Use a faster deflate setting][37298]
6589 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
6590   during interning of slices][37270]
6591 * [Optimize `write_metadata`][37267]
6592 * [Don't process obligation forest cycles when stalled][37231]
6593 * [Avoid many `CrateConfig` clones][37161]
6594 * [Optimize `Substs::super_fold_with`][37108]
6595 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
6596 * [Speed up `plug_leaks`][36917]
6597
6598 Libraries
6599 ---------
6600
6601 * [`println!()`, with no arguments, prints newline][36825].
6602   Previously, an empty string was required to achieve the same.
6603 * [`Wrapping` impls standard binary and unary operators, as well as
6604    the `Sum` and `Product` iterators][37356]
6605 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
6606   Vec<T>`][37326]
6607 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
6608   `VecDeque` iterators][37315]
6609 * [Improve `SipHasher` performance on small values][37312]
6610 * [Add Iterator trait TrustedLen to enable better FromIterator /
6611   Extend][37306]
6612 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
6613 * [`ReadDir` implements `Debug`][37221]
6614 * [Implement `RefUnwindSafe` for atomic types][37178]
6615 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
6616 * [Avoid allocations in `Decoder::read_str`][37064]
6617 * [`io::Error` implements `From<io::ErrorKind>`][37037]
6618 * [Impl `Debug` for raw pointers to unsized data][36880]
6619 * [Don't reuse `HashMap` random seeds][37470]
6620 * [The internal memory layout of `HashMap` is more cache-friendly, for
6621   significant improvements in some operations][36692]
6622 * [`HashMap` uses less memory on 32-bit architectures][36595]
6623 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
6624
6625 Cargo
6626 -----
6627
6628 * [Expose rustc cfg values to build scripts][cargo/3243]
6629 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
6630 * [Fix passing --features when testing multiple packages][cargo/3280]
6631 * [Use a single profile set per workspace][cargo/3249]
6632 * [Load `replace` sections from lock files][cargo/3220]
6633 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
6634
6635 Tooling
6636 -------
6637
6638 * [rustup is the recommended Rust installation method][1.14rustup]
6639 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
6640   S390x. These are [tier 2] platforms and may have major defects. Follow the
6641   instructions on the website to install, or add the targets to an existing
6642   installation with `rustup target add`. The new target triples are:
6643   - `mips-unknown-linux-gnu`
6644   - `mipsel-unknown-linux-gnu`
6645   - `mips64-unknown-linux-gnuabi64`
6646   - `mips64el-unknown-linux-gnuabi64 `
6647   - `powerpc-unknown-linux-gnu`
6648   - `powerpc64-unknown-linux-gnu`
6649   - `powerpc64le-unknown-linux-gnu`
6650   - `s390x-unknown-linux-gnu `
6651 * This release includes target (std) builds for ARM Linux running MUSL
6652   libc. These are [tier 2] platforms and may have major defects. Add the
6653   following triples to an existing rustup installation with `rustup target add`:
6654   - `arm-unknown-linux-musleabi`
6655   - `arm-unknown-linux-musleabihf`
6656   - `armv7-unknown-linux-musleabihf`
6657 * This release includes [experimental support for WebAssembly][1.14wasm], via
6658   the `wasm32-unknown-emscripten` target. This target is known to have major
6659   defects. Please test, report, and fix.
6660 * rustup no longer installs documentation by default. Run `rustup
6661   component add rust-docs` to install.
6662 * [Fix line stepping in debugger][37310]
6663 * [Enable line number debuginfo in releases][37280]
6664
6665 Misc
6666 ----
6667
6668 * [Disable jemalloc on aarch64/powerpc/mips][37392]
6669 * [Add support for Fuchsia OS][37313]
6670 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
6671
6672 Compatibility Notes
6673 -------------------
6674
6675 * [A number of forward-compatibility lints used by the compiler
6676   to gradually introduce language changes have been converted
6677   to deny by default][36894]:
6678   - ["use of inaccessible extern crate erroneously allowed"][36886]
6679   - ["type parameter default erroneously allowed in invalid location"][36887]
6680   - ["detects super or self keywords at the beginning of global path"][36888]
6681   - ["two overlapping inherent impls define an item with the same name
6682     were erroneously allowed"][36889]
6683   - ["floating-point constants cannot be used in patterns"][36890]
6684   - ["constants of struct or enum type can only be used in a pattern if
6685      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
6686   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
6687 * [Prohibit patterns in trait methods without bodies][37378]
6688 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
6689 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
6690 * [The `$crate` macro variable is accepted in fewer locations][37213]
6691 * [Impls specifying extra region requirements beyond the trait
6692   they implement are rejected][37167]
6693 * [Enums may not be unsized][37111]. Unsized enums are intended to
6694   work but never have. For now they are forbidden.
6695 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
6696
6697 [tier 2]: https://forge.rust-lang.org/platform-support.html
6698 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
6699 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
6700 [36430]: https://github.com/rust-lang/rust/pull/36430
6701 [36595]: https://github.com/rust-lang/rust/pull/36595
6702 [36692]: https://github.com/rust-lang/rust/pull/36692
6703 [36767]: https://github.com/rust-lang/rust/pull/36767
6704 [36794]: https://github.com/rust-lang/rust/pull/36794
6705 [36798]: https://github.com/rust-lang/rust/pull/36798
6706 [36819]: https://github.com/rust-lang/rust/pull/36819
6707 [36822]: https://github.com/rust-lang/rust/pull/36822
6708 [36825]: https://github.com/rust-lang/rust/pull/36825
6709 [36843]: https://github.com/rust-lang/rust/pull/36843
6710 [36880]: https://github.com/rust-lang/rust/pull/36880
6711 [36886]: https://github.com/rust-lang/rust/issues/36886
6712 [36887]: https://github.com/rust-lang/rust/issues/36887
6713 [36888]: https://github.com/rust-lang/rust/issues/36888
6714 [36889]: https://github.com/rust-lang/rust/issues/36889
6715 [36890]: https://github.com/rust-lang/rust/issues/36890
6716 [36891]: https://github.com/rust-lang/rust/issues/36891
6717 [36892]: https://github.com/rust-lang/rust/issues/36892
6718 [36894]: https://github.com/rust-lang/rust/pull/36894
6719 [36917]: https://github.com/rust-lang/rust/pull/36917
6720 [36993]: https://github.com/rust-lang/rust/pull/36993
6721 [37037]: https://github.com/rust-lang/rust/pull/37037
6722 [37064]: https://github.com/rust-lang/rust/pull/37064
6723 [37094]: https://github.com/rust-lang/rust/pull/37094
6724 [37108]: https://github.com/rust-lang/rust/pull/37108
6725 [37111]: https://github.com/rust-lang/rust/pull/37111
6726 [37161]: https://github.com/rust-lang/rust/pull/37161
6727 [37162]: https://github.com/rust-lang/rust/pull/37162
6728 [37167]: https://github.com/rust-lang/rust/pull/37167
6729 [37178]: https://github.com/rust-lang/rust/pull/37178
6730 [37200]: https://github.com/rust-lang/rust/pull/37200
6731 [37213]: https://github.com/rust-lang/rust/pull/37213
6732 [37221]: https://github.com/rust-lang/rust/pull/37221
6733 [37224]: https://github.com/rust-lang/rust/pull/37224
6734 [37230]: https://github.com/rust-lang/rust/pull/37230
6735 [37231]: https://github.com/rust-lang/rust/pull/37231
6736 [37247]: https://github.com/rust-lang/rust/pull/37247
6737 [37267]: https://github.com/rust-lang/rust/pull/37267
6738 [37270]: https://github.com/rust-lang/rust/pull/37270
6739 [37273]: https://github.com/rust-lang/rust/pull/37273
6740 [37280]: https://github.com/rust-lang/rust/pull/37280
6741 [37298]: https://github.com/rust-lang/rust/pull/37298
6742 [37306]: https://github.com/rust-lang/rust/pull/37306
6743 [37310]: https://github.com/rust-lang/rust/pull/37310
6744 [37312]: https://github.com/rust-lang/rust/pull/37312
6745 [37313]: https://github.com/rust-lang/rust/pull/37313
6746 [37315]: https://github.com/rust-lang/rust/pull/37315
6747 [37318]: https://github.com/rust-lang/rust/pull/37318
6748 [37322]: https://github.com/rust-lang/rust/pull/37322
6749 [37326]: https://github.com/rust-lang/rust/pull/37326
6750 [37351]: https://github.com/rust-lang/rust/pull/37351
6751 [37356]: https://github.com/rust-lang/rust/pull/37356
6752 [37367]: https://github.com/rust-lang/rust/pull/37367
6753 [37373]: https://github.com/rust-lang/rust/pull/37373
6754 [37378]: https://github.com/rust-lang/rust/pull/37378
6755 [37389]: https://github.com/rust-lang/rust/pull/37389
6756 [37392]: https://github.com/rust-lang/rust/pull/37392
6757 [37427]: https://github.com/rust-lang/rust/pull/37427
6758 [37439]: https://github.com/rust-lang/rust/pull/37439
6759 [37445]: https://github.com/rust-lang/rust/pull/37445
6760 [37470]: https://github.com/rust-lang/rust/pull/37470
6761 [37569]: https://github.com/rust-lang/rust/pull/37569
6762 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6763 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
6764 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
6765 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
6766 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
6767 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
6768 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
6769
6770
6771 Version 1.13.0 (2016-11-10)
6772 ===========================
6773
6774 Language
6775 --------
6776
6777 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
6778   errors, like the `try!` macro, described in [RFC 0243].
6779 * [Stabilize macros in type position][36014]. Described in [RFC 873].
6780 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
6781 * [Fix `#[derive]` for empty tuple structs/variants][35728]
6782 * [Fix lifetime rules for 'if' conditions][36029]
6783 * [Avoid loading and parsing unconfigured non-inline modules][36482]
6784
6785 Compiler
6786 --------
6787
6788 * [Add the `-C link-arg` argument][36574]
6789 * [Remove the old AST-based backend from rustc_trans][35764]
6790 * [Don't enable NEON by default on armv7 Linux][35814]
6791 * [Fix debug line number info for macro expansions][35238]
6792 * [Do not emit "class method" debuginfo for types that are not
6793   DICompositeType][36008]
6794 * [Warn about multiple conflicting #[repr] hints][34623]
6795 * [When sizing DST, don't double-count nested struct prefixes][36351]
6796 * [Default RUST_MIN_STACK to 16MiB for now][36505]
6797 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
6798 * [Reject macros with empty repetitions to avoid infinite loop][36721]
6799 * [Expand macros without recursing to avoid stack overflows][36214]
6800
6801 Diagnostics
6802 -----------
6803
6804 * [Replace macro backtraces with labeled local uses][35702]
6805 * [Improve error message for misplaced doc comments][33922]
6806 * [Buffer unix and lock windows to prevent message interleaving][35975]
6807 * [Update lifetime errors to specifically note temporaries][36171]
6808 * [Special case a few colors for Windows][36178]
6809 * [Suggest `use self` when such an import resolves][36289]
6810 * [Be more specific when type parameter shadows primitive type][36338]
6811 * Many minor improvements
6812
6813 Compile-time Optimizations
6814 --------------------------
6815
6816 * [Compute and cache HIR hashes at beginning][35854]
6817 * [Don't hash types in loan paths][36004]
6818 * [Cache projections in trans][35761]
6819 * [Optimize the parser's last token handling][36527]
6820 * [Only instantiate #[inline] functions in codegen units referencing
6821   them][36524]. This leads to big improvements in cases where crates export
6822   define many inline functions without using them directly.
6823 * [Lazily allocate TypedArena's first chunk][36592]
6824 * [Don't allocate during default HashSet creation][36734]
6825
6826 Stabilized APIs
6827 ---------------
6828
6829 * [`checked_abs`]
6830 * [`wrapping_abs`]
6831 * [`overflowing_abs`]
6832 * [`RefCell::try_borrow`]
6833 * [`RefCell::try_borrow_mut`]
6834
6835 Libraries
6836 ---------
6837
6838 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
6839 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
6840   covariant][35354]
6841 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
6842 * [Implement `Debug` for `std::vec::IntoIter`][35707]
6843 * [`CString`: avoid excessive growth just to 0-terminate][35871]
6844 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
6845 * [Use arc4rand on FreeBSD][35884]
6846 * [memrchr: Correct aligned offset computation][35969]
6847 * [Improve Demangling of Rust Symbols][36059]
6848 * [Use monotonic time in condition variables][35048]
6849 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
6850 * [Implement conversion traits for `char`][35755]
6851 * [Fix illegal instruction caused by overflow in channel cloning][36104]
6852 * [Zero first byte of CString on drop][36264]
6853 * [Inherit overflow checks for sum and product][36372]
6854 * [Add missing Eq implementations][36423]
6855 * [Implement `Debug` for `DirEntry`][36631]
6856 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
6857   `errno`][36754]
6858 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6859 * [Implement more traits for `std::io::ErrorKind`][35911]
6860 * [Optimize BinaryHeap bounds checking][36072]
6861 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
6862   `extend_with_element`][36355]
6863 * [Fix overflow checking in unsigned pow()][34942]
6864
6865 Cargo
6866 -----
6867
6868 * This release includes security fixes to both curl and OpenSSL.
6869 * [Fix transitive doctests when panic=abort][cargo/3021]
6870 * [Add --all-features flag to cargo][cargo/3038]
6871 * [Reject path-based dependencies in `cargo package`][cargo/3060]
6872 * [Don't parse the home directory more than once][cargo/3078]
6873 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
6874 * [Update OpenSSL to 1.0.2j][cargo/3121]
6875 * [Add license and license_file to cargo metadata output][cargo/3110]
6876 * [Make crates-io registry URL optional in config; ignore all changes to
6877   source.crates-io][cargo/3089]
6878 * [Don't download dependencies from other platforms][cargo/3123]
6879 * [Build transitive dev-dependencies when needed][cargo/3125]
6880 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
6881 * [Avoid updating registry when adding existing deps][cargo/3144]
6882 * [Warn about path overrides that won't work][cargo/3136]
6883 * [Use workspaces during `cargo install`][cargo/3146]
6884 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
6885 * [Add --message-format flag][cargo/3000]
6886 * [Pass target environment for rustdoc][cargo/3205]
6887 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
6888 * [Update curl and curl-sys][cargo/3241]
6889 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
6890
6891 Tooling
6892 -------
6893
6894 * [rustdoc: Add the `--sysroot` argument][36586]
6895 * [rustdoc: Fix a couple of issues with the search results][35655]
6896 * [rustdoc: remove the `!` from macro URLs and titles][35234]
6897 * [gdb: Fix pretty-printing special-cased Rust types][35585]
6898 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
6899
6900 Misc
6901 ----
6902
6903 * [Remove unmaintained style guide][35124]
6904 * [Add s390x support][36369]
6905 * [Initial work at Haiku OS support][36727]
6906 * [Add mips-uclibc targets][35734]
6907 * [Crate-ify compiler-rt into compiler-builtins][35021]
6908 * [Add rustc version info (git hash + date) to dist tarball][36213]
6909 * Many documentation improvements
6910
6911 Compatibility Notes
6912 -------------------
6913
6914 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6915 * [Deny (by default) transmuting from fn item types to pointer-sized
6916   types][34923]. Continuing the long transition to zero-sized fn items,
6917   per [RFC 401].
6918 * [Fix `#[derive]` for empty tuple structs/variants][35728].
6919   Part of [RFC 1506].
6920 * [Issue deprecation warnings for safe accesses to extern statics][36173]
6921 * [Fix lifetime rules for 'if' conditions][36029].
6922 * [Inherit overflow checks for sum and product][36372].
6923 * [Forbid user-defined macros named "macro_rules"][36730].
6924
6925 [33922]: https://github.com/rust-lang/rust/pull/33922
6926 [34623]: https://github.com/rust-lang/rust/pull/34623
6927 [34923]: https://github.com/rust-lang/rust/pull/34923
6928 [34942]: https://github.com/rust-lang/rust/pull/34942
6929 [35021]: https://github.com/rust-lang/rust/pull/35021
6930 [35048]: https://github.com/rust-lang/rust/pull/35048
6931 [35074]: https://github.com/rust-lang/rust/pull/35074
6932 [35124]: https://github.com/rust-lang/rust/pull/35124
6933 [35234]: https://github.com/rust-lang/rust/pull/35234
6934 [35238]: https://github.com/rust-lang/rust/pull/35238
6935 [35354]: https://github.com/rust-lang/rust/pull/35354
6936 [35559]: https://github.com/rust-lang/rust/pull/35559
6937 [35585]: https://github.com/rust-lang/rust/pull/35585
6938 [35627]: https://github.com/rust-lang/rust/pull/35627
6939 [35655]: https://github.com/rust-lang/rust/pull/35655
6940 [35702]: https://github.com/rust-lang/rust/pull/35702
6941 [35707]: https://github.com/rust-lang/rust/pull/35707
6942 [35728]: https://github.com/rust-lang/rust/pull/35728
6943 [35734]: https://github.com/rust-lang/rust/pull/35734
6944 [35755]: https://github.com/rust-lang/rust/pull/35755
6945 [35761]: https://github.com/rust-lang/rust/pull/35761
6946 [35764]: https://github.com/rust-lang/rust/pull/35764
6947 [35814]: https://github.com/rust-lang/rust/pull/35814
6948 [35854]: https://github.com/rust-lang/rust/pull/35854
6949 [35871]: https://github.com/rust-lang/rust/pull/35871
6950 [35884]: https://github.com/rust-lang/rust/pull/35884
6951 [35911]: https://github.com/rust-lang/rust/pull/35911
6952 [35969]: https://github.com/rust-lang/rust/pull/35969
6953 [35975]: https://github.com/rust-lang/rust/pull/35975
6954 [36004]: https://github.com/rust-lang/rust/pull/36004
6955 [36008]: https://github.com/rust-lang/rust/pull/36008
6956 [36014]: https://github.com/rust-lang/rust/pull/36014
6957 [36029]: https://github.com/rust-lang/rust/pull/36029
6958 [36059]: https://github.com/rust-lang/rust/pull/36059
6959 [36072]: https://github.com/rust-lang/rust/pull/36072
6960 [36101]: https://github.com/rust-lang/rust/pull/36101
6961 [36104]: https://github.com/rust-lang/rust/pull/36104
6962 [36171]: https://github.com/rust-lang/rust/pull/36171
6963 [36173]: https://github.com/rust-lang/rust/pull/36173
6964 [36178]: https://github.com/rust-lang/rust/pull/36178
6965 [36213]: https://github.com/rust-lang/rust/pull/36213
6966 [36214]: https://github.com/rust-lang/rust/pull/36214
6967 [36264]: https://github.com/rust-lang/rust/pull/36264
6968 [36266]: https://github.com/rust-lang/rust/pull/36266
6969 [36289]: https://github.com/rust-lang/rust/pull/36289
6970 [36338]: https://github.com/rust-lang/rust/pull/36338
6971 [36351]: https://github.com/rust-lang/rust/pull/36351
6972 [36355]: https://github.com/rust-lang/rust/pull/36355
6973 [36369]: https://github.com/rust-lang/rust/pull/36369
6974 [36372]: https://github.com/rust-lang/rust/pull/36372
6975 [36423]: https://github.com/rust-lang/rust/pull/36423
6976 [36482]: https://github.com/rust-lang/rust/pull/36482
6977 [36505]: https://github.com/rust-lang/rust/pull/36505
6978 [36524]: https://github.com/rust-lang/rust/pull/36524
6979 [36527]: https://github.com/rust-lang/rust/pull/36527
6980 [36551]: https://github.com/rust-lang/rust/pull/36551
6981 [36574]: https://github.com/rust-lang/rust/pull/36574
6982 [36586]: https://github.com/rust-lang/rust/pull/36586
6983 [36592]: https://github.com/rust-lang/rust/pull/36592
6984 [36631]: https://github.com/rust-lang/rust/pull/36631
6985 [36721]: https://github.com/rust-lang/rust/pull/36721
6986 [36727]: https://github.com/rust-lang/rust/pull/36727
6987 [36730]: https://github.com/rust-lang/rust/pull/36730
6988 [36734]: https://github.com/rust-lang/rust/pull/36734
6989 [36754]: https://github.com/rust-lang/rust/pull/36754
6990 [36995]: https://github.com/rust-lang/rust/pull/36995
6991 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
6992 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
6993 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6994 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
6995 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
6996 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
6997 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
6998 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
6999 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
7000 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
7001 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
7002 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
7003 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
7004 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
7005 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
7006 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
7007 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
7008 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
7009 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
7010 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
7011 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
7012 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
7013 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
7014 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
7015 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
7016 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
7017 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
7018 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
7019 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
7020 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
7021 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
7022 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
7023
7024
7025 Version 1.12.1 (2016-10-20)
7026 ===========================
7027
7028 Regression Fixes
7029 ----------------
7030
7031 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
7032 * [Confusion with double negation and booleans][36856]
7033 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
7034 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
7035 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
7036 * [Corrupted memory after updated to 1.12][36936]
7037 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
7038 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
7039 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
7040
7041 [36381]: https://github.com/rust-lang/rust/issues/36381
7042 [36856]: https://github.com/rust-lang/rust/issues/36856
7043 [36875]: https://github.com/rust-lang/rust/issues/36875
7044 [36924]: https://github.com/rust-lang/rust/issues/36924
7045 [36926]: https://github.com/rust-lang/rust/issues/36926
7046 [36936]: https://github.com/rust-lang/rust/issues/36936
7047 [37026]: https://github.com/rust-lang/rust/issues/37026
7048 [37112]: https://github.com/rust-lang/rust/issues/37112
7049 [37153]: https://github.com/rust-lang/rust/issues/37153
7050
7051
7052 Version 1.12.0 (2016-09-29)
7053 ===========================
7054
7055 Highlights
7056 ----------
7057
7058 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
7059   This translation pass is far simpler than the previous AST->LLVM pass, and
7060   creates opportunities to perform new optimizations directly on the MIR. It
7061   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
7062 * [`rustc` presents a new, more readable error format, along with
7063   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
7064   Most common editors supporting Rust have been updated to work with it. It was
7065   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
7066
7067 Compiler
7068 --------
7069
7070 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
7071   This translation pass is far simpler than the previous AST->LLVM pass, and
7072   creates opportunities to perform new optimizations directly on the MIR. It
7073   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
7074 * [Print the Rust target name, not the LLVM target name, with
7075   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
7076 * [The computation of `TypeId` is correct in some cases where it was previously
7077   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
7078 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
7079 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
7080   `--print relocation-models`, and `--print code-models` print the available
7081   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
7082   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
7083 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
7084   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
7085   These targets produce statically-linked binaries. There are no binary release
7086   builds yet though.
7087
7088 Diagnostics
7089 -----------
7090
7091 * [`rustc` presents a new, more readable error format, along with
7092   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
7093   Most common editors supporting Rust have been updated to work with it. It was
7094   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
7095 * [In error descriptions, references are now described in plain English,
7096   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
7097 * [In error type descriptions, unknown numeric types are named `{integer}` or
7098   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
7099 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
7100
7101 Language
7102 --------
7103
7104 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
7105 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
7106 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
7107   useful](https://github.com/rust-lang/rust/pull/34908)
7108 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
7109   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
7110 * [Semicolons are properly required as statement delimiters inside
7111   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
7112 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
7113
7114 Stabilized APIs
7115 ---------------
7116
7117 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
7118 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
7119 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
7120 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
7121 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
7122 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
7123 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
7124 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
7125 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
7126 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
7127   Both on Unix and Windows.
7128 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
7129 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
7130 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
7131 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
7132 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
7133 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
7134 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
7135 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
7136
7137 Libraries
7138 ---------
7139
7140 * [The `format!` macro and friends now allow a single argument to be formatted
7141   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
7142 * [The lifetime bounds on `[T]::binary_search_by` and
7143   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
7144 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
7145 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
7146 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
7147 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
7148 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
7149 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
7150 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
7151 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
7152   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
7153 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
7154   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
7155 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
7156 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
7157   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
7158 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
7159 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
7160 * [`mpsc::sync_channel` `Receiver`s return any available message before
7161   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
7162 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
7163 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
7164
7165 Cargo
7166 -----
7167
7168 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
7169 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
7170 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
7171 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
7172 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
7173 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
7174 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
7175 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
7176 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
7177 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
7178 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
7179 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
7180 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
7181 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
7182 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
7183 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
7184
7185 Performance
7186 -----------
7187
7188 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
7189 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
7190
7191 Tooling
7192 -------
7193
7194 * [Test binaries now support a `--test-threads` argument to specify the number
7195   of threads used to run tests, and which acts the same as the
7196   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
7197 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
7198 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
7199 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7200 * [Rust releases now come with source packages that can be installed by rustup
7201   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
7202   The resulting source code can be used by tools and IDES, located in the
7203   sysroot under `lib/rustlib/src`.
7204
7205 Misc
7206 ----
7207
7208 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
7209 * Many minor improvements to the documentation.
7210 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
7211
7212 Compatibility Notes
7213 -------------------
7214
7215 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
7216   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
7217 * [When formatting strings, if "precision" is specified, the "fill",
7218   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
7219 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
7220
7221
7222 Version 1.11.0 (2016-08-18)
7223 ===========================
7224
7225 Language
7226 --------
7227
7228 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
7229 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
7230 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
7231 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
7232
7233 Stabilized APIs
7234 ---------------
7235
7236 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
7237 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
7238 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
7239 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
7240 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
7241 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
7242   (in libcore - previously stabilized in libstd)
7243 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
7244   (in libcore - previously stabilized in libstd)
7245 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
7246   (in libcore - previously stabilized in libstd)
7247 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
7248   (in libcore - previously stabilized in libstd)
7249 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7250 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7251 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
7252 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
7253
7254 Libraries
7255 ---------
7256
7257 * [The `thread_local!` macro supports multiple definitions in a single
7258    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
7259 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
7260 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
7261   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
7262 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
7263 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
7264 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
7265 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
7266
7267 Cargo
7268 -----
7269
7270 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
7271 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
7272 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
7273 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
7274 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
7275   and `-vv` prints warnings for all crates.
7276 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
7277 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
7278   This provides room for expansion by arbitrary tools.
7279 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
7280 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
7281 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
7282 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
7283 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
7284 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
7285 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
7286
7287 Performance
7288 -----------
7289
7290 * [Caching projections speeds up type check dramatically for some
7291   workloads](https://github.com/rust-lang/rust/pull/33816)
7292 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
7293   This hasher is faster, but is believed to provide sufficient
7294   protection from collision attacks.
7295 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
7296
7297 Rustdoc
7298 -------
7299
7300 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
7301 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
7302 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
7303 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
7304 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
7305
7306 Tooling
7307 -------
7308
7309 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
7310 * [When emitting debug info, rustc emits frame pointers for closures,
7311   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
7312 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7313 * Many more errors have been given error codes and extended
7314   explanations
7315 * API documentation continues to be improved, with many new examples
7316
7317 Misc
7318 ----
7319
7320 * [rustc no longer hangs when dependencies recursively re-export
7321   submodules](https://github.com/rust-lang/rust/pull/34542)
7322 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
7323 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
7324   rewritten](https://github.com/rust-lang/rust/pull/33895)
7325 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
7326   No targets use this yet, but it works toward AVR support.
7327
7328 Compatibility Notes
7329 -------------------
7330
7331 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
7332 * [The new follow-set rules that place restrictions on `macro_rules!`
7333   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
7334   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
7335   and has been a warning since 1.10.
7336 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
7337   This causes breakage in some corner cases.
7338
7339
7340 Version 1.10.0 (2016-07-07)
7341 ===========================
7342
7343 Language
7344 --------
7345
7346 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
7347   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
7348 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
7349 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
7350 * [`panic!` can be converted to a runtime abort with the
7351   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
7352   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7353 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
7354   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
7355   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
7356   Note that Cargo does not yet directly support cdylibs.
7357
7358 Stabilized APIs
7359 ---------------
7360
7361 * `os::windows::fs::OpenOptionsExt::access_mode`
7362 * `os::windows::fs::OpenOptionsExt::share_mode`
7363 * `os::windows::fs::OpenOptionsExt::custom_flags`
7364 * `os::windows::fs::OpenOptionsExt::attributes`
7365 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
7366 * `os::unix::fs::OpenOptionsExt::custom_flags`
7367 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
7368 * `Default for sync::Weak`
7369 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
7370 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
7371 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
7372 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
7373 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
7374 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
7375 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
7376 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
7377 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
7378 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
7379 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
7380 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
7381 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
7382 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
7383 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
7384 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
7385 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
7386 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
7387 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
7388 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
7389 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
7390 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
7391 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
7392 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
7393 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
7394 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7395 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7396 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7397 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7398 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
7399 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
7400 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
7401 * Read/Write/RawFd impls for `UnixStream`
7402 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
7403 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
7404 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
7405 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
7406 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
7407 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
7408 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
7409 * RawFd impls for `UnixListener`
7410 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
7411 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
7412 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
7413 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
7414 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
7415 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
7416 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
7417 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
7418 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
7419 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
7420 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
7421 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
7422 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
7423 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
7424 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
7425 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
7426 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
7427 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
7428 * RawFd impls for `UnixDatagram`
7429 * `{BTree,Hash}Map::values_mut`
7430 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
7431
7432 Libraries
7433 ---------
7434
7435 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
7436   The semantics of this minor method are subtle and probably not what
7437   most people want.
7438 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
7439 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
7440   will fall back to `/dev/urandom` temporarily to avoid blocking
7441   during early boot](https://github.com/rust-lang/rust/pull/33086).
7442 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
7443 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
7444 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
7445 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
7446 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
7447 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
7448   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
7449
7450 Cargo
7451 -----
7452 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
7453   This controls the runtime behavior of the `panic!` macro
7454   and can be either "unwind" (the default), or "abort".
7455   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7456 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
7457 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
7458 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
7459   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
7460 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
7461 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
7462 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
7463   By default they are retried twice, which can be customized with the
7464   `net.retry` value in `.cargo/config`.
7465 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
7466 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
7467 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
7468 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
7469   Makes it possible to install multiple crates in parallel.
7470 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
7471 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
7472 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
7473 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
7474 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
7475 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
7476
7477 Performance
7478 -----------
7479
7480 * [rustc memory usage was reduced by refactoring the context used for
7481   type checking](https://github.com/rust-lang/rust/pull/33425).
7482 * [Speed up creation of `HashMap`s by caching the random keys used
7483   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
7484 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
7485 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
7486 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
7487   10x faster than the previous lookup tables.
7488 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
7489
7490 Usability
7491 ---------
7492
7493 * Many incremental improvements to documentation and rustdoc.
7494 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
7495 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
7496 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
7497 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
7498 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
7499 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
7500 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
7501
7502 Misc
7503 ----
7504
7505 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
7506 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
7507 * [`std` no longer prints backtraces on platforms where the running
7508   module must be loaded with `env::current_exe`, which can't be relied
7509   on](https://github.com/rust-lang/rust/pull/33554).
7510 * This release includes std binaries for the i586-unknown-linux-gnu,
7511   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
7512   i586 target is for old x86 hardware without SSE2, and the armv7
7513   target is for Android running on modern ARM architectures.
7514 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
7515   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
7516 * [On Unix the runtime aborts by calling `libc::abort` instead of
7517   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
7518 * [Rust is now bootstrapped from the previous release of Rust,
7519   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
7520
7521 Compatibility Notes
7522 -------------------
7523
7524 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
7525 * [`target_env` for Linux ARM targets is just `gnu`, not
7526   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
7527 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
7528 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
7529 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
7530   Affects how macros are parsed.
7531 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
7532 * [Feature-gated attributes on macro-generated macro invocations are
7533   now rejected](https://github.com/rust-lang/rust/pull/32791).
7534 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
7535   This caused some minor changes to type inference.
7536
7537
7538 Version 1.9.0 (2016-05-26)
7539 ==========================
7540
7541 Language
7542 --------
7543
7544 * The `#[deprecated]` attribute when applied to an API will generate
7545   warnings when used. The warnings may be suppressed with
7546   `#[allow(deprecated)]`. [RFC 1270].
7547 * [`fn` item types are zero sized, and each `fn` names a unique
7548   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7549   `transmute` on a `fn` type will generate a warning for a few cycles,
7550   then will be converted to an error.
7551 * [Field and method resolution understand visibility, so private
7552   fields and methods cannot prevent the proper use of public fields
7553   and methods][1.9fv].
7554 * [The parser considers unicode codepoints in the
7555   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
7556
7557 Stabilized APIs
7558 ---------------
7559
7560 * [`std::panic`]
7561 * [`std::panic::catch_unwind`] (renamed from `recover`)
7562 * [`std::panic::resume_unwind`] (renamed from `propagate`)
7563 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
7564 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
7565 * [`str::is_char_boundary`]
7566 * [`<*const T>::as_ref`]
7567 * [`<*mut T>::as_ref`]
7568 * [`<*mut T>::as_mut`]
7569 * [`AsciiExt::make_ascii_uppercase`]
7570 * [`AsciiExt::make_ascii_lowercase`]
7571 * [`char::decode_utf16`]
7572 * [`char::DecodeUtf16`]
7573 * [`char::DecodeUtf16Error`]
7574 * [`char::DecodeUtf16Error::unpaired_surrogate`]
7575 * [`BTreeSet::take`]
7576 * [`BTreeSet::replace`]
7577 * [`BTreeSet::get`]
7578 * [`HashSet::take`]
7579 * [`HashSet::replace`]
7580 * [`HashSet::get`]
7581 * [`OsString::with_capacity`]
7582 * [`OsString::clear`]
7583 * [`OsString::capacity`]
7584 * [`OsString::reserve`]
7585 * [`OsString::reserve_exact`]
7586 * [`OsStr::is_empty`]
7587 * [`OsStr::len`]
7588 * [`std::os::unix::thread`]
7589 * [`RawPthread`]
7590 * [`JoinHandleExt`]
7591 * [`JoinHandleExt::as_pthread_t`]
7592 * [`JoinHandleExt::into_pthread_t`]
7593 * [`HashSet::hasher`]
7594 * [`HashMap::hasher`]
7595 * [`CommandExt::exec`]
7596 * [`File::try_clone`]
7597 * [`SocketAddr::set_ip`]
7598 * [`SocketAddr::set_port`]
7599 * [`SocketAddrV4::set_ip`]
7600 * [`SocketAddrV4::set_port`]
7601 * [`SocketAddrV6::set_ip`]
7602 * [`SocketAddrV6::set_port`]
7603 * [`SocketAddrV6::set_flowinfo`]
7604 * [`SocketAddrV6::set_scope_id`]
7605 * [`slice::copy_from_slice`]
7606 * [`ptr::read_volatile`]
7607 * [`ptr::write_volatile`]
7608 * [`OpenOptions::create_new`]
7609 * [`TcpStream::set_nodelay`]
7610 * [`TcpStream::nodelay`]
7611 * [`TcpStream::set_ttl`]
7612 * [`TcpStream::ttl`]
7613 * [`TcpStream::set_only_v6`]
7614 * [`TcpStream::only_v6`]
7615 * [`TcpStream::take_error`]
7616 * [`TcpStream::set_nonblocking`]
7617 * [`TcpListener::set_ttl`]
7618 * [`TcpListener::ttl`]
7619 * [`TcpListener::set_only_v6`]
7620 * [`TcpListener::only_v6`]
7621 * [`TcpListener::take_error`]
7622 * [`TcpListener::set_nonblocking`]
7623 * [`UdpSocket::set_broadcast`]
7624 * [`UdpSocket::broadcast`]
7625 * [`UdpSocket::set_multicast_loop_v4`]
7626 * [`UdpSocket::multicast_loop_v4`]
7627 * [`UdpSocket::set_multicast_ttl_v4`]
7628 * [`UdpSocket::multicast_ttl_v4`]
7629 * [`UdpSocket::set_multicast_loop_v6`]
7630 * [`UdpSocket::multicast_loop_v6`]
7631 * [`UdpSocket::set_multicast_ttl_v6`]
7632 * [`UdpSocket::multicast_ttl_v6`]
7633 * [`UdpSocket::set_ttl`]
7634 * [`UdpSocket::ttl`]
7635 * [`UdpSocket::set_only_v6`]
7636 * [`UdpSocket::only_v6`]
7637 * [`UdpSocket::join_multicast_v4`]
7638 * [`UdpSocket::join_multicast_v6`]
7639 * [`UdpSocket::leave_multicast_v4`]
7640 * [`UdpSocket::leave_multicast_v6`]
7641 * [`UdpSocket::take_error`]
7642 * [`UdpSocket::connect`]
7643 * [`UdpSocket::send`]
7644 * [`UdpSocket::recv`]
7645 * [`UdpSocket::set_nonblocking`]
7646
7647 Libraries
7648 ---------
7649
7650 * [`std::sync::Once` is poisoned if its initialization function
7651   fails][1.9o].
7652 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
7653 * [Most types implement `fmt::Debug`][1.9db].
7654 * [The default buffer size used by `BufReader` and `BufWriter` was
7655   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
7656   used by other languages.
7657 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
7658   `Duration` additionally implements `*=` and `/=`][1.9ta].
7659 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
7660 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
7661 * [`Chain` implements `BufRead`][1.9ch].
7662 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
7663
7664 Cargo
7665 -----
7666
7667 * [Cargo can now run concurrently][1.9cc].
7668 * [Top-level overrides allow specific revisions of crates to be
7669   overridden through the entire crate graph][1.9ct].  This is intended
7670   to make upgrades easier for large projects, by allowing crates to be
7671   forked temporarily until they've been upgraded and republished.
7672 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
7673 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
7674   on the commandline][1.9cf]. `rustc` arguments can also be specified
7675   in the `build.rustflags` configuration key.
7676
7677 Performance
7678 -----------
7679
7680 * [The time complexity of comparing variables for equivalence during type
7681   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
7682   to major compilation time improvement in some scenarios.
7683 * [`ToString` is specialized for `str`, giving it the same performance
7684   as `to_owned`][1.9ts].
7685 * [Spawning processes with `Command::output` no longer creates extra
7686   threads][1.9sp].
7687 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
7688   for C-like enums][1.9cl].
7689
7690 Misc
7691 ----
7692
7693 * [Passing the `--quiet` flag to a test runner will produce
7694   much-abbreviated output][1.9q].
7695 * The Rust Project now publishes std binaries for the
7696   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
7697   `i586-pc-windows-msvc` targets.
7698
7699 Compatibility Notes
7700 -------------------
7701
7702 * [`std::sync::Once` is poisoned if its initialization function
7703   fails][1.9o].
7704 * [It is illegal to define methods with the same name in overlapping
7705   inherent `impl` blocks][1.9sn].
7706 * [`fn` item types are zero sized, and each `fn` names a unique
7707   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7708   `transmute` on a `fn` type will generate a warning for a few cycles,
7709   then will be converted to an error.
7710 * [Improvements to const evaluation may trigger new errors when integer
7711   literals are out of range][1.9ce].
7712
7713
7714 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
7715 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
7716 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
7717 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
7718 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
7719 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
7720 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
7721 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
7722 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
7723 [1.9db]: https://github.com/rust-lang/rust/pull/32054
7724 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
7725 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
7726 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
7727 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
7728 [1.9o]: https://github.com/rust-lang/rust/pull/32325
7729 [1.9q]: https://github.com/rust-lang/rust/pull/31887
7730 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
7731 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
7732 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
7733 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
7734 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
7735 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
7736 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
7737 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
7738 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7739 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
7740 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7741 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
7742 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
7743 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
7744 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
7745 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
7746 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
7747 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
7748 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
7749 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
7750 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
7751 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
7752 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
7753 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
7754 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
7755 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
7756 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
7757 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
7758 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
7759 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
7760 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
7761 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
7762 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
7763 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
7764 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
7765 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
7766 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
7767 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
7768 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
7769 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
7770 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
7771 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
7772 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
7773 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
7774 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7775 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7776 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7777 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7778 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7779 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7780 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
7781 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7782 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
7783 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7784 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7785 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7786 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7787 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7788 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
7789 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
7790 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
7791 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
7792 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
7793 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
7794 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
7795 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
7796 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
7797 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
7798 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
7799 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
7800 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
7801 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
7802 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
7803 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
7804 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
7805 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
7806 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
7807 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
7808 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
7809 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
7810 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
7811 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
7812 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
7813 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
7814 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
7815 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
7816 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
7817 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
7818 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
7819 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
7820 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
7821 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
7822 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
7823 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
7824
7825
7826 Version 1.8.0 (2016-04-14)
7827 ==========================
7828
7829 Language
7830 --------
7831
7832 * Rust supports overloading of compound assignment statements like
7833   `+=` by implementing the [`AddAssign`], [`SubAssign`],
7834   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
7835   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
7836   traits. [RFC 953].
7837 * Empty structs can be defined with braces, as in `struct Foo { }`, in
7838   addition to the non-braced form, `struct Foo;`. [RFC 218].
7839
7840 Libraries
7841 ---------
7842
7843 * Stabilized APIs:
7844   * [`str::encode_utf16`] (renamed from `utf16_units`)
7845   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
7846   * [`Ref::map`]
7847   * [`RefMut::map`]
7848   * [`ptr::drop_in_place`]
7849   * [`time::Instant`]
7850   * [`time::SystemTime`]
7851   * [`Instant::now`]
7852   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
7853   * [`Instant::elapsed`]
7854   * [`SystemTime::now`]
7855   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
7856   * [`SystemTime::elapsed`]
7857   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
7858   * [`SystemTimeError`]
7859   * [`SystemTimeError::duration`]
7860   * Various impls for `SystemTimeError`
7861   * [`UNIX_EPOCH`]
7862   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
7863     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
7864     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
7865 * [The `write!` and `writeln!` macros correctly emit errors if any of
7866   their arguments can't be formatted][1.8w].
7867 * [Various I/O functions support large files on 32-bit Linux][1.8l].
7868 * [The Unix-specific `raw` modules, which contain a number of
7869   redefined C types are deprecated][1.8r], including `os::raw::unix`,
7870   `os::raw::macos`, and `os::raw::linux`. These modules defined types
7871   such as `ino_t` and `dev_t`. The inconsistency of these definitions
7872   across platforms was making it difficult to implement `std`
7873   correctly. Those that need these definitions should use the `libc`
7874   crate. [RFC 1415].
7875 * The Unix-specific `MetadataExt` traits, including
7876   `os::unix::fs::MetadataExt`, which expose values such as inode
7877   numbers [no longer return platform-specific types][1.8r], but
7878   instead return widened integers. [RFC 1415].
7879 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
7880 * [Atomic loads and stores are not volatile][1.8a].
7881 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
7882
7883 Performance
7884 -----------
7885
7886 * [Inlining hash functions lead to a 3% compile-time improvement in
7887   some workloads][1.8h].
7888 * When using jemalloc, its symbols are [unprefixed so that it
7889   overrides the libc malloc implementation][1.8h]. This means that for
7890   rustc, LLVM is now using jemalloc, which results in a 6%
7891   compile-time improvement on a specific workload.
7892 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
7893
7894 Misc
7895 ----
7896
7897 * [32-bit MSVC builds finally implement unwinding][1.8ms].
7898   i686-pc-windows-msvc is now considered a tier-1 platform.
7899 * [The `--print targets` flag prints a list of supported targets][1.8t].
7900 * [The `--print cfg` flag prints the `cfg`s defined for the current
7901   target][1.8cf].
7902 * [`rustc` can be built with an new Cargo-based build system, written
7903   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
7904   build system. To enable it configure with `configure --rustbuild`.
7905 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
7906   variants while also indicating the total number of missing variants
7907   if more than 3][1.8m].
7908 * [Executable stacks are disabled on Linux and BSD][1.8nx].
7909 * The Rust Project now publishes binary releases of the standard
7910   library for a number of tier-2 targets:
7911   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
7912   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
7913   `x86_64-rumprun-netbsd`. These can be installed with
7914   tools such as [multirust][1.8mr].
7915
7916 Cargo
7917 -----
7918
7919 * [`cargo init` creates a new Cargo project in the current
7920   directory][1.8ci].  It is otherwise like `cargo new`.
7921 * [Cargo has configuration keys for `-v` and
7922   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
7923   `[term]` section of `.cargo/config`.
7924 * [Configuration keys that evaluate to strings or integers can be set
7925   via environment variables][1.8ce]. For example the `build.jobs` key
7926   can be set via `CARGO_BUILD_JOBS`. Environment variables take
7927   precedence over config files.
7928 * [Target-specific dependencies support Rust `cfg` syntax for
7929   describing targets][1.8cfg] so that dependencies for multiple
7930   targets can be specified together. [RFC 1361].
7931 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
7932   `RUSTDOC` take precedence over the `build.target-dir`,
7933   `build.rustc`, and `build.rustdoc` configuration values][1.8cfv].
7934 * [The child process tree is killed on Windows when Cargo is
7935   killed][1.8ck].
7936 * [The `build.target` configuration value sets the target platform,
7937   like `--target`][1.8ct].
7938
7939 Compatibility Notes
7940 -------------------
7941
7942 * [Unstable compiler flags have been further restricted][1.8u]. Since
7943   1.0 `-Z` flags have been considered unstable, and other flags that
7944   were considered unstable additionally required passing `-Z
7945   unstable-options` to access. Unlike unstable language and library
7946   features though, these options have been accessible on the stable
7947   release channel. Going forward, *new unstable flags will not be
7948   available on the stable release channel*, and old unstable flags
7949   will warn about their usage. In the future, all unstable flags will
7950   be unavailable on the stable release channel.
7951 * [It is no longer possible to `match` on empty enum variants using
7952   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
7953 * The Unix-specific `MetadataExt` traits, including
7954   `os::unix::fs::MetadataExt`, which expose values such as inode
7955   numbers [no longer return platform-specific types][1.8r], but
7956   instead return widened integers. [RFC 1415].
7957 * [Modules sourced from the filesystem cannot appear within arbitrary
7958   blocks, but only within other modules][1.8mf].
7959 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
7960 * On Unix, [stack overflow triggers a runtime abort instead of a
7961   SIGSEGV][1.8so].
7962 * [`Command::spawn` and its equivalents return an error if any of
7963   its command-line arguments contain interior `NUL`s][1.8n].
7964 * [Tuple and unit enum variants from other crates are in the type
7965   namespace][1.8tn].
7966 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
7967   type instead of `.a` files][1.8st]. Additionally, for the MSVC
7968   toolchain, `rustc` emits import libraries named `foo.dll.lib`
7969   instead of `foo.lib`.
7970
7971
7972 [1.8a]: https://github.com/rust-lang/rust/pull/30962
7973 [1.8b]: https://github.com/rust-lang/rust/pull/31123
7974 [1.8c]: https://github.com/rust-lang/rust/pull/31530
7975 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
7976 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
7977 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
7978 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
7979 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
7980 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
7981 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
7982 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
7983 [1.8cfv]: https://github.com/rust-lang/cargo/issues/2365
7984 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
7985 [1.8h]: https://github.com/rust-lang/rust/pull/31460
7986 [1.8l]: https://github.com/rust-lang/rust/pull/31668
7987 [1.8m]: https://github.com/rust-lang/rust/pull/31020
7988 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
7989 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
7990 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
7991 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
7992 [1.8n]: https://github.com/rust-lang/rust/pull/31056
7993 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
7994 [1.8r]: https://github.com/rust-lang/rust/pull/31551
7995 [1.8so]: https://github.com/rust-lang/rust/pull/31333
7996 [1.8st]: https://github.com/rust-lang/rust/pull/29520
7997 [1.8t]: https://github.com/rust-lang/rust/pull/31358
7998 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
7999 [1.8u]: https://github.com/rust-lang/rust/pull/31793
8000 [1.8v]: https://github.com/rust-lang/rust/pull/31757
8001 [1.8w]: https://github.com/rust-lang/rust/pull/31904
8002 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
8003 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
8004 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
8005 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
8006 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
8007 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
8008 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
8009 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
8010 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
8011 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
8012 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
8013 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
8014 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
8015 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
8016 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
8017 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
8018 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
8019 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
8020 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
8021 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
8022 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
8023 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
8024 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
8025 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
8026 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
8027 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
8028 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
8029 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
8030 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
8031 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
8032
8033
8034 Version 1.7.0 (2016-03-03)
8035 ==========================
8036
8037 Libraries
8038 ---------
8039
8040 * Stabilized APIs
8041   * `Path`
8042     * [`Path::strip_prefix`] (renamed from relative_from)
8043     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
8044   * `Ipv4Addr`
8045     * [`Ipv4Addr::is_loopback`]
8046     * [`Ipv4Addr::is_private`]
8047     * [`Ipv4Addr::is_link_local`]
8048     * [`Ipv4Addr::is_multicast`]
8049     * [`Ipv4Addr::is_broadcast`]
8050     * [`Ipv4Addr::is_documentation`]
8051   * `Ipv6Addr`
8052     * [`Ipv6Addr::is_unspecified`]
8053     * [`Ipv6Addr::is_loopback`]
8054     * [`Ipv6Addr::is_multicast`]
8055   * `Vec`
8056     * [`Vec::as_slice`]
8057     * [`Vec::as_mut_slice`]
8058   * `String`
8059     * [`String::as_str`]
8060     * [`String::as_mut_str`]
8061   * Slices
8062     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
8063     be the same length
8064     * `<[T]>::`[`sort_by_key`]
8065   * checked, saturated, and overflowing operations
8066     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
8067     * [`i32::saturating_mul`]
8068     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
8069     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
8070     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
8071     * [`u32::saturating_mul`]
8072     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
8073     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
8074     * and checked, saturated, and overflowing operations for other primitive types
8075   * FFI
8076     * [`ffi::IntoStringError`]
8077     * [`CString::into_string`]
8078     * [`CString::into_bytes`]
8079     * [`CString::into_bytes_with_nul`]
8080     * `From<CString> for Vec<u8>`
8081   * `IntoStringError`
8082     * [`IntoStringError::into_cstring`]
8083     * [`IntoStringError::utf8_error`]
8084     * `Error for IntoStringError`
8085   * Hashing
8086     * [`std::hash::BuildHasher`]
8087     * [`BuildHasher::Hasher`]
8088     * [`BuildHasher::build_hasher`]
8089     * [`std::hash::BuildHasherDefault`]
8090     * [`HashMap::with_hasher`]
8091     * [`HashMap::with_capacity_and_hasher`]
8092     * [`HashSet::with_hasher`]
8093     * [`HashSet::with_capacity_and_hasher`]
8094     * [`std::collections::hash_map::RandomState`]
8095     * [`RandomState::new`]
8096 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
8097   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
8098   from bytes is faster.
8099 * [The performance of `LineWriter` (and thus `io::stdout`) was
8100   improved by using `memchr` to search for newlines][1.7m].
8101 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
8102   `f64` variants were stabilized previously.
8103 * [`BTreeMap` was rewritten to use less memory and improve the performance
8104   of insertion and iteration, the latter by as much as 5x][1.7bm].
8105 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
8106   covariant over their contained type][1.7bt].
8107 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
8108   over their contained type][1.7ll].
8109 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
8110   searching methods.
8111 * [`Any` is implemented for unsized types][1.7a].
8112 * [`Hash` is implemented for `Duration`][1.7h].
8113
8114 Misc
8115 ----
8116
8117 * [When running tests with `--test`, rustdoc will pass `--cfg`
8118   arguments to the compiler][1.7dt].
8119 * [The compiler is built with RPATH information by default][1.7rpa].
8120   This means that it will be possible to run `rustc` when installed in
8121   unusual configurations without configuring the dynamic linker search
8122   path explicitly.
8123 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
8124   any RPATH entries (emitted with `-C rpath`) *not* take precedence
8125   over `LD_LIBRARY_PATH`.
8126
8127 Cargo
8128 -----
8129
8130 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
8131   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
8132 * [The `rerun-if-changed` build script directive no longer causes the
8133   build script to incorrectly run twice in certain scenarios][1.7rr].
8134
8135 Compatibility Notes
8136 -------------------
8137
8138 * Soundness fixes to the interactions between associated types and
8139   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
8140   code that violates the new rules. This is a significant change that
8141   is known to break existing code, so it has emitted warnings for the
8142   new error cases since 1.4 to give crate authors time to adapt. The
8143   details of what is changing are subtle; read the RFC for more.
8144 * [Several bugs in the compiler's visibility calculations were
8145   fixed][1.7v]. Since this was found to break significant amounts of
8146   code, the new errors will be emitted as warnings for several release
8147   cycles, under the `private_in_public` lint.
8148 * Defaulted type parameters were accidentally accepted in positions
8149   that were not intended. In this release, [defaulted type parameters
8150   appearing outside of type definitions will generate a
8151   warning][1.7d], which will become an error in future releases.
8152 * [Parsing "." as a float results in an error instead of 0][1.7p].
8153   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
8154 * [Borrows of closure parameters may not outlive the closure][1.7bc].
8155
8156 [1.7a]: https://github.com/rust-lang/rust/pull/30928
8157 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
8158 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
8159 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
8160 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
8161 [1.7d]: https://github.com/rust-lang/rust/pull/30724
8162 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
8163 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
8164 [1.7f]: https://github.com/rust-lang/rust/pull/30672
8165 [1.7h]: https://github.com/rust-lang/rust/pull/30818
8166 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
8167 [1.7m]: https://github.com/rust-lang/rust/pull/30381
8168 [1.7p]: https://github.com/rust-lang/rust/pull/30681
8169 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
8170 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
8171 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
8172 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
8173 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
8174 [1.7v]: https://github.com/rust-lang/rust/pull/29973
8175 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8176 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8177 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
8178 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
8179 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
8180 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
8181 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
8182 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
8183 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
8184 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
8185 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
8186 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
8187 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
8188 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
8189 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
8190 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
8191 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
8192 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
8193 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
8194 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
8195 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
8196 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
8197 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
8198 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
8199 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
8200 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
8201 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
8202 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
8203 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
8204 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
8205 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
8206 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
8207 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
8208 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
8209 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
8210 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
8211 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
8212 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
8213 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
8214 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
8215 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
8216 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
8217 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
8218 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
8219 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
8220 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
8221 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
8222 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8223 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
8224 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8225 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
8226 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
8227 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
8228 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
8229 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
8230 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
8231 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
8232 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
8233 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
8234 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
8235
8236
8237 Version 1.6.0 (2016-01-21)
8238 ==========================
8239
8240 Language
8241 --------
8242
8243 * The `#![no_std]` attribute causes a crate to not be linked to the
8244   standard library, but only the [core library][1.6co], as described
8245   in [RFC 1184]. The core library defines common types and traits but
8246   has no platform dependencies whatsoever, and is the basis for Rust
8247   software in environments that cannot support a full port of the
8248   standard library, such as operating systems. Most of the core
8249   library is now stable.
8250
8251 Libraries
8252 ---------
8253
8254 * Stabilized APIs:
8255   [`Read::read_exact`],
8256   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
8257   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
8258   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
8259   [`os::unix::fs::DirBuilderExt`],
8260   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
8261   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
8262   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
8263   [`collections::hash_map::Drain`],
8264   [`collections::hash_map::HashMap::drain`],
8265   [`collections::hash_set::Drain`],
8266   [`collections::hash_set::HashSet::drain`],
8267   [`collections::binary_heap::Drain`],
8268   [`collections::binary_heap::BinaryHeap::drain`],
8269   [`Vec::extend_from_slice`] (renamed from `push_all`),
8270   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
8271   [`RwLock::into_inner`],
8272   [`Iterator::min_by_key`] (renamed from `min_by`),
8273   [`Iterator::max_by_key`] (renamed from `max_by`).
8274 * The [core library][1.6co] is stable, as are most of its APIs.
8275 * [The `assert_eq!` macro supports arguments that don't implement
8276   `Sized`][1.6ae], such as arrays. In this way it behaves more like
8277   `assert!`.
8278 * Several timer functions that take duration in milliseconds [are
8279   deprecated in favor of those that take `Duration`][1.6ms]. These
8280   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
8281   `thread::park_timeout_ms`.
8282 * The algorithm by which `Vec` reserves additional elements was
8283   [tweaked to not allocate excessive space][1.6a] while still growing
8284   exponentially.
8285 * `From` conversions are [implemented from integers to floats][1.6f]
8286   in cases where the conversion is lossless. Thus they are not
8287   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
8288   or `f64`. They are also not implemented for `isize` and `usize`
8289   because the implementations would be platform-specific. `From` is
8290   also implemented from `f32` to `f64`.
8291 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
8292 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
8293 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
8294 * [`BinaryHeap` was refactored][1.6bh] for modest performance
8295   improvements.
8296 * Sorting slices that are already sorted [is 50% faster in some
8297   cases][1.6s].
8298
8299 Cargo
8300 -----
8301
8302 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
8303 * Cargo build scripts can specify their dependencies by emitting the
8304   [`rerun-if-changed`][1.6rr] key.
8305 * crates.io will reject publication of crates with dependencies that
8306   have a wildcard version constraint. Crates with wildcard
8307   dependencies were seen to cause a variety of problems, as described
8308   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
8309   warning.
8310 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
8311   release folder.  A variety of artifacts that Cargo failed to clean
8312   are now correctly deleted.
8313
8314 Misc
8315 ----
8316
8317 * The `unreachable_code` lint [warns when a function call's argument
8318   diverges][1.6dv].
8319 * The parser indicates [failures that may be caused by
8320   confusingly-similar Unicode characters][1.6uc]
8321 * Certain macro errors [are reported at definition time][1.6m], not
8322   expansion.
8323
8324 Compatibility Notes
8325 -------------------
8326
8327 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
8328   environment variable when locating crates. This was a pre-cargo
8329   feature for integrating with the package manager that was
8330   accidentally never removed.
8331 * [A number of bugs were fixed in the privacy checker][1.6p] that
8332   could cause previously-accepted code to break.
8333 * [Modules and unit/tuple structs may not share the same name][1.6ts].
8334 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
8335   struct pattern syntax (`Foo(..)`) can no longer be used to match
8336   unit structs. This is a warning now, but will become an error in
8337   future releases. Patterns that share the same name as a const are
8338   now an error.
8339 * A bug was fixed that causes [rustc not to apply default type
8340   parameters][1.6xc] when resolving certain method implementations of
8341   traits defined in other crates.
8342
8343 [1.6a]: https://github.com/rust-lang/rust/pull/29454
8344 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
8345 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
8346 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
8347 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
8348 [1.6co]: http://doc.rust-lang.org/core/index.html
8349 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
8350 [1.6f]: https://github.com/rust-lang/rust/pull/29129
8351 [1.6m]: https://github.com/rust-lang/rust/pull/29828
8352 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
8353 [1.6p]: https://github.com/rust-lang/rust/pull/29726
8354 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
8355 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
8356 [1.6s]: https://github.com/rust-lang/rust/pull/29675
8357 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
8358 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
8359 [1.6us]: https://github.com/rust-lang/rust/pull/29383
8360 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
8361 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
8362 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8363 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
8364 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
8365 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
8366 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
8367 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
8368 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
8369 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
8370 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
8371 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
8372 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
8373 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
8374 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
8375 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
8376 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
8377 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
8378 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
8379 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
8380 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
8381 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
8382 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
8383 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
8384 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
8385 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
8386 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
8387 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
8388 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
8389 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
8390
8391
8392 Version 1.5.0 (2015-12-10)
8393 ==========================
8394
8395 * ~700 changes, numerous bugfixes
8396
8397 Highlights
8398 ----------
8399
8400 * Stabilized APIs:
8401   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
8402   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
8403   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
8404   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
8405   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
8406   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
8407   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
8408   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
8409   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
8410   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
8411   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
8412   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
8413   [`Path::read_link`], [`Path::symlink_metadata`],
8414   [`Utf8Error::valid_up_to`], [`Vec::resize`],
8415   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
8416   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
8417   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
8418   [`slice::split_first_mut`], [`slice::split_first`],
8419   [`slice::split_last_mut`], [`slice::split_last`],
8420   [`char::from_u32_unchecked`], [`fs::canonicalize`],
8421   [`str::MatchIndices`], [`str::RMatchIndices`],
8422   [`str::match_indices`], [`str::rmatch_indices`],
8423   [`str::slice_mut_unchecked`], [`string::ParseError`].
8424 * Rust applications hosted on crates.io can be installed locally to
8425   `~/.cargo/bin` with the [`cargo install`] command. Among other
8426   things this makes it easier to augment Cargo with new subcommands:
8427   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
8428   invoked as `cargo foo`.
8429 * Crates with wildcard (`*`) dependencies will [emit warnings when
8430   published][1.5w]. In 1.6 it will no longer be possible to publish
8431   crates with wildcard dependencies.
8432
8433 Breaking Changes
8434 ----------------
8435
8436 * The rules determining when a particular lifetime must outlive
8437   a particular value (known as '[dropck]') have been [modified
8438   to not rely on parametricity][1.5p].
8439 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
8440   and `Arc`][1.5a]. Because these smart pointer types implement
8441   `Deref`, this causes breakage in cases where the interior type
8442   contains methods of the same name.
8443 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
8444   that they could drop their content. Soundness fix.
8445 * All method invocations are [properly checked][1.5wf1] for
8446   [well-formedness][1.5wf2]. Soundness fix.
8447 * Traits whose supertraits contain `Self` are [not object
8448   safe][1.5o]. Soundness fix.
8449 * Target specifications support a [`no_default_libraries`][1.5nd]
8450   setting that controls whether `-nodefaultlibs` is passed to the
8451   linker, and in turn the `is_like_windows` setting no longer affects
8452   the `-nodefaultlibs` flag.
8453 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
8454 * The `#[inline]` and `#[repr]` attributes [can only appear
8455   in valid locations][1.5at].
8456 * Native libraries linked from the local crate are [passed to
8457   the linker before native libraries from upstream crates][1.5nl].
8458 * Two rarely-used attributes, `#[no_debug]` and
8459   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
8460 * Negation of unsigned integers, which has been a warning for
8461   several releases, [is now behind a feature gate and will
8462   generate errors][1.5nu].
8463 * The parser accidentally accepted visibility modifiers on
8464   enum variants, a bug [which has been fixed][1.5ev].
8465 * [A bug was fixed that allowed `use` statements to import unstable
8466   features][1.5use].
8467
8468 Language
8469 --------
8470
8471 * When evaluating expressions at compile-time that are not
8472   compile-time constants (const-evaluating expressions in non-const
8473   contexts), incorrect code such as overlong bitshifts and arithmetic
8474   overflow will [generate a warning instead of an error][1.5ce],
8475   delaying the error until runtime. This will allow the
8476   const-evaluator to be expanded in the future backwards-compatibly.
8477 * The `improper_ctypes` lint [no longer warns about using `isize` and
8478   `usize` in FFI][1.5ict].
8479
8480 Libraries
8481 ---------
8482
8483 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
8484   invariant][1.5c].
8485 * `Default` is [implemented for mutable slices][1.5d].
8486 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
8487 * There are now `From` conversions [between floating point
8488   types][1.5f] where the conversions are lossless.
8489 * There are now `From` conversions [between integer types][1.5i] where
8490   the conversions are lossless.
8491 * [`fs::Metadata` implements `Clone`][1.5fs].
8492 * The `parse` method [accepts a leading "+" when parsing
8493   integers][1.5pi].
8494 * [`AsMut` is implemented for `Vec`][1.5am].
8495 * The `clone_from` implementations for `String` and `BinaryHeap` [have
8496   been optimized][1.5cf] and no longer rely on the default impl.
8497 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
8498   `unsafe extern "C"` function types now [implement `Clone`,
8499   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
8500   `fmt::Debug` for up to 12 arguments][1.5fp].
8501 * [Dropping `Vec`s is much faster in unoptimized builds when the
8502   element types don't implement `Drop`][1.5dv].
8503 * A bug that caused in incorrect behavior when [combining `VecDeque`
8504   with zero-sized types][1.5vdz] was resolved.
8505 * [`PartialOrd` for slices is faster][1.5po].
8506
8507 Miscellaneous
8508 -------------
8509
8510 * [Crate metadata size was reduced by 20%][1.5md].
8511 * [Improvements to code generation reduced the size of libcore by 3.3
8512   MB and rustc's memory usage by 18MB][1.5m].
8513 * [Improvements to deref translation increased performance in
8514   unoptimized builds][1.5dr].
8515 * Various errors in trait resolution [are deduplicated to only be
8516   reported once][1.5te].
8517 * Rust has preliminary [support for rumprun kernels][1.5rr].
8518 * Rust has preliminary [support for NetBSD on amd64][1.5na].
8519
8520 [1.5use]: https://github.com/rust-lang/rust/pull/28364
8521 [1.5po]: https://github.com/rust-lang/rust/pull/28436
8522 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
8523 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
8524 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
8525 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
8526 [1.5md]: https://github.com/rust-lang/rust/pull/28521
8527 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
8528 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
8529 [1.5na]: https://github.com/rust-lang/rust/pull/28543
8530 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
8531 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
8532 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
8533 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
8534 [1.5te]: https://github.com/rust-lang/rust/pull/28645
8535 [1.5at]: https://github.com/rust-lang/rust/pull/28650
8536 [1.5am]: https://github.com/rust-lang/rust/pull/28663
8537 [1.5m]: https://github.com/rust-lang/rust/pull/28778
8538 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
8539 [1.5a]: https://github.com/rust-lang/rust/pull/28811
8540 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
8541 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
8542 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
8543 [1.5i]: https://github.com/rust-lang/rust/pull/28921
8544 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
8545 [1.5f]: https://github.com/rust-lang/rust/pull/29129
8546 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
8547 [1.5s]: https://github.com/rust-lang/rust/pull/29190
8548 [1.5d]: https://github.com/rust-lang/rust/pull/29245
8549 [1.5o]: https://github.com/rust-lang/rust/pull/29259
8550 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
8551 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8552 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
8553 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
8554 [1.5c]: https://github.com/rust-lang/rust/pull/29110
8555 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8556 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
8557 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
8558 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
8559 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
8560 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
8561 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
8562 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
8563 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
8564 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
8565 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
8566 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
8567 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
8568 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
8569 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
8570 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
8571 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
8572 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
8573 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
8574 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
8575 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
8576 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
8577 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
8578 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
8579 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
8580 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
8581 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
8582 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
8583 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
8584 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
8585 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
8586 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
8587 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
8588 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
8589 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
8590 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
8591 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
8592 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
8593 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
8594 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
8595 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
8596 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
8597 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
8598 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
8599 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
8600 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
8601 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
8602 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
8603 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
8604 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
8605 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
8606 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
8607 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
8608 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
8609
8610 Version 1.4.0 (2015-10-29)
8611 ==========================
8612
8613 * ~1200 changes, numerous bugfixes
8614
8615 Highlights
8616 ----------
8617
8618 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
8619   GNU) are now supported and recommended for use.
8620
8621 Breaking Changes
8622 ----------------
8623
8624 * [Several changes have been made to fix type soundness and improve
8625   the behavior of associated types][sound]. See [RFC 1214]. Although
8626   we have mostly introduced these changes as warnings this release, to
8627   become errors next release, there are still some scenarios that will
8628   see immediate breakage.
8629 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
8630   line breaks in addition to `\n`][crlf].
8631 * [Loans of `'static` lifetime extend to the end of a function][stat].
8632 * [`str::parse` no longer introduces avoidable rounding error when
8633   parsing floating point numbers. Together with earlier changes to
8634   float formatting/output, "round trips" like f.to_string().parse()
8635   now preserve the value of f exactly. Additionally, leading plus
8636   signs are now accepted][fp3].
8637
8638
8639 Language
8640 --------
8641
8642 * `use` statements that import multiple items [can now rename
8643   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
8644 * [Binops work correctly on fat pointers][binfat].
8645 * `pub extern crate`, which does not behave as expected, [issues a
8646   warning][pec] until a better solution is found.
8647
8648 Libraries
8649 ---------
8650
8651 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
8652   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
8653   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
8654   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
8655   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
8656   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
8657   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
8658   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
8659   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
8660   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
8661   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
8662   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
8663   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
8664   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
8665   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
8666   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
8667   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
8668   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
8669   [`thread::sleep`].
8670 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
8671   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
8672   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
8673   `f64::from_str_radix`.
8674 * [Reverse-searching strings is faster with the 'two-way'
8675   algorithm][s].
8676 * [`std::io::copy` allows `?Sized` arguments][cc].
8677 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
8678   [override `count`, `nth` and `last` with an *O*(1)
8679   implementation][it].
8680 * [`Default` is implemented for arrays up to `[T; 32]`][d].
8681 * [`IntoRawFd` has been added to the Unix-specific prelude,
8682   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
8683   prelude][pr].
8684 * [`Extend<String>` and `FromIterator<String` are both implemented for
8685   `String`][es].
8686 * [`IntoIterator` is implemented for references to `Option` and
8687   `Result`][into2].
8688 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
8689   Copy`][ext] as part of [RFC 839]. This will cause type inference
8690   breakage in rare situations.
8691 * [`BinaryHeap` implements `Debug`][bh2].
8692 * [`Borrow` and `BorrowMut` are implemented for fixed-size
8693   arrays][bm].
8694 * [`extern fn`s with the "Rust" and "C" ABIs implement common
8695   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
8696 * [String comparison is faster][faststr].
8697 * `&mut T` where `T: std::fmt::Write` [also implements
8698   `std::fmt::Write`][mutw].
8699 * [A stable regression in `VecDeque::push_back` and other
8700   capacity-altering methods that caused panics for zero-sized types
8701   was fixed][vd].
8702 * [Function pointers implement traits for up to 12 parameters][fp2].
8703
8704 Miscellaneous
8705 -------------
8706
8707 * The compiler [no longer uses the 'morestack' feature to prevent
8708   stack overflow][mm]. Instead it uses guard pages and stack
8709   probes (though stack probes are not yet implemented on any platform
8710   but Windows).
8711 * [The compiler matches traits faster when projections are involved][p].
8712 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
8713   `usize`][ffi].
8714 * [Cargo now displays useful information about what its doing during
8715   `cargo update`][cu].
8716
8717 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
8718 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
8719 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
8720 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
8721 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
8722 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
8723 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
8724 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
8725 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
8726 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
8727 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
8728 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
8729 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
8730 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
8731 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
8732 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
8733 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
8734 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
8735 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8736 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8737 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8738 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8739 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8740 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8741 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8742 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8743 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
8744 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
8745 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
8746 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
8747 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
8748 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
8749 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
8750 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
8751 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
8752 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
8753 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
8754 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
8755 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
8756 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
8757 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
8758 [bh2]: https://github.com/rust-lang/rust/pull/28156
8759 [binfat]: https://github.com/rust-lang/rust/pull/28270
8760 [bm]: https://github.com/rust-lang/rust/pull/28197
8761 [cc]: https://github.com/rust-lang/rust/pull/27531
8762 [crlf]: https://github.com/rust-lang/rust/pull/28034
8763 [cu]: https://github.com/rust-lang/cargo/pull/1931
8764 [d]: https://github.com/rust-lang/rust/pull/27825
8765 [dep]: https://github.com/rust-lang/rust/pull/28339
8766 [es]: https://github.com/rust-lang/rust/pull/27956
8767 [ext]: https://github.com/rust-lang/rust/pull/28094
8768 [faststr]: https://github.com/rust-lang/rust/pull/28338
8769 [ffi]: https://github.com/rust-lang/rust/pull/28779
8770 [fp]: https://github.com/rust-lang/rust/pull/28268
8771 [fp2]: https://github.com/rust-lang/rust/pull/28560
8772 [fp3]: https://github.com/rust-lang/rust/pull/27307
8773 [i]: https://github.com/rust-lang/rust/pull/27451
8774 [into2]: https://github.com/rust-lang/rust/pull/28039
8775 [it]: https://github.com/rust-lang/rust/pull/27652
8776 [mm]: https://github.com/rust-lang/rust/pull/27338
8777 [mutw]: https://github.com/rust-lang/rust/pull/28368
8778 [sound]: https://github.com/rust-lang/rust/pull/27641
8779 [p]: https://github.com/rust-lang/rust/pull/27866
8780 [pec]: https://github.com/rust-lang/rust/pull/28486
8781 [pr]: https://github.com/rust-lang/rust/pull/27896
8782 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8783 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8784 [s]: https://github.com/rust-lang/rust/pull/27474
8785 [stab]: https://github.com/rust-lang/rust/pull/28339
8786 [stat]: https://github.com/rust-lang/rust/pull/28321
8787 [vd]: https://github.com/rust-lang/rust/pull/28494
8788
8789 Version 1.3.0 (2015-09-17)
8790 ==============================
8791
8792 * ~900 changes, numerous bugfixes
8793
8794 Highlights
8795 ----------
8796
8797 * The [new object lifetime defaults][nold] have been [turned
8798   on][nold2] after a cycle of warnings about the change. Now types
8799   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
8800   being interpreted as `&'a Box<Trait+'a>` to `&'a
8801   Box<Trait+'static>`.
8802 * [The Rustonomicon][nom] is a new book in the official documentation
8803   that dives into writing unsafe Rust.
8804 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
8805   timekeeping is employed by other std APIs, as well as out-of-tree
8806   time crates.
8807
8808 Breaking Changes
8809 ----------------
8810
8811 * The [new object lifetime defaults][nold] have been [turned
8812   on][nold2] after a cycle of warnings about the change.
8813 * There is a known [regression][lr] in how object lifetime elision is
8814   interpreted, the proper solution for which is undetermined.
8815 * The `#[prelude_import]` attribute, an internal implementation
8816   detail, was accidentally stabilized previously. [It has been put
8817   behind the `prelude_import` feature gate][pi]. This change is
8818   believed to break no existing code.
8819 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8820   [more sane for dynamically sized types][dst3]. Code that relied on
8821   the previous behavior is thought to be broken.
8822 * The `dropck` rules, which checks that destructors can't access
8823   destroyed values, [have been updated][dropck] to match the
8824   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
8825   cause some previously-compiling code to no longer build.
8826
8827 Language
8828 --------
8829
8830 * The [new object lifetime defaults][nold] have been [turned
8831   on][nold2] after a cycle of warnings about the change.
8832 * Semicolons may [now follow types and paths in
8833   macros](https://github.com/rust-lang/rust/pull/27000).
8834 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8835   [more sane for dynamically sized types][dst3]. Code that relied on
8836   the previous behavior is not known to exist, and suspected to be
8837   broken.
8838 * `'static` variables [may now be recursive][st].
8839 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
8840   implementations correctly.
8841 * The `dropck` rules, which checks that destructors can't access
8842   destroyed values, [have been updated][dropck] to match the
8843   [RFC][dropckrfc].
8844
8845 Libraries
8846 ---------
8847
8848 * The [`Duration`] API, [has been stabilized][ds], as well as the
8849   `std::time` module, which presently contains only `Duration`.
8850 * `Box<str>` and `Box<[T]>` both implement `Clone`.
8851 * The owned C string, [`CString`], implements [`Borrow`] and the
8852   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
8853   these allow C strings to be borrowed and cloned in generic code.
8854 * [`CStr`] implements [`Debug`].
8855 * [`AtomicPtr`] implements [`Debug`].
8856 * [`Error`] trait objects [can be downcast to their concrete types][e]
8857   in many common configurations, using the [`is`], [`downcast`],
8858   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
8859   [`Any`] trait.
8860 * Searching for substrings now [employs the two-way algorithm][search]
8861   instead of doing a naive search. This gives major speedups to a
8862   number of methods, including [`contains`][sc], [`find`][sf],
8863   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
8864   [`ends_with`][sew] are also faster.
8865 * The performance of `PartialEq` for slices is [much faster][ps].
8866 * The [`Hash`] trait offers the default method, [`hash_slice`], which
8867   is overridden and optimized by the implementations for scalars.
8868 * The [`Hasher`] trait now has a number of specialized `write_*`
8869   methods for primitive types, for efficiency.
8870 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
8871   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
8872   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
8873   of [`std::error::Error::cause`][iec] also delegates to the inner
8874   error.
8875 * [`process::Child`][pc] gained the [`id`] method, which returns a
8876   `u32` representing the platform-specific process identifier.
8877 * The [`connect`] method on slices is deprecated, replaced by the new
8878   [`join`] method (note that both of these are on the *unstable*
8879   [`SliceConcatExt`] trait, but through the magic of the prelude are
8880   available to stable code anyway).
8881 * The [`Div`] operator is implemented for [`Wrapping`] types.
8882 * [`DerefMut` is implemented for `String`][dms].
8883 * Performance of SipHash (the default hasher for `HashMap`) is
8884   [better for long data][sh].
8885 * [`AtomicPtr`] implements [`Send`].
8886 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
8887   are now [specialized to use uninitialized buffers for increased
8888   performance][rte].
8889 * Lifetime parameters of foreign functions [are now resolved
8890   properly][f].
8891
8892 Misc
8893 ----
8894
8895 * Rust can now, with some coercion, [produce programs that run on
8896   Windows XP][xp], though XP is not considered a supported platform.
8897 * Porting Rust on Windows from the GNU toolchain to MSVC continues
8898   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
8899   recommended for use in 1.3, though should be fully-functional
8900   in the [64-bit 1.4 beta][b14].
8901 * On Fedora-based systems installation will [properly configure the
8902   dynamic linker][fl].
8903 * The compiler gained many new extended error descriptions, which can
8904   be accessed with the `--explain` flag.
8905 * The `dropck` pass, which checks that destructors can't access
8906   destroyed values, [has been rewritten][27261]. This fixes some
8907   soundness holes, and as such will cause some previously-compiling
8908   code to no longer build.
8909 * `rustc` now uses [LLVM to write archive files where possible][ar].
8910   Eventually this will eliminate the compiler's dependency on the ar
8911   utility.
8912 * Rust has [preliminary support for i686 FreeBSD][26959] (it has long
8913   supported FreeBSD on x86_64).
8914 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
8915   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
8916   more strict.
8917 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
8918   will kill the process instead of leaking][nlp].
8919
8920 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
8921 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
8922 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
8923 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
8924 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
8925 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8926 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8927 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
8928 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
8929 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
8930 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
8931 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
8932 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
8933 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8934 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
8935 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
8936 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
8937 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
8938 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8939 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
8940 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
8941 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
8942 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
8943 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8944 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
8945 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
8946 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
8947 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
8948 [ar]: https://github.com/rust-lang/rust/pull/26926
8949 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
8950 [dms]: https://github.com/rust-lang/rust/pull/26241
8951 [27261]: https://github.com/rust-lang/rust/pull/27261
8952 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8953 [ds]: https://github.com/rust-lang/rust/pull/26818
8954 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
8955 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
8956 [dst3]: https://github.com/rust-lang/rust/pull/27351
8957 [e]: https://github.com/rust-lang/rust/pull/24793
8958 [f]: https://github.com/rust-lang/rust/pull/26588
8959 [26959]: https://github.com/rust-lang/rust/pull/26959
8960 [fl]: https://github.com/rust-lang/rust-installer/pull/41
8961 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
8962 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
8963 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
8964 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
8965 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
8966 [lic]: https://github.com/rust-lang/rust/pull/26583
8967 [lnu]: https://github.com/rust-lang/rust/pull/27026
8968 [lr]: https://github.com/rust-lang/rust/issues/27248
8969 [lum]: https://github.com/rust-lang/rust/pull/26378
8970 [lur]: https://github.com/rust-lang/rust/pull/26783
8971 [nlp]: https://github.com/rust-lang/rust/pull/27176
8972 [nold2]: https://github.com/rust-lang/rust/pull/27045
8973 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
8974 [nom]: http://doc.rust-lang.org/nightly/nomicon/
8975 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
8976 [pi]: https://github.com/rust-lang/rust/pull/26699
8977 [ps]: https://github.com/rust-lang/rust/pull/26884
8978 [rte]: https://github.com/rust-lang/rust/pull/26950
8979 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
8980 [search]: https://github.com/rust-lang/rust/pull/26327
8981 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
8982 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
8983 [sh]: https://github.com/rust-lang/rust/pull/27280
8984 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
8985 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
8986 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
8987 [st]: https://github.com/rust-lang/rust/pull/26630
8988 [win1]: https://github.com/rust-lang/rust/pull/26569
8989 [win2]: https://github.com/rust-lang/rust/pull/26741
8990 [win3]: https://github.com/rust-lang/rust/pull/26741
8991 [win4]: https://github.com/rust-lang/rust/pull/27210
8992 [xp]: https://github.com/rust-lang/rust/pull/26569
8993
8994 Version 1.2.0 (2015-08-07)
8995 ==========================
8996
8997 * ~1200 changes, numerous bugfixes
8998
8999 Highlights
9000 ----------
9001
9002 * [Dynamically-sized-type coercions][dst] allow smart pointer types
9003   like `Rc` to contain types without a fixed size, arrays and trait
9004   objects, finally enabling use of `Rc<[T]>` and completing the
9005   implementation of DST.
9006 * [Parallel codegen][parcodegen] is now working again, which can
9007   substantially speed up large builds in debug mode; It also gets
9008   another ~33% speedup when bootstrapping on a 4 core machine (using 8
9009   jobs). It's not enabled by default, but will be "in the near
9010   future". It can be activated with the `-C codegen-units=N` flag to
9011   `rustc`.
9012 * This is the first release with [experimental support for linking
9013   with the MSVC linker and lib C on Windows (instead of using the GNU
9014   variants via MinGW)][win]. It is yet recommended only for the most
9015   intrepid Rustaceans.
9016 * Benchmark compilations are showing a 30% improvement in
9017   bootstrapping over 1.1.
9018
9019 Breaking Changes
9020 ----------------
9021
9022 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
9023   unicode case mapping, which is a previously-planned change in
9024   behavior and considered a bugfix.
9025 * [`mem::align_of`] now specifies [the *minimum alignment* for
9026   T][align], which is usually the alignment programs are interested
9027   in, and the same value reported by clang's
9028   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
9029   break real code.
9030 * [The `#[packed]` attribute is no longer silently accepted by the
9031   compiler][packed]. This attribute did nothing and code that
9032   mentioned it likely did not work as intended.
9033 * Associated type defaults are [now behind the
9034   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
9035   defaults *did not work*, but could be mentioned syntactically. As
9036   such this breakage has minimal impact.
9037
9038 Language
9039 --------
9040
9041 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
9042   matching against dereferenceable values.
9043
9044 Libraries
9045 ---------
9046
9047 * The [`Extend`] trait, which grows a collection from an iterator, is
9048   implemented over iterators of references, for `String`, `Vec`,
9049   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
9050   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
9051 * The [`iter::once`] function returns an iterator that yields a single
9052   element, and [`iter::empty`] returns an iterator that yields no
9053   elements.
9054 * The [`matches`] and [`rmatches`] methods on `str` return iterators
9055   over substring matches.
9056 * [`Cell`] and [`RefCell`] both implement `Eq`.
9057 * A number of methods for wrapping arithmetic are added to the
9058   integral types, [`wrapping_div`], [`wrapping_rem`],
9059   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
9060   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
9061   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
9062   type.. It is illegal for the default arithmetic operations in Rust
9063   to overflow; the desire to wrap must be explicit.
9064 * The `{:#?}` formatting specifier [displays the alternate,
9065   pretty-printed][debugfmt] form of the `Debug` formatter. This
9066   feature was actually introduced prior to 1.0 with little
9067   fanfare.
9068 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
9069   for writing data to formatted strings, similar to [`io::Write`].
9070 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
9071   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
9072   are used by code generators to emit implementations of [`Debug`].
9073 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
9074   methods that convert case, following Unicode case mapping.
9075 * It is now easier to handle poisoned locks. The [`PoisonError`]
9076   type, returned by failing lock operations, exposes `into_inner`,
9077   `get_ref`, and `get_mut`, which all give access to the inner lock
9078   guard, and allow the poisoned lock to continue to operate. The
9079   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
9080   poisoned lock without attempting to take the lock.
9081 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
9082   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
9083   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
9084   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
9085   `ChildStderr`.
9086 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
9087   malformed input.
9088
9089 Misc
9090 ----
9091
9092 * `rustc` employs smarter heuristics for guessing at [typos].
9093 * `rustc` emits more efficient code for [no-op conversions between
9094   unsafe pointers][nop].
9095 * Fat pointers are now [passed in pairs of immediate arguments][fat],
9096   resulting in faster compile times and smaller code.
9097
9098 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
9099 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
9100 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
9101 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
9102 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
9103 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
9104 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
9105 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
9106 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
9107 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
9108 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
9109 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
9110 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
9111 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
9112 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
9113 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
9114 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
9115 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
9116 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
9117 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
9118 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
9119 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
9120 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
9121 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
9122 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
9123 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
9124 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
9125 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
9126 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
9127 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
9128 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
9129 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
9130 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
9131 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9132 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9133 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
9134 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
9135 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
9136 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
9137 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
9138 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
9139 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
9140 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
9141 [align]: https://github.com/rust-lang/rust/pull/25646
9142 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
9143 [typos]: https://github.com/rust-lang/rust/pull/26087
9144 [nop]: https://github.com/rust-lang/rust/pull/26336
9145 [fat]: https://github.com/rust-lang/rust/pull/26411
9146 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
9147 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
9148 [packed]: https://github.com/rust-lang/rust/pull/25541
9149 [ad]: https://github.com/rust-lang/rust/pull/27382
9150 [win]: https://github.com/rust-lang/rust/pull/25350
9151
9152 Version 1.1.0 (2015-06-25)
9153 =========================
9154
9155 * ~850 changes, numerous bugfixes
9156
9157 Highlights
9158 ----------
9159
9160 * The [`std::fs` module has been expanded][fs] to expand the set of
9161   functionality exposed:
9162   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
9163     don't incur a syscall on some platforms.
9164   * A `symlink_metadata` function has been added.
9165   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
9166     access to all underlying information.
9167 * The compiler now contains extended explanations of many errors. When an error
9168   with an explanation occurs the compiler suggests using the `--explain` flag
9169   to read the explanation. Error explanations are also [available online][err-index].
9170 * Thanks to multiple [improvements][sk] to [type checking][pre], as
9171   well as other work, the time to bootstrap the compiler decreased by
9172   32%.
9173
9174 Libraries
9175 ---------
9176
9177 * The [`str::split_whitespace`] method splits a string on unicode
9178   whitespace boundaries.
9179 * On both Windows and Unix, new extension traits provide conversion of
9180   I/O types to and from the underlying system handles. On Unix, these
9181   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
9182   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
9183   `TcpListener`, and `UpdSocket`. Further implementations for
9184   `std::process` will be stabilized later.
9185 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
9186   Windows, symlinks can be created with
9187   `std::os::windows::symlink_dir` and
9188   `std::os::windows::symlink_file`.
9189 * The `mpsc::Receiver` type can now be converted into an iterator with
9190   `into_iter` on the [`IntoIterator`] trait.
9191 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
9192   implementation of the [`From`] trait.
9193 * The `Debug` implementation for `RangeFull` [creates output that is
9194   more consistent with other implementations][rf].
9195 * [`Debug` is implemented for `File`][file].
9196 * The `Default` implementation for `Arc` [no longer requires `Sync +
9197   Send`][arc].
9198 * [The `Iterator` methods `count`, `nth`, and `last` have been
9199   overridden for slices to have *O*(1) performance instead of *O*(*n*)][si].
9200 * Incorrect handling of paths on Windows has been improved in both the
9201   compiler and the standard library.
9202 * [`AtomicPtr` gained a `Default` implementation][ap].
9203 * In accordance with Rust's policy on arithmetic overflow `abs` now
9204   [panics on overflow when debug assertions are enabled][abs].
9205 * The [`Cloned`] iterator, which was accidentally left unstable for
9206   1.0 [has been stabilized][c].
9207 * The [`Incoming`] iterator, which iterates over incoming TCP
9208   connections, and which was accidentally unnamable in 1.0, [is now
9209   properly exported][inc].
9210 * [`BinaryHeap`] no longer corrupts itself [when functions called by
9211   `sift_up` or `sift_down` panic][bh].
9212 * The [`split_off`] method of `LinkedList` [no longer corrupts
9213   the list in certain scenarios][ll].
9214
9215 Misc
9216 ----
9217
9218 * Type checking performance [has improved notably][sk] with
9219   [multiple improvements][pre].
9220 * The compiler [suggests code changes][ch] for more errors.
9221 * rustc and it's build system have experimental support for [building
9222   toolchains against MUSL][m] instead of glibc on Linux.
9223 * The compiler defines the `target_env` cfg value, which is used for
9224   distinguishing toolchains that are otherwise for the same
9225   platform. Presently this is set to `gnu` for common GNU Linux
9226   targets and for MinGW targets, and `musl` for MUSL Linux targets.
9227 * The [`cargo rustc`][crc] command invokes a build with custom flags
9228   to rustc.
9229 * [Android executables are always position independent][pie].
9230 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
9231   with `Drop`][24935].
9232
9233 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
9234 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9235 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9236 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
9237 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
9238 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
9239 [rf]: https://github.com/rust-lang/rust/pull/24491
9240 [err-index]: https://doc.rust-lang.org/error-index.html
9241 [sk]: https://github.com/rust-lang/rust/pull/24615
9242 [pre]: https://github.com/rust-lang/rust/pull/25323
9243 [file]: https://github.com/rust-lang/rust/pull/24598
9244 [ch]: https://github.com/rust-lang/rust/pull/24683
9245 [arc]: https://github.com/rust-lang/rust/pull/24695
9246 [si]: https://github.com/rust-lang/rust/pull/24701
9247 [ap]: https://github.com/rust-lang/rust/pull/24834
9248 [m]: https://github.com/rust-lang/rust/pull/24777
9249 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
9250 [crc]: https://github.com/rust-lang/cargo/pull/1568
9251 [pie]: https://github.com/rust-lang/rust/pull/24953
9252 [abs]: https://github.com/rust-lang/rust/pull/25441
9253 [c]: https://github.com/rust-lang/rust/pull/25496
9254 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
9255 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
9256 [inc]: https://github.com/rust-lang/rust/pull/25522
9257 [bh]: https://github.com/rust-lang/rust/pull/25856
9258 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
9259 [ll]: https://github.com/rust-lang/rust/pull/26022
9260 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
9261 [24935]: https://github.com/rust-lang/rust/pull/24935
9262
9263 Version 1.0.0 (2015-05-15)
9264 ========================
9265
9266 * ~1500 changes, numerous bugfixes
9267
9268 Highlights
9269 ----------
9270
9271 * The vast majority of the standard library is now `#[stable]`. It is
9272   no longer possible to use unstable features with a stable build of
9273   the compiler.
9274 * Many popular crates on [crates.io] now work on the stable release
9275   channel.
9276 * Arithmetic on basic integer types now [checks for overflow in debug
9277   builds][overflow].
9278
9279 Language
9280 --------
9281
9282 * Several [restrictions have been added to trait coherence][coh] in
9283   order to make it easier for upstream authors to change traits
9284   without breaking downstream code.
9285 * Digits of binary and octal literals are [lexed more eagerly][lex] to
9286   improve error messages and macro behavior. For example, `0b1234` is
9287   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
9288 * Trait bounds [are always invariant][inv], eliminating the need for
9289   the `PhantomFn` and `MarkerTrait` lang items, which have been
9290   removed.
9291 * ["-" is no longer a valid character in crate names][cr], the `extern crate
9292   "foo" as bar` syntax has been replaced with `extern crate foo as
9293   bar`, and Cargo now automatically translates "-" in *package* names
9294   to underscore for the crate name.
9295 * [Lifetime shadowing is an error][lt].
9296 * [`Send` no longer implies `'static`][send-rfc].
9297 * [UFCS now supports trait-less associated paths][moar-ufcs] like
9298   `MyType::default()`.
9299 * Primitive types [now have inherent methods][prim-inherent],
9300   obviating the need for extension traits like `SliceExt`.
9301 * Methods with `Self: Sized` in their `where` clause are [considered
9302   object-safe][self-sized], allowing many extension traits like
9303   `IteratorExt` to be merged into the traits they extended.
9304 * You can now [refer to associated types][assoc-where] whose
9305   corresponding trait bounds appear only in a `where` clause.
9306 * The final bits of [OIBIT landed][oibit-final], meaning that traits
9307   like `Send` and `Sync` are now library-defined.
9308 * A [Reflect trait][reflect] was introduced, which means that
9309   downcasting via the `Any` trait is effectively limited to concrete
9310   types. This helps retain the potentially-important "parametricity"
9311   property: generic code cannot behave differently for different type
9312   arguments except in minor ways.
9313 * The `unsafe_destructor` feature is now deprecated in favor of the
9314   [new `dropck`][rfc769]. This change is a major reduction in unsafe
9315   code.
9316
9317 Libraries
9318 ---------
9319
9320 * The `thread_local` module [has been renamed to `std::thread`][th].
9321 * The methods of `IteratorExt` [have been moved to the `Iterator`
9322   trait itself][23300].
9323 * Several traits that implement Rust's conventions for type
9324   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
9325   [centralized in the `std::convert` module][con].
9326 * The `FromError` trait [was removed in favor of `From`][fe].
9327 * The basic sleep function [has moved to
9328   `std::thread::sleep_ms`][slp].
9329 * The `splitn` function now takes an `n` parameter that represents the
9330   number of items yielded by the returned iterator [instead of the
9331   number of 'splits'][spl].
9332 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
9333 * [Derived implementations of `PartialOrd` now order enums according
9334   to their explicitly-assigned discriminants][po].
9335 * [Methods for searching strings are generic over `Pattern`s][pat],
9336   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
9337   some others.
9338 * [In method resolution, object methods are resolved before inherent
9339   methods][meth].
9340 * [`String::from_str` has been deprecated in favor of the `From` impl,
9341   `String::from`][24517].
9342 * [`io::Error` implements `Sync`][ios].
9343 * [The `words` method on `&str` has been replaced with
9344   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
9345   a word?'
9346 * The new path and IO modules are complete and `#[stable]`. This
9347   was the major library focus for this cycle.
9348 * The path API was [revised][path-normalize] to normalize `.`,
9349   adjusting the tradeoffs in favor of the most common usage.
9350 * A large number of remaining APIs in `std` were also stabilized
9351   during this cycle; about 75% of the non-deprecated API surface
9352   is now stable.
9353 * The new [string pattern API][string-pattern] landed, which makes
9354   the string slice API much more internally consistent and flexible.
9355 * A new set of [generic conversion traits][conversion] replaced
9356   many existing ad hoc traits.
9357 * Generic numeric traits were [completely removed][num-traits]. This
9358   was made possible thanks to inherent methods for primitive types,
9359   and the removal gives maximal flexibility for designing a numeric
9360   hierarchy in the future.
9361 * The `Fn` traits are now related via [inheritance][fn-inherit]
9362   and provide ergonomic [blanket implementations][fn-blanket].
9363 * The `Index` and `IndexMut` traits were changed to
9364   [take the index by value][index-value], enabling code like
9365   `hash_map["string"]` to work.
9366 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
9367   `Copy` data is known to be `Clone` as well.
9368
9369 Misc
9370 ----
9371
9372 * Many errors now have extended explanations that can be accessed with
9373   the `--explain` flag to `rustc`.
9374 * Many new examples have been added to the standard library
9375   documentation.
9376 * rustdoc has received a number of improvements focused on completion
9377   and polish.
9378 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
9379 * Much headway was made on ecosystem-wide CI, making it possible
9380   to [compare builds for breakage][ci-compare].
9381
9382
9383 [crates.io]: http://crates.io
9384 [clo]: https://github.com/rust-lang/rust/pull/24034
9385 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
9386 [con]: https://github.com/rust-lang/rust/pull/23875
9387 [cr]: https://github.com/rust-lang/rust/pull/23419
9388 [fe]: https://github.com/rust-lang/rust/pull/23879
9389 [23300]: https://github.com/rust-lang/rust/pull/23300
9390 [inv]: https://github.com/rust-lang/rust/pull/23938
9391 [ios]: https://github.com/rust-lang/rust/pull/24133
9392 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
9393 [lt]: https://github.com/rust-lang/rust/pull/24057
9394 [meth]: https://github.com/rust-lang/rust/pull/24056
9395 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
9396 [po]: https://github.com/rust-lang/rust/pull/24270
9397 [24517]: https://github.com/rust-lang/rust/pull/24517
9398 [slp]: https://github.com/rust-lang/rust/pull/23949
9399 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
9400 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
9401 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
9402 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
9403 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
9404 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
9405 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
9406 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
9407 [self-sized]: https://github.com/rust-lang/rust/pull/22301
9408 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
9409 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
9410 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
9411 [reflect]: https://github.com/rust-lang/rust/pull/23712
9412 [conversion]: https://github.com/rust-lang/rfcs/pull/529
9413 [num-traits]: https://github.com/rust-lang/rust/pull/23549
9414 [index-value]: https://github.com/rust-lang/rust/pull/23601
9415 [rfc769]: https://github.com/rust-lang/rfcs/pull/769
9416 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
9417 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
9418 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
9419 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
9420 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
9421
9422
9423 Version 1.0.0-alpha.2 (2015-02-20)
9424 =====================================
9425
9426 * ~1300 changes, numerous bugfixes
9427
9428 * Highlights
9429
9430     * The various I/O modules were [overhauled][io-rfc] to reduce
9431       unnecessary abstractions and provide better interoperation with
9432       the underlying platform. The old `io` module remains temporarily
9433       at `std::old_io`.
9434     * The standard library now [participates in feature gating][feat],
9435       so use of unstable libraries now requires a `#![feature(...)]`
9436       attribute. The impact of this change is [described on the
9437       forum][feat-forum]. [RFC][feat-rfc].
9438
9439 * Language
9440
9441     * `for` loops [now operate on the `IntoIterator` trait][into],
9442       which eliminates the need to call `.iter()`, etc. to iterate
9443       over collections. There are some new subtleties to remember
9444       though regarding what sort of iterators various types yield, in
9445       particular that `for foo in bar { }` yields values from a move
9446       iterator, destroying the original collection. [RFC][into-rfc].
9447     * Objects now have [default lifetime bounds][obj], so you don't
9448       have to write `Box<Trait+'static>` when you don't care about
9449       storing references. [RFC][obj-rfc].
9450     * In types that implement `Drop`, [lifetimes must outlive the
9451       value][drop]. This will soon make it possible to safely
9452       implement `Drop` for types where `#[unsafe_destructor]` is now
9453       required. Read the [gorgeous RFC][drop-rfc] for details.
9454     * The fully qualified <T as Trait>::X syntax lets you set the Self
9455       type for a trait method or associated type. [RFC][ufcs-rfc].
9456     * References to types that implement `Deref<U>` now [automatically
9457       coerce to references][deref] to the dereferenced type `U`,
9458       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
9459       should eliminate many unsightly uses of `&*`, as when converting
9460       from references to vectors into references to
9461       slices. [RFC][deref-rfc].
9462     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
9463       `|:|`) is obsolete and closure kind is inferred from context.
9464     * [`Self` is a keyword][Self].
9465
9466 * Libraries
9467
9468     * The `Show` and `String` formatting traits [have been
9469       renamed][fmt] to `Debug` and `Display` to more clearly reflect
9470       their related purposes. Automatically getting a string
9471       conversion to use with `format!("{:?}", something_to_debug)` is
9472       now written `#[derive(Debug)]`.
9473     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
9474       OsStr}`, provide strings in platform-specific encodings for easier
9475       interop with system APIs. [RFC][osstr-rfc].
9476     * The `boxed::into_raw` and `Box::from_raw` functions [convert
9477       between `Box<T>` and `*mut T`][boxraw], a common pattern for
9478       creating raw pointers.
9479
9480 * Tooling
9481
9482     * Certain long error messages of the form 'expected foo found bar'
9483       are now [split neatly across multiple
9484       lines][multiline]. Examples in the PR.
9485     * On Unix Rust can be [uninstalled][un] by running
9486       `/usr/local/lib/rustlib/uninstall.sh`.
9487     * The `#[rustc_on_unimplemented]` attribute, requiring the
9488       'on_unimplemented' feature, lets rustc [display custom error
9489       messages when a trait is expected to be implemented for a type
9490       but is not][onun].
9491
9492 * Misc
9493
9494     * Rust is tested against a [LALR grammar][lalr], which parses
9495       almost all the Rust files that rustc does.
9496
9497 [boxraw]: https://github.com/rust-lang/rust/pull/21318
9498 [close]: https://github.com/rust-lang/rust/pull/21843
9499 [deref]: https://github.com/rust-lang/rust/pull/21351
9500 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
9501 [drop]: https://github.com/rust-lang/rust/pull/21972
9502 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
9503 [feat]: https://github.com/rust-lang/rust/pull/21248
9504 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
9505 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
9506 [fmt]: https://github.com/rust-lang/rust/pull/21457
9507 [into]: https://github.com/rust-lang/rust/pull/20790
9508 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
9509 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9510 [lalr]: https://github.com/rust-lang/rust/pull/21452
9511 [multiline]: https://github.com/rust-lang/rust/pull/19870
9512 [obj]: https://github.com/rust-lang/rust/pull/22230
9513 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
9514 [onun]: https://github.com/rust-lang/rust/pull/20889
9515 [osstr]: https://github.com/rust-lang/rust/pull/21488
9516 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9517 [Self]: https://github.com/rust-lang/rust/pull/22158
9518 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
9519 [un]: https://github.com/rust-lang/rust/pull/22256
9520
9521
9522 Version 1.0.0-alpha (2015-01-09)
9523 ==================================
9524
9525   * ~2400 changes, numerous bugfixes
9526
9527   * Highlights
9528
9529     * The language itself is considered feature complete for 1.0,
9530       though there will be many usability improvements and bugfixes
9531       before the final release.
9532     * Nearly 50% of the public API surface of the standard library has
9533       been declared 'stable'. Those interfaces are unlikely to change
9534       before 1.0.
9535     * The long-running debate over integer types has been
9536       [settled][ints]: Rust will ship with types named `isize` and
9537       `usize`, rather than `int` and `uint`, for pointer-sized
9538       integers. Guidelines will be rolled out during the alpha cycle.
9539     * Most crates that are not `std` have been moved out of the Rust
9540       distribution into the Cargo ecosystem so they can evolve
9541       separately and don't need to be stabilized as quickly, including
9542       'time', 'getopts', 'num', 'regex', and 'term'.
9543     * Documentation continues to be expanded with more API coverage, more
9544       examples, and more in-depth explanations. The guides have been
9545       consolidated into [The Rust Programming Language][trpl].
9546     * "[Rust By Example][rbe]" is now maintained by the Rust team.
9547     * All official Rust binary installers now come with [Cargo], the
9548       Rust package manager.
9549
9550 * Language
9551
9552     * Closures have been [completely redesigned][unboxed] to be
9553       implemented in terms of traits, can now be used as generic type
9554       bounds and thus monomorphized and inlined, or via an opaque
9555       pointer (boxed) as in the old system. The new system is often
9556       referred to as 'unboxed' closures.
9557     * Traits now support [associated types][assoc], allowing families
9558       of related types to be defined together and used generically in
9559       powerful ways.
9560     * Enum variants are [namespaced by their type names][enum].
9561     * [`where` clauses][where] provide a more versatile and attractive
9562       syntax for specifying generic bounds, though the previous syntax
9563       remains valid.
9564     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
9565       numeric types.
9566     * Rust [no longer has a runtime][rt] of any description, and only
9567       supports OS threads, not green threads.
9568     * At long last, Rust has been overhauled for 'dynamically-sized
9569       types' ([DST]), which integrates 'fat pointers' (object types,
9570       arrays, and `str`) more deeply into the type system, making it
9571       more consistent.
9572     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
9573       `..j` that produce range types and which, when combined with the
9574       `Index` operator and multidispatch, leads to a convenient slice
9575       notation, `[i..j]`.
9576     * The new range syntax revealed an ambiguity in the fixed-length
9577       array syntax, so now fixed length arrays [are written `[T;
9578       N]`][arrays].
9579     * The `Copy` trait is no longer implemented automatically. Unsafe
9580       pointers no longer implement `Sync` and `Send` so types
9581       containing them don't automatically either. `Sync` and `Send`
9582       are now 'unsafe traits' so one can "forcibly" implement them via
9583       `unsafe impl` if a type confirms to the requirements for them
9584       even though the internals do not (e.g. structs containing unsafe
9585       pointers like `Arc`). These changes are intended to prevent some
9586       footguns and are collectively known as [opt-in built-in
9587       traits][oibit] (though `Sync` and `Send` will soon become pure
9588       library types unknown to the compiler).
9589     * Operator traits now take their operands [by value][ops], and
9590       comparison traits can use multidispatch to compare one type
9591       against multiple other types, allowing e.g. `String` to be
9592       compared with `&str`.
9593     * `if let` and `while let` are no longer feature-gated.
9594     * Rust has adopted a more [uniform syntax for escaping unicode
9595       characters][unicode].
9596     * `macro_rules!` [has been declared stable][mac]. Though it is a
9597       flawed system it is sufficiently popular that it must be usable
9598       for 1.0. Effort has gone into [future-proofing][mac-future] it
9599       in ways that will allow other macro systems to be developed in
9600       parallel, and won't otherwise impact the evolution of the
9601       language.
9602     * The prelude has been [pared back significantly][prelude] such
9603       that it is the minimum necessary to support the most pervasive
9604       code patterns, and through [generalized where clauses][where]
9605       many of the prelude extension traits have been consolidated.
9606     * Rust's rudimentary reflection [has been removed][refl], as it
9607       incurred too much code generation for little benefit.
9608     * [Struct variants][structvars] are no longer feature-gated.
9609     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
9610       known as 'higher-ranked trait bounds', this crucially allows
9611       unboxed closures to work.
9612     * Macros invocations surrounded by parens or square brackets and
9613       not terminated by a semicolon are [parsed as
9614       expressions][macros], which makes expressions like `vec![1i32,
9615       2, 3].len()` work as expected.
9616     * Trait objects now implement their traits automatically, and
9617       traits that can be coerced to objects now must be [object
9618       safe][objsafe].
9619     * Automatically deriving traits is now done with `#[derive(...)]`
9620       not `#[deriving(...)]` for [consistency with other naming
9621       conventions][derive].
9622     * Importing the containing module or enum at the same time as
9623       items or variants they contain is [now done with `self` instead
9624       of `mod`][self], as in use `foo::{self, bar}`
9625     * Glob imports are no longer feature-gated.
9626     * The `box` operator and `box` patterns have been feature-gated
9627       pending a redesign. For now unique boxes should be allocated
9628       like other containers, with `Box::new`.
9629
9630 * Libraries
9631
9632     * A [series][coll1] of [efforts][coll2] to establish
9633       [conventions][coll3] for collections types has resulted in API
9634       improvements throughout the standard library.
9635     * New [APIs for error handling][err] provide ergonomic interop
9636       between error types, and [new conventions][err-conv] describe
9637       more clearly the recommended error handling strategies in Rust.
9638     * The `fail!` macro has been renamed to [`panic!`][panic] so that
9639       it is easier to discuss failure in the context of error handling
9640       without making clarifications as to whether you are referring to
9641       the 'fail' macro or failure more generally.
9642     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
9643       syscall when available.
9644     * The 'serialize' crate has been renamed 'rustc-serialize' and
9645       moved out of the distribution to Cargo. Although it is widely
9646       used now, it is expected to be superseded in the near future.
9647     * The `Show` formatter, typically implemented with
9648       `#[derive(Show)]` is [now requested with the `{:?}`
9649       specifier][show] and is intended for use by all types, for uses
9650       such as `println!` debugging. The new `String` formatter must be
9651       implemented by hand, uses the `{}` specifier, and is intended
9652       for full-fidelity conversions of things that can logically be
9653       represented as strings.
9654
9655 * Tooling
9656
9657     * [Flexible target specification][flex] allows rustc's code
9658       generation to be configured to support otherwise-unsupported
9659       platforms.
9660     * Rust comes with rust-gdb and rust-lldb scripts that launch their
9661       respective debuggers with Rust-appropriate pretty-printing.
9662     * The Windows installation of Rust is distributed with the
9663       MinGW components currently required to link binaries on that
9664       platform.
9665
9666 * Misc
9667
9668     * Nullable enum optimizations have been extended to more types so
9669       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
9670       space than the inner types themselves.
9671     * Work has begun on supporting AArch64.
9672
9673 [Cargo]: https://crates.io
9674 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
9675 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
9676 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
9677 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
9678 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
9679 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
9680 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
9681 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
9682 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
9683 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
9684 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
9685 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
9686 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
9687 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
9688 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
9689 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
9690 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
9691 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
9692 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
9693 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
9694 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
9695 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
9696 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
9697 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
9698 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
9699 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
9700 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
9701 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
9702 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
9703 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
9704 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
9705 [trpl]: https://doc.rust-lang.org/book/index.html
9706 [rbe]: http://rustbyexample.com/
9707
9708
9709 Version 0.12.0 (2014-10-09)
9710 =============================
9711
9712   * ~1900 changes, numerous bugfixes
9713
9714   * Highlights
9715
9716     * The introductory documentation (now called The Rust Guide) has
9717       been completely rewritten, as have a number of supplementary
9718       guides.
9719     * Rust's package manager, Cargo, continues to improve and is
9720       sometimes considered to be quite awesome.
9721     * Many API's in `std` have been reviewed and updated for
9722       consistency with the in-development Rust coding
9723       guidelines. The standard library documentation tracks
9724       stabilization progress.
9725     * Minor libraries have been moved out-of-tree to the rust-lang org
9726       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
9727       be installed with Cargo.
9728     * Lifetime elision allows lifetime annotations to be left off of
9729       function declarations in many common scenarios.
9730     * Rust now works on 64-bit Windows.
9731
9732   * Language
9733     * Indexing can be overloaded with the `Index` and `IndexMut`
9734       traits.
9735     * The `if let` construct takes a branch only if the `let` pattern
9736       matches, currently behind the 'if_let' feature gate.
9737     * 'where clauses', a more flexible syntax for specifying trait
9738       bounds that is more aesthetic, have been added for traits and
9739       free functions. Where clauses will in the future make it
9740       possible to constrain associated types, which would be
9741       impossible with the existing syntax.
9742     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
9743       the 'slicing_syntax' feature gate, and can be overloaded with
9744       the `Slice` or `SliceMut` traits.
9745     * The syntax for matching of sub-slices has been changed to use a
9746       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
9747       consistency with other uses of `..` and to future-proof
9748       potential additional uses of the syntax.
9749     * The syntax for matching inclusive ranges in patterns has changed
9750       from `0..3` to `0...4` to be consistent with the exclusive range
9751       syntax for slicing.
9752     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
9753       c]`) has been put behind the 'advanced_slice_patterns' feature
9754       gate and may be removed in the future.
9755     * Components of tuples and tuple structs can be extracted using
9756       the `value.0` syntax, currently behind the `tuple_indexing`
9757       feature gate.
9758     * The `#[crate_id]` attribute is no longer supported; versioning
9759       is handled by the package manager.
9760     * Renaming crate imports are now written `extern crate foo as bar`
9761       instead of `extern crate bar = foo`.
9762     * Renaming use statements are now written `use foo as bar` instead
9763       of `use bar = foo`.
9764     * `let` and `match` bindings and argument names in macros are now
9765       hygienic.
9766     * The new, more efficient, closure types ('unboxed closures') have
9767       been added under a feature gate, 'unboxed_closures'. These will
9768       soon replace the existing closure types, once higher-ranked
9769       trait lifetimes are added to the language.
9770     * `move` has been added as a keyword, for indicating closures
9771       that capture by value.
9772     * Mutation and assignment is no longer allowed in pattern guards.
9773     * Generic structs and enums can now have trait bounds.
9774     * The `Share` trait is now called `Sync` to free up the term
9775       'shared' to refer to 'shared reference' (the default reference
9776       type.
9777     * Dynamically-sized types have been mostly implemented,
9778       unifying the behavior of fat-pointer types with the rest of the
9779       type system.
9780     * As part of dynamically-sized types, the `Sized` trait has been
9781       introduced, which qualifying types implement by default, and
9782       which type parameters expect by default. To specify that a type
9783       parameter does not need to be sized, write `<Sized? T>`. Most
9784       types are `Sized`, notable exceptions being unsized arrays
9785       (`[T]`) and trait types.
9786     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
9787     * Lifetime bounds can now be applied to type parameters and object
9788       types.
9789     * The old, reference counted GC type, `Gc<T>` which was once
9790       denoted by the `@` sigil, has finally been removed. GC will be
9791       revisited in the future.
9792
9793   * Libraries
9794     * Library documentation has been improved for a number of modules.
9795     * Bit-vectors, collections::bitv has been modernized.
9796     * The url crate is deprecated in favor of
9797       http://github.com/servo/rust-url, which can be installed with
9798       Cargo.
9799     * Most I/O stream types can be cloned and subsequently closed from
9800       a different thread.
9801     * A `std::time::Duration` type has been added for use in I/O
9802       methods that rely on timers, as well as in the 'time' crate's
9803       `Timespec` arithmetic.
9804     * The runtime I/O abstraction layer that enabled the green thread
9805       scheduler to do non-thread-blocking I/O has been removed, along
9806       with the libuv-based implementation employed by the green thread
9807       scheduler. This will greatly simplify the future I/O work.
9808     * `collections::btree` has been rewritten to have a more
9809       idiomatic and efficient design.
9810
9811   * Tooling
9812     * rustdoc output now indicates the stability levels of API's.
9813     * The `--crate-name` flag can specify the name of the crate
9814       being compiled, like `#[crate_name]`.
9815     * The `-C metadata` specifies additional metadata to hash into
9816       symbol names, and `-C extra-filename` specifies additional
9817       information to put into the output filename, for use by the
9818       package manager for versioning.
9819     * debug info generation has continued to improve and should be
9820       more reliable under both gdb and lldb.
9821     * rustc has experimental support for compiling in parallel
9822       using the `-C codegen-units` flag.
9823     * rustc no longer encodes rpath information into binaries by
9824       default.
9825
9826   * Misc
9827     * Stack usage has been optimized with LLVM lifetime annotations.
9828     * Official Rust binaries on Linux are more compatible with older
9829       kernels and distributions, built on CentOS 5.10.
9830
9831
9832 Version 0.11.0 (2014-07-02)
9833 ==========================
9834
9835   * ~1700 changes, numerous bugfixes
9836
9837   * Language
9838     * ~[T] has been removed from the language. This type is superseded by
9839       the Vec<T> type.
9840     * ~str has been removed from the language. This type is superseded by
9841       the String type.
9842     * ~T has been removed from the language. This type is superseded by the
9843       Box<T> type.
9844     * @T has been removed from the language. This type is superseded by the
9845       standard library's std::gc::Gc<T> type.
9846     * Struct fields are now all private by default.
9847     * Vector indices and shift amounts are both required to be a `uint`
9848       instead of any integral type.
9849     * Byte character, byte string, and raw byte string literals are now all
9850       supported by prefixing the normal literal with a `b`.
9851     * Multiple ABIs are no longer allowed in an ABI string
9852     * The syntax for lifetimes on closures/procedures has been tweaked
9853       slightly: `<'a>|A, B|: 'b + K -> T`
9854     * Floating point modulus has been removed from the language; however it
9855       is still provided by a library implementation.
9856     * Private enum variants are now disallowed.
9857     * The `priv` keyword has been removed from the language.
9858     * A closure can no longer be invoked through a &-pointer.
9859     * The `use foo, bar, baz;` syntax has been removed from the language.
9860     * The transmute intrinsic no longer works on type parameters.
9861     * Statics now allow blocks/items in their definition.
9862     * Trait bounds are separated from objects with + instead of : now.
9863     * Objects can no longer be read while they are mutably borrowed.
9864     * The address of a static is now marked as insignificant unless the
9865       #[inline(never)] attribute is placed it.
9866     * The #[unsafe_destructor] attribute is now behind a feature gate.
9867     * Struct literals are no longer allowed in ambiguous positions such as
9868       if, while, match, and for..in.
9869     * Declaration of lang items and intrinsics are now feature-gated by
9870       default.
9871     * Integral literals no longer default to `int`, and floating point
9872       literals no longer default to `f64`. Literals must be suffixed with an
9873       appropriate type if inference cannot determine the type of the
9874       literal.
9875     * The Box<T> type is no longer implicitly borrowed to &mut T.
9876     * Procedures are now required to not capture borrowed references.
9877
9878   * Libraries
9879     * The standard library is now a "facade" over a number of underlying
9880       libraries. This means that development on the standard library should
9881       be speedier due to smaller crates, as well as a clearer line between
9882       all dependencies.
9883     * A new library, libcore, lives under the standard library's facade
9884       which is Rust's "0-assumption" library, suitable for embedded and
9885       kernel development for example.
9886     * A regex crate has been added to the standard distribution. This crate
9887       includes statically compiled regular expressions.
9888     * The unwrap/unwrap_err methods on Result require a Show bound for
9889       better error messages.
9890     * The return types of the std::comm primitives have been centralized
9891       around the Result type.
9892     * A number of I/O primitives have gained the ability to time out their
9893       operations.
9894     * A number of I/O primitives have gained the ability to close their
9895       reading/writing halves to cancel pending operations.
9896     * Reverse iterator methods have been removed in favor of `rev()` on
9897       their forward-iteration counterparts.
9898     * A bitflags! macro has been added to enable easy interop with C and
9899       management of bit flags.
9900     * A debug_assert! macro is now provided which is disabled when
9901       `--cfg ndebug` is passed to the compiler.
9902     * A graphviz crate has been added for creating .dot files.
9903     * The std::cast module has been migrated into std::mem.
9904     * The std::local_data api has been migrated from freestanding functions
9905       to being based on methods.
9906     * The Pod trait has been renamed to Copy.
9907     * jemalloc has been added as the default allocator for types.
9908     * The API for allocating memory has been changed to use proper alignment
9909       and sized deallocation
9910     * Connecting a TcpStream or binding a TcpListener is now based on a
9911       string address and a u16 port. This allows connecting to a hostname as
9912       opposed to an IP.
9913     * The Reader trait now contains a core method, read_at_least(), which
9914       correctly handles many repeated 0-length reads.
9915     * The process-spawning API is now centered around a builder-style
9916       Command struct.
9917     * The :? printing qualifier has been moved from the standard library to
9918       an external libdebug crate.
9919     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
9920       have been renamed to Eq/Ord.
9921     * The select/plural methods have been removed from format!. The escapes
9922       for { and } have also changed from \{ and \} to {{ and }},
9923       respectively.
9924     * The TaskBuilder API has been re-worked to be a true builder, and
9925       extension traits for spawning native/green tasks have been added.
9926
9927   * Tooling
9928     * All breaking changes to the language or libraries now have their
9929       commit message annotated with `[breaking-change]` to allow for easy
9930       discovery of breaking changes.
9931     * The compiler will now try to suggest how to annotate lifetimes if a
9932       lifetime-related error occurs.
9933     * Debug info continues to be improved greatly with general bug fixes and
9934       better support for situations like link time optimization (LTO).
9935     * Usage of syntax extensions when cross-compiling has been fixed.
9936     * Functionality equivalent to GCC & Clang's -ffunction-sections,
9937       -fdata-sections and --gc-sections has been enabled by default
9938     * The compiler is now stricter about where it will load module files
9939       from when a module is declared via `mod foo;`.
9940     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
9941       Syntax extensions are now discovered via a "plugin registrar" type
9942       which will be extended in the future to other various plugins.
9943     * Lints have been restructured to allow for dynamically loadable lints.
9944     * A number of rustdoc improvements:
9945       * The HTML output has been visually redesigned.
9946       * Markdown is now powered by hoedown instead of sundown.
9947       * Searching heuristics have been greatly improved.
9948       * The search index has been reduced in size by a great amount.
9949       * Cross-crate documentation via `pub use` has been greatly improved.
9950       * Primitive types are now hyperlinked and documented.
9951     * Documentation has been moved from static.rust-lang.org/doc to
9952       doc.rust-lang.org
9953     * A new sandbox, play.rust-lang.org, is available for running and
9954       sharing rust code examples on-line.
9955     * Unused attributes are now more robustly warned about.
9956     * The dead_code lint now warns about unused struct fields.
9957     * Cross-compiling to iOS is now supported.
9958     * Cross-compiling to mipsel is now supported.
9959     * Stability attributes are now inherited by default and no longer apply
9960       to intra-crate usage, only inter-crate usage.
9961     * Error message related to non-exhaustive match expressions have been
9962       greatly improved.
9963
9964
9965 Version 0.10 (2014-04-03)
9966 =========================
9967
9968   * ~1500 changes, numerous bugfixes
9969
9970   * Language
9971     * A new RFC process is now in place for modifying the language.
9972     * Patterns with `@`-pointers have been removed from the language.
9973     * Patterns with unique vectors (`~[T]`) have been removed from the
9974       language.
9975     * Patterns with unique strings (`~str`) have been removed from the
9976       language.
9977     * `@str` has been removed from the language.
9978     * `@[T]` has been removed from the language.
9979     * `@self` has been removed from the language.
9980     * `@Trait` has been removed from the language.
9981     * Headers on `~` allocations which contain `@` boxes inside the type for
9982       reference counting have been removed.
9983     * The semantics around the lifetimes of temporary expressions have changed,
9984       see #3511 and #11585 for more information.
9985     * Cross-crate syntax extensions are now possible, but feature gated. See
9986       #11151 for more information. This includes both `macro_rules!` macros as
9987       well as syntax extensions such as `format!`.
9988     * New lint modes have been added, and older ones have been turned on to be
9989       warn-by-default.
9990       * Unnecessary parentheses
9991       * Uppercase statics
9992       * Camel Case types
9993       * Uppercase variables
9994       * Publicly visible private types
9995       * `#[deriving]` with raw pointers
9996     * Unsafe functions can no longer be coerced to closures.
9997     * Various obscure macros such as `log_syntax!` are now behind feature gates.
9998     * The `#[simd]` attribute is now behind a feature gate.
9999     * Visibility is no longer allowed on `extern crate` statements, and
10000       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
10001     * Trailing commas are now allowed in argument lists and tuple patterns.
10002     * The `do` keyword has been removed, it is now a reserved keyword.
10003     * Default type parameters have been implemented, but are feature gated.
10004     * Borrowed variables through captures in closures are now considered soundly.
10005     * `extern mod` is now `extern crate`
10006     * The `Freeze` trait has been removed.
10007     * The `Share` trait has been added for types that can be shared among
10008       threads.
10009     * Labels in macros are now hygienic.
10010     * Expression/statement macro invocations can be delimited with `{}` now.
10011     * Treatment of types allowed in `static mut` locations has been tweaked.
10012     * The `*` and `.` operators are now overloadable through the `Deref` and
10013       `DerefMut` traits.
10014     * `~Trait` and `proc` no longer have `Send` bounds by default.
10015     * Partial type hints are now supported with the `_` type marker.
10016     * An `Unsafe` type was introduced for interior mutability. It is now
10017       considered undefined to transmute from `&T` to `&mut T` without using the
10018       `Unsafe` type.
10019     * The #[linkage] attribute was implemented for extern statics/functions.
10020     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
10021     * `Pod` was renamed to `Copy`.
10022
10023   * Libraries
10024     * The `libextra` library has been removed. It has now been decomposed into
10025       component libraries with smaller and more focused nuggets of
10026       functionality. The full list of libraries can be found on the
10027       documentation index page.
10028     * std: `std::condition` has been removed. All I/O errors are now propagated
10029       through the `Result` type. In order to assist with error handling, a
10030       `try!` macro for unwrapping errors with an early return and a lint for
10031       unused results has been added. See #12039 for more information.
10032     * std: The `vec` module has been renamed to `slice`.
10033     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
10034       This will become the only growable vector in the future.
10035     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
10036       are now found at `std::io::BufferedReader` instead of
10037       `std::io::buffered::BufferedReader`.
10038     * std: `print` and `println` are no longer in the prelude, the `print!` and
10039       `println!` macros are intended to be used instead.
10040     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
10041       attempts to statically prevent cycles.
10042     * std: The standard distribution is adopting the policy of pushing failure
10043       to the user rather than failing in libraries. Many functions (such as
10044       `slice::last()`) now return `Option<T>` instead of `T` + failing.
10045     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
10046       deriving mode: `#[deriving(Show)]`.
10047     * std: `ToStr` is now implemented for all types implementing `Show`.
10048     * std: The formatting trait methods now take `&self` instead of `&T`
10049     * std: The `invert()` method on iterators has been renamed to `rev()`
10050     * std: `std::num` has seen a reduction in the genericity of its traits,
10051       consolidating functionality into a few core traits.
10052     * std: Backtraces are now printed on task failure if the environment
10053       variable `RUST_BACKTRACE` is present.
10054     * std: Naming conventions for iterators have been standardized. More details
10055       can be found on the wiki's style guide.
10056     * std: `eof()` has been removed from the `Reader` trait. Specific types may
10057       still implement the function.
10058     * std: Networking types are now cloneable to allow simultaneous reads/writes.
10059     * std: `assert_approx_eq!` has been removed
10060     * std: The `e` and `E` formatting specifiers for floats have been added to
10061       print them in exponential notation.
10062     * std: The `Times` trait has been removed
10063     * std: Indications of variance and opting out of builtin bounds is done
10064       through marker types in `std::kinds::marker` now
10065     * std: `hash` has been rewritten, `IterBytes` has been removed, and
10066       `#[deriving(Hash)]` is now possible.
10067     * std: `SharedChan` has been removed, `Sender` is now cloneable.
10068     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
10069     * std: `Chan::new` is now `channel()`.
10070     * std: A new synchronous channel type has been implemented.
10071     * std: A `select!` macro is now provided for selecting over `Receiver`s.
10072     * std: `hashmap` and `trie` have been moved to `libcollections`
10073     * std: `run` has been rolled into `io::process`
10074     * std: `assert_eq!` now uses `{}` instead of `{:?}`
10075     * std: The equality and comparison traits have seen some reorganization.
10076     * std: `rand` has moved to `librand`.
10077     * std: `to_{lower,upper}case` has been implemented for `char`.
10078     * std: Logging has been moved to `liblog`.
10079     * collections: `HashMap` has been rewritten for higher performance and less
10080       memory usage.
10081     * native: The default runtime is now `libnative`. If `libgreen` is desired,
10082       it can be booted manually. The runtime guide has more information and
10083       examples.
10084     * native: All I/O functionality except signals has been implemented.
10085     * green: Task spawning with `libgreen` has been optimized with stack caching
10086       and various trimming of code.
10087     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
10088     * sync: The `extra::sync` module has been updated to modern rust (and moved
10089       to the `sync` library), tweaking and improving various interfaces while
10090       dropping redundant functionality.
10091     * sync: A new `Barrier` type has been added to the `sync` library.
10092     * sync: An efficient mutex for native and green tasks has been implemented.
10093     * serialize: The `base64` module has seen some improvement. It treats
10094       newlines better, has non-string error values, and has seen general
10095       cleanup.
10096     * fourcc: A `fourcc!` macro was introduced
10097     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
10098       hexadecimal literal.
10099
10100   * Tooling
10101     * `rustpkg` has been deprecated and removed from the main repository. Its
10102       replacement, `cargo`, is under development.
10103     * Nightly builds of rust are now available
10104     * The memory usage of rustc has been improved many times throughout this
10105       release cycle.
10106     * The build process supports disabling rpath support for the rustc binary
10107       itself.
10108     * Code generation has improved in some cases, giving more information to the
10109       LLVM optimization passes to enable more extensive optimizations.
10110     * Debuginfo compatibility with lldb on OSX has been restored.
10111     * The master branch is now gated on an android bot, making building for
10112       android much more reliable.
10113     * Output flags have been centralized into one `--emit` flag.
10114     * Crate type flags have been centralized into one `--crate-type` flag.
10115     * Codegen flags have been consolidated behind a `-C` flag.
10116     * Linking against outdated crates now has improved error messages.
10117     * Error messages with lifetimes will often suggest how to annotate the
10118       function to fix the error.
10119     * Many more types are documented in the standard library, and new guides
10120       were written.
10121     * Many `rustdoc` improvements:
10122       * code blocks are syntax highlighted.
10123       * render standalone markdown files.
10124       * the --test flag tests all code blocks by default.
10125       * exported macros are displayed.
10126       * re-exported types have their documentation inlined at the location of the
10127         first re-export.
10128       * search works across crates that have been rendered to the same output
10129         directory.
10130
10131
10132 Version 0.9 (2014-01-09)
10133 ==========================
10134
10135    * ~1800 changes, numerous bugfixes
10136
10137    * Language
10138       * The `float` type has been removed. Use `f32` or `f64` instead.
10139       * A new facility for enabling experimental features (feature gating) has
10140         been added, using the crate-level `#[feature(foo)]` attribute.
10141       * Managed boxes (@) are now behind a feature gate
10142         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
10143         standard library's `Gc` or `Rc` types instead.
10144       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
10145       * Jumping back to the top of a loop is now done with `continue` instead of
10146         `loop`.
10147       * Strings can no longer be mutated through index assignment.
10148       * Raw strings can be created via the basic `r"foo"` syntax or with matched
10149         hash delimiters, as in `r###"foo"###`.
10150       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
10151         called once.
10152       * The `&fn` type is now written `|args| -> ret` to match the literal form.
10153       * `@fn`s have been removed.
10154       * `do` only works with procs in order to make it obvious what the cost
10155         of `do` is.
10156       * Single-element tuple-like structs can no longer be dereferenced to
10157         obtain the inner value. A more comprehensive solution for overloading
10158         the dereference operator will be provided in the future.
10159       * The `#[link(...)]` attribute has been replaced with
10160         `#[crate_id = "name#vers"]`.
10161       * Empty `impl`s must be terminated with empty braces and may not be
10162         terminated with a semicolon.
10163       * Keywords are no longer allowed as lifetime names; the `self` lifetime
10164         no longer has any special meaning.
10165       * The old `fmt!` string formatting macro has been removed.
10166       * `printf!` and `printfln!` (old-style formatting) removed in favor of
10167         `print!` and `println!`.
10168       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
10169       * The `extern mod foo (name = "bar")` syntax has been removed. Use
10170         `extern mod foo = "bar"` instead.
10171       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
10172       * Macros can have attributes.
10173       * Macros can expand to items with attributes.
10174       * Macros can expand to multiple items.
10175       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
10176       * Comments may be nested.
10177       * Values automatically coerce to trait objects they implement, without
10178         an explicit `as`.
10179       * Enum discriminants are no longer an entire word but as small as needed to
10180         contain all the variants. The `repr` attribute can be used to override
10181         the discriminant size, as in `#[repr(int)]` for integer-sized, and
10182         `#[repr(C)]` to match C enums.
10183       * Non-string literals are not allowed in attributes (they never worked).
10184       * The FFI now supports variadic functions.
10185       * Octal numeric literals, as in `0o7777`.
10186       * The `concat!` syntax extension performs compile-time string concatenation.
10187       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
10188         removed as Rust no longer uses segmented stacks.
10189       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
10190       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
10191         not `*`; ignoring remaining fields of a struct is also done with `..`,
10192         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
10193       * `rustc` supports the "win64" calling convention via `extern "win64"`.
10194       * `rustc` supports the "system" calling convention, which defaults to the
10195         preferred convention for the target platform, "stdcall" on 32-bit Windows,
10196         "C" elsewhere.
10197       * The `type_overflow` lint (default: warn) checks literals for overflow.
10198       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
10199       * The `attribute_usage` lint (default: warn) warns about unknown
10200         attributes.
10201       * The `unknown_features` lint (default: warn) warns about unknown
10202         feature gates.
10203       * The `dead_code` lint (default: warn) checks for dead code.
10204       * Rust libraries can be linked statically to one another
10205       * `#[link_args]` is behind the `link_args` feature gate.
10206       * Native libraries are now linked with `#[link(name = "foo")]`
10207       * Native libraries can be statically linked to a rust crate
10208         (`#[link(name = "foo", kind = "static")]`).
10209       * Native OS X frameworks are now officially supported
10210         (`#[link(name = "foo", kind = "framework")]`).
10211       * The `#[thread_local]` attribute creates thread-local (not task-local)
10212         variables. Currently behind the `thread_local` feature gate.
10213       * The `return` keyword may be used in closures.
10214       * Types that can be copied via a memcpy implement the `Pod` kind.
10215       * The `cfg` attribute can now be used on struct fields and enum variants.
10216
10217    * Libraries
10218       * std: The `option` and `result` API's have been overhauled to make them
10219         simpler, more consistent, and more composable.
10220       * std: The entire `std::io` module has been replaced with one that is
10221         more comprehensive and that properly interfaces with the underlying
10222         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
10223         implemented.
10224       * std: `io::util` contains a number of useful implementations of
10225         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
10226         `ZeroReader`, `TeeReader`.
10227       * std: The reference counted pointer type `extra::rc` moved into std.
10228       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
10229         just a wrapper around it).
10230       * std: The `Either` type has been removed.
10231       * std: `fmt::Default` can be implemented for any type to provide default
10232         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
10233       * std: The `rand` API continues to be tweaked.
10234       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
10235         on failure in gdb, is now named `rust_fail`.
10236       * std: The `each_key` and `each_value` methods on `HashMap` have been
10237         replaced by the `keys` and `values` iterators.
10238       * std: Functions dealing with type size and alignment have moved from the
10239         `sys` module to the `mem` module.
10240       * std: The `path` module was written and API changed.
10241       * std: `str::from_utf8` has been changed to cast instead of allocate.
10242       * std: `starts_with` and `ends_with` methods added to vectors via the
10243         `ImmutableEqVector` trait, which is in the prelude.
10244       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
10245         if the index is out of bounds.
10246       * std: Task failure no longer propagates between tasks, as the model was
10247         complex, expensive, and incompatible with thread-based tasks.
10248       * std: The `Any` type can be used for dynamic typing.
10249       * std: `~Any` can be passed to the `fail!` macro and retrieved via
10250         `task::try`.
10251       * std: Methods that produce iterators generally do not have an `_iter`
10252         suffix now.
10253       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
10254         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
10255       * std: `util::ignore` renamed to `prelude::drop`.
10256       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
10257         trait.
10258       * std: `vec::raw` has seen a lot of cleanup and API changes.
10259       * std: The standard library no longer includes any C++ code, and very
10260         minimal C, eliminating the dependency on libstdc++.
10261       * std: Runtime scheduling and I/O functionality has been factored out into
10262         extensible interfaces and is now implemented by two different crates:
10263         libnative, for native threading and I/O; and libgreen, for green threading
10264         and I/O. This paves the way for using the standard library in more limited
10265         embedded environments.
10266       * std: The `comm` module has been rewritten to be much faster, have a
10267         simpler, more consistent API, and to work for both native and green
10268         threading.
10269       * std: All libuv dependencies have been moved into the rustuv crate.
10270       * native: New implementations of runtime scheduling on top of OS threads.
10271       * native: New native implementations of TCP, UDP, file I/O, process spawning,
10272         and other I/O.
10273       * green: The green thread scheduler and message passing types are almost
10274         entirely lock-free.
10275       * extra: The `flatpipes` module had bitrotted and was removed.
10276       * extra: All crypto functions have been removed and Rust now has a policy of
10277         not reimplementing crypto in the standard library. In the future crypto
10278         will be provided by external crates with bindings to established libraries.
10279       * extra: `c_vec` has been modernized.
10280       * extra: The `sort` module has been removed. Use the `sort` method on
10281         mutable slices.
10282
10283    * Tooling
10284       * The `rust` and `rusti` commands have been removed, due to lack of
10285         maintenance.
10286       * `rustdoc` was completely rewritten.
10287       * `rustdoc` can test code examples in documentation.
10288       * `rustpkg` can test packages with the argument, 'test'.
10289       * `rustpkg` supports arbitrary dependencies, including C libraries.
10290       * `rustc`'s support for generating debug info is improved again.
10291       * `rustc` has better error reporting for unbalanced delimiters.
10292       * `rustc`'s JIT support was removed due to bitrot.
10293       * Executables and static libraries can be built with LTO (-Z lto)
10294       * `rustc` adds a `--dep-info` flag for communicating dependencies to
10295         build tools.
10296
10297
10298 Version 0.8 (2013-09-26)
10299 ============================
10300
10301    * ~2200 changes, numerous bugfixes
10302
10303    * Language
10304       * The `for` loop syntax has changed to work with the `Iterator` trait.
10305       * At long last, unwinding works on Windows.
10306       * Default methods are ready for use.
10307       * Many trait inheritance bugs fixed.
10308       * Owned and borrowed trait objects work more reliably.
10309       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
10310       * rustc can omit emission of code for the `debug!` macro if it is passed
10311         `--cfg ndebug`
10312       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
10313         for foo.rs, then foo/mod.rs, and will generate an error when both are
10314         present.
10315       * Strings no longer contain trailing nulls. The new `std::c_str` module
10316         provides new mechanisms for converting to C strings.
10317       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
10318       * The FFI has been overhauled such that foreign functions are called directly,
10319         instead of through a stack-switching wrapper.
10320       * Calling a foreign function must be done through a Rust function with the
10321         `#[fixed_stack_segment]` attribute.
10322       * The `externfn!` macro can be used to declare both a foreign function and
10323         a `#[fixed_stack_segment]` wrapper at once.
10324       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
10325       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
10326       * `priv` is disallowed everywhere except for struct fields and enum variants.
10327       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
10328       * `ref` bindings in irrefutable patterns work correctly now.
10329       * `char` is now prevented from containing invalid code points.
10330       * Casting to `bool` is no longer allowed.
10331       * `\0` is now accepted as an escape in chars and strings.
10332       * `yield` is a reserved keyword.
10333       * `typeof` is a reserved keyword.
10334       * Crates may be imported by URL with `extern mod foo = "url";`.
10335       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
10336       * Static vectors can be initialized with repeating elements,
10337         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
10338       * Static structs can be initialized with functional record update,
10339         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
10340       * `cfg!` can be used to conditionally execute code based on the crate
10341         configuration, similarly to `#[cfg(...)]`.
10342       * The `unnecessary_qualification` lint detects unneeded module
10343         prefixes (default: allow).
10344       * Arithmetic operations have been implemented on the SIMD types in
10345         `std::unstable::simd`.
10346       * Exchange allocation headers were removed, reducing memory usage.
10347       * `format!` implements a completely new, extensible, and higher-performance
10348         string formatting system. It will replace `fmt!`.
10349       * `print!` and `println!` write formatted strings (using the `format!`
10350         extension) to stdout.
10351       * `write!` and `writeln!` write formatted strings (using the `format!`
10352         extension) to the new Writers in `std::rt::io`.
10353       * The library section in which a function or static is placed may
10354         be specified with `#[link_section = "..."]`.
10355       * The `proto!` syntax extension for defining bounded message protocols
10356         was removed.
10357       * `macro_rules!` is hygienic for `let` declarations.
10358       * The `#[export_name]` attribute specifies the name of a symbol.
10359       * `unreachable!` can be used to indicate unreachable code, and fails
10360         if executed.
10361
10362    * Libraries
10363       * std: Transitioned to the new runtime, written in Rust.
10364       * std: Added an experimental I/O library, `rt::io`, based on the new
10365         runtime.
10366       * std: A new generic `range` function was added to the prelude, replacing
10367         `uint::range` and friends.
10368       * std: `range_rev` no longer exists. Since range is an iterator it can be
10369         reversed with `range(lo, hi).invert()`.
10370       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
10371         renamed to `unwrap_or`.
10372       * std: The `iterator` module was renamed to `iter`.
10373       * std: Integral types now support the `checked_add`, `checked_sub`, and
10374         `checked_mul` operations for detecting overflow.
10375       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
10376         consistency.
10377       * std: Methods are standardizing on conventions for casting methods:
10378         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
10379         and cheap casts.
10380       * std: The `CString` type in `c_str` provides new ways to convert to and
10381         from C strings.
10382       * std: `DoubleEndedIterator` can yield elements in two directions.
10383       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
10384         two splices.
10385       * std: `str::from_bytes` renamed to `str::from_utf8`.
10386       * std: `pop_opt` and `shift_opt` methods added to vectors.
10387       * std: The task-local data interface no longer uses @, and keys are
10388         no longer function pointers.
10389       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
10390       * std: Added `SharedPort` to `comm`.
10391       * std: `Eq` has a default method for `ne`; only `eq` is required
10392         in implementations.
10393       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
10394         is required in implementations.
10395       * std: `is_utf8` performance is improved, impacting many string functions.
10396       * std: `os::MemoryMap` provides cross-platform mmap.
10397       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
10398         are not 'in-bounds' are considered undefined.
10399       * std: Many freestanding functions in `vec` removed in favor of methods.
10400       * std: Many freestanding functions on scalar types removed in favor of
10401         methods.
10402       * std: Many options to task builders were removed since they don't make
10403         sense in the new scheduler design.
10404       * std: More containers implement `FromIterator` so can be created by the
10405         `collect` method.
10406       * std: More complete atomic types in `unstable::atomics`.
10407       * std: `comm::PortSet` removed.
10408       * std: Mutating methods in the `Set` and `Map` traits have been moved into
10409         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
10410         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
10411         default implementations.
10412       * std: Various `from_str` functions were removed in favor of a generic
10413         `from_str` which is available in the prelude.
10414       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
10415       * extra: `dlist`, the doubly-linked list was modernized.
10416       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
10417       * extra: Added `glob` module, replacing `std::os::glob`.
10418       * extra: `rope` was removed.
10419       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
10420       * extra: `net`, and `timer` were removed. The experimental replacements
10421         are `std::rt::io::net` and `std::rt::io::timer`.
10422       * extra: Iterators implemented for `SmallIntMap`.
10423       * extra: Iterators implemented for `Bitv` and `BitvSet`.
10424       * extra: `SmallIntSet` removed. Use `BitvSet`.
10425       * extra: Performance of JSON parsing greatly improved.
10426       * extra: `semver` updated to SemVer 2.0.0.
10427       * extra: `term` handles more terminals correctly.
10428       * extra: `dbg` module removed.
10429       * extra: `par` module removed.
10430       * extra: `future` was cleaned up, with some method renames.
10431       * extra: Most free functions in `getopts` were converted to methods.
10432
10433    * Other
10434       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
10435       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
10436         similarly to gcc's `--march` flag.
10437       * rustc's performance compiling small crates is much better.
10438       * rustpkg has received many improvements.
10439       * rustpkg supports git tags as package IDs.
10440       * rustpkg builds into target-specific directories so it can be used for
10441         cross-compiling.
10442       * The number of concurrent test tasks is controlled by the environment
10443         variable RUST_TEST_TASKS.
10444       * The test harness can now report metrics for benchmarks.
10445       * All tools have man pages.
10446       * Programs compiled with `--test` now support the `-h` and `--help` flags.
10447       * The runtime uses jemalloc for allocations.
10448       * Segmented stacks are temporarily disabled as part of the transition to
10449         the new runtime. Stack overflows are possible!
10450       * A new documentation backend, rustdoc_ng, is available for use. It is
10451         still invoked through the normal `rustdoc` command.
10452
10453
10454 Version 0.7 (2013-07-03)
10455 =======================
10456
10457    * ~2000 changes, numerous bugfixes
10458
10459    * Language
10460       * `impl`s no longer accept a visibility qualifier. Put them on methods
10461         instead.
10462       * The borrow checker has been rewritten with flow-sensitivity, fixing
10463         many bugs and inconveniences.
10464       * The `self` parameter no longer implicitly means `&'self self`,
10465         and can be explicitly marked with a lifetime.
10466       * Overloadable compound operators (`+=`, etc.) have been temporarily
10467         removed due to bugs.
10468       * The `for` loop protocol now requires `for`-iterators to return `bool`
10469         so they compose better.
10470       * The `Durable` trait is replaced with the `'static` bounds.
10471       * Trait default methods work more often.
10472       * Structs with the `#[packed]` attribute have byte alignment and
10473         no padding between fields.
10474       * Type parameters bound by `Copy` must now be copied explicitly with
10475         the `copy` keyword.
10476       * It is now illegal to move out of a dereferenced unsafe pointer.
10477       * `Option<~T>` is now represented as a nullable pointer.
10478       * `@mut` does dynamic borrow checks correctly.
10479       * The `main` function is only detected at the topmost level of the crate.
10480         The `#[main]` attribute is still valid anywhere.
10481       * Struct fields may no longer be mutable. Use inherited mutability.
10482       * The `#[no_send]` attribute makes a type that would otherwise be
10483         `Send`, not.
10484       * The `#[no_freeze]` attribute makes a type that would otherwise be
10485         `Freeze`, not.
10486       * Unbounded recursion will abort the process after reaching the limit
10487         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
10488       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
10489         are never implicitly copyable.
10490       * `#[static_assert]` makes compile-time assertions about static bools.
10491       * At long last, 'argument modes' no longer exist.
10492       * The rarely used `use mod` statement no longer exists.
10493
10494    * Syntax extensions
10495       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
10496         argument list.
10497       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
10498         `Rand`, `Zero` and `ToStr` can all be automatically derived with
10499         `#[deriving(...)]`.
10500       * The `bytes!` macro returns a vector of bytes for string, u8, char,
10501         and unsuffixed integer literals.
10502
10503    * Libraries
10504       * The `core` crate was renamed to `std`.
10505       * The `std` crate was renamed to `extra`.
10506       * More and improved documentation.
10507       * std: `iterator` module for external iterator objects.
10508       * Many old-style (internal, higher-order function) iterators replaced by
10509         implementations of `Iterator`.
10510       * std: Many old internal vector and string iterators,
10511         incl. `any`, `all`. removed.
10512       * std: The `finalize` method of `Drop` renamed to `drop`.
10513       * std: The `drop` method now takes `&mut self` instead of `&self`.
10514       * std: The prelude no longer re-exports any modules, only types and traits.
10515       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
10516         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
10517       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
10518         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
10519       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
10520         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
10521       * std: Many types implement `Clone`.
10522       * std: `path` type renamed to `Path`.
10523       * std: `mut` module and `Mut` type removed.
10524       * std: Many standalone functions removed in favor of methods and iterators
10525         in `vec`, `str`. In the future methods will also work as functions.
10526       * std: `reinterpret_cast` removed. Use `transmute`.
10527       * std: ascii string handling in `std::ascii`.
10528       * std: `Rand` is implemented for ~/@.
10529       * std: `run` module for spawning processes overhauled.
10530       * std: Various atomic types added to `unstable::atomic`.
10531       * std: Various types implement `Zero`.
10532       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
10533       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
10534       * std: Added `os::mkdir_recursive`.
10535       * std: Added `os::glob` function performs filesystems globs.
10536       * std: `FuzzyEq` renamed to `ApproxEq`.
10537       * std: `Map` now defines `pop` and `swap` methods.
10538       * std: `Cell` constructors converted to static methods.
10539       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
10540       * extra: `flate` module moved from `std` to `extra`.
10541       * extra: `fileinput` module for iterating over a series of files.
10542       * extra: `Complex` number type and `complex` module.
10543       * extra: `Rational` number type and `rational` module.
10544       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
10545       * extra: `term` uses terminfo now, is more correct.
10546       * extra: `arc` functions converted to methods.
10547       * extra: Implementation of fixed output size variations of SHA-2.
10548
10549    * Tooling
10550       * `unused_variables` lint mode for unused variables (default: warn).
10551       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
10552         (default: warn).
10553       * `unused_mut` lint mode for identifying unused `mut` qualifiers
10554         (default: warn).
10555       * `dead_assignment` lint mode for unread variables (default: warn).
10556       * `unnecessary_allocation` lint mode detects some heap allocations that are
10557         immediately borrowed so could be written without allocating (default: warn).
10558       * `missing_doc` lint mode (default: allow).
10559       * `unreachable_code` lint mode (default: warn).
10560       * The `rusti` command has been rewritten and a number of bugs addressed.
10561       * rustc outputs in color on more terminals.
10562       * rustc accepts a `--link-args` flag to pass arguments to the linker.
10563       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
10564       * Compiling with `-g` will make the binary record information about
10565         dynamic borrowcheck failures for debugging.
10566       * rustdoc has a nicer stylesheet.
10567       * Various improvements to rustdoc.
10568       * Improvements to rustpkg (see the detailed release notes).
10569
10570
10571 Version 0.6 (2013-04-03)
10572 ========================
10573
10574    * ~2100 changes, numerous bugfixes
10575
10576    * Syntax changes
10577       * The self type parameter in traits is now spelled `Self`
10578       * The `self` parameter in trait and impl methods must now be explicitly
10579         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
10580       * Static methods no longer require the `static` keyword and instead
10581         are distinguished by the lack of a `self` parameter
10582       * Replaced the `Durable` trait with the `'static` lifetime
10583       * The old closure type syntax with the trailing sigil has been
10584         removed in favor of the more consistent leading sigil
10585       * `super` is a keyword, and may be prefixed to paths
10586       * Trait bounds are separated with `+` instead of whitespace
10587       * Traits are implemented with `impl Trait for Type`
10588         instead of `impl Type: Trait`
10589       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
10590       * The `export` keyword has finally been removed
10591       * The `move` keyword has been removed (see "Semantic changes")
10592       * The interior mutability qualifier on vectors, `[mut T]`, has been
10593         removed. Use `&mut [T]`, etc.
10594       * `mut` is no longer valid in `~mut T`. Use inherited mutability
10595       * `fail` is no longer a keyword. Use `fail!()`
10596       * `assert` is no longer a keyword. Use `assert!()`
10597       * `log` is no longer a keyword. use `debug!`, etc.
10598       * 1-tuples may be represented as `(T,)`
10599       * Struct fields may no longer be `mut`. Use inherited mutability,
10600         `@mut T`, `core::mut` or `core::cell`
10601       * `extern mod { ... }` is no longer valid syntax for foreign
10602         function modules. Use extern blocks: `extern { ... }`
10603       * Newtype enums removed. Use tuple-structs.
10604       * Trait implementations no longer support visibility modifiers
10605       * Pattern matching over vectors improved and expanded
10606       * `const` renamed to `static` to correspond to lifetime name,
10607         and make room for future `static mut` unsafe mutable globals.
10608       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
10609       * `Clone` implementations can be automatically generated with
10610         `#[deriving(Clone)]`
10611       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
10612         instead of `foo as Bar`.
10613       * Fixed length vector types are now written as `[int, .. 3]`
10614         instead of `[int * 3]`.
10615       * Fixed length vector types can express the length as a constant
10616         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
10617
10618    * Semantic changes
10619       * Types with owned pointers or custom destructors move by default,
10620         eliminating the `move` keyword
10621       * All foreign functions are considered unsafe
10622       * &mut is now unaliasable
10623       * Writes to borrowed @mut pointers are prevented dynamically
10624       * () has size 0
10625       * The name of the main function can be customized using #[main]
10626       * The default type of an inferred closure is &fn instead of @fn
10627       * `use` statements may no longer be "chained" - they cannot import
10628         identifiers imported by previous `use` statements
10629       * `use` statements are crate relative, importing from the "top"
10630         of the crate by default. Paths may be prefixed with `super::`
10631         or `self::` to change the search behavior.
10632       * Method visibility is inherited from the implementation declaration
10633       * Structural records have been removed
10634       * Many more types can be used in static items, including enums
10635         'static-lifetime pointers and vectors
10636       * Pattern matching over vectors improved and expanded
10637       * Typechecking of closure types has been overhauled to
10638         improve inference and eliminate unsoundness
10639       * Macros leave scope at the end of modules, unless that module is
10640         tagged with #[macro_escape]
10641
10642    * Libraries
10643       * Added big integers to `std::bigint`
10644       * Removed `core::oldcomm` module
10645       * Added pipe-based `core::comm` module
10646       * Numeric traits have been reorganized under `core::num`
10647       * `vec::slice` finally returns a slice
10648       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
10649       * Containers reorganized around traits in `core::container`
10650       * `core::dvec` removed, `~[T]` is a drop-in replacement
10651       * `core::send_map` renamed to `core::hashmap`
10652       * `std::map` removed; replaced with `core::hashmap`
10653       * `std::treemap` reimplemented as an owned balanced tree
10654       * `std::deque` and `std::smallintmap` reimplemented as owned containers
10655       * `core::trie` added as a fast ordered map for integer keys
10656       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
10657       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
10658         overload the comparison operators, whereas `TotalOrd` is used
10659         by certain container types
10660
10661    * Other
10662       * Replaced the 'cargo' package manager with 'rustpkg'
10663       * Added all-purpose 'rust' tool
10664       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
10665       * rustc now *attempts* to offer spelling suggestions
10666       * Improved support for ARM and Android
10667       * Preliminary MIPS backend
10668       * Improved foreign function ABI implementation for x86, x86_64
10669       * Various memory usage improvements
10670       * Rust code may be embedded in foreign code under limited circumstances
10671       * Inline assembler supported by new asm!() syntax extension.
10672
10673
10674 Version 0.5 (2012-12-21)
10675 ===========================
10676
10677    * ~900 changes, numerous bugfixes
10678
10679    * Syntax changes
10680       * Removed `<-` move operator
10681       * Completed the transition from the `#fmt` extension syntax to `fmt!`
10682       * Removed old fixed length vector syntax - `[T]/N`
10683       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
10684       * Macros may now expand to items and statements
10685       * `a.b()` is always parsed as a method call, never as a field projection
10686       * `Eq` and `IterBytes` implementations can be automatically generated
10687         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
10688       * Removed the special crate language for `.rc` files
10689       * Function arguments may consist of any irrefutable pattern
10690
10691    * Semantic changes
10692       * `&` and `~` pointers may point to objects
10693       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
10694       * Enum variants may be structs
10695       * Destructors can be added to all nominal types with the Drop trait
10696       * Structs and nullary enum variants may be constants
10697       * Values that cannot be implicitly copied are now automatically moved
10698         without writing `move` explicitly
10699       * `&T` may now be coerced to `*T`
10700       * Coercions happen in `let` statements as well as function calls
10701       * `use` statements now take crate-relative paths
10702       * The module and type namespaces have been merged so that static
10703         method names can be resolved under the trait in which they are
10704         declared
10705
10706    * Improved support for language features
10707       * Trait inheritance works in many scenarios
10708       * More support for explicit self arguments in methods - `self`, `&self`
10709         `@self`, and `~self` all generally work as expected
10710       * Static methods work in more situations
10711       * Experimental: Traits may declare default methods for the implementations
10712         to use
10713
10714    * Libraries
10715       * New condition handling system in `core::condition`
10716       * Timsort added to `std::sort`
10717       * New priority queue, `std::priority_queue`
10718       * Pipes for serializable types, `std::flatpipes'
10719       * Serialization overhauled to be trait-based
10720       * Expanded `getopts` definitions
10721       * Moved futures to `std`
10722       * More functions are pure now
10723       * `core::comm` renamed to `oldcomm`. Still deprecated
10724       * `rustdoc` and `cargo` are libraries now
10725
10726    * Misc
10727       * Added a preliminary REPL, `rusti`
10728       * License changed from MIT to dual MIT/APL2
10729
10730
10731 Version 0.4 (2012-10-15)
10732 ==========================
10733
10734    * ~2000 changes, numerous bugfixes
10735
10736    * Syntax
10737       * All keywords are now strict and may not be used as identifiers anywhere
10738       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
10739         'of', 'with', 'to', 'class'.
10740       * Classes are replaced with simpler structs
10741       * Explicit method self types
10742       * `ret` became `return` and `alt` became `match`
10743       * `import` is now `use`; `use is now `extern mod`
10744       * `extern mod { ... }` is now `extern { ... }`
10745       * `use mod` is the recommended way to import modules
10746       * `pub` and `priv` replace deprecated export lists
10747       * The syntax of `match` pattern arms now uses fat arrow (=>)
10748       * `main` no longer accepts an args vector; use `os::args` instead
10749
10750    * Semantics
10751       * Trait implementations are now coherent, ala Haskell typeclasses
10752       * Trait methods may be static
10753       * Argument modes are deprecated
10754       * Borrowed pointers are much more mature and recommended for use
10755       * Strings and vectors in the static region are stored in constant memory
10756       * Typestate was removed
10757       * Resolution rewritten to be more reliable
10758       * Support for 'dual-mode' data structures (freezing and thawing)
10759
10760    * Libraries
10761       * Most binary operators can now be overloaded via the traits in
10762         `core::ops'
10763       * `std::net::url` for representing URLs
10764       * Sendable hash maps in `core::send_map`
10765       * `core::task' gained a (currently unsafe) task-local storage API
10766
10767    * Concurrency
10768       * An efficient new intertask communication primitive called the pipe,
10769         along with a number of higher-level channel types, in `core::pipes`
10770       * `std::arc`, an atomically reference counted, immutable, shared memory
10771         type
10772       * `std::sync`, various exotic synchronization tools based on arcs and pipes
10773       * Futures are now based on pipes and sendable
10774       * More robust linked task failure
10775       * Improved task builder API
10776
10777    * Other
10778       * Improved error reporting
10779       * Preliminary JIT support
10780       * Preliminary work on precise GC
10781       * Extensive architectural improvements to rustc
10782       * Begun a transition away from buggy C++-based reflection (shape) code to
10783         Rust-based (visitor) code
10784       * All hash functions and tables converted to secure, randomized SipHash
10785
10786
10787 Version 0.3  (2012-07-12)
10788 ========================
10789
10790    * ~1900 changes, numerous bugfixes
10791
10792    * New coding conveniences
10793       * Integer-literal suffix inference
10794       * Per-item control over warnings, errors
10795       * #[cfg(windows)] and #[cfg(unix)] attributes
10796       * Documentation comments
10797       * More compact closure syntax
10798       * 'do' expressions for treating higher-order functions as
10799         control structures
10800       * *-patterns (wildcard extended to all constructor fields)
10801
10802    * Semantic cleanup
10803       * Name resolution pass and exhaustiveness checker rewritten
10804       * Region pointers and borrow checking supersede alias
10805         analysis
10806       * Init-ness checking is now provided by a region-based liveness
10807         pass instead of the typestate pass; same for last-use analysis
10808       * Extensive work on region pointers
10809
10810    * Experimental new language features
10811       * Slices and fixed-size, interior-allocated vectors
10812       * #!-comments for lang versioning, shell execution
10813       * Destructors and iface implementation for classes;
10814         type-parameterized classes and class methods
10815       * 'const' type kind for types that can be used to implement
10816         shared-memory concurrency patterns
10817
10818    * Type reflection
10819
10820    * Removal of various obsolete features
10821       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
10822                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
10823
10824       * Constructs: do-while loops ('do' repurposed), fn binding,
10825                     resources (replaced by destructors)
10826
10827    * Compiler reorganization
10828       * Syntax-layer of compiler split into separate crate
10829       * Clang (from LLVM project) integrated into build
10830       * Typechecker split into sub-modules
10831
10832    * New library code
10833       * New time functions
10834       * Extension methods for many built-in types
10835       * Arc: atomic-refcount read-only / exclusive-use shared cells
10836       * Par: parallel map and search routines
10837       * Extensive work on libuv interface
10838       * Much vector code moved to libraries
10839       * Syntax extensions: #line, #col, #file, #mod, #stringify,
10840         #include, #include_str, #include_bin
10841
10842    * Tool improvements
10843       * Cargo automatically resolves dependencies
10844
10845
10846 Version 0.2  (2012-03-29)
10847 =========================
10848
10849    * >1500 changes, numerous bugfixes
10850
10851    * New docs and doc tooling
10852
10853    * New port: FreeBSD x86_64
10854
10855    * Compilation model enhancements
10856       * Generics now specialized, multiply instantiated
10857       * Functions now inlined across separate crates
10858
10859    * Scheduling, stack and threading fixes
10860       * Noticeably improved message-passing performance
10861       * Explicit schedulers
10862       * Callbacks from C
10863       * Helgrind clean
10864
10865    * Experimental new language features
10866       * Operator overloading
10867       * Region pointers
10868       * Classes
10869
10870    * Various language extensions
10871       * C-callback function types: 'crust fn ...'
10872       * Infinite-loop construct: 'loop { ... }'
10873       * Shorten 'mutable' to 'mut'
10874       * Required mutable-local qualifier: 'let mut ...'
10875       * Basic glob-exporting: 'export foo::*;'
10876       * Alt now exhaustive, 'alt check' for runtime-checked
10877       * Block-function form of 'for' loop, with 'break' and 'ret'.
10878
10879    * New library code
10880       * AST quasi-quote syntax extension
10881       * Revived libuv interface
10882       * New modules: core::{future, iter}, std::arena
10883       * Merged per-platform std::{os*, fs*} to core::{libc, os}
10884       * Extensive cleanup, regularization in libstd, libcore
10885
10886
10887 Version 0.1  (2012-01-20)
10888 ===============================
10889
10890    * Most language features work, including:
10891       * Unique pointers, unique closures, move semantics
10892       * Interface-constrained generics
10893       * Static interface dispatch
10894       * Stack growth
10895       * Multithread task scheduling
10896       * Typestate predicates
10897       * Failure unwinding, destructors
10898       * Pattern matching and destructuring assignment
10899       * Lightweight block-lambda syntax
10900       * Preliminary macro-by-example
10901
10902    * Compiler works with the following configurations:
10903       * Linux: x86 and x86_64 hosts and targets
10904       * macOS: x86 and x86_64 hosts and targets
10905       * Windows: x86 hosts and targets
10906
10907    * Cross compilation / multi-target configuration supported.
10908
10909    * Preliminary API-documentation and package-management tools included.
10910
10911 Known issues:
10912
10913    * Documentation is incomplete.
10914
10915    * Performance is below intended target.
10916
10917    * Standard library APIs are subject to extensive change, reorganization.
10918
10919    * Language-level versioning is not yet operational - future code will
10920      break unexpectedly.