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
 160 Compiler
 161 --------
 162
 163 - [Create more accurate debuginfo for vtables.][89597]
 164 - [Add `armv6k-nintendo-3ds` at Tier 3\*.][88529]
 165 - [Add `armv7-unknown-linux-uclibceabihf` at Tier 3\*.][88952]
 166 - [Add `m68k-unknown-linux-gnu` at Tier 3\*.][88321]
 167 - [Add SOLID targets at Tier 3\*:][86191] `aarch64-kmc-solid_asp3`, `armv7a-kmc-solid_asp3-eabi`, `armv7a-kmc-solid_asp3-eabihf`
 168
 169 \* Refer to Rust's [platform support page][platform-support-doc] for more
 170    information on Rust's tiered platform support.
 171
 172 Libraries
 173 ---------
 174
 175 - [Avoid allocations and copying in `Vec::leak`][89337]
 176 - [Add `#[repr(i8)]` to `Ordering`][89507]
 177 - [Optimize `File::read_to_end` and `read_to_string`][89582]
 178 - [Update to Unicode 14.0][89614]
 179 - [Many more functions are marked `#[must_use]`][89692], producing a warning
 180   when ignoring their return value. This helps catch mistakes such as expecting
 181   a function to mutate a value in place rather than return a new value.
 182
 183 Stabilised APIs
 184 ---------------
 185
 186 - [`[T; N]::as_mut_slice`][`array::as_mut_slice`]
 187 - [`[T; N]::as_slice`][`array::as_slice`]
 188 - [`collections::TryReserveError`]
 189 - [`HashMap::try_reserve`]
 190 - [`HashSet::try_reserve`]
 191 - [`String::try_reserve`]
 192 - [`String::try_reserve_exact`]
 193 - [`Vec::try_reserve`]
 194 - [`Vec::try_reserve_exact`]
 195 - [`VecDeque::try_reserve`]
 196 - [`VecDeque::try_reserve_exact`]
 197 - [`Iterator::map_while`]
 198 - [`iter::MapWhile`]
 199 - [`proc_macro::is_available`]
 200 - [`Command::get_program`]
 201 - [`Command::get_args`]
 202 - [`Command::get_envs`]
 203 - [`Command::get_current_dir`]
 204 - [`CommandArgs`]
 205 - [`CommandEnvs`]
 206
 207 These APIs are now usable in const contexts:
 208
 209 - [`hint::unreachable_unchecked`]
 210
 211 Cargo
 212 -----
 213
 214 - [Stabilize custom profiles][cargo/9943]
 215
 216 Compatibility notes
 217 -------------------
 218
 219 Internal changes
 220 ----------------
 221 These changes provide no direct user facing benefits, but represent significant
 222 improvements to the internals and overall performance of rustc
 223 and related tools.
 224
 225 - [Added an experimental backend for codegen with `libgccjit`.][87260]
 226
 227 [86191]: https://github.com/rust-lang/rust/pull/86191/
 228 [87220]: https://github.com/rust-lang/rust/pull/87220/
 229 [87260]: https://github.com/rust-lang/rust/pull/87260/
 230 [88321]: https://github.com/rust-lang/rust/pull/88321/
 231 [88529]: https://github.com/rust-lang/rust/pull/88529/
 232 [88690]: https://github.com/rust-lang/rust/pull/88690/
 233 [88952]: https://github.com/rust-lang/rust/pull/88952/
 234 [89337]: https://github.com/rust-lang/rust/pull/89337/
 235 [89507]: https://github.com/rust-lang/rust/pull/89507/
 236 [89508]: https://github.com/rust-lang/rust/pull/89508/
 237 [89582]: https://github.com/rust-lang/rust/pull/89582/
 238 [89597]: https://github.com/rust-lang/rust/pull/89597/
 239 [89614]: https://github.com/rust-lang/rust/pull/89614/
 240 [89692]: https://github.com/rust-lang/rust/issues/89692/
 241 [cargo/9943]: https://github.com/rust-lang/cargo/pull/9943/
 242 [`array::as_mut_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_mut_slice
 243 [`array::as_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_slice
 244 [`collections::TryReserveError`]: https://doc.rust-lang.org/std/collections/struct.TryReserveError.html
 245 [`HashMap::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_map/struct.HashMap.html#method.try_reserve
 246 [`HashSet::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_set/struct.HashSet.html#method.try_reserve
 247 [`String::try_reserve`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve
 248 [`String::try_reserve_exact`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve_exact
 249 [`Vec::try_reserve`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve
 250 [`Vec::try_reserve_exact`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve_exact
 251 [`VecDeque::try_reserve`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve
 252 [`VecDeque::try_reserve_exact`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve_exact
 253 [`Iterator::map_while`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.map_while
 254 [`iter::MapWhile`]: https://doc.rust-lang.org/std/iter/struct.MapWhile.html
 255 [`proc_macro::is_available`]: https://doc.rust-lang.org/proc_macro/fn.is_available.html
 256 [`Command::get_program`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_program
 257 [`Command::get_args`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_args
 258 [`Command::get_envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_envs
 259 [`Command::get_current_dir`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_current_dir
 260 [`CommandArgs`]: https://doc.rust-lang.org/std/process/struct.CommandArgs.html
 261 [`CommandEnvs`]: https://doc.rust-lang.org/std/process/struct.CommandEnvs.html
 262
 263 Version 1.56.1 (2021-11-01)
 264 ===========================
 265
 266 - New lints to detect the presence of bidirectional-override Unicode
 267   codepoints in the compiled source code ([CVE-2021-42574])
 268
 269 [CVE-2021-42574]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-42574
 270
 271 Version 1.56.0 (2021-10-21)
 272 ========================
 273
 274 Language
 275 --------
 276
 277 - [The 2021 Edition is now stable.][rust#88100]
 278   See [the edition guide][rust-2021-edition-guide] for more details.
 279 - [The pattern in `binding @ pattern` can now also introduce new bindings.][rust#85305]
 280 - [Union field access is permitted in `const fn`.][rust#85769]
 281
 282 [rust-2021-edition-guide]: https://doc.rust-lang.org/nightly/edition-guide/rust-2021/index.html
 283
 284 Compiler
 285 --------
 286
 287 - [Upgrade to LLVM 13.][rust#87570]
 288 - [Support memory, address, and thread sanitizers on aarch64-unknown-freebsd.][rust#88023]
 289 - [Allow specifying a deployment target version for all iOS targets][rust#87699]
 290 - [Warnings can be forced on with `--force-warn`.][rust#87472]
 291   This feature is primarily intended for usage by `cargo fix`, rather than end users.
 292 - [Promote `aarch64-apple-ios-sim` to Tier 2\*.][rust#87760]
 293 - [Add `powerpc-unknown-freebsd` at Tier 3\*.][rust#87370]
 294 - [Add `riscv32imc-esp-espidf` at Tier 3\*.][rust#87666]
 295
 296 \* Refer to Rust's [platform support page][platform-support-doc] for more
 297 information on Rust's tiered platform support.
 298
 299 Libraries
 300 ---------
 301
 302 - [Allow writing of incomplete UTF-8 sequences via stdout/stderr on Windows.][rust#83342]
 303   The Windows console still requires valid Unicode, but this change allows
 304   splitting a UTF-8 character across multiple write calls. This allows, for
 305   instance, programs that just read and write data buffers (e.g. copying a file
 306   to stdout) without regard for Unicode or character boundaries.
 307 - [Prefer `AtomicU{64,128}` over Mutex for Instant backsliding protection.][rust#83093]
 308   For this use case, atomics scale much better under contention.
 309 - [Implement `Extend<(A, B)>` for `(Extend<A>, Extend<B>)`][rust#85835]
 310 - [impl Default, Copy, Clone for std::io::Sink and std::io::Empty][rust#86744]
 311 - [`impl From<[(K, V); N]>` for all collections.][rust#84111]
 312 - [Remove `P: Unpin` bound on impl Future for Pin.][rust#81363]
 313 - [Treat invalid environment variable names as non-existent.][rust#86183]
 314   Previously, the environment functions would panic if given a variable name
 315   with an internal null character or equal sign (`=`). Now, these functions will
 316   just treat such names as non-existent variables, since the OS cannot represent
 317   the existence of a variable with such a name.
 318
 319 Stabilised APIs
 320 ---------------
 321
 322 - [`std::os::unix::fs::chroot`]
 323 - [`UnsafeCell::raw_get`]
 324 - [`BufWriter::into_parts`]
 325 - [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]
 326   These APIs were previously stable in `std`, but are now also available in `core`.
 327 - [`Vec::shrink_to`]
 328 - [`String::shrink_to`]
 329 - [`OsString::shrink_to`]
 330 - [`PathBuf::shrink_to`]
 331 - [`BinaryHeap::shrink_to`]
 332 - [`VecDeque::shrink_to`]
 333 - [`HashMap::shrink_to`]
 334 - [`HashSet::shrink_to`]
 335
 336 These APIs are now usable in const contexts:
 337
 338 - [`std::mem::transmute`]
 339 - [`[T]::first`][`slice::first`]
 340 - [`[T]::split_first`][`slice::split_first`]
 341 - [`[T]::last`][`slice::last`]
 342 - [`[T]::split_last`][`slice::split_last`]
 343
 344 Cargo
 345 -----
 346
 347 - [Cargo supports specifying a minimum supported Rust version in Cargo.toml.][`rust-version`]
 348   This has no effect at present on dependency version selection.
 349   We encourage crates to specify their minimum supported Rust version, and we encourage CI systems
 350   that support Rust code to include a crate's specified minimum version in the test matrix for that
 351   crate by default.
 352
 353 Compatibility notes
 354 -------------------
 355
 356 - [Update to new argument parsing rules on Windows.][rust#87580]
 357   This adjusts Rust's standard library to match the behavior of the standard
 358   libraries for C/C++. The rules have changed slightly over time, and this PR
 359   brings us to the latest set of rules (changed in 2008).
 360 - [Disallow the aapcs calling convention on aarch64][rust#88399]
 361   This was already not supported by LLVM; this change surfaces this lack of
 362   support with a better error message.
 363 - [Make `SEMICOLON_IN_EXPRESSIONS_FROM_MACROS` warn by default][rust#87385]
 364 - [Warn when an escaped newline skips multiple lines.][rust#87671]
 365 - [Calls to `libc::getpid` / `std::process::id` from `Command::pre_exec`
 366    may return different values on glibc <= 2.24.][rust#81825]
 367    Rust now invokes the `clone3` system call directly, when available, to use new functionality
 368    available via that system call. Older versions of glibc cache the result of `getpid`, and only
 369    update that cache when calling glibc's clone/fork functions, so a direct system call bypasses
 370    that cache update. glibc 2.25 and newer no longer cache `getpid` for exactly this reason.
 371
 372 Internal changes
 373 ----------------
 374 These changes provide no direct user facing benefits, but represent significant
 375 improvements to the internals and overall performance of rustc
 376 and related tools.
 377
 378 - [LLVM is compiled with PGO in published x86_64-unknown-linux-gnu artifacts.][rust#88069]
 379   This improves the performance of most Rust builds.
 380 - [Unify representation of macros in internal data structures.][rust#88019]
 381   This change fixes a host of bugs with the handling of macros by the compiler,
 382   as well as rustdoc.
 383
 384 [`std::os::unix::fs::chroot`]: https://doc.rust-lang.org/stable/std/os/unix/fs/fn.chroot.html
 385 [`UnsafeCell::raw_get`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.raw_get
 386 [`BufWriter::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.BufWriter.html#method.into_parts
 387 [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]: https://github.com/rust-lang/rust/pull/84662
 388 [`Vec::shrink_to`]: https://doc.rust-lang.org/stable/std/vec/struct.Vec.html#method.shrink_to
 389 [`String::shrink_to`]: https://doc.rust-lang.org/stable/std/string/struct.String.html#method.shrink_to
 390 [`OsString::shrink_to`]: https://doc.rust-lang.org/stable/std/ffi/struct.OsString.html#method.shrink_to
 391 [`PathBuf::shrink_to`]: https://doc.rust-lang.org/stable/std/path/struct.PathBuf.html#method.shrink_to
 392 [`BinaryHeap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.BinaryHeap.html#method.shrink_to
 393 [`VecDeque::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.VecDeque.html#method.shrink_to
 394 [`HashMap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_map/struct.HashMap.html#method.shrink_to
 395 [`HashSet::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_set/struct.HashSet.html#method.shrink_to
 396 [`std::mem::transmute`]: https://doc.rust-lang.org/stable/std/mem/fn.transmute.html
 397 [`slice::first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.first
 398 [`slice::split_first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_first
 399 [`slice::last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.last
 400 [`slice::split_last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_last
 401 [`rust-version`]: https://doc.rust-lang.org/nightly/cargo/reference/manifest.html#the-rust-version-field
 402 [rust#87671]: https://github.com/rust-lang/rust/pull/87671
 403 [rust#86183]: https://github.com/rust-lang/rust/pull/86183
 404 [rust#87385]: https://github.com/rust-lang/rust/pull/87385
 405 [rust#88100]: https://github.com/rust-lang/rust/pull/88100
 406 [rust#85305]: https://github.com/rust-lang/rust/pull/85305
 407 [rust#88069]: https://github.com/rust-lang/rust/pull/88069
 408 [rust#87472]: https://github.com/rust-lang/rust/pull/87472
 409 [rust#87699]: https://github.com/rust-lang/rust/pull/87699
 410 [rust#87570]: https://github.com/rust-lang/rust/pull/87570
 411 [rust#88023]: https://github.com/rust-lang/rust/pull/88023
 412 [rust#87760]: https://github.com/rust-lang/rust/pull/87760
 413 [rust#87370]: https://github.com/rust-lang/rust/pull/87370
 414 [rust#87580]: https://github.com/rust-lang/rust/pull/87580
 415 [rust#83342]: https://github.com/rust-lang/rust/pull/83342
 416 [rust#83093]: https://github.com/rust-lang/rust/pull/83093
 417 [rust#85835]: https://github.com/rust-lang/rust/pull/85835
 418 [rust#86744]: https://github.com/rust-lang/rust/pull/86744
 419 [rust#81363]: https://github.com/rust-lang/rust/pull/81363
 420 [rust#84111]: https://github.com/rust-lang/rust/pull/84111
 421 [rust#85769]: https://github.com/rust-lang/rust/pull/85769#issuecomment-854363720
 422 [rust#88399]: https://github.com/rust-lang/rust/pull/88399
 423 [rust#81825]: https://github.com/rust-lang/rust/pull/81825#issuecomment-808406918
 424 [rust#88019]: https://github.com/rust-lang/rust/pull/88019
 425 [rust#87666]: https://github.com/rust-lang/rust/pull/87666
 426
 427 Version 1.55.0 (2021-09-09)
 428 ============================
 429
 430 Language
 431 --------
 432 - [You can now write open "from" range patterns (`X..`), which will start at `X` and
 433   will end at the maximum value of the integer.][83918]
 434 - [You can now explicitly import the prelude of different editions
 435   through `std::prelude` (e.g. `use std::prelude::rust_2021::*;`).][86294]
 436
 437 Compiler
 438 --------
 439 - [Added tier 3\* support for `powerpc64le-unknown-freebsd`.][83572]
 440
 441 \* Refer to Rust's [platform support page][platform-support-doc] for more
 442    information on Rust's tiered platform support.
 443
 444 Libraries
 445 ---------
 446
 447 - [Updated std's float parsing to use the Eisel-Lemire algorithm.][86761]
 448   These improvements should in general provide faster string parsing of floats,
 449   no longer reject certain valid floating point values, and reduce
 450   the produced code size for non-stripped artifacts.
 451 - [`string::Drain` now implements `AsRef<str>` and `AsRef<[u8]>`.][86858]
 452
 453 Stabilised APIs
 454 ---------------
 455
 456 - [`Bound::cloned`]
 457 - [`Drain::as_str`]
 458 - [`IntoInnerError::into_error`]
 459 - [`IntoInnerError::into_parts`]
 460 - [`MaybeUninit::assume_init_mut`]
 461 - [`MaybeUninit::assume_init_ref`]
 462 - [`MaybeUninit::write`]
 463 - [`array::map`]
 464 - [`ops::ControlFlow`]
 465 - [`x86::_bittest`]
 466 - [`x86::_bittestandcomplement`]
 467 - [`x86::_bittestandreset`]
 468 - [`x86::_bittestandset`]
 469 - [`x86_64::_bittest64`]
 470 - [`x86_64::_bittestandcomplement64`]
 471 - [`x86_64::_bittestandreset64`]
 472 - [`x86_64::_bittestandset64`]
 473
 474 The following previously stable functions are now `const`.
 475
 476 - [`str::from_utf8_unchecked`]
 477
 478
 479 Cargo
 480 -----
 481 - [Cargo will now deduplicate compiler diagnostics to the terminal when invoking
 482   rustc in parallel such as when using `cargo test`.][cargo/9675]
 483 - [The package definition in `cargo metadata` now includes the `"default_run"`
 484   field from the manifest.][cargo/9550]
 485 - [Added `cargo d` as an alias for `cargo doc`.][cargo/9680]
 486 - [Added `{lib}` as formatting option for `cargo tree` to print the `"lib_name"`
 487   of packages.][cargo/9663]
 488
 489 Rustdoc
 490 -------
 491 - [Added "Go to item on exact match" search option.][85876]
 492 - [The "Implementors" section on traits no longer shows redundant
 493   method definitions.][85970]
 494 - [Trait implementations are toggled open by default.][86260] This should make the
 495   implementations more searchable by tools like `CTRL+F` in your browser.
 496 - [Intra-doc links should now correctly resolve associated items (e.g. methods)
 497   through type aliases.][86334]
 498 - [Traits which are marked with `#[doc(hidden)]` will no longer appear in the
 499   "Trait Implementations" section.][86513]
 500
 501
 502 Compatibility Notes
 503 -------------------
 504 - [std functions that return an `io::Error` will no longer use the
 505   `ErrorKind::Other` variant.][85746] This is to better reflect that these
 506   kinds of errors could be categorised [into newer more specific `ErrorKind`
 507   variants][79965], and that they do not represent a user error.
 508 - [Using environment variable names with `process::Command` on Windows now
 509   behaves as expected.][85270] Previously using envionment variables with
 510   `Command` would cause them to be ASCII-uppercased.
 511 - [Rustdoc will now warn on using rustdoc lints that aren't prefixed
 512   with `rustdoc::`][86849]
 513 - `RUSTFLAGS` is no longer set for build scripts. Build scripts
 514   should use `CARGO_ENCODED_RUSTFLAGS` instead. See the
 515   [documentation](https://doc.rust-lang.org/nightly/cargo/reference/environment-variables.html#environment-variables-cargo-sets-for-build-scripts)
 516   for more details.
 517
 518 [86849]: https://github.com/rust-lang/rust/pull/86849
 519 [86513]: https://github.com/rust-lang/rust/pull/86513
 520 [86334]: https://github.com/rust-lang/rust/pull/86334
 521 [86260]: https://github.com/rust-lang/rust/pull/86260
 522 [85970]: https://github.com/rust-lang/rust/pull/85970
 523 [85876]: https://github.com/rust-lang/rust/pull/85876
 524 [83572]: https://github.com/rust-lang/rust/pull/83572
 525 [86294]: https://github.com/rust-lang/rust/pull/86294
 526 [86858]: https://github.com/rust-lang/rust/pull/86858
 527 [86761]: https://github.com/rust-lang/rust/pull/86761
 528 [85746]: https://github.com/rust-lang/rust/pull/85746
 529 [85270]: https://github.com/rust-lang/rust/pull/85270
 530 [83918]: https://github.com/rust-lang/rust/pull/83918
 531 [79965]: https://github.com/rust-lang/rust/pull/79965
 532 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
 533 [cargo/9675]: https://github.com/rust-lang/cargo/pull/9675
 534 [cargo/9550]: https://github.com/rust-lang/cargo/pull/9550
 535 [cargo/9680]: https://github.com/rust-lang/cargo/pull/9680
 536 [`array::map`]: https://doc.rust-lang.org/stable/std/primitive.array.html#method.map
 537 [`Bound::cloned`]: https://doc.rust-lang.org/stable/std/ops/enum.Bound.html#method.cloned
 538 [`Drain::as_str`]: https://doc.rust-lang.org/stable/std/string/struct.Drain.html#method.as_str
 539 [`IntoInnerError::into_error`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_error
 540 [`IntoInnerError::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_parts
 541 [`MaybeUninit::assume_init_mut`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_mut
 542 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
 543 [`MaybeUninit::write`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.write
 544 [`ops::ControlFlow`]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html
 545 [`str::from_utf8_unchecked`]: https://doc.rust-lang.org/stable/std/str/fn.from_utf8_unchecked.html
 546 [`x86::_bittest`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittest.html
 547 [`x86::_bittestandcomplement`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandcomplement.html
 548 [`x86::_bittestandreset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandreset.html
 549 [`x86::_bittestandset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandset.html
 550 [`x86_64::_bittest64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittest64.html
 551 [`x86_64::_bittestandcomplement64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandcomplement64.html
 552 [`x86_64::_bittestandreset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandreset64.html
 553 [`x86_64::_bittestandset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandset64.html
 554
 555
 556 Version 1.54.0 (2021-07-29)
 557 ============================
 558
 559 Language
 560 -----------------------
 561
 562 - [You can now use macros for values in some built-in attributes.][83366]
 563   This primarily allows you to call macros within the `#[doc]` attribute. For
 564   example, to include external documentation in your crate, you can now write
 565   the following:
 566   ```rust
 567   #![doc = include_str!("README.md")]
 568   ```
 569
 570 - [You can now cast between unsized slice types (and types which contain
 571   unsized slices) in `const fn`.][85078]
 572 - [You can now use multiple generic lifetimes with `impl Trait` where the
 573    lifetimes don't explicitly outlive another.][84701] In code this means
 574    that you can now have `impl Trait<'a, 'b>` where as before you could
 575    only have `impl Trait<'a, 'b> where 'b: 'a`.
 576
 577 Compiler
 578 -----------------------
 579
 580 - [Rustc will now search for custom JSON targets in
 581   `/lib/rustlib/<target-triple>/target.json` where `/` is the "sysroot"
 582   directory.][83800] You can find your sysroot directory by running
 583   `rustc --print sysroot`.
 584 - [Added `wasm` as a `target_family` for WebAssembly platforms.][84072]
 585 - [You can now use `#[target_feature]` on safe functions when targeting
 586   WebAssembly platforms.][84988]
 587 - [Improved debugger output for enums on Windows MSVC platforms.][85292]
 588 - [Added tier 3\* support for `bpfel-unknown-none`
 589    and `bpfeb-unknown-none`.][79608]
 590 - [`-Zmutable-noalias=yes`][82834] is enabled by default when using LLVM 12 or above.
 591
 592 \* Refer to Rust's [platform support page][platform-support-doc] for more
 593    information on Rust's tiered platform support.
 594
 595 Libraries
 596 -----------------------
 597
 598 - [`panic::panic_any` will now `#[track_caller]`.][85745]
 599 - [Added `OutOfMemory` as a variant of `io::ErrorKind`.][84744]
 600 - [ `proc_macro::Literal` now implements `FromStr`.][84717]
 601 - [The implementations of vendor intrinsics in core::arch have been
 602    significantly refactored.][83278] The main user-visible changes are
 603    a 50% reduction in the size of libcore.rlib and stricter validation
 604    of constant operands passed to intrinsics. The latter is technically
 605    a breaking change, but allows Rust to more closely match the C vendor
 606    intrinsics API.
 607
 608 Stabilized APIs
 609 ---------------
 610
 611 - [`BTreeMap::into_keys`]
 612 - [`BTreeMap::into_values`]
 613 - [`HashMap::into_keys`]
 614 - [`HashMap::into_values`]
 615 - [`arch::wasm32`]
 616 - [`VecDeque::binary_search`]
 617 - [`VecDeque::binary_search_by`]
 618 - [`VecDeque::binary_search_by_key`]
 619 - [`VecDeque::partition_point`]
 620
 621 Cargo
 622 -----
 623
 624 - [Added the `--prune <spec>` option to `cargo-tree` to remove a package from
 625   the dependency graph.][cargo/9520]
 626 - [Added the `--depth` option to `cargo-tree` to print only to a certain depth
 627   in the tree ][cargo/9499]
 628 - [Added the `no-proc-macro` value to `cargo-tree --edges` to hide procedural
 629   macro dependencies.][cargo/9488]
 630 - [A new environment variable named `CARGO_TARGET_TMPDIR` is available.][cargo/9375]
 631   This variable points to a directory that integration tests and benches
 632   can use as a "scratchpad" for testing filesystem operations.
 633
 634 Compatibility Notes
 635 -------------------
 636 - [Mixing Option and Result via `?` is no longer permitted in closures for inferred types.][86831]
 637 - [Previously unsound code is no longer permitted where different constructors in branches
 638   could require different lifetimes.][85574]
 639 - As previously mentioned the [`std::arch` instrinsics now uses stricter const checking][83278]
 640   than before and may reject some previously accepted code.
 641 - [`i128` multiplication on Cortex M0+ platforms currently unconditionally causes overflow
 642    when compiled with `codegen-units = 1`.][86063]
 643
 644 [85574]: https://github.com/rust-lang/rust/issues/85574
 645 [86831]: https://github.com/rust-lang/rust/issues/86831
 646 [86063]: https://github.com/rust-lang/rust/issues/86063
 647 [79608]: https://github.com/rust-lang/rust/pull/79608
 648 [84988]: https://github.com/rust-lang/rust/pull/84988
 649 [84701]: https://github.com/rust-lang/rust/pull/84701
 650 [84072]: https://github.com/rust-lang/rust/pull/84072
 651 [85745]: https://github.com/rust-lang/rust/pull/85745
 652 [84744]: https://github.com/rust-lang/rust/pull/84744
 653 [85078]: https://github.com/rust-lang/rust/pull/85078
 654 [84717]: https://github.com/rust-lang/rust/pull/84717
 655 [83800]: https://github.com/rust-lang/rust/pull/83800
 656 [83366]: https://github.com/rust-lang/rust/pull/83366
 657 [83278]: https://github.com/rust-lang/rust/pull/83278
 658 [85292]: https://github.com/rust-lang/rust/pull/85292
 659 [82834]: https://github.com/rust-lang/rust/pull/82834
 660 [cargo/9520]: https://github.com/rust-lang/cargo/pull/9520
 661 [cargo/9499]: https://github.com/rust-lang/cargo/pull/9499
 662 [cargo/9488]: https://github.com/rust-lang/cargo/pull/9488
 663 [cargo/9375]: https://github.com/rust-lang/cargo/pull/9375
 664 [`BTreeMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_keys
 665 [`BTreeMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_values
 666 [`HashMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_keys
 667 [`HashMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_values
 668 [`arch::wasm32`]: https://doc.rust-lang.org/core/arch/wasm32/index.html
 669 [`VecDeque::binary_search`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search
 670 [`VecDeque::binary_search_by`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by
 671
 672 [`VecDeque::binary_search_by_key`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by_key
 673
 674 [`VecDeque::partition_point`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.partition_point
 675
 676 Version 1.53.0 (2021-06-17)
 677 ============================
 678
 679 Language
 680 -----------------------
 681 - [You can now use unicode for identifiers.][83799] This allows multilingual
 682   identifiers but still doesn't allow glyphs that are not considered characters
 683   such as `◆` or `🦀`. More specifically you can now use any identifier that
 684   matches the UAX #31 "Unicode Identifier and Pattern Syntax" standard. This
 685   is the same standard as languages like Python, however Rust uses NFC
 686   normalization which may be different from other languages.
 687 - [You can now specify "or patterns" inside pattern matches.][79278]
 688   Previously you could only use `|` (OR) on complete patterns. E.g.
 689   ```rust
 690   let x = Some(2u8);
 691   // Before
 692   matches!(x, Some(1) | Some(2));
 693   // Now
 694   matches!(x, Some(1 | 2));
 695   ```
 696 - [Added the `:pat_param` `macro_rules!` matcher.][83386] This matcher
 697   has the same semantics as the `:pat` matcher. This is to allow `:pat`
 698   to change semantics to being a pattern fragment in a future edition.
 699
 700 Compiler
 701 -----------------------
 702 - [Updated the minimum external LLVM version to LLVM 10.][83387]
 703 - [Added Tier 3\* support for the `wasm64-unknown-unknown` target.][80525]
 704 - [Improved debuginfo for closures and async functions on Windows MSVC.][83941]
 705
 706 \* Refer to Rust's [platform support page][platform-support-doc] for more
 707 information on Rust's tiered platform support.
 708
 709 Libraries
 710 -----------------------
 711 - [Abort messages will now forward to `android_set_abort_message` on
 712   Android platforms when available.][81469]
 713 - [`slice::IterMut<'_, T>` now implements `AsRef<[T]>`][82771]
 714 - [Arrays of any length now implement `IntoIterator`.][84147]
 715   Currently calling `.into_iter()` as a method on an array will
 716   return `impl Iterator<Item=&T>`, but this may change in a
 717   future edition to change `Item` to `T`. Calling `IntoIterator::into_iter`
 718   directly on arrays will provide `impl Iterator<Item=T>` as expected.
 719 - [`leading_zeros`, and `trailing_zeros` are now available on all
 720   `NonZero` integer types.][84082]
 721 - [`{f32, f64}::from_str` now parse and print special values
 722   (`NaN`, `-0`) according to IEEE 754.][78618]
 723 - [You can now index into slices using `(Bound<usize>, Bound<usize>)`.][77704]
 724 - [Add the `BITS` associated constant to all numeric types.][82565]
 725
 726 Stabilised APIs
 727 ---------------
 728 - [`AtomicBool::fetch_update`]
 729 - [`AtomicPtr::fetch_update`]
 730 - [`BTreeMap::retain`]
 731 - [`BTreeSet::retain`]
 732 - [`BufReader::seek_relative`]
 733 - [`DebugStruct::non_exhaustive`]
 734 - [`Duration::MAX`]
 735 - [`Duration::ZERO`]
 736 - [`Duration::is_zero`]
 737 - [`Duration::saturating_add`]
 738 - [`Duration::saturating_mul`]
 739 - [`Duration::saturating_sub`]
 740 - [`ErrorKind::Unsupported`]
 741 - [`Option::insert`]
 742 - [`Ordering::is_eq`]
 743 - [`Ordering::is_ge`]
 744 - [`Ordering::is_gt`]
 745 - [`Ordering::is_le`]
 746 - [`Ordering::is_lt`]
 747 - [`Ordering::is_ne`]
 748 - [`OsStr::is_ascii`]
 749 - [`OsStr::make_ascii_lowercase`]
 750 - [`OsStr::make_ascii_uppercase`]
 751 - [`OsStr::to_ascii_lowercase`]
 752 - [`OsStr::to_ascii_uppercase`]
 753 - [`Peekable::peek_mut`]
 754 - [`Rc::decrement_strong_count`]
 755 - [`Rc::increment_strong_count`]
 756 - [`Vec::extend_from_within`]
 757 - [`array::from_mut`]
 758 - [`array::from_ref`]
 759 - [`cmp::max_by_key`]
 760 - [`cmp::max_by`]
 761 - [`cmp::min_by_key`]
 762 - [`cmp::min_by`]
 763 - [`f32::is_subnormal`]
 764 - [`f64::is_subnormal`]
 765
 766 Cargo
 767 -----------------------
 768 - [Cargo now supports git repositories where the default `HEAD` branch is not
 769   "master".][cargo/9392] This also includes a switch to the version 3 `Cargo.lock` format
 770   which can handle default branches correctly.
 771 - [macOS targets now default to `unpacked` split-debuginfo.][cargo/9298]
 772 - [The `authors` field is no longer included in `Cargo.toml` for new
 773   projects.][cargo/9282]
 774
 775 Rustdoc
 776 -----------------------
 777 - [Added the `rustdoc::bare_urls` lint that warns when you have URLs
 778   without hyperlinks.][81764]
 779
 780 Compatibility Notes
 781 -------------------
 782 - [Implement token-based handling of attributes during expansion][82608]
 783 - [`Ipv4::from_str` will now reject octal format IP addresses in addition
 784   to rejecting hexadecimal IP addresses.][83652] The octal format can lead
 785   to confusion and potential security vulnerabilities and [is no
 786   longer recommended][ietf6943].
 787 - [The added `BITS` constant may conflict with external definitions.][85667]
 788   In particular, this was known to be a problem in the `lexical-core` crate,
 789   but they have published fixes for semantic versions 0.4 through 0.7. To
 790   update this dependency alone, use `cargo update -p lexical-core`.
 791 - Incremental compilation remains off by default, unless one uses the `RUSTC_FORCE_INCREMENTAL=1` environment variable added in 1.52.1.
 792
 793 Internal Only
 794 -------------
 795 These changes provide no direct user facing benefits, but represent significant
 796 improvements to the internals and overall performance of rustc and
 797 related tools.
 798
 799 - [Rework the `std::sys::windows::alloc` implementation.][83065]
 800 - [rustdoc: Don't enter an infer_ctxt in get_blanket_impls for impls that aren't blanket impls.][82864]
 801 - [rustdoc: Only look at blanket impls in `get_blanket_impls`][83681]
 802 - [Rework rustdoc const type][82873]
 803
 804 [85667]: https://github.com/rust-lang/rust/pull/85667
 805 [83386]: https://github.com/rust-lang/rust/pull/83386
 806 [82771]: https://github.com/rust-lang/rust/pull/82771
 807 [84147]: https://github.com/rust-lang/rust/pull/84147
 808 [84082]: https://github.com/rust-lang/rust/pull/84082
 809 [83799]: https://github.com/rust-lang/rust/pull/83799
 810 [83681]: https://github.com/rust-lang/rust/pull/83681
 811 [83652]: https://github.com/rust-lang/rust/pull/83652
 812 [83387]: https://github.com/rust-lang/rust/pull/83387
 813 [82873]: https://github.com/rust-lang/rust/pull/82873
 814 [82864]: https://github.com/rust-lang/rust/pull/82864
 815 [82608]: https://github.com/rust-lang/rust/pull/82608
 816 [82565]: https://github.com/rust-lang/rust/pull/82565
 817 [80525]: https://github.com/rust-lang/rust/pull/80525
 818 [79278]: https://github.com/rust-lang/rust/pull/79278
 819 [78618]: https://github.com/rust-lang/rust/pull/78618
 820 [77704]: https://github.com/rust-lang/rust/pull/77704
 821 [83941]: https://github.com/rust-lang/rust/pull/83941
 822 [83065]: https://github.com/rust-lang/rust/pull/83065
 823 [81764]: https://github.com/rust-lang/rust/pull/81764
 824 [81469]: https://github.com/rust-lang/rust/pull/81469
 825 [cargo/9298]: https://github.com/rust-lang/cargo/pull/9298
 826 [cargo/9282]: https://github.com/rust-lang/cargo/pull/9282
 827 [cargo/9392]: https://github.com/rust-lang/cargo/pull/9392
 828 [`AtomicBool::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicBool.html#method.fetch_update
 829 [`AtomicPtr::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicPtr.html#method.fetch_update
 830 [`BTreeMap::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.retain
 831 [`BTreeSet::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeSet.html#method.retain
 832 [`BufReader::seek_relative`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.seek_relative
 833 [`DebugStruct::non_exhaustive`]: https://doc.rust-lang.org/std/fmt/struct.DebugStruct.html#method.finish_non_exhaustive
 834 [`Duration::MAX`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
 835 [`Duration::ZERO`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.ZERO
 836 [`Duration::is_zero`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.is_zero
 837 [`Duration::saturating_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_add
 838 [`Duration::saturating_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_mul
 839 [`Duration::saturating_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_sub
 840 [`ErrorKind::Unsupported`]: https://doc.rust-lang.org/std/io/enum.ErrorKind.html#variant.Unsupported
 841 [`Option::insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.insert
 842 [`Ordering::is_eq`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_eq
 843 [`Ordering::is_ge`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ge
 844 [`Ordering::is_gt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_gt
 845 [`Ordering::is_le`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_le
 846 [`Ordering::is_lt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_lt
 847 [`Ordering::is_ne`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ne
 848 [`OsStr::is_ascii`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.is_ascii
 849 [`OsStr::make_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_lowercase
 850 [`OsStr::make_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_uppercase
 851 [`OsStr::to_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_lowercase
 852 [`OsStr::to_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_uppercase
 853 [`Peekable::peek_mut`]: https://doc.rust-lang.org/std/iter/struct.Peekable.html#method.peek_mut
 854 [`Rc::decrement_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
 855 [`Rc::increment_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
 856 [`Vec::extend_from_within`]: https://doc.rust-lang.org/beta/std/vec/struct.Vec.html#method.extend_from_within
 857 [`array::from_mut`]: https://doc.rust-lang.org/beta/std/array/fn.from_mut.html
 858 [`array::from_ref`]: https://doc.rust-lang.org/beta/std/array/fn.from_ref.html
 859 [`cmp::max_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by_key.html
 860 [`cmp::max_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by.html
 861 [`cmp::min_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by_key.html
 862 [`cmp::min_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by.html
 863 [`f32::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
 864 [`f64::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
 865 [ietf6943]: https://datatracker.ietf.org/doc/html/rfc6943#section-3.1.1
 866
 867
 868 Version 1.52.1 (2021-05-10)
 869 ============================
 870
 871 This release disables incremental compilation, unless the user has explicitly
 872 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
 873
 874 This is due to the widespread, and frequently occuring, breakage encountered by
 875 Rust users due to newly enabled incremental verification in 1.52.0. Notably,
 876 Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
 877 newly added incremental verification are still present in past stable versions,
 878 and are not yet fixed on any channel. These bugs can lead to miscompilation of
 879 Rust binaries.
 880
 881 These problems only affect incremental builds, so release builds with Cargo
 882 should not be affected unless the user has explicitly opted into incremental.
 883 Debug and check builds are affected.
 884
 885 See [84970] for more details.
 886
 887 [84970]: https://github.com/rust-lang/rust/issues/84970
 888
 889 Version 1.52.0 (2021-05-06)
 890 ============================
 891
 892 Language
 893 --------
 894 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
 895   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
 896   is allowed by default, and may become a warning or hard error in a
 897   future edition.
 898 - [You can now cast mutable references to arrays to a pointer of the same type as
 899   the element.][81479]
 900
 901 Compiler
 902 --------
 903 - [Upgraded the default LLVM to LLVM 12.][81451]
 904
 905 Added tier 3\* support for the following targets.
 906
 907 - [`s390x-unknown-linux-musl`][82166]
 908 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
 909 - [`powerpc-unknown-openbsd`][82733]
 910
 911 \* Refer to Rust's [platform support page][platform-support-doc] for more
 912 information on Rust's tiered platform support.
 913
 914 Libraries
 915 ---------
 916 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
 917 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
 918 - [`Arc<impl Error>` now implements `error::Error`.][80553]
 919 - [All integer division and remainder operations are now `const`.][80962]
 920
 921 Stabilised APIs
 922 -------------
 923 - [`Arguments::as_str`]
 924 - [`char::MAX`]
 925 - [`char::REPLACEMENT_CHARACTER`]
 926 - [`char::UNICODE_VERSION`]
 927 - [`char::decode_utf16`]
 928 - [`char::from_digit`]
 929 - [`char::from_u32_unchecked`]
 930 - [`char::from_u32`]
 931 - [`slice::partition_point`]
 932 - [`str::rsplit_once`]
 933 - [`str::split_once`]
 934
 935 The following previously stable APIs are now `const`.
 936
 937 - [`char::len_utf8`]
 938 - [`char::len_utf16`]
 939 - [`char::to_ascii_uppercase`]
 940 - [`char::to_ascii_lowercase`]
 941 - [`char::eq_ignore_ascii_case`]
 942 - [`u8::to_ascii_uppercase`]
 943 - [`u8::to_ascii_lowercase`]
 944 - [`u8::eq_ignore_ascii_case`]
 945
 946 Rustdoc
 947 -------
 948 - [Rustdoc lints are now treated as a tool lint, meaning that
 949   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
 950   Using the old style is still allowed, and will become a warning in
 951   a future release.
 952 - [Rustdoc now supports argument files.][82261]
 953 - [Rustdoc now generates smart punctuation for documentation.][79423]
 954 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
 955   ```markdown
 956   - [x] Complete
 957   - [ ] Todo
 958   ```
 959
 960 Misc
 961 ----
 962 - [You can now pass multiple filters to tests.][81356] E.g.
 963   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
 964 - [Rustup now distributes PDB symbols for the `std` library on Windows,
 965   allowing you to see `std` symbols when debugging.][82218]
 966
 967 Internal Only
 968 -------------
 969 These changes provide no direct user facing benefits, but represent significant
 970 improvements to the internals and overall performance of rustc and
 971 related tools.
 972
 973 - [Check the result cache before the DepGraph when ensuring queries][81855]
 974 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
 975 - [Only store a LocalDefId in some HIR nodes][81611]
 976 - [Store HIR attributes in a side table][79519]
 977
 978 Compatibility Notes
 979 -------------------
 980 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
 981 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
 982 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
 983 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
 984   languages in code blocks.][78429]
 985 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
 986 - [Changes in how proc macros handle whitespace may lead to panics when used
 987   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
 988 - [Turn `#[derive]` into a regular macro attribute][79078]
 989
 990 [84136]: https://github.com/rust-lang/rust/issues/84136
 991 [80763]: https://github.com/rust-lang/rust/pull/80763
 992 [82166]: https://github.com/rust-lang/rust/pull/82166
 993 [82121]: https://github.com/rust-lang/rust/pull/82121
 994 [81879]: https://github.com/rust-lang/rust/pull/81879
 995 [82261]: https://github.com/rust-lang/rust/pull/82261
 996 [82218]: https://github.com/rust-lang/rust/pull/82218
 997 [82216]: https://github.com/rust-lang/rust/pull/82216
 998 [82202]: https://github.com/rust-lang/rust/pull/82202
 999 [81855]: https://github.com/rust-lang/rust/pull/81855
1000 [81766]: https://github.com/rust-lang/rust/pull/81766
1001 [81744]: https://github.com/rust-lang/rust/pull/81744
1002 [81611]: https://github.com/rust-lang/rust/pull/81611
1003 [81479]: https://github.com/rust-lang/rust/pull/81479
1004 [81451]: https://github.com/rust-lang/rust/pull/81451
1005 [81356]: https://github.com/rust-lang/rust/pull/81356
1006 [80962]: https://github.com/rust-lang/rust/pull/80962
1007 [80553]: https://github.com/rust-lang/rust/pull/80553
1008 [80527]: https://github.com/rust-lang/rust/pull/80527
1009 [79519]: https://github.com/rust-lang/rust/pull/79519
1010 [79423]: https://github.com/rust-lang/rust/pull/79423
1011 [79208]: https://github.com/rust-lang/rust/pull/79208
1012 [78429]: https://github.com/rust-lang/rust/pull/78429
1013 [82733]: https://github.com/rust-lang/rust/pull/82733
1014 [82594]: https://github.com/rust-lang/rust/pull/82594
1015 [79078]: https://github.com/rust-lang/rust/pull/79078
1016 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
1017 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
1018 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
1019 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
1020 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
1021 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
1022 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
1023 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
1024 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
1025 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
1026 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
1027 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
1028 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
1029 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
1030 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
1031 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
1032 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
1033 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
1034 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
1035 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
1036 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
1037 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
1038
1039 Version 1.51.0 (2021-03-25)
1040 ============================
1041
1042 Language
1043 --------
1044 - [You can now parameterize items such as functions, traits, and `struct`s by constant
1045   values in addition to by types and lifetimes.][79135] Also known as "const generics"
1046   E.g. you can now write the following. Note: Only values of primitive integers,
1047   `bool`, or `char` types are currently permitted.
1048   ```rust
1049   struct GenericArray<T, const LENGTH: usize> {
1050       inner: [T; LENGTH]
1051   }
1052
1053   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
1054       const fn last(&self) -> Option<&T> {
1055           if LENGTH == 0 {
1056               None
1057           } else {
1058               Some(&self.inner[LENGTH - 1])
1059           }
1060       }
1061   }
1062   ```
1063
1064
1065 Compiler
1066 --------
1067
1068 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
1069   This option controls whether debug information is split across multiple files
1070   or packed into a single file. **Note** This option is unstable on other platforms.
1071 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
1072   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
1073 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
1074 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
1075
1076 \* Refer to Rust's [platform support page][platform-support-doc] for more
1077 information on Rust's tiered platform support.
1078
1079 Libraries
1080 ---------
1081
1082 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
1083 - [`str` now implements `AsMut<str>`.][80279]
1084 - [`u64` and `u128` now implement `From<char>`.][79502]
1085 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
1086 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
1087 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
1088 - [`io::Empty` now implements `io::Seek`.][78044]
1089 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
1090   `T: ?Sized` types.][80764]
1091 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
1092
1093
1094 Stabilized APIs
1095 ---------------
1096
1097 - [`Arc::decrement_strong_count`]
1098 - [`Arc::increment_strong_count`]
1099 - [`Once::call_once_force`]
1100 - [`Peekable::next_if_eq`]
1101 - [`Peekable::next_if`]
1102 - [`Seek::stream_position`]
1103 - [`array::IntoIter`]
1104 - [`panic::panic_any`]
1105 - [`ptr::addr_of!`]
1106 - [`ptr::addr_of_mut!`]
1107 - [`slice::fill_with`]
1108 - [`slice::split_inclusive_mut`]
1109 - [`slice::split_inclusive`]
1110 - [`slice::strip_prefix`]
1111 - [`slice::strip_suffix`]
1112 - [`str::split_inclusive`]
1113 - [`sync::OnceState`]
1114 - [`task::Wake`]
1115 - [`VecDeque::range`]
1116 - [`VecDeque::range_mut`]
1117
1118 Cargo
1119 -----
1120 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
1121   codegen option.][cargo/9112]
1122 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
1123   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
1124   to avoid unifying features of dependencies where that unification could be unwanted.
1125   Such as using the same dependency with a `std` feature in a build scripts and
1126   proc-macros, while using the `no-std` feature in the final binary. See the
1127   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
1128
1129 Rustdoc
1130 -------
1131
1132 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
1133 - [You can now provide a `--default-theme` flag which sets the default theme to use for
1134   documentation.][79642]
1135
1136 Various improvements to intra-doc links:
1137
1138 - [You can link to non-path primitives such as `slice`.][80181]
1139 - [You can link to associated items.][74489]
1140 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
1141
1142 Misc
1143 ----
1144 - [You can now pass `--include-ignored` to tests (e.g. with
1145   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
1146
1147 Compatibility Notes
1148 -------------------
1149
1150 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
1151 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
1152   could fail.][80579]
1153 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
1154   for the distributed artifacts.][81521]
1155     - `armv5te-unknown-linux-gnueabi`
1156     - `sparc64-unknown-linux-gnu`
1157     - `thumbv7neon-unknown-linux-gnueabihf`
1158     - `armv7-unknown-linux-gnueabi`
1159     - `x86_64-unknown-linux-gnux32`
1160 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
1161
1162 Internal Only
1163 -------------
1164
1165 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
1166
1167 [79135]: https://github.com/rust-lang/rust/pull/79135
1168 [74489]: https://github.com/rust-lang/rust/pull/74489
1169 [76934]: https://github.com/rust-lang/rust/pull/76934
1170 [79570]: https://github.com/rust-lang/rust/pull/79570
1171 [80181]: https://github.com/rust-lang/rust/pull/80181
1172 [79642]: https://github.com/rust-lang/rust/pull/79642
1173 [80945]: https://github.com/rust-lang/rust/pull/80945
1174 [80279]: https://github.com/rust-lang/rust/pull/80279
1175 [80053]: https://github.com/rust-lang/rust/pull/80053
1176 [79502]: https://github.com/rust-lang/rust/pull/79502
1177 [75180]: https://github.com/rust-lang/rust/pull/75180
1178 [81521]: https://github.com/rust-lang/rust/pull/81521
1179 [80968]: https://github.com/rust-lang/rust/pull/80968
1180 [80959]: https://github.com/rust-lang/rust/pull/80959
1181 [80718]: https://github.com/rust-lang/rust/pull/80718
1182 [80653]: https://github.com/rust-lang/rust/pull/80653
1183 [80579]: https://github.com/rust-lang/rust/pull/80579
1184 [79998]: https://github.com/rust-lang/rust/pull/79998
1185 [78044]: https://github.com/rust-lang/rust/pull/78044
1186 [81455]: https://github.com/rust-lang/rust/pull/81455
1187 [80764]: https://github.com/rust-lang/rust/pull/80764
1188 [80749]: https://github.com/rust-lang/rust/pull/80749
1189 [80662]: https://github.com/rust-lang/rust/pull/80662
1190 [79134]: https://github.com/rust-lang/rust/pull/79134
1191 [80966]: https://github.com/rust-lang/rust/pull/80966
1192 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
1193 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
1194 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
1195 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
1196 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
1197 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
1198 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
1199 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
1200 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
1201 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
1202 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
1203 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
1204 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
1205 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
1206 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
1207 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
1208 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
1209 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
1210 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
1211 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
1212 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
1213 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
1214 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
1215
1216 Version 1.50.0 (2021-02-11)
1217 ============================
1218
1219 Language
1220 -----------------------
1221 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
1222   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
1223 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
1224
1225 Compiler
1226 -----------------------
1227 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
1228 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
1229 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
1230 - [Dropped support for all cloudabi targets.][78439]
1231
1232 \* Refer to Rust's [platform support page][platform-support-doc] for more
1233 information on Rust's tiered platform support.
1234
1235 Libraries
1236 -----------------------
1237
1238 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
1239 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
1240 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
1241   This value cannot be a valid file descriptor, and now means `Option<File>` takes
1242   up the same amount of space as `File`.
1243
1244 Stabilized APIs
1245 ---------------
1246
1247 - [`bool::then`]
1248 - [`btree_map::Entry::or_insert_with_key`]
1249 - [`f32::clamp`]
1250 - [`f64::clamp`]
1251 - [`hash_map::Entry::or_insert_with_key`]
1252 - [`Ord::clamp`]
1253 - [`RefCell::take`]
1254 - [`slice::fill`]
1255 - [`UnsafeCell::get_mut`]
1256
1257 The following previously stable methods are now `const`.
1258
1259 - [`IpAddr::is_ipv4`]
1260 - [`IpAddr::is_ipv6`]
1261 - [`IpAddr::is_unspecified`]
1262 - [`IpAddr::is_loopback`]
1263 - [`IpAddr::is_multicast`]
1264 - [`Ipv4Addr::octets`]
1265 - [`Ipv4Addr::is_loopback`]
1266 - [`Ipv4Addr::is_private`]
1267 - [`Ipv4Addr::is_link_local`]
1268 - [`Ipv4Addr::is_multicast`]
1269 - [`Ipv4Addr::is_broadcast`]
1270 - [`Ipv4Addr::is_documentation`]
1271 - [`Ipv4Addr::to_ipv6_compatible`]
1272 - [`Ipv4Addr::to_ipv6_mapped`]
1273 - [`Ipv6Addr::segments`]
1274 - [`Ipv6Addr::is_unspecified`]
1275 - [`Ipv6Addr::is_loopback`]
1276 - [`Ipv6Addr::is_multicast`]
1277 - [`Ipv6Addr::to_ipv4`]
1278 - [`Layout::size`]
1279 - [`Layout::align`]
1280 - [`Layout::from_size_align`]
1281 - `pow` for all integer types.
1282 - `checked_pow` for all integer types.
1283 - `saturating_pow` for all integer types.
1284 - `wrapping_pow` for all integer types.
1285 - `next_power_of_two` for all unsigned integer types.
1286 - `checked_next_power_of_two` for all unsigned integer types.
1287
1288 Cargo
1289 -----------------------
1290
1291 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
1292   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
1293 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
1294   contents of that directory for changes.][cargo/8973]
1295 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
1296
1297 Misc
1298 ----
1299
1300 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
1301 - [Running tests will now print the total time taken to execute.][75752]
1302
1303 Compatibility Notes
1304 -------------------
1305
1306 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
1307   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
1308 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
1309   unhygenic `macro_rules!` macros.][79472]
1310 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
1311   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
1312 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
1313 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
1314   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
1315 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
1316
1317 [74989]: https://github.com/rust-lang/rust/pull/74989
1318 [79261]: https://github.com/rust-lang/rust/pull/79261
1319 [79896]: https://github.com/rust-lang/rust/pull/79896
1320 [79484]: https://github.com/rust-lang/rust/pull/79484
1321 [79472]: https://github.com/rust-lang/rust/pull/79472
1322 [79270]: https://github.com/rust-lang/rust/pull/79270
1323 [79003]: https://github.com/rust-lang/rust/pull/79003
1324 [78864]: https://github.com/rust-lang/rust/pull/78864
1325 [78636]: https://github.com/rust-lang/rust/pull/78636
1326 [78439]: https://github.com/rust-lang/rust/pull/78439
1327 [78343]: https://github.com/rust-lang/rust/pull/78343
1328 [78296]: https://github.com/rust-lang/rust/pull/78296
1329 [78068]: https://github.com/rust-lang/rust/pull/78068
1330 [75752]: https://github.com/rust-lang/rust/pull/75752
1331 [74699]: https://github.com/rust-lang/rust/pull/74699
1332 [78142]: https://github.com/rust-lang/rust/pull/78142
1333 [77484]: https://github.com/rust-lang/rust/pull/77484
1334 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
1335 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
1336 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
1337 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
1338 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
1339 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
1340 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
1341 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
1342 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
1343 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
1344 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
1345 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
1346 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
1347 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
1348 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
1349 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
1350 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
1351 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
1352 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
1353 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
1354 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
1355 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
1356 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
1357 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
1358 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
1359 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
1360 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
1361 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
1362 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
1363 [`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
1364 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
1365 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
1366 [`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
1367 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
1368
1369
1370 Version 1.49.0 (2020-12-31)
1371 ============================
1372
1373 Language
1374 -----------------------
1375
1376 - [Unions can now implement `Drop`, and you can now have a field in a union
1377   with `ManuallyDrop<T>`.][77547]
1378 - [You can now cast uninhabited enums to integers.][76199]
1379 - [You can now bind by reference and by move in patterns.][76119] This
1380   allows you to selectively borrow individual components of a type. E.g.
1381   ```rust
1382   #[derive(Debug)]
1383   struct Person {
1384       name: String,
1385       age: u8,
1386   }
1387
1388   let person = Person {
1389       name: String::from("Alice"),
1390       age: 20,
1391   };
1392
1393   // `name` is moved out of person, but `age` is referenced.
1394   let Person { name, ref age } = person;
1395   println!("{} {}", name, age);
1396   ```
1397
1398 Compiler
1399 -----------------------
1400
1401 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
1402 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
1403 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
1404 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
1405 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
1406 - [Output from threads spawned in tests is now captured.][78227]
1407 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
1408
1409 \* Refer to Rust's [platform support page][platform-support-doc] for more
1410 information on Rust's tiered platform support.
1411
1412 Libraries
1413 -----------------------
1414
1415 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
1416 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
1417
1418 Stabilized APIs
1419 ---------------
1420
1421 - [`slice::select_nth_unstable`]
1422 - [`slice::select_nth_unstable_by`]
1423 - [`slice::select_nth_unstable_by_key`]
1424
1425 The following previously stable methods are now `const`.
1426
1427 - [`Poll::is_ready`]
1428 - [`Poll::is_pending`]
1429
1430 Cargo
1431 -----------------------
1432 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
1433 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
1434 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
1435   variable will be set if the crate being built is one the user selected to build, either
1436   with `-p` or through defaults.
1437 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
1438
1439
1440 Compatibility Notes
1441 -------------------
1442
1443 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
1444 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
1445 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
1446   Previously such invalid or unused attributes could be ignored.
1447 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
1448   read [this post about the changes][rustdoc-ws-post] for more details.
1449 - [Trait bounds are no longer inferred for associated types.][79904]
1450
1451 Internal Only
1452 -------------
1453 These changes provide no direct user facing benefits, but represent significant
1454 improvements to the internals and overall performance of rustc and
1455 related tools.
1456
1457 - [rustc's internal crates are now compiled using the `initial-exec` Thread
1458   Local Storage model.][78201]
1459 - [Calculate visibilities once in resolve.][78077]
1460 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
1461 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
1462
1463
1464 [75991]: https://github.com/rust-lang/rust/pull/75991
1465 [78951]: https://github.com/rust-lang/rust/pull/78951
1466 [78848]: https://github.com/rust-lang/rust/pull/78848
1467 [78746]: https://github.com/rust-lang/rust/pull/78746
1468 [78376]: https://github.com/rust-lang/rust/pull/78376
1469 [78228]: https://github.com/rust-lang/rust/pull/78228
1470 [78227]: https://github.com/rust-lang/rust/pull/78227
1471 [78201]: https://github.com/rust-lang/rust/pull/78201
1472 [78109]: https://github.com/rust-lang/rust/pull/78109
1473 [78077]: https://github.com/rust-lang/rust/pull/78077
1474 [77997]: https://github.com/rust-lang/rust/pull/77997
1475 [77703]: https://github.com/rust-lang/rust/pull/77703
1476 [77547]: https://github.com/rust-lang/rust/pull/77547
1477 [77015]: https://github.com/rust-lang/rust/pull/77015
1478 [76199]: https://github.com/rust-lang/rust/pull/76199
1479 [76119]: https://github.com/rust-lang/rust/pull/76119
1480 [75914]: https://github.com/rust-lang/rust/pull/75914
1481 [79004]: https://github.com/rust-lang/rust/pull/79004
1482 [78676]: https://github.com/rust-lang/rust/pull/78676
1483 [79904]: https://github.com/rust-lang/rust/issues/79904
1484 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
1485 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
1486 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
1487 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
1488 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
1489 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
1490 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
1491 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
1492 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
1493 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
1494
1495 Version 1.48.0 (2020-11-19)
1496 ==========================
1497
1498 Language
1499 --------
1500
1501 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
1502   is still rejected *semantically*, but can now be parsed by procedural macros.
1503
1504 Compiler
1505 --------
1506 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
1507   `rustc` whether to link its own C runtime and libraries or to rely on a external
1508   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
1509 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
1510   Note: If you're using cargo you must explicitly pass the `--target` flag.
1511 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
1512
1513 \* Refer to Rust's [platform support page][platform-support-doc] for more
1514 information on Rust's tiered platform support.
1515
1516 Libraries
1517 ---------
1518 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
1519   and `&Stderr`.][76275]
1520 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
1521 - [The `matches!` macro now supports having a trailing comma.][74880]
1522 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
1523 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
1524
1525 Stabilized APIs
1526 ---------------
1527 - [`slice::as_ptr_range`]
1528 - [`slice::as_mut_ptr_range`]
1529 - [`VecDeque::make_contiguous`]
1530 - [`future::pending`]
1531 - [`future::ready`]
1532
1533 The following previously stable methods are now `const fn`'s:
1534
1535 - [`Option::is_some`]
1536 - [`Option::is_none`]
1537 - [`Option::as_ref`]
1538 - [`Result::is_ok`]
1539 - [`Result::is_err`]
1540 - [`Result::as_ref`]
1541 - [`Ordering::reverse`]
1542 - [`Ordering::then`]
1543
1544 Cargo
1545 -----
1546
1547 Rustdoc
1548 -------
1549 - [You can now link to items in `rustdoc` using the intra-doc link
1550   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
1551   a link to `std::future`'s documentation. See ["Linking to items by
1552   name"][intradoc-links] for more information.
1553 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
1554   when searching through `rustdoc`'s UI.][75740]
1555
1556 Compatibility Notes
1557 -------------------
1558 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
1559   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
1560   promoted to `'static` lifetime any more inside `const fn`s.
1561 - [Associated type bindings on trait objects are now verified to meet the bounds
1562   declared on the trait when checking that they implement the trait.][27675]
1563 - [When trait bounds on associated types or opaque types are ambiguous, the
1564   compiler no longer makes an arbitrary choice on which bound to use.][54121]
1565 - [Fixed recursive nonterminals not being expanded in macros during
1566   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
1567   correctly handling recursive nonterminal tokens.
1568 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
1569 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
1570   in places where they have no effect.][73461]
1571 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
1572   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
1573 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
1574   disallow zero-initialization.][71274]
1575 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
1576 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
1577   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
1578   see the [`catch_unwind`] documentation for further information.
1579
1580
1581
1582 Internal Only
1583 -------------
1584 These changes provide no direct user facing benefits, but represent significant
1585 improvements to the internals and overall performance of rustc and
1586 related tools.
1587
1588 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
1589   You can continue building with `make` by setting `ninja=false` in
1590   your `config.toml`.
1591 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
1592 - [Made `ensure_sufficient_stack()` non-generic][76680]
1593
1594 [78143]: https://github.com/rust-lang/rust/issues/78143
1595 [76680]: https://github.com/rust-lang/rust/pull/76680/
1596 [76030]: https://github.com/rust-lang/rust/pull/76030/
1597 [70212]: https://github.com/rust-lang/rust/pull/70212/
1598 [27675]: https://github.com/rust-lang/rust/issues/27675/
1599 [54121]: https://github.com/rust-lang/rust/issues/54121/
1600 [71274]: https://github.com/rust-lang/rust/pull/71274/
1601 [77386]: https://github.com/rust-lang/rust/pull/77386/
1602 [77153]: https://github.com/rust-lang/rust/pull/77153/
1603 [77055]: https://github.com/rust-lang/rust/pull/77055/
1604 [76275]: https://github.com/rust-lang/rust/pull/76275/
1605 [76310]: https://github.com/rust-lang/rust/pull/76310/
1606 [76420]: https://github.com/rust-lang/rust/pull/76420/
1607 [76158]: https://github.com/rust-lang/rust/pull/76158/
1608 [75857]: https://github.com/rust-lang/rust/pull/75857/
1609 [75585]: https://github.com/rust-lang/rust/pull/75585/
1610 [75740]: https://github.com/rust-lang/rust/pull/75740/
1611 [75502]: https://github.com/rust-lang/rust/pull/75502/
1612 [74880]: https://github.com/rust-lang/rust/pull/74880/
1613 [74922]: https://github.com/rust-lang/rust/pull/74922/
1614 [74430]: https://github.com/rust-lang/rust/pull/74430/
1615 [74194]: https://github.com/rust-lang/rust/pull/74194/
1616 [73461]: https://github.com/rust-lang/rust/pull/73461/
1617 [73166]: https://github.com/rust-lang/rust/pull/73166/
1618 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
1619 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
1620 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
1621 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
1622 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
1623 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
1624 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
1625 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
1626 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
1627 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
1628 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
1629 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
1630 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
1631 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
1632 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
1633
1634
1635 Version 1.47.0 (2020-10-08)
1636 ==========================
1637
1638 Language
1639 --------
1640 - [Closures will now warn when not used.][74869]
1641
1642 Compiler
1643 --------
1644 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
1645   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
1646   platforms.
1647 - [Upgraded to LLVM 11.][73526]
1648 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
1649 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
1650 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
1651
1652 \* Refer to Rust's [platform support page][platform-support-doc] for more
1653 information on Rust's tiered platform support.
1654
1655 Libraries
1656 ---------
1657 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
1658 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
1659   those of length less than 33.][74060]
1660 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
1661 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
1662   `PartialEq`, and `PartialOrd`.][73583]
1663
1664 Stabilized APIs
1665 ---------------
1666 - [`Ident::new_raw`]
1667 - [`Range::is_empty`]
1668 - [`RangeInclusive::is_empty`]
1669 - [`Result::as_deref`]
1670 - [`Result::as_deref_mut`]
1671 - [`Vec::leak`]
1672 - [`pointer::offset_from`]
1673 - [`f32::TAU`]
1674 - [`f64::TAU`]
1675
1676 The following previously stable APIs have now been made const.
1677
1678 - [The `new` method for all `NonZero` integers.][73858]
1679 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
1680   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
1681   methods for all integers.][73858]
1682 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
1683   signed integers.][73858]
1684 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
1685   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
1686   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
1687   `is_ascii_control` methods for `char` and `u8`.][73858]
1688
1689 Cargo
1690 -----
1691 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
1692   You can override this by setting the following in your `Cargo.toml`.
1693   ```toml
1694   [profile.release.build-override]
1695   opt-level = 3
1696   ```
1697 - [`cargo-help` will now display man pages for commands rather just the
1698   `--help` text.][cargo/8456]
1699 - [`cargo-metadata` now emits a `test` field indicating if a target has
1700   tests enabled.][cargo/8478]
1701 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
1702 - [`cargo-publish` will now use an alternative registry by default if it's the
1703   only registry specified in `package.publish`.][cargo/8571]
1704
1705 Misc
1706 ----
1707 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
1708   type based search.][75366]
1709 - [Added the Ayu theme to rustdoc.][71237]
1710
1711 Compatibility Notes
1712 -------------------
1713 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
1714 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
1715 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
1716   help to preserve more span information.][73084] These changes may cause
1717   compiliation errors if your macro was unhygenic or didn't correctly handle
1718   `Delimiter::None`.
1719 - [Moved support for the CloudABI target to tier 3.][75568]
1720 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
1721 - [Added the `rustc-docs` component.][75560] This allows you to install
1722   and read the documentation for the compiler internal APIs. (Currently only
1723   available for `x86_64-unknown-linux-gnu`.)
1724
1725 Internal Only
1726 --------
1727
1728 - [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.
1729
1730 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
1731 [75048]: https://github.com/rust-lang/rust/pull/75048/
1732 [74163]: https://github.com/rust-lang/rust/pull/74163/
1733 [71237]: https://github.com/rust-lang/rust/pull/71237/
1734 [74869]: https://github.com/rust-lang/rust/pull/74869/
1735 [73858]: https://github.com/rust-lang/rust/pull/73858/
1736 [75716]: https://github.com/rust-lang/rust/pull/75716/
1737 [75560]: https://github.com/rust-lang/rust/pull/75560/
1738 [75568]: https://github.com/rust-lang/rust/pull/75568/
1739 [75366]: https://github.com/rust-lang/rust/pull/75366/
1740 [75204]: https://github.com/rust-lang/rust/pull/75204/
1741 [74650]: https://github.com/rust-lang/rust/pull/74650/
1742 [74419]: https://github.com/rust-lang/rust/pull/74419/
1743 [73964]: https://github.com/rust-lang/rust/pull/73964/
1744 [74021]: https://github.com/rust-lang/rust/pull/74021/
1745 [74060]: https://github.com/rust-lang/rust/pull/74060/
1746 [73893]: https://github.com/rust-lang/rust/pull/73893/
1747 [73526]: https://github.com/rust-lang/rust/pull/73526/
1748 [73583]: https://github.com/rust-lang/rust/pull/73583/
1749 [73084]: https://github.com/rust-lang/rust/pull/73084/
1750 [73197]: https://github.com/rust-lang/rust/pull/73197/
1751 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
1752 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
1753 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
1754 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
1755 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
1756 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
1757 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
1758 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
1759 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
1760 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
1761 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
1762 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
1763 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
1764 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
1765
1766
1767 Version 1.46.0 (2020-08-27)
1768 ==========================
1769
1770 Language
1771 --------
1772 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
1773 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
1774   const functions.][73862]
1775 - [The `#[track_caller]` attribute can now be added to functions to use the
1776   function's caller's location information for panic messages.][72445]
1777 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
1778   `x.0.0` over `(x.0).0`.
1779 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
1780   You currently can't use `mem::transmute` in constant functions.
1781
1782 Compiler
1783 --------
1784 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
1785 - [Enabled static "Position Independent Executables" by default
1786   for `x86_64-unknown-linux-musl`.][70740]
1787
1788 Libraries
1789 ---------
1790 - [`mem::forget` is now a `const fn`.][73887]
1791 - [`String` now implements `From<char>`.][73466]
1792 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
1793   integer types.][73032]
1794 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
1795 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
1796   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
1797 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
1798 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
1799 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
1800
1801 Stabilized APIs
1802 ---------------
1803 - [`Option::zip`]
1804 - [`vec::Drain::as_slice`]
1805
1806 Cargo
1807 -----
1808 Added a number of new environment variables that are now available when
1809 compiling your crate.
1810
1811 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
1812   the specific binary being compiled and the name of the crate.
1813 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
1814 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
1815
1816 Compatibility Notes
1817 -------------------
1818 - [The target configuration option `abi_blacklist` has been renamed
1819   to `unsupported_abis`.][74150] The old name will still continue to work.
1820 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
1821   This was previously accepted but will become a hard error in a future release.
1822 - [Rustc will fail to compile if you have a struct with
1823   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
1824   allowed on `enum`s.
1825 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
1826   ensure that spans have the correct information, and may cause breakage if you
1827   were relying on receiving spans with dummy information.
1828 - [The InnoSetup installer for Windows is no longer available.][72569] This was
1829   a legacy installer that was replaced by a MSI installer a few years ago but
1830   was still being built.
1831 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
1832 - [Rustc will no longer accept overlapping trait implementations that only
1833   differ in how the lifetime was bound.][72493]
1834 - [Rustc now correctly relates the lifetime of an existential associated
1835   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
1836   you to pass a shorter lifetime than expected.
1837 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
1838   The library will need to be installed for `rustc` to work, even though we
1839   expect it to be already available on most systems.
1840 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
1841   under QEMU.][74820]
1842 - [Pretty printing of some tokens in procedural macros changed.][75453] The
1843   exact output returned by rustc's pretty printing is an unstable
1844   implementation detail: we recommend any macro relying on it to switch to a
1845   more robust parsing system.
1846
1847 [75453]: https://github.com/rust-lang/rust/issues/75453/
1848 [74820]: https://github.com/rust-lang/rust/issues/74820/
1849 [74420]: https://github.com/rust-lang/rust/issues/74420/
1850 [74109]: https://github.com/rust-lang/rust/pull/74109/
1851 [74150]: https://github.com/rust-lang/rust/pull/74150/
1852 [73862]: https://github.com/rust-lang/rust/pull/73862/
1853 [73887]: https://github.com/rust-lang/rust/pull/73887/
1854 [73466]: https://github.com/rust-lang/rust/pull/73466/
1855 [73516]: https://github.com/rust-lang/rust/pull/73516/
1856 [73293]: https://github.com/rust-lang/rust/pull/73293/
1857 [73007]: https://github.com/rust-lang/rust/pull/73007/
1858 [73032]: https://github.com/rust-lang/rust/pull/73032/
1859 [72920]: https://github.com/rust-lang/rust/pull/72920/
1860 [72569]: https://github.com/rust-lang/rust/pull/72569/
1861 [72583]: https://github.com/rust-lang/rust/pull/72583/
1862 [72584]: https://github.com/rust-lang/rust/pull/72584/
1863 [72717]: https://github.com/rust-lang/rust/pull/72717/
1864 [72437]: https://github.com/rust-lang/rust/pull/72437/
1865 [72445]: https://github.com/rust-lang/rust/pull/72445/
1866 [72486]: https://github.com/rust-lang/rust/pull/72486/
1867 [72493]: https://github.com/rust-lang/rust/pull/72493/
1868 [72331]: https://github.com/rust-lang/rust/pull/72331/
1869 [71896]: https://github.com/rust-lang/rust/pull/71896/
1870 [71660]: https://github.com/rust-lang/rust/pull/71660/
1871 [71322]: https://github.com/rust-lang/rust/pull/71322/
1872 [70740]: https://github.com/rust-lang/rust/pull/70740/
1873 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
1874 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
1875 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
1876 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
1877 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
1878
1879
1880 Version 1.45.2 (2020-08-03)
1881 ==========================
1882
1883 * [Fix bindings in tuple struct patterns][74954]
1884 * [Fix track_caller integration with trait objects][74784]
1885
1886 [74954]: https://github.com/rust-lang/rust/issues/74954
1887 [74784]: https://github.com/rust-lang/rust/issues/74784
1888
1889
1890 Version 1.45.1 (2020-07-30)
1891 ==========================
1892
1893 * [Fix const propagation with references.][73613]
1894 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1895 * [Avoid spurious implicit region bound.][74509]
1896 * [Install clippy on x.py install][74457]
1897
1898 [73613]: https://github.com/rust-lang/rust/pull/73613
1899 [73078]: https://github.com/rust-lang/rust/issues/73078
1900 [74509]: https://github.com/rust-lang/rust/pull/74509
1901 [74457]: https://github.com/rust-lang/rust/pull/74457
1902
1903
1904 Version 1.45.0 (2020-07-16)
1905 ==========================
1906
1907 Language
1908 --------
1909 - [Out of range float to int conversions using `as` has been defined as a saturating
1910   conversion.][71269] This was previously undefined behaviour, but you can use the
1911    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
1912    may be desirable in rare performance sensitive situations.
1913 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
1914   using `u64`.][70705]
1915 - [Function like procedural macros can now be used in expression, pattern, and  statement
1916   positions.][68717] This means you can now use a function-like procedural macro
1917   anywhere you can use a declarative (`macro_rules!`) macro.
1918
1919 Compiler
1920 --------
1921 - [You can now override individual target features through the `target-feature`
1922   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
1923   equivalent to `-C target-feature=+avx2,+fma`.
1924 - [Added the `force-unwind-tables` flag.][69984] This option allows
1925   rustc to always generate unwind tables regardless of panic strategy.
1926 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
1927   to include LLVM bitcode into generated `rlib`s (this is on by default).
1928 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
1929 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
1930 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
1931 - [Upgraded to LLVM 10.][67759]
1932
1933 \* Refer to Rust's [platform support page][platform-support-doc] for more
1934 information on Rust's tiered platform support.
1935
1936
1937 Libraries
1938 ---------
1939 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
1940   and `Ord`.][72239]
1941 - [`proc_macro::TokenStream` now implements `Default`.][72234]
1942 - [You can now use `char` with
1943   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
1944   a range of codepoints.][72413] E.g.
1945   you can now write the following;
1946   ```rust
1947   for ch in 'a'..='z' {
1948       print!("{}", ch);
1949   }
1950   println!();
1951   // Prints "abcdefghijklmnopqrstuvwxyz"
1952   ```
1953 - [`OsString` now implements `FromStr`.][71662]
1954 - [The `saturating_neg` method has been added to all signed integer primitive
1955   types, and the `saturating_abs` method has been added for all integer
1956   primitive types.][71886]
1957 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
1958   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
1959   or `Path`.][71447]
1960 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
1961 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
1962   integer types.][69813]
1963 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
1964   integer types.][72324]
1965 - [The `fetch_update` method has been added to all atomic integer types.][71843]
1966
1967 Stabilized APIs
1968 ---------------
1969 - [`Arc::as_ptr`]
1970 - [`BTreeMap::remove_entry`]
1971 - [`Rc::as_ptr`]
1972 - [`rc::Weak::as_ptr`]
1973 - [`rc::Weak::from_raw`]
1974 - [`rc::Weak::into_raw`]
1975 - [`str::strip_prefix`]
1976 - [`str::strip_suffix`]
1977 - [`sync::Weak::as_ptr`]
1978 - [`sync::Weak::from_raw`]
1979 - [`sync::Weak::into_raw`]
1980 - [`char::UNICODE_VERSION`]
1981 - [`Span::resolved_at`]
1982 - [`Span::located_at`]
1983 - [`Span::mixed_site`]
1984 - [`unix::process::CommandExt::arg0`]
1985
1986 Cargo
1987 -----
1988
1989 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
1990   time.][cargo/8066]
1991
1992 Misc
1993 ----
1994 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
1995   `~~outdated information~~` becomes "~~outdated information~~".
1996 - [Added an emoji to Rustdoc's deprecated API message.][72014]
1997
1998 Compatibility Notes
1999 -------------------
2000 - [Trying to self initialize a static value (that is creating a value using
2001   itself) is unsound and now causes a compile error.][71140]
2002 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
2003   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
2004 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
2005   previously undocumented and not intended for public use. Rustdoc still provides
2006   a non-zero exit code on errors.
2007 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
2008   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
2009   flags while cargo is adding `embed-bitcode` itself. The recommended way to
2010   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
2011   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
2012
2013 Internals Only
2014 --------------
2015 - [Make clippy a git subtree instead of a git submodule][70655]
2016 - [Unify the undo log of all snapshot types][69464]
2017
2018 [71848]: https://github.com/rust-lang/rust/issues/71848/
2019 [73420]: https://github.com/rust-lang/rust/issues/73420/
2020 [72324]: https://github.com/rust-lang/rust/pull/72324/
2021 [71843]: https://github.com/rust-lang/rust/pull/71843/
2022 [71886]: https://github.com/rust-lang/rust/pull/71886/
2023 [72234]: https://github.com/rust-lang/rust/pull/72234/
2024 [72239]: https://github.com/rust-lang/rust/pull/72239/
2025 [72397]: https://github.com/rust-lang/rust/pull/72397/
2026 [72413]: https://github.com/rust-lang/rust/pull/72413/
2027 [72014]: https://github.com/rust-lang/rust/pull/72014/
2028 [72062]: https://github.com/rust-lang/rust/pull/72062/
2029 [72094]: https://github.com/rust-lang/rust/pull/72094/
2030 [72133]: https://github.com/rust-lang/rust/pull/72133/
2031 [67759]: https://github.com/rust-lang/rust/pull/67759/
2032 [71900]: https://github.com/rust-lang/rust/pull/71900/
2033 [71928]: https://github.com/rust-lang/rust/pull/71928/
2034 [71662]: https://github.com/rust-lang/rust/pull/71662/
2035 [71716]: https://github.com/rust-lang/rust/pull/71716/
2036 [71447]: https://github.com/rust-lang/rust/pull/71447/
2037 [71269]: https://github.com/rust-lang/rust/pull/71269/
2038 [71095]: https://github.com/rust-lang/rust/pull/71095/
2039 [71140]: https://github.com/rust-lang/rust/pull/71140/
2040 [70655]: https://github.com/rust-lang/rust/pull/70655/
2041 [70705]: https://github.com/rust-lang/rust/pull/70705/
2042 [69984]: https://github.com/rust-lang/rust/pull/69984/
2043 [69813]: https://github.com/rust-lang/rust/pull/69813/
2044 [69464]: https://github.com/rust-lang/rust/pull/69464/
2045 [68717]: https://github.com/rust-lang/rust/pull/68717/
2046 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
2047 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
2048 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
2049 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
2050 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
2051 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
2052 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
2053 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
2054 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
2055 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
2056 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
2057 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
2058 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
2059 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
2060 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
2061 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
2062 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
2063
2064
2065 Version 1.44.1 (2020-06-18)
2066 ===========================
2067
2068 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
2069 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
2070 * [Fix crashes when finding backtrace on macOS.][71397]
2071 * [Clippy applies lint levels into different files.][clippy/5356]
2072
2073 [71397]: https://github.com/rust-lang/rust/issues/71397
2074 [73078]: https://github.com/rust-lang/rust/issues/73078
2075 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
2076 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
2077
2078
2079 Version 1.44.0 (2020-06-04)
2080 ==========================
2081
2082 Language
2083 --------
2084 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
2085 - [Added the `unused_braces` lint.][70081]
2086
2087 **Syntax-only changes**
2088
2089 - [Expansion-driven outline module parsing][69838]
2090 ```rust
2091 #[cfg(FALSE)]
2092 mod foo {
2093     mod bar {
2094         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
2095     }
2096 }
2097 ```
2098
2099 These are still rejected semantically, so you will likely receive an error but
2100 these changes can be seen and parsed by macros and conditional compilation.
2101
2102 Compiler
2103 --------
2104 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
2105   Additionally when in incremental mode rustc defaults to 256 codegen units.
2106 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
2107   a panic is thrown.][67502]
2108 - [Added tier 3\* support for the `aarch64-unknown-none` and
2109   `aarch64-unknown-none-softfloat` targets.][68334]
2110 - [Added tier 3 support for `arm64-apple-tvos` and
2111   `x86_64-apple-tvos` targets.][68191]
2112
2113
2114 Libraries
2115 ---------
2116 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
2117   `vec![]` to be able to be used in `const` contexts.
2118 - [`convert::Infallible` now implements `Hash`.][70281]
2119 - [`OsString` now implements `DerefMut` and `IndexMut` returning
2120   a `&mut OsStr`.][70048]
2121 - [Unicode 13 is now supported.][69929]
2122 - [`String` now implements `From<&mut str>`.][69661]
2123 - [`IoSlice` now implements `Copy`.][69403]
2124 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
2125 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
2126 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
2127   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
2128   integer types.][69373]
2129
2130 Stabilized APIs
2131 ---------------
2132 - [`PathBuf::with_capacity`]
2133 - [`PathBuf::capacity`]
2134 - [`PathBuf::clear`]
2135 - [`PathBuf::reserve`]
2136 - [`PathBuf::reserve_exact`]
2137 - [`PathBuf::shrink_to_fit`]
2138 - [`f32::to_int_unchecked`]
2139 - [`f64::to_int_unchecked`]
2140 - [`Layout::align_to`]
2141 - [`Layout::pad_to_align`]
2142 - [`Layout::array`]
2143 - [`Layout::extend`]
2144
2145 Cargo
2146 -----
2147 - [Added the `cargo tree` command which will print a tree graph of
2148   your dependencies.][cargo/8062] E.g.
2149   ```
2150     mdbook v0.3.2 (/Users/src/rust/mdbook)
2151   ├── ammonia v3.0.0
2152   │   ├── html5ever v0.24.0
2153   │   │   ├── log v0.4.8
2154   │   │   │   └── cfg-if v0.1.9
2155   │   │   ├── mac v0.1.1
2156   │   │   └── markup5ever v0.9.0
2157   │   │       ├── log v0.4.8 (*)
2158   │   │       ├── phf v0.7.24
2159   │   │       │   └── phf_shared v0.7.24
2160   │   │       │       ├── siphasher v0.2.3
2161   │   │       │       └── unicase v1.4.2
2162   │   │       │           [build-dependencies]
2163   │   │       │           └── version_check v0.1.5
2164   ...
2165   ```
2166   You can also display dependencies on multiple versions of the same crate with
2167   `cargo tree -d` (short for `cargo tree --duplicates`).
2168
2169 Misc
2170 ----
2171 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
2172   the version in the sidebar.][69494]
2173
2174 Compatibility Notes
2175 -------------------
2176 - [Rustc now correctly generates static libraries on Windows GNU targets with
2177   the `.a` extension, rather than the previous `.lib`.][70937]
2178 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
2179 - [The `file_name` property in JSON output of macro errors now points the actual
2180   source file rather than the previous format of `<NAME macros>`.][70969]
2181   **Note:** this may not point to a file that actually exists on the user's system.
2182 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
2183 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
2184   not allow zero initialization such as `NonZeroU8`.][66059] This was
2185   previously a warning.
2186 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
2187   operator has been defined as a saturating operation.][71269] This was previously
2188   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
2189   continue using the current behaviour, which may be desirable in rare performance
2190   sensitive situations.
2191
2192 Internal Only
2193 -------------
2194 These changes provide no direct user facing benefits, but represent significant
2195 improvements to the internals and overall performance of rustc and
2196 related tools.
2197
2198 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
2199 - [Replace big JS dict with JSON parsing.][71250]
2200
2201 [69373]: https://github.com/rust-lang/rust/pull/69373/
2202 [66059]: https://github.com/rust-lang/rust/pull/66059/
2203 [68191]: https://github.com/rust-lang/rust/pull/68191/
2204 [68899]: https://github.com/rust-lang/rust/pull/68899/
2205 [71147]: https://github.com/rust-lang/rust/pull/71147/
2206 [71250]: https://github.com/rust-lang/rust/pull/71250/
2207 [70937]: https://github.com/rust-lang/rust/pull/70937/
2208 [70969]: https://github.com/rust-lang/rust/pull/70969/
2209 [70632]: https://github.com/rust-lang/rust/pull/70632/
2210 [70281]: https://github.com/rust-lang/rust/pull/70281/
2211 [70345]: https://github.com/rust-lang/rust/pull/70345/
2212 [70048]: https://github.com/rust-lang/rust/pull/70048/
2213 [70081]: https://github.com/rust-lang/rust/pull/70081/
2214 [70156]: https://github.com/rust-lang/rust/pull/70156/
2215 [71269]: https://github.com/rust-lang/rust/pull/71269/
2216 [69838]: https://github.com/rust-lang/rust/pull/69838/
2217 [69929]: https://github.com/rust-lang/rust/pull/69929/
2218 [69661]: https://github.com/rust-lang/rust/pull/69661/
2219 [69778]: https://github.com/rust-lang/rust/pull/69778/
2220 [69494]: https://github.com/rust-lang/rust/pull/69494/
2221 [69403]: https://github.com/rust-lang/rust/pull/69403/
2222 [69033]: https://github.com/rust-lang/rust/pull/69033/
2223 [68692]: https://github.com/rust-lang/rust/pull/68692/
2224 [68334]: https://github.com/rust-lang/rust/pull/68334/
2225 [67502]: https://github.com/rust-lang/rust/pull/67502/
2226 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
2227 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
2228 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
2229 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
2230 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
2231 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
2232 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
2233 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
2234 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
2235 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
2236 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
2237 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
2238 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
2239
2240
2241 Version 1.43.1 (2020-05-07)
2242 ===========================
2243
2244 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
2245 * [Fixed the stabilization of AVX-512 features.][71473]
2246 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
2247
2248 [71430]: https://github.com/rust-lang/rust/pull/71430
2249 [71473]: https://github.com/rust-lang/rust/issues/71473
2250 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
2251
2252
2253 Version 1.43.0 (2020-04-23)
2254 ==========================
2255
2256 Language
2257 --------
2258 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
2259   the type inferred correctly.][68129]
2260 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
2261
2262 **Syntax only changes**
2263 - [Allow `type Foo: Ord` syntactically.][69361]
2264 - [Fuse associated and extern items up to defaultness.][69194]
2265 - [Syntactically allow `self` in all `fn` contexts.][68764]
2266 - [Merge `fn` syntax + cleanup item parsing.][68728]
2267 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
2268   For example, you may now write:
2269   ```rust
2270   macro_rules! mac_trait {
2271       ($i:item) => {
2272           trait T { $i }
2273       }
2274   }
2275   mac_trait! {
2276       fn foo() {}
2277   }
2278   ```
2279
2280 These are still rejected *semantically*, so you will likely receive an error but
2281 these changes can be seen and parsed by macros and
2282 conditional compilation.
2283
2284
2285 Compiler
2286 --------
2287 - [You can now pass multiple lint flags to rustc to override the previous
2288   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
2289   everything in the `unused` lint group except `unused-variables` which
2290   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
2291   everything in the `unused` lint group **including** `unused-variables` since
2292   the allow flag is specified before the deny flag (and therefore overridden).
2293 - [rustc will now prefer your system MinGW libraries over its bundled libraries
2294   if they are available on `windows-gnu`.][67429]
2295 - [rustc now buffers errors/warnings printed in JSON.][69227]
2296
2297 Libraries
2298 ---------
2299 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
2300   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
2301   respectively.][69538] **Note** These conversions are only available when `N`
2302   is `0..=32`.
2303 - [You can now use associated constants on floats and integers directly, rather
2304   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
2305   `f32::NAN` with no imports.
2306 - [`u8::is_ascii` is now `const`.][68984]
2307 - [`String` now implements `AsMut<str>`.][68742]
2308 - [Added the `primitive` module to `std` and `core`.][67637] This module
2309   reexports Rust's primitive types. This is mainly useful in macros
2310   where you want avoid these types being shadowed.
2311 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
2312 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
2313
2314 Stabilized APIs
2315 ---------------
2316 - [`Once::is_completed`]
2317 - [`f32::LOG10_2`]
2318 - [`f32::LOG2_10`]
2319 - [`f64::LOG10_2`]
2320 - [`f64::LOG2_10`]
2321 - [`iter::once_with`]
2322
2323 Cargo
2324 -----
2325 - [You can now set config `[profile]`s in your `.cargo/config`, or through
2326   your environment.][cargo/7823]
2327 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
2328   executable path when running integration tests or benchmarks.][cargo/7697]
2329   `<name>` is the name of your binary as-is e.g. If you wanted the executable
2330   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
2331
2332 Misc
2333 ----
2334 - [Certain checks in the `const_err` lint were deemed unrelated to const
2335   evaluation][69185], and have been moved to the `unconditional_panic` and
2336   `arithmetic_overflow` lints.
2337
2338 Compatibility Notes
2339 -------------------
2340
2341 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
2342   has been a warning since 1.36.0.
2343 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
2344   led to some instances being accepted, and now correctly emits a hard error.
2345
2346 [69340]: https://github.com/rust-lang/rust/pull/69340
2347
2348 Internal Only
2349 -------------
2350 These changes provide no direct user facing benefits, but represent significant
2351 improvements to the internals and overall performance of `rustc` and
2352 related tools.
2353
2354 - [All components are now built with `opt-level=3` instead of `2`.][67878]
2355 - [Improved how rustc generates drop code.][67332]
2356 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
2357 - [traits: preallocate 2 Vecs of known initial size][69022]
2358 - [Avoid exponential behaviour when relating types][68772]
2359 - [Skip `Drop` terminators for enum variants without drop glue][68943]
2360 - [Improve performance of coherence checks][68966]
2361 - [Deduplicate types in the generator witness][68672]
2362 - [Invert control in struct_lint_level.][68725]
2363
2364 [67332]: https://github.com/rust-lang/rust/pull/67332/
2365 [67429]: https://github.com/rust-lang/rust/pull/67429/
2366 [67637]: https://github.com/rust-lang/rust/pull/67637/
2367 [67642]: https://github.com/rust-lang/rust/pull/67642/
2368 [67878]: https://github.com/rust-lang/rust/pull/67878/
2369 [67885]: https://github.com/rust-lang/rust/pull/67885/
2370 [68129]: https://github.com/rust-lang/rust/pull/68129/
2371 [68672]: https://github.com/rust-lang/rust/pull/68672/
2372 [68725]: https://github.com/rust-lang/rust/pull/68725/
2373 [68728]: https://github.com/rust-lang/rust/pull/68728/
2374 [68738]: https://github.com/rust-lang/rust/pull/68738/
2375 [68742]: https://github.com/rust-lang/rust/pull/68742/
2376 [68764]: https://github.com/rust-lang/rust/pull/68764/
2377 [68772]: https://github.com/rust-lang/rust/pull/68772/
2378 [68943]: https://github.com/rust-lang/rust/pull/68943/
2379 [68952]: https://github.com/rust-lang/rust/pull/68952/
2380 [68966]: https://github.com/rust-lang/rust/pull/68966/
2381 [68984]: https://github.com/rust-lang/rust/pull/68984/
2382 [69022]: https://github.com/rust-lang/rust/pull/69022/
2383 [69185]: https://github.com/rust-lang/rust/pull/69185/
2384 [69194]: https://github.com/rust-lang/rust/pull/69194/
2385 [69201]: https://github.com/rust-lang/rust/pull/69201/
2386 [69227]: https://github.com/rust-lang/rust/pull/69227/
2387 [69548]: https://github.com/rust-lang/rust/pull/69548/
2388 [69256]: https://github.com/rust-lang/rust/pull/69256/
2389 [69361]: https://github.com/rust-lang/rust/pull/69361/
2390 [69366]: https://github.com/rust-lang/rust/pull/69366/
2391 [69538]: https://github.com/rust-lang/rust/pull/69538/
2392 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
2393 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
2394 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
2395 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
2396 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
2397 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
2398 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
2399 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
2400
2401
2402 Version 1.42.0 (2020-03-12)
2403 ==========================
2404
2405 Language
2406 --------
2407 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
2408   ```rust
2409   fn foo(words: &[&str]) {
2410       match words {
2411           ["Hello", "World", "!", ..] => println!("Hello World!"),
2412           ["Foo", "Bar", ..] => println!("Baz"),
2413           rest => println!("{:?}", rest),
2414       }
2415   }
2416   ```
2417 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
2418   that you can create an enum that has the exact layout and ABI of the type
2419   it contains.
2420 - [You can now use outer attribute procedural macros on inline modules.][64273]
2421 - [There are some *syntax-only* changes:][67131]
2422    - `default` is syntactically allowed before items in `trait` definitions.
2423    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
2424      leave out their bodies in favor of `;`.
2425    - Bounds on associated types in `impl`s are now syntactically allowed
2426      (e.g. `type Foo: Ord;`).
2427    - `...` (the C-variadic type) may occur syntactically directly as the type of
2428       any function parameter.
2429
2430   These are still rejected *semantically*, so you will likely receive an error
2431   but these changes can be seen and parsed by procedural macros and
2432   conditional compilation.
2433
2434 Compiler
2435 --------
2436 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
2437 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
2438 - [`Option::{expect,unwrap}` and
2439    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
2440    pointing to the location where they were called, rather than
2441    `core`'s internals. ][67887]
2442
2443 \* Refer to Rust's [platform support page][platform-support-doc] for more
2444 information on Rust's tiered platform support.
2445
2446 Libraries
2447 ---------
2448 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
2449 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
2450    to implement `Sized`.][67935]
2451 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
2452 - [`Layout::new` is now `const`.][66254]
2453 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
2454
2455
2456 Stabilized APIs
2457 ---------------
2458 - [`CondVar::wait_while`]
2459 - [`CondVar::wait_timeout_while`]
2460 - [`DebugMap::key`]
2461 - [`DebugMap::value`]
2462 - [`ManuallyDrop::take`]
2463 - [`matches!`]
2464 - [`ptr::slice_from_raw_parts_mut`]
2465 - [`ptr::slice_from_raw_parts`]
2466
2467 Cargo
2468 -----
2469 - [You no longer need to include `extern crate proc_macro;` to be able to
2470   `use proc_macro;` in the `2018` edition.][cargo/7700]
2471
2472 Compatibility Notes
2473 -------------------
2474 - [`Error::description` has been deprecated, and its use will now produce a
2475   warning.][66919] It's recommended to use `Display`/`to_string` instead.
2476
2477 [68253]: https://github.com/rust-lang/rust/pull/68253/
2478 [68348]: https://github.com/rust-lang/rust/pull/68348/
2479 [67935]: https://github.com/rust-lang/rust/pull/67935/
2480 [68339]: https://github.com/rust-lang/rust/pull/68339/
2481 [68122]: https://github.com/rust-lang/rust/pull/68122/
2482 [64273]: https://github.com/rust-lang/rust/pull/64273/
2483 [67712]: https://github.com/rust-lang/rust/pull/67712/
2484 [67887]: https://github.com/rust-lang/rust/pull/67887/
2485 [67131]: https://github.com/rust-lang/rust/pull/67131/
2486 [67233]: https://github.com/rust-lang/rust/pull/67233/
2487 [66899]: https://github.com/rust-lang/rust/pull/66899/
2488 [66919]: https://github.com/rust-lang/rust/pull/66919/
2489 [66254]: https://github.com/rust-lang/rust/pull/66254/
2490 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
2491 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
2492 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
2493 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
2494 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
2495 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
2496 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
2497 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
2498 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
2499
2500
2501 Version 1.41.1 (2020-02-27)
2502 ===========================
2503
2504 * [Always check types of static items][69145]
2505 * [Always check lifetime bounds of `Copy` impls][69145]
2506 * [Fix miscompilation in callers of `Layout::repeat`][69225]
2507
2508 [69225]: https://github.com/rust-lang/rust/issues/69225
2509 [69145]: https://github.com/rust-lang/rust/pull/69145
2510
2511
2512 Version 1.41.0 (2020-01-30)
2513 ===========================
2514
2515 Language
2516 --------
2517
2518 - [You can now pass type parameters to foreign items when implementing
2519   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
2520 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
2521   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
2522   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
2523 - [You can now use any valid identifier in a `format_args` macro.][66847]
2524   Previously identifiers starting with an underscore were not allowed.
2525 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
2526   enum variants.][66183] These are still rejected semantically, but
2527   can be seen and parsed by procedural macros and conditional compilation.
2528 - [You can now define a Rust `extern "C"` function with `Box<T>` and use `T*` as the corresponding
2529   type on the C side.][62514] Please see [the documentation][box-memory-layout] for more information,
2530   including the important caveat about preferring to avoid `Box<T>` in Rust signatures for functions defined in C.
2531
2532 [box-memory-layout]: https://doc.rust-lang.org/std/boxed/index.html#memory-layout
2533
2534 Compiler
2535 --------
2536
2537 - [Rustc will now warn if you have unused loop `'label`s.][66325]
2538 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
2539 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
2540 - [You can now pass an arguments file passing the `@path` syntax
2541   to rustc.][66172] Note that the format differs somewhat from what is
2542   found in other tooling; please see [the documentation][argfile-docs] for
2543   more information.
2544 - [You can now provide `--extern` flag without a path, indicating that it is
2545   available from the search path or specified with an `-L` flag.][64882]
2546
2547 \* Refer to Rust's [platform support page][platform-support-doc] for more
2548 information on Rust's tiered platform support.
2549
2550 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
2551
2552 Libraries
2553 ---------
2554
2555 - [The `core::panic` module is now stable.][66771] It was already stable
2556   through `std`.
2557 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
2558   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
2559 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
2560
2561 Stabilized APIs
2562 ---------------
2563
2564 - [`Result::map_or`]
2565 - [`Result::map_or_else`]
2566 - [`std::rc::Weak::weak_count`]
2567 - [`std::rc::Weak::strong_count`]
2568 - [`std::sync::Weak::weak_count`]
2569 - [`std::sync::Weak::strong_count`]
2570
2571 Cargo
2572 -----
2573
2574 - [Cargo will now document all the private items for binary crates
2575   by default.][cargo/7593]
2576 - [`cargo-install` will now reinstall the package if it detects that it is out
2577   of date.][cargo/7560]
2578 - [Cargo.lock now uses a more git friendly format that should help to reduce
2579   merge conflicts.][cargo/7579]
2580 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
2581   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
2582   optimisation level to `2` for debug builds. You can also use
2583   `[profile.<profile>.build-override]` to override build scripts and
2584   their dependencies.
2585
2586 Misc
2587 ----
2588
2589 - [You can now specify `edition` in documentation code blocks to compile the block
2590   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
2591   should be compiled the 2018 edition of Rust.
2592 - [You can now provide custom themes to rustdoc with `--theme`, and check the
2593   current theme with `--check-theme`.][54733]
2594 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
2595
2596 Compatibility Notes
2597 -------------------
2598
2599 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
2600   Apple targets.][apple-32bit-drop] This means that the source code is still
2601   available to build, but the targets are no longer being tested and release
2602   binaries for those platforms will no longer be distributed by the Rust project.
2603   Please refer to the linked blog post for more information.
2604
2605 [54733]: https://github.com/rust-lang/rust/pull/54733/
2606 [61351]: https://github.com/rust-lang/rust/pull/61351/
2607 [62514]: https://github.com/rust-lang/rust/pull/62514/
2608 [67255]: https://github.com/rust-lang/rust/pull/67255/
2609 [66661]: https://github.com/rust-lang/rust/pull/66661/
2610 [66771]: https://github.com/rust-lang/rust/pull/66771/
2611 [66847]: https://github.com/rust-lang/rust/pull/66847/
2612 [66238]: https://github.com/rust-lang/rust/pull/66238/
2613 [66277]: https://github.com/rust-lang/rust/pull/66277/
2614 [66325]: https://github.com/rust-lang/rust/pull/66325/
2615 [66172]: https://github.com/rust-lang/rust/pull/66172/
2616 [66183]: https://github.com/rust-lang/rust/pull/66183/
2617 [65879]: https://github.com/rust-lang/rust/pull/65879/
2618 [65013]: https://github.com/rust-lang/rust/pull/65013/
2619 [64882]: https://github.com/rust-lang/rust/pull/64882/
2620 [64325]: https://github.com/rust-lang/rust/pull/64325/
2621 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
2622 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
2623 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
2624 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
2625 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
2626 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
2627 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
2628 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
2629 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
2630 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
2631 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
2632
2633 Version 1.40.0 (2019-12-19)
2634 ===========================
2635
2636 Language
2637 --------
2638 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
2639   `const` contexts.][65188] e.g.
2640
2641   ```rust
2642   pub struct Point(i32, i32);
2643
2644   const ORIGIN: Point = {
2645       let constructor = Point;
2646
2647       constructor(0, 0)
2648   };
2649   ```
2650
2651 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
2652   indicate that there may be variants or fields added in the future.][64639]
2653   For example this requires adding a wild-card branch (`_ => {}`) to any match
2654   statements on a non-exhaustive `enum`. [(RFC 2008)]
2655 - [You can now use function-like procedural macros in `extern` blocks and in
2656   type positions.][63931] e.g. `type Generated = macro!();`
2657 - [Function-like and attribute procedural macros can now emit
2658   `macro_rules!` items, so you can now have your macros generate macros.][64035]
2659 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
2660   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
2661   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
2662
2663 Compiler
2664 --------
2665 - [Added tier 3 support\* for the
2666   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
2667 - [Added tier 3 support for the
2668   `aarch64-unknown-none-softfloat` target.][64589]
2669 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
2670   `mips64el-unknown-linux-muslabi64` targets.][65843]
2671
2672 \* Refer to Rust's [platform support page][platform-support-doc] for more
2673   information on Rust's tiered platform support.
2674
2675 Libraries
2676 ---------
2677 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
2678
2679 Stabilized APIs
2680 ---------------
2681 - [`BTreeMap::get_key_value`]
2682 - [`HashMap::get_key_value`]
2683 - [`Option::as_deref_mut`]
2684 - [`Option::as_deref`]
2685 - [`Option::flatten`]
2686 - [`UdpSocket::peer_addr`]
2687 - [`f32::to_be_bytes`]
2688 - [`f32::to_le_bytes`]
2689 - [`f32::to_ne_bytes`]
2690 - [`f64::to_be_bytes`]
2691 - [`f64::to_le_bytes`]
2692 - [`f64::to_ne_bytes`]
2693 - [`f32::from_be_bytes`]
2694 - [`f32::from_le_bytes`]
2695 - [`f32::from_ne_bytes`]
2696 - [`f64::from_be_bytes`]
2697 - [`f64::from_le_bytes`]
2698 - [`f64::from_ne_bytes`]
2699 - [`mem::take`]
2700 - [`slice::repeat`]
2701 - [`todo!`]
2702
2703 Cargo
2704 -----
2705 - [Cargo will now always display warnings, rather than only on
2706   fresh builds.][cargo/7450]
2707 - [Feature flags (except `--all-features`) passed to a virtual workspace will
2708   now produce an error.][cargo/7507] Previously these flags were ignored.
2709 - [You can now publish `dev-dependencies` without including
2710   a `version`.][cargo/7333]
2711
2712 Misc
2713 ----
2714 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
2715   when running documentation tests with `rustdoc`.][63803]
2716
2717 Compatibility Notes
2718 -------------------
2719 - [As previously announced, any previous NLL warnings in the 2015 edition are
2720   now hard errors.][64221]
2721 - [The `include!` macro will now warn if it failed to include the
2722   entire file.][64284] The `include!` macro unintentionally only includes the
2723   first _expression_ in a file, and this can be unintuitive. This will become
2724   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
2725 - [Using `#[inline]` on function prototypes and consts now emits a warning under
2726   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
2727   or `extern` blocks now correctly emits a hard error.
2728
2729 [65294]: https://github.com/rust-lang/rust/pull/65294/
2730 [66103]: https://github.com/rust-lang/rust/pull/66103/
2731 [65843]: https://github.com/rust-lang/rust/pull/65843/
2732 [65188]: https://github.com/rust-lang/rust/pull/65188/
2733 [65092]: https://github.com/rust-lang/rust/pull/65092/
2734 [64589]: https://github.com/rust-lang/rust/pull/64589/
2735 [64639]: https://github.com/rust-lang/rust/pull/64639/
2736 [64221]: https://github.com/rust-lang/rust/pull/64221/
2737 [64284]: https://github.com/rust-lang/rust/pull/64284/
2738 [63931]: https://github.com/rust-lang/rust/pull/63931/
2739 [64035]: https://github.com/rust-lang/rust/pull/64035/
2740 [63674]: https://github.com/rust-lang/rust/pull/63674/
2741 [63803]: https://github.com/rust-lang/rust/pull/63803/
2742 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
2743 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
2744 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
2745 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
2746 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
2747 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
2748 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
2749 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
2750 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
2751 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
2752 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
2753 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
2754 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
2755 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
2756 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
2757 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
2758 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
2759 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
2760 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
2761 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
2762 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
2763 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
2764 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
2765 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
2766 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
2767
2768
2769 Version 1.39.0 (2019-11-07)
2770 ===========================
2771
2772 Language
2773 --------
2774 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
2775   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
2776 - [You can now use certain attributes on function, closure, and function pointer
2777   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
2778   `deny`, `forbid` as well as inert helper attributes used by procedural macro
2779   attributes applied to items. e.g.
2780   ```rust
2781   fn len(
2782       #[cfg(windows)] slice: &[u16],
2783       #[cfg(not(windows))] slice: &[u8],
2784   ) -> usize {
2785       slice.len()
2786   }
2787   ```
2788 - [You can now take shared references to bind-by-move patterns in the `if` guards
2789   of `match` arms.][63118] e.g.
2790   ```rust
2791   fn main() {
2792       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
2793
2794       match array {
2795           nums
2796   //      ---- `nums` is bound by move.
2797               if nums.iter().sum::<u8>() == 10
2798   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
2799           => {
2800               drop(nums);
2801   //          ----------- Legal as `nums` was bound by move and so we have ownership.
2802           }
2803           _ => unreachable!(),
2804       }
2805   }
2806   ```
2807
2808
2809
2810 Compiler
2811 --------
2812 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
2813 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
2814 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
2815   **Note** Cargo currently doesn't use this feature. Refer to
2816   [cargo#7315][cargo/7315] to track this feature's progress.
2817 - [You can now pass `--show-output` argument to test binaries to print the
2818   output of successful tests.][62600]
2819
2820
2821 \* Refer to Rust's [platform support page][platform-support-doc] for more
2822 information on Rust's tiered platform support.
2823
2824 Libraries
2825 ---------
2826 - [`Vec::new` and `String::new` are now `const` functions.][64028]
2827 - [`LinkedList::new` is now a `const` function.][63684]
2828 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
2829 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
2830   now `const`.][63786]
2831
2832 Stabilized APIs
2833 ---------------
2834 - [`Pin::into_inner`]
2835 - [`Instant::checked_duration_since`]
2836 - [`Instant::saturating_duration_since`]
2837
2838 Cargo
2839 -----
2840 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
2841 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
2842   `--all` is now deprecated.
2843
2844 Misc
2845 ----
2846 - [You can now pass `-Clinker` to rustdoc to control the linker used
2847   for compiling doctests.][63834]
2848
2849 Compatibility Notes
2850 -------------------
2851 - [Code that was previously accepted by the old borrow checker, but rejected by
2852   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
2853   previously a warning, and will also become a hard error in the Rust 2015
2854   edition in the 1.40.0 release.
2855 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
2856   run tests.][63827] This should improve performance when running a large
2857   amount of doctests.
2858 - [The `try!` macro will now issue a deprecation warning.][62672] It is
2859   recommended to use the `?` operator instead.
2860 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
2861   returned `0.0`.
2862
2863 [62600]: https://github.com/rust-lang/rust/pull/62600/
2864 [62672]: https://github.com/rust-lang/rust/pull/62672/
2865 [63118]: https://github.com/rust-lang/rust/pull/63118/
2866 [63209]: https://github.com/rust-lang/rust/pull/63209/
2867 [63402]: https://github.com/rust-lang/rust/pull/63402/
2868 [63565]: https://github.com/rust-lang/rust/pull/63565/
2869 [63595]: https://github.com/rust-lang/rust/pull/63595/
2870 [63684]: https://github.com/rust-lang/rust/pull/63684/
2871 [63698]: https://github.com/rust-lang/rust/pull/63698/
2872 [63770]: https://github.com/rust-lang/rust/pull/63770/
2873 [63786]: https://github.com/rust-lang/rust/pull/63786/
2874 [63827]: https://github.com/rust-lang/rust/pull/63827/
2875 [63834]: https://github.com/rust-lang/rust/pull/63834/
2876 [64010]: https://github.com/rust-lang/rust/pull/64010/
2877 [64028]: https://github.com/rust-lang/rust/pull/64028/
2878 [64334]: https://github.com/rust-lang/rust/pull/64334/
2879 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
2880 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
2881 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
2882 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
2883 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
2884 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
2885
2886 Version 1.38.0 (2019-09-26)
2887 ==========================
2888
2889 Language
2890 --------
2891 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
2892 - [The `#[deprecated]` attribute can now be used on macros.][62042]
2893
2894 Compiler
2895 --------
2896 - [Added pipelined compilation support to `rustc`.][62766] This will
2897   improve compilation times in some cases. For further information please refer
2898   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
2899 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
2900   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
2901   `x86_64-uwp-windows-msvc` targets.][60260]
2902 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
2903   `armv7-unknown-linux-musleabi` targets.][63107]
2904 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
2905 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
2906 - [Upgraded to LLVM 9.][62592]
2907
2908 \* Refer to Rust's [platform support page][platform-support-doc] for more
2909 information on Rust's tiered platform support.
2910
2911 Libraries
2912 ---------
2913 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
2914 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
2915   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
2916   is available at `std::clone::Clone`). This also makes all built-in macros
2917   available in `std`/`core` root. e.g. `std::include_bytes!`.
2918 - [`str::Chars` now implements `Debug`.][63000]
2919 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
2920 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
2921 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
2922 - [Added euclidean remainder and division operations (`div_euclid`,
2923   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
2924   `overflowing`, and `wrapping` versions are available for all
2925   integer primitives.
2926 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
2927   `PartialEq`.][61491]
2928 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
2929
2930 Stabilized APIs
2931 ---------------
2932 - [`<*const T>::cast`]
2933 - [`<*mut T>::cast`]
2934 - [`Duration::as_secs_f32`]
2935 - [`Duration::as_secs_f64`]
2936 - [`Duration::div_f32`]
2937 - [`Duration::div_f64`]
2938 - [`Duration::from_secs_f32`]
2939 - [`Duration::from_secs_f64`]
2940 - [`Duration::mul_f32`]
2941 - [`Duration::mul_f64`]
2942 - [`any::type_name`]
2943
2944 Cargo
2945 -----
2946 - [Added pipelined compilation support to `cargo`.][cargo/7143]
2947 - [You can now pass the `--features` option multiple times to enable
2948   multiple features.][cargo/7084]
2949
2950 Rustdoc
2951 -------
2952
2953 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
2954
2955 Misc
2956 ----
2957 - [`rustc` will now warn about some incorrect uses of
2958   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
2959
2960 Compatibility Notes
2961 -------------------
2962 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
2963   1.38.0.
2964 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
2965   issues][62896] with certain crates such as libc.
2966
2967 [60260]: https://github.com/rust-lang/rust/pull/60260/
2968 [61457]: https://github.com/rust-lang/rust/pull/61457/
2969 [61491]: https://github.com/rust-lang/rust/pull/61491/
2970 [61884]: https://github.com/rust-lang/rust/pull/61884/
2971 [61953]: https://github.com/rust-lang/rust/pull/61953/
2972 [62042]: https://github.com/rust-lang/rust/pull/62042/
2973 [62528]: https://github.com/rust-lang/rust/pull/62528/
2974 [62583]: https://github.com/rust-lang/rust/pull/62583/
2975 [62735]: https://github.com/rust-lang/rust/pull/62735/
2976 [62766]: https://github.com/rust-lang/rust/pull/62766/
2977 [62784]: https://github.com/rust-lang/rust/pull/62784/
2978 [62592]: https://github.com/rust-lang/rust/pull/62592/
2979 [62785]: https://github.com/rust-lang/rust/issues/62785/
2980 [62814]: https://github.com/rust-lang/rust/pull/62814/
2981 [62896]: https://github.com/rust-lang/rust/issues/62896/
2982 [63000]: https://github.com/rust-lang/rust/pull/63000/
2983 [63056]: https://github.com/rust-lang/rust/pull/63056/
2984 [63107]: https://github.com/rust-lang/rust/pull/63107/
2985 [63346]: https://github.com/rust-lang/rust/pull/63346/
2986 [63421]: https://github.com/rust-lang/rust/pull/63421/
2987 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
2988 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
2989 [63048]: https://github.com/rust-lang/rust/pull/63048
2990 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2991 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2992 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
2993 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
2994 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
2995 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
2996 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
2997 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
2998 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
2999 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
3000 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
3001 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
3002 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
3003
3004 Version 1.37.0 (2019-08-15)
3005 ==========================
3006
3007 Language
3008 --------
3009 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
3010   [`Box`][62228], or an [array][62235] and unused.
3011 - [You can now use the `cfg` and `cfg_attr` attributes on
3012   generic parameters.][61547]
3013 - [You can now use enum variants through type alias.][61682] e.g. You can
3014   write the following:
3015   ```rust
3016   type MyOption = Option<u8>;
3017
3018   fn increment_or_zero(x: MyOption) -> u8 {
3019       match x {
3020           MyOption::Some(y) => y + 1,
3021           MyOption::None => 0,
3022       }
3023   }
3024   ```
3025 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
3026   `const _: u32 = 5;`.
3027 - [You can now use `#[repr(align(X)]` on enums.][61229]
3028 - [The  `?` Kleene macro operator is now available in the
3029   2015 edition.][60932]
3030
3031 Compiler
3032 --------
3033 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
3034   and `-C profile-use` flags.][61268] For more information on how to use profile
3035   guided optimization, please refer to the [rustc book][rustc-book-pgo].
3036 - [The `rust-lldb` wrapper script should now work again.][61827]
3037
3038 Libraries
3039 ---------
3040 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
3041
3042 Stabilized APIs
3043 ---------------
3044 - [`BufReader::buffer`]
3045 - [`BufWriter::buffer`]
3046 - [`Cell::from_mut`]
3047 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
3048 - [`DoubleEndedIterator::nth_back`]
3049 - [`Option::xor`]
3050 - [`Wrapping::reverse_bits`]
3051 - [`i128::reverse_bits`]
3052 - [`i16::reverse_bits`]
3053 - [`i32::reverse_bits`]
3054 - [`i64::reverse_bits`]
3055 - [`i8::reverse_bits`]
3056 - [`isize::reverse_bits`]
3057 - [`slice::copy_within`]
3058 - [`u128::reverse_bits`]
3059 - [`u16::reverse_bits`]
3060 - [`u32::reverse_bits`]
3061 - [`u64::reverse_bits`]
3062 - [`u8::reverse_bits`]
3063 - [`usize::reverse_bits`]
3064
3065 Cargo
3066 -----
3067 - [`Cargo.lock` files are now included by default when publishing executable crates
3068   with executables.][cargo/7026]
3069 - [You can now specify `default-run="foo"` in `[package]` to specify the
3070   default executable to use for `cargo run`.][cargo/7056]
3071
3072 Misc
3073 ----
3074
3075 Compatibility Notes
3076 -------------------
3077 - [Using `...` for inclusive range patterns will now warn by default.][61342]
3078   Please transition your code to using the `..=` syntax for inclusive
3079   ranges instead.
3080 - [Using a trait object without the `dyn` will now warn by default.][61203]
3081   Please transition your code to use `dyn Trait` for trait objects instead.
3082
3083 [62228]: https://github.com/rust-lang/rust/pull/62228/
3084 [62235]: https://github.com/rust-lang/rust/pull/62235/
3085 [61802]: https://github.com/rust-lang/rust/pull/61802/
3086 [61827]: https://github.com/rust-lang/rust/pull/61827/
3087 [61547]: https://github.com/rust-lang/rust/pull/61547/
3088 [61682]: https://github.com/rust-lang/rust/pull/61682/
3089 [61268]: https://github.com/rust-lang/rust/pull/61268/
3090 [61342]: https://github.com/rust-lang/rust/pull/61342/
3091 [61347]: https://github.com/rust-lang/rust/pull/61347/
3092 [61100]: https://github.com/rust-lang/rust/pull/61100/
3093 [61203]: https://github.com/rust-lang/rust/pull/61203/
3094 [61229]: https://github.com/rust-lang/rust/pull/61229/
3095 [60932]: https://github.com/rust-lang/rust/pull/60932/
3096 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
3097 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
3098 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
3099 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
3100 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
3101 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
3102 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
3103 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
3104 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
3105 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
3106 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
3107 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
3108 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
3109 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
3110 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
3111 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
3112 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
3113 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
3114 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
3115 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
3116 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
3117 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
3118 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
3119
3120
3121 Version 1.36.0 (2019-07-04)
3122 ==========================
3123
3124 Language
3125 --------
3126 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
3127 - [The order of traits in trait objects no longer affects the semantics of that
3128   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
3129   `dyn fmt::Debug + Send`, where this was previously not the case.
3130
3131 Libraries
3132 ---------
3133 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
3134 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
3135 - [`mem::needs_drop` is now available as a const fn.][60364]
3136 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
3137 - [`String` now implements `BorrowMut<str>`.][60404]
3138 - [`io::Cursor` now implements `Default`.][60234]
3139 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
3140 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
3141   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
3142   environment has access to heap memory allocation.
3143 - [`String` now implements `From<&String>`.][59825]
3144 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
3145   return a tuple of each argument when there is multiple arguments.
3146 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
3147   not used.][59648]
3148
3149 Stabilized APIs
3150 ---------------
3151 - [`VecDeque::rotate_left`]
3152 - [`VecDeque::rotate_right`]
3153 - [`Iterator::copied`]
3154 - [`io::IoSlice`]
3155 - [`io::IoSliceMut`]
3156 - [`Read::read_vectored`]
3157 - [`Write::write_vectored`]
3158 - [`str::as_mut_ptr`]
3159 - [`mem::MaybeUninit`]
3160 - [`pointer::align_offset`]
3161 - [`future::Future`]
3162 - [`task::Context`]
3163 - [`task::RawWaker`]
3164 - [`task::RawWakerVTable`]
3165 - [`task::Waker`]
3166 - [`task::Poll`]
3167
3168 Cargo
3169 -----
3170 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
3171 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
3172
3173 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
3174
3175 Clippy
3176 ------
3177 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
3178
3179 Misc
3180 ----
3181
3182 Compatibility Notes
3183 -------------------
3184 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
3185   longer recommended, and will be deprecated in 1.39.0.
3186
3187 [60318]: https://github.com/rust-lang/rust/pull/60318/
3188 [60364]: https://github.com/rust-lang/rust/pull/60364/
3189 [60370]: https://github.com/rust-lang/rust/pull/60370/
3190 [60404]: https://github.com/rust-lang/rust/pull/60404/
3191 [60234]: https://github.com/rust-lang/rust/pull/60234/
3192 [60244]: https://github.com/rust-lang/rust/pull/60244/
3193 [58623]: https://github.com/rust-lang/rust/pull/58623/
3194 [59648]: https://github.com/rust-lang/rust/pull/59648/
3195 [59675]: https://github.com/rust-lang/rust/pull/59675/
3196 [59825]: https://github.com/rust-lang/rust/pull/59825/
3197 [59826]: https://github.com/rust-lang/rust/pull/59826/
3198 [59445]: https://github.com/rust-lang/rust/pull/59445/
3199 [59114]: https://github.com/rust-lang/rust/pull/59114/
3200 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
3201 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
3202 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
3203 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
3204 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
3205 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
3206 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
3207 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
3208 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
3209 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
3210 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
3211 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
3212 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
3213 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
3214 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
3215 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
3216 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
3217 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
3218 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
3219 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
3220
3221
3222 Version 1.35.0 (2019-05-23)
3223 ==========================
3224
3225 Language
3226 --------
3227 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
3228   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
3229 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
3230   ```rust
3231   unsafe fn call_unsafe(func: unsafe fn()) {
3232       func()
3233   }
3234
3235   pub fn main() {
3236       unsafe { call_unsafe(|| {}); }
3237   }
3238   ```
3239
3240
3241 Compiler
3242 --------
3243 - [Added the `armv6-unknown-freebsd-gnueabihf` and
3244   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
3245 - [Added the `wasm32-unknown-wasi` target.][59464]
3246
3247
3248 Libraries
3249 ---------
3250 - [`Thread` will now show its ID in `Debug` output.][59460]
3251 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
3252 - [`alloc::System` now implements `Default`.][59451]
3253 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
3254   last field.][59076]
3255 - [`char::{ToLowercase, ToUppercase}` now
3256   implement `ExactSizeIterator`.][58778]
3257 - [All `NonZero` numeric types now implement `FromStr`.][58717]
3258 - [Removed the `Read` trait bounds
3259   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
3260 - [You can now call the `dbg!` macro without any parameters to print the file
3261   and line where it is called.][57847]
3262 - [In place ASCII case conversions are now up to 4× faster.][59283]
3263   e.g. `str::make_ascii_lowercase`
3264 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
3265   and `Send`.][58369]
3266
3267 Stabilized APIs
3268 ---------------
3269 - [`f32::copysign`]
3270 - [`f64::copysign`]
3271 - [`RefCell::replace_with`]
3272 - [`RefCell::map_split`]
3273 - [`ptr::hash`]
3274 - [`Range::contains`]
3275 - [`RangeFrom::contains`]
3276 - [`RangeTo::contains`]
3277 - [`RangeInclusive::contains`]
3278 - [`RangeToInclusive::contains`]
3279 - [`Option::copied`]
3280
3281 Cargo
3282 -----
3283 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
3284   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
3285   platform specific.
3286
3287 Misc
3288 ----
3289 - [The Rust toolchain is now available natively for musl based distros.][58575]
3290
3291 [59460]: https://github.com/rust-lang/rust/pull/59460/
3292 [59464]: https://github.com/rust-lang/rust/pull/59464/
3293 [59500]: https://github.com/rust-lang/rust/pull/59500/
3294 [59512]: https://github.com/rust-lang/rust/pull/59512/
3295 [59580]: https://github.com/rust-lang/rust/pull/59580/
3296 [59283]: https://github.com/rust-lang/rust/pull/59283/
3297 [59451]: https://github.com/rust-lang/rust/pull/59451/
3298 [59076]: https://github.com/rust-lang/rust/pull/59076/
3299 [58778]: https://github.com/rust-lang/rust/pull/58778/
3300 [58717]: https://github.com/rust-lang/rust/pull/58717/
3301 [58369]: https://github.com/rust-lang/rust/pull/58369/
3302 [58423]: https://github.com/rust-lang/rust/pull/58423/
3303 [58080]: https://github.com/rust-lang/rust/pull/58080/
3304 [57847]: https://github.com/rust-lang/rust/pull/57847/
3305 [58575]: https://github.com/rust-lang/rust/pull/58575
3306 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
3307 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
3308 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
3309 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
3310 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
3311 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
3312 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
3313 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
3314 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
3315 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
3316 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
3317 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
3318
3319 Version 1.34.2 (2019-05-14)
3320 ===========================
3321
3322 * [Destabilize the `Error::type_id` function due to a security
3323    vulnerability][60785] ([CVE-2019-12083])
3324
3325 [60785]: https://github.com/rust-lang/rust/pull/60785
3326 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
3327
3328 Version 1.34.1 (2019-04-25)
3329 ===========================
3330
3331 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
3332 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
3333 * [Fix Clippy panic when checking some macros][clippy/3805]
3334
3335 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
3336 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
3337 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
3338
3339 Version 1.34.0 (2019-04-11)
3340 ==========================
3341
3342 Language
3343 --------
3344 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
3345   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
3346   but had no effect.
3347 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
3348   `#[attr{}]` procedural macros.][57367]
3349 - [You can now write `extern crate self as foo;`][57407] to import your
3350   crate's root into the extern prelude.
3351
3352
3353 Compiler
3354 --------
3355 - [You can now target `riscv64imac-unknown-none-elf` and
3356   `riscv64gc-unknown-none-elf`.][58406]
3357 - [You can now enable linker plugin LTO optimisations with
3358   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
3359   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
3360   boundaries.
3361 - [You can now target `powerpc64-unknown-freebsd`.][57809]
3362
3363
3364 Libraries
3365 ---------
3366 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
3367   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
3368   the `Hash` trait to create an iterator.
3369 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
3370   methods.][58421] Most notably you no longer require the `Ord` trait to create
3371   an iterator.
3372 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
3373   for all numeric types.][58044]
3374 - [Indexing a `str` is now generic over all types that
3375   implement `SliceIndex<str>`.][57604]
3376 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
3377   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
3378   produce a warning if their returning type is unused.
3379 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
3380   `overflowing_pow` are now available for all numeric types.][57873] These are
3381   equivalent to methods such as `wrapping_add` for the `pow` operation.
3382
3383
3384 Stabilized APIs
3385 ---------------
3386
3387 #### std & core
3388 * [`Any::type_id`]
3389 * [`Error::type_id`]
3390 * [`atomic::AtomicI16`]
3391 * [`atomic::AtomicI32`]
3392 * [`atomic::AtomicI64`]
3393 * [`atomic::AtomicI8`]
3394 * [`atomic::AtomicU16`]
3395 * [`atomic::AtomicU32`]
3396 * [`atomic::AtomicU64`]
3397 * [`atomic::AtomicU8`]
3398 * [`convert::Infallible`]
3399 * [`convert::TryFrom`]
3400 * [`convert::TryInto`]
3401 * [`iter::from_fn`]
3402 * [`iter::successors`]
3403 * [`num::NonZeroI128`]
3404 * [`num::NonZeroI16`]
3405 * [`num::NonZeroI32`]
3406 * [`num::NonZeroI64`]
3407 * [`num::NonZeroI8`]
3408 * [`num::NonZeroIsize`]
3409 * [`slice::sort_by_cached_key`]
3410 * [`str::escape_debug`]
3411 * [`str::escape_default`]
3412 * [`str::escape_unicode`]
3413 * [`str::split_ascii_whitespace`]
3414
3415 #### std
3416 * [`Instant::checked_add`]
3417 * [`Instant::checked_sub`]
3418 * [`SystemTime::checked_add`]
3419 * [`SystemTime::checked_sub`]
3420
3421 Cargo
3422 -----
3423 - [You can now use alternative registries to crates.io.][cargo/6654]
3424
3425 Misc
3426 ----
3427 - [You can now use the `?` operator in your documentation tests without manually
3428   adding `fn main() -> Result<(), _> {}`.][56470]
3429
3430 Compatibility Notes
3431 -------------------
3432 - [`Command::before_exec` is being replaced by the unsafe method
3433   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
3434 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
3435   can now use `const` functions in `static` variables.
3436
3437 [58370]: https://github.com/rust-lang/rust/pull/58370/
3438 [58406]: https://github.com/rust-lang/rust/pull/58406/
3439 [58421]: https://github.com/rust-lang/rust/pull/58421/
3440 [58166]: https://github.com/rust-lang/rust/pull/58166/
3441 [58044]: https://github.com/rust-lang/rust/pull/58044/
3442 [58057]: https://github.com/rust-lang/rust/pull/58057/
3443 [58059]: https://github.com/rust-lang/rust/pull/58059/
3444 [57809]: https://github.com/rust-lang/rust/pull/57809/
3445 [57873]: https://github.com/rust-lang/rust/pull/57873/
3446 [57604]: https://github.com/rust-lang/rust/pull/57604/
3447 [57367]: https://github.com/rust-lang/rust/pull/57367/
3448 [57407]: https://github.com/rust-lang/rust/pull/57407/
3449 [57425]: https://github.com/rust-lang/rust/pull/57425/
3450 [57106]: https://github.com/rust-lang/rust/pull/57106/
3451 [56470]: https://github.com/rust-lang/rust/pull/56470/
3452 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
3453 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
3454 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
3455 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
3456 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
3457 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
3458 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
3459 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
3460 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
3461 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
3462 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
3463 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
3464 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
3465 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
3466 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
3467 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
3468 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
3469 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
3470 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
3471 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
3472 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
3473 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
3474 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
3475 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
3476 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
3477 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
3478 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
3479 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
3480 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
3481 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
3482 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
3483
3484
3485 Version 1.33.0 (2019-02-28)
3486 ==========================
3487
3488 Language
3489 --------
3490 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
3491   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
3492 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
3493   E.g. You can have match statement on a `u8` that covers `0..=255` and
3494   you would no longer be required to have a `_ => unreachable!()` case.
3495 - [You can now have multiple patterns in `if let` and `while let`
3496   expressions.][57532] You can do this with the same syntax as a `match`
3497   expression. E.g.
3498   ```rust
3499   enum Creature {
3500       Crab(String),
3501       Lobster(String),
3502       Person(String),
3503   }
3504
3505   fn main() {
3506       let state = Creature::Crab("Ferris");
3507
3508       if let Creature::Crab(name) | Creature::Person(name) = state {
3509           println!("This creature's name is: {}", name);
3510       }
3511   }
3512   ```
3513 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
3514   this feature will by default produce a warning as this behaviour can be
3515   unintuitive. E.g. `if let _ = 5 {}`
3516 - [You can now use `let` bindings, assignments, expression statements,
3517   and irrefutable pattern destructuring in const functions.][57175]
3518 - [You can now call unsafe const functions.][57067] E.g.
3519   ```rust
3520   const unsafe fn foo() -> i32 { 5 }
3521   const fn bar() -> i32 {
3522       unsafe { foo() }
3523   }
3524   ```
3525 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
3526   E.g. `#[cfg_attr(all(), must_use, optimize)]`
3527 - [You can now specify a specific alignment with the `#[repr(packed)]`
3528   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
3529   with an alignment of 2 bytes and a size of 6 bytes.
3530 - [You can now import an item from a module as an `_`.][56303] This allows you to
3531   import a trait's impls, and not have the name in the namespace. E.g.
3532   ```rust
3533   use std::io::Read as _;
3534
3535   // Allowed as there is only one `Read` in the module.
3536   pub trait Read {}
3537   ```
3538 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
3539
3540 Compiler
3541 --------
3542 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
3543   command line argument.][56351]
3544 - [The minimum required LLVM version has been bumped to 6.0.][56642]
3545 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
3546 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
3547   tier 2 support.][57130] Visit the [platform support][platform-support] page for
3548   information on Rust's platform support.
3549 - [Added support for the `thumbv7neon-linux-androideabi` and
3550   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
3551 - [Added support for the `x86_64-unknown-uefi` target.][56769]
3552
3553 Libraries
3554 ---------
3555 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
3556   functions for all numeric types.][57566]
3557 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
3558   are now `const` functions for all numeric types.][57105]
3559 - [The methods `is_positive` and `is_negative` are now `const` functions for
3560   all signed numeric types.][57105]
3561 - [The `get` method for all `NonZero` types is now `const`.][57167]
3562 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
3563   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
3564   numeric types.][57234]
3565 - [`Ipv4Addr::new` is now a `const` function][57234]
3566
3567 Stabilized APIs
3568 ---------------
3569 - [`unix::FileExt::read_exact_at`]
3570 - [`unix::FileExt::write_all_at`]
3571 - [`Option::transpose`]
3572 - [`Result::transpose`]
3573 - [`convert::identity`]
3574 - [`pin::Pin`]
3575 - [`marker::Unpin`]
3576 - [`marker::PhantomPinned`]
3577 - [`Vec::resize_with`]
3578 - [`VecDeque::resize_with`]
3579 - [`Duration::as_millis`]
3580 - [`Duration::as_micros`]
3581 - [`Duration::as_nanos`]
3582
3583
3584 Cargo
3585 -----
3586 - [You can now publish crates that require a feature flag to compile with
3587   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
3588 - [Cargo should now rebuild a crate if a file was modified during the initial
3589   build.][cargo/6484]
3590
3591 Compatibility Notes
3592 -------------------
3593 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
3594   are now deprecated in the standard library, and their usage will now produce a warning.
3595   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
3596   methods instead.
3597 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
3598   downcasting.
3599 - [Libtest no longer creates a new thread for each test when
3600   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
3601
3602 [56243]: https://github.com/rust-lang/rust/pull/56243
3603 [56303]: https://github.com/rust-lang/rust/pull/56303/
3604 [56351]: https://github.com/rust-lang/rust/pull/56351/
3605 [56362]: https://github.com/rust-lang/rust/pull/56362
3606 [56642]: https://github.com/rust-lang/rust/pull/56642/
3607 [56769]: https://github.com/rust-lang/rust/pull/56769/
3608 [56805]: https://github.com/rust-lang/rust/pull/56805
3609 [56947]: https://github.com/rust-lang/rust/pull/56947/
3610 [57049]: https://github.com/rust-lang/rust/pull/57049/
3611 [57067]: https://github.com/rust-lang/rust/pull/57067/
3612 [57105]: https://github.com/rust-lang/rust/pull/57105
3613 [57130]: https://github.com/rust-lang/rust/pull/57130/
3614 [57167]: https://github.com/rust-lang/rust/pull/57167/
3615 [57175]: https://github.com/rust-lang/rust/pull/57175/
3616 [57234]: https://github.com/rust-lang/rust/pull/57234/
3617 [57332]: https://github.com/rust-lang/rust/pull/57332/
3618 [57465]: https://github.com/rust-lang/rust/pull/57465/
3619 [57532]: https://github.com/rust-lang/rust/pull/57532/
3620 [57535]: https://github.com/rust-lang/rust/pull/57535/
3621 [57566]: https://github.com/rust-lang/rust/pull/57566/
3622 [57615]: https://github.com/rust-lang/rust/pull/57615/
3623 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
3624 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
3625 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
3626 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
3627 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
3628 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
3629 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
3630 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
3631 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
3632 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
3633 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
3634 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
3635 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
3636 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
3637 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
3638 [platform-support]: https://forge.rust-lang.org/platform-support.html
3639
3640 Version 1.32.0 (2019-01-17)
3641 ==========================
3642
3643 Language
3644 --------
3645 #### 2018 edition
3646 - [You can now use the `?` operator in macro definitions.][56245] The `?`
3647   operator allows you to specify zero or one repetitions similar to the `*` and
3648   `+` operators.
3649 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
3650   now always resolve to the item (`enum`, `struct`, etc.) available in the
3651   module if present, before resolving to a external crate or an item the prelude.][56759]
3652   E.g.
3653   ```rust
3654   enum Color { Red, Green, Blue }
3655
3656   use Color::*;
3657   ```
3658
3659 #### All editions
3660 - [You can now match against `PhantomData<T>` types.][55837]
3661 - [You can now match against literals in macros with the `literal`
3662   specifier.][56072] This will match against a literal of any type.
3663   E.g. `1`, `'A'`, `"Hello World"`
3664 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
3665   ```rust
3666   struct Point(i32, i32);
3667
3668   impl Point {
3669       pub fn new(x: i32, y: i32) -> Self {
3670           Self(x, y)
3671       }
3672
3673       pub fn is_origin(&self) -> bool {
3674           match self {
3675               Self(0, 0) => true,
3676               _ => false,
3677           }
3678       }
3679   }
3680   ```
3681 - [Self can also now be used in type definitions.][56366] E.g.
3682   ```rust
3683   enum List<T>
3684   where
3685       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
3686   {
3687       Nil,
3688       Cons(T, Box<Self>) // likewise here
3689   }
3690   ```
3691 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
3692   a `impl Trait` or `dyn Trait` is returned and unused in the program.
3693
3694 Compiler
3695 --------
3696 - [The default allocator has changed from jemalloc to the default allocator on
3697   your system.][55238] The compiler itself on Linux & macOS will still use
3698   jemalloc, but programs compiled with it will use the system allocator.
3699 - [Added the `aarch64-pc-windows-msvc` target.][55702]
3700
3701 Libraries
3702 ---------
3703 - [`PathBuf` now implements `FromStr`.][55148]
3704 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
3705 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
3706   easily debug expressions in your rust program. E.g.
3707   ```rust
3708   let a = 2;
3709   let b = dbg!(a * 2) + 1;
3710   //      ^-- prints: [src/main.rs:4] a * 2 = 4
3711   assert_eq!(b, 5);
3712   ```
3713
3714 The following APIs are now `const` functions and can be used in a
3715 `const` context.
3716
3717 - [`Cell::as_ptr`]
3718 - [`UnsafeCell::get`]
3719 - [`char::is_ascii`]
3720 - [`iter::empty`]
3721 - [`ManuallyDrop::new`]
3722 - [`ManuallyDrop::into_inner`]
3723 - [`RangeInclusive::start`]
3724 - [`RangeInclusive::end`]
3725 - [`NonNull::as_ptr`]
3726 - [`slice::as_ptr`]
3727 - [`str::as_ptr`]
3728 - [`Duration::as_secs`]
3729 - [`Duration::subsec_millis`]
3730 - [`Duration::subsec_micros`]
3731 - [`Duration::subsec_nanos`]
3732 - [`CStr::as_ptr`]
3733 - [`Ipv4Addr::is_unspecified`]
3734 - [`Ipv6Addr::new`]
3735 - [`Ipv6Addr::octets`]
3736
3737 Stabilized APIs
3738 ---------------
3739 - [`i8::to_be_bytes`]
3740 - [`i8::to_le_bytes`]
3741 - [`i8::to_ne_bytes`]
3742 - [`i8::from_be_bytes`]
3743 - [`i8::from_le_bytes`]
3744 - [`i8::from_ne_bytes`]
3745 - [`i16::to_be_bytes`]
3746 - [`i16::to_le_bytes`]
3747 - [`i16::to_ne_bytes`]
3748 - [`i16::from_be_bytes`]
3749 - [`i16::from_le_bytes`]
3750 - [`i16::from_ne_bytes`]
3751 - [`i32::to_be_bytes`]
3752 - [`i32::to_le_bytes`]
3753 - [`i32::to_ne_bytes`]
3754 - [`i32::from_be_bytes`]
3755 - [`i32::from_le_bytes`]
3756 - [`i32::from_ne_bytes`]
3757 - [`i64::to_be_bytes`]
3758 - [`i64::to_le_bytes`]
3759 - [`i64::to_ne_bytes`]
3760 - [`i64::from_be_bytes`]
3761 - [`i64::from_le_bytes`]
3762 - [`i64::from_ne_bytes`]
3763 - [`i128::to_be_bytes`]
3764 - [`i128::to_le_bytes`]
3765 - [`i128::to_ne_bytes`]
3766 - [`i128::from_be_bytes`]
3767 - [`i128::from_le_bytes`]
3768 - [`i128::from_ne_bytes`]
3769 - [`isize::to_be_bytes`]
3770 - [`isize::to_le_bytes`]
3771 - [`isize::to_ne_bytes`]
3772 - [`isize::from_be_bytes`]
3773 - [`isize::from_le_bytes`]
3774 - [`isize::from_ne_bytes`]
3775 - [`u8::to_be_bytes`]
3776 - [`u8::to_le_bytes`]
3777 - [`u8::to_ne_bytes`]
3778 - [`u8::from_be_bytes`]
3779 - [`u8::from_le_bytes`]
3780 - [`u8::from_ne_bytes`]
3781 - [`u16::to_be_bytes`]
3782 - [`u16::to_le_bytes`]
3783 - [`u16::to_ne_bytes`]
3784 - [`u16::from_be_bytes`]
3785 - [`u16::from_le_bytes`]
3786 - [`u16::from_ne_bytes`]
3787 - [`u32::to_be_bytes`]
3788 - [`u32::to_le_bytes`]
3789 - [`u32::to_ne_bytes`]
3790 - [`u32::from_be_bytes`]
3791 - [`u32::from_le_bytes`]
3792 - [`u32::from_ne_bytes`]
3793 - [`u64::to_be_bytes`]
3794 - [`u64::to_le_bytes`]
3795 - [`u64::to_ne_bytes`]
3796 - [`u64::from_be_bytes`]
3797 - [`u64::from_le_bytes`]
3798 - [`u64::from_ne_bytes`]
3799 - [`u128::to_be_bytes`]
3800 - [`u128::to_le_bytes`]
3801 - [`u128::to_ne_bytes`]
3802 - [`u128::from_be_bytes`]
3803 - [`u128::from_le_bytes`]
3804 - [`u128::from_ne_bytes`]
3805 - [`usize::to_be_bytes`]
3806 - [`usize::to_le_bytes`]
3807 - [`usize::to_ne_bytes`]
3808 - [`usize::from_be_bytes`]
3809 - [`usize::from_le_bytes`]
3810 - [`usize::from_ne_bytes`]
3811
3812 Cargo
3813 -----
3814 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
3815 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
3816
3817 Misc
3818 ----
3819 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
3820
3821 Compatibility Notes
3822 -------------------
3823 - [The argument types for AVX's
3824   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
3825   been changed from `*const` to `*mut` as the previous implementation
3826   was unsound.
3827
3828
3829 [55148]: https://github.com/rust-lang/rust/pull/55148/
3830 [55238]: https://github.com/rust-lang/rust/pull/55238/
3831 [55280]: https://github.com/rust-lang/rust/pull/55280/
3832 [55610]: https://github.com/rust-lang/rust/pull/55610/
3833 [55663]: https://github.com/rust-lang/rust/pull/55663/
3834 [55702]: https://github.com/rust-lang/rust/pull/55702/
3835 [55837]: https://github.com/rust-lang/rust/pull/55837/
3836 [55843]: https://github.com/rust-lang/rust/pull/55843/
3837 [56072]: https://github.com/rust-lang/rust/pull/56072/
3838 [56245]: https://github.com/rust-lang/rust/pull/56245/
3839 [56365]: https://github.com/rust-lang/rust/pull/56365/
3840 [56366]: https://github.com/rust-lang/rust/pull/56366/
3841 [56395]: https://github.com/rust-lang/rust/pull/56395/
3842 [56759]: https://github.com/rust-lang/rust/pull/56759/
3843 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
3844 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
3845 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
3846 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
3847 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
3848 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3849 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3850 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
3851 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
3852 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
3853 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
3854 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
3855 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
3856 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
3857 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
3858 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
3859 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
3860 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
3861 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
3862 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
3863 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
3864 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
3865 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
3866 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
3867 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
3868 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
3869 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
3870 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
3871 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
3872 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
3873 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
3874 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
3875 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
3876 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
3877 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
3878 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
3879 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
3880 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
3881 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
3882 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
3883 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
3884 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
3885 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
3886 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
3887 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
3888 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
3889 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
3890 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
3891 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
3892 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
3893 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
3894 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
3895 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
3896 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
3897 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
3898 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
3899 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
3900 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
3901 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
3902 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
3903 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
3904 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
3905 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
3906 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
3907 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
3908 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
3909 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
3910 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
3911 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
3912 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
3913 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
3914 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
3915 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
3916 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
3917 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
3918 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
3919 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
3920 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
3921 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
3922 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
3923 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
3924 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
3925 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
3926 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
3927 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
3928 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
3929 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
3930 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
3931 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
3932 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
3933 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
3934 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
3935 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
3936
3937
3938 Version 1.31.1 (2018-12-20)
3939 ===========================
3940
3941 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
3942 - [Fix broken go-to-definition in RLS][rls/1171]
3943 - [Fix infinite loop on hover in RLS][rls/1170]
3944
3945 [56562]: https://github.com/rust-lang/rust/pull/56562
3946 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
3947 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
3948
3949 Version 1.31.0 (2018-12-06)
3950 ==========================
3951
3952 Language
3953 --------
3954 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
3955 - [New lifetime elision rules now allow for eliding lifetimes in functions and
3956   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
3957   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
3958   in structs.
3959 - [You can now define and use `const` functions.][54835] These are currently
3960   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
3961   [language reference][const-reference] for what exactly is available.
3962 - [You can now use tool lints, which allow you to scope lints from external
3963   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
3964 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
3965   a crate, not just in exported functions.][54451]
3966 - [You can now use parentheses in pattern matches.][54497]
3967
3968 Compiler
3969 --------
3970 - [Updated musl to 1.1.20][54430]
3971
3972 Libraries
3973 ---------
3974 - [You can now convert `num::NonZero*` types to their raw equivalents using the
3975   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
3976 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
3977   into `Option<&mut T>` using the `From` trait.][53218]
3978 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
3979
3980
3981 Stabilized APIs
3982 ---------------
3983 - [`slice::align_to`]
3984 - [`slice::align_to_mut`]
3985 - [`slice::chunks_exact`]
3986 - [`slice::chunks_exact_mut`]
3987 - [`slice::rchunks`]
3988 - [`slice::rchunks_mut`]
3989 - [`slice::rchunks_exact`]
3990 - [`slice::rchunks_exact_mut`]
3991 - [`Option::replace`]
3992
3993 Cargo
3994 -----
3995 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
3996 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
3997   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
3998
3999 [52813]: https://github.com/rust-lang/rust/pull/52813/
4000 [53218]: https://github.com/rust-lang/rust/pull/53218/
4001 [54057]: https://github.com/rust-lang/rust/pull/54057/
4002 [54240]: https://github.com/rust-lang/rust/pull/54240/
4003 [54430]: https://github.com/rust-lang/rust/pull/54430/
4004 [54451]: https://github.com/rust-lang/rust/pull/54451/
4005 [54497]: https://github.com/rust-lang/rust/pull/54497/
4006 [54778]: https://github.com/rust-lang/rust/pull/54778/
4007 [54835]: https://github.com/rust-lang/rust/pull/54835/
4008 [54870]: https://github.com/rust-lang/rust/pull/54870/
4009 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
4010 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
4011 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
4012 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
4013 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
4014 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
4015 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
4016 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
4017 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
4018 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
4019 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
4020 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
4021 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
4022 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
4023
4024 Version 1.30.1 (2018-11-08)
4025 ===========================
4026
4027 - [Fixed overflow ICE in rustdoc][54199]
4028 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
4029
4030 [54199]: https://github.com/rust-lang/rust/pull/54199
4031 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
4032
4033 Version 1.30.0 (2018-10-25)
4034 ==========================
4035
4036 Language
4037 --------
4038 - [Procedural macros are now available.][52081] These kinds of macros allow for
4039   more powerful code generation. There is a [new chapter available][proc-macros]
4040   in the Rust Programming Language book that goes further in depth.
4041 - [You can now use keywords as identifiers using the raw identifiers
4042   syntax (`r#`),][53236] e.g. `let r#for = true;`
4043 - [Using anonymous parameters in traits is now deprecated with a warning and
4044   will be a hard error in the 2018 edition.][53272]
4045 - [You can now use `crate` in paths.][54404] This allows you to refer to the
4046   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
4047 - [Using a external crate no longer requires being prefixed with `::`.][54404]
4048   Previously, using a external crate in a module without a use statement
4049   required `let json = ::serde_json::from_str(foo);` but can now be written
4050   as `let json = serde_json::from_str(foo);`.
4051 - [You can now apply the `#[used]` attribute to static items to prevent the
4052   compiler from optimising them away, even if they appear to be unused,][51363]
4053   e.g. `#[used] static FOO: u32 = 1;`
4054 - [You can now import and reexport macros from other crates with the `use`
4055   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
4056   the root module of the crate. If your macro relies on calling other local
4057   macros, it is recommended to export with the
4058   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
4059   those macros.
4060 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
4061   using the `vis` specifier.][53370]
4062 - [Non-macro attributes now allow all forms of literals, not just
4063   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
4064   write `#[attr(true)]`.
4065 - [You can now specify a function to handle a panic in the Rust runtime with the
4066   `#[panic_handler]` attribute.][51366]
4067
4068 Compiler
4069 --------
4070 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
4071 - [Added the `aarch64-unknown-netbsd` target][53165]
4072 - [Upgraded to LLVM 8.][53611]
4073
4074 Libraries
4075 ---------
4076 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
4077
4078 Stabilized APIs
4079 ---------------
4080 - [`Ipv4Addr::BROADCAST`]
4081 - [`Ipv4Addr::LOCALHOST`]
4082 - [`Ipv4Addr::UNSPECIFIED`]
4083 - [`Ipv6Addr::LOCALHOST`]
4084 - [`Ipv6Addr::UNSPECIFIED`]
4085 - [`Iterator::find_map`]
4086
4087   The following methods are replacement methods for `trim_left`, `trim_right`,
4088   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
4089   in 1.33.0:
4090 - [`str::trim_end_matches`]
4091 - [`str::trim_end`]
4092 - [`str::trim_start_matches`]
4093 - [`str::trim_start`]
4094
4095 Cargo
4096 ----
4097 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
4098 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
4099   equivalent to calling `rustdoc --error-format=json`.
4100 - [Cargo will now provide a progress bar for builds.][cargo/5995]
4101
4102 Misc
4103 ----
4104 - [`rustdoc` allows you to specify what edition to treat your code as with the
4105   `--edition` option.][54057]
4106 - [`rustdoc` now has the `--color` (specify whether to output color) and
4107   `--error-format` (specify error format, e.g. `json`) options.][53003]
4108 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
4109   debug symbols.][53774]
4110 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
4111   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
4112
4113 [50911]: https://github.com/rust-lang/rust/pull/50911/
4114 [51363]: https://github.com/rust-lang/rust/pull/51363/
4115 [51366]: https://github.com/rust-lang/rust/pull/51366/
4116 [52081]: https://github.com/rust-lang/rust/pull/52081/
4117 [53003]: https://github.com/rust-lang/rust/pull/53003/
4118 [53033]: https://github.com/rust-lang/rust/pull/53033/
4119 [53044]: https://github.com/rust-lang/rust/pull/53044/
4120 [53165]: https://github.com/rust-lang/rust/pull/53165/
4121 [53611]: https://github.com/rust-lang/rust/pull/53611/
4122 [53236]: https://github.com/rust-lang/rust/pull/53236/
4123 [53272]: https://github.com/rust-lang/rust/pull/53272/
4124 [53370]: https://github.com/rust-lang/rust/pull/53370/
4125 [53459]: https://github.com/rust-lang/rust/pull/53459/
4126 [53774]: https://github.com/rust-lang/rust/pull/53774/
4127 [53822]: https://github.com/rust-lang/rust/pull/53822/
4128 [54057]: https://github.com/rust-lang/rust/pull/54057/
4129 [54404]: https://github.com/rust-lang/rust/pull/54404/
4130 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
4131 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
4132 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
4133 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
4134
4135 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
4136 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
4137 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
4138 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
4139 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
4140 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
4141 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
4142 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
4143 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
4144 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
4145
4146
4147 Version 1.29.2 (2018-10-11)
4148 ===========================
4149
4150 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
4151 - The `rls-preview` component on the windows-gnu targets has been restored.
4152
4153 [54639]: https://github.com/rust-lang/rust/pull/54639
4154
4155
4156 Version 1.29.1 (2018-09-25)
4157 ===========================
4158
4159 Security Notes
4160 --------------
4161
4162 - The standard library's `str::repeat` function contained an out of bounds write
4163   caused by an integer overflow. This has been fixed by deterministically
4164   panicking when an overflow happens.
4165
4166   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
4167   us.
4168
4169
4170 Version 1.29.0 (2018-09-13)
4171 ==========================
4172
4173 Compiler
4174 --------
4175 - [Bumped minimum LLVM version to 5.0.][51899]
4176 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
4177 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
4178 - [Upgraded to LLVM 7.][51966]
4179
4180 Libraries
4181 ---------
4182 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
4183 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
4184 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
4185 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
4186   for `&str`.][51178]
4187 - [`Cell<T>` now allows `T` to be unsized.][50494]
4188 - [`SocketAddr` is now stable on Redox.][52656]
4189
4190 Stabilized APIs
4191 ---------------
4192 - [`Arc::downcast`]
4193 - [`Iterator::flatten`]
4194 - [`Rc::downcast`]
4195
4196 Cargo
4197 -----
4198 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
4199   `--locked` to disable this behavior.
4200 - [`cargo-install` will now allow you to cross compile an install
4201   using `--target`.][cargo/5614]
4202 - [Added the `cargo-fix` subcommand to automatically move project code from
4203   2015 edition to 2018.][cargo/5723]
4204 - [`cargo doc` can now optionally document private types using the
4205   `--document-private-items` flag.][cargo/5543]
4206
4207 Misc
4208 ----
4209 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
4210   the specified level to that level.][52354] For example `--cap-lints warn`
4211   will demote `deny` and `forbid` lints to `warn`.
4212 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
4213   fails and `101` if there is a panic.][52197]
4214 - [A preview of clippy has been made available through rustup.][51122]
4215   You can install the preview with `rustup component add clippy-preview`.
4216
4217 Compatibility Notes
4218 -------------------
4219 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
4220   Use `str::get_unchecked(begin..end)` instead.
4221 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
4222   Consider using the `home_dir` function from
4223   https://crates.io/crates/dirs instead.
4224 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
4225 - [`cfg` attributes and `--cfg` command line flags are now more
4226   strictly validated.][53893]
4227
4228 [53893]: https://github.com/rust-lang/rust/pull/53893/
4229 [52861]: https://github.com/rust-lang/rust/pull/52861/
4230 [51966]: https://github.com/rust-lang/rust/pull/51966/
4231 [52656]: https://github.com/rust-lang/rust/pull/52656/
4232 [52239]: https://github.com/rust-lang/rust/pull/52239/
4233 [52330]: https://github.com/rust-lang/rust/pull/52330/
4234 [52354]: https://github.com/rust-lang/rust/pull/52354/
4235 [52402]: https://github.com/rust-lang/rust/pull/52402/
4236 [52197]: https://github.com/rust-lang/rust/pull/52197/
4237 [51807]: https://github.com/rust-lang/rust/pull/51807/
4238 [51899]: https://github.com/rust-lang/rust/pull/51899/
4239 [51912]: https://github.com/rust-lang/rust/pull/51912/
4240 [51619]: https://github.com/rust-lang/rust/pull/51619/
4241 [51656]: https://github.com/rust-lang/rust/pull/51656/
4242 [51178]: https://github.com/rust-lang/rust/pull/51178/
4243 [51122]: https://github.com/rust-lang/rust/pull/51122
4244 [50494]: https://github.com/rust-lang/rust/pull/50494/
4245 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
4246 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
4247 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
4248 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
4249 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
4250 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
4251 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
4252
4253
4254 Version 1.28.0 (2018-08-02)
4255 ===========================
4256
4257 Language
4258 --------
4259 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
4260   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
4261   the inner type across Foreign Function Interface (FFI) boundaries.
4262 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
4263   and can now be used as identifiers.][51196]
4264 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
4265   stable.][51241] This will allow users to specify a global allocator for
4266   their program.
4267 - [Unit test functions marked with the `#[test]` attribute can now return
4268   `Result<(), E: Debug>` in addition to `()`.][51298]
4269 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
4270   allows macros to easily target lifetimes.
4271
4272 Compiler
4273 --------
4274 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
4275   prioritise making smaller binary sizes. `z` is the same as `s` with the
4276   exception that it does not vectorise loops, which typically results in an even
4277   smaller binary.
4278 - [The short error format is now stable.][49546] Specified with
4279   `--error-format=short` this option will provide a more compressed output of
4280   rust error messages.
4281 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
4282 - [Reduced the number of allocations in the macro parser.][50855] This can
4283   improve compile times of macro heavy crates on average by 5%.
4284
4285 Libraries
4286 ---------
4287 - [Implemented `Default` for `&mut str`.][51306]
4288 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
4289 - [Implemented `Extend` for `()`.][50234]
4290 - [The `Debug` implementation of `time::Duration` should now be more easily
4291   human readable.][50364] Previously a `Duration` of one second would printed as
4292   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
4293 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
4294   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
4295   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
4296   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
4297   for `PathBuf`.][50170]
4298 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
4299   and `Wrapping<i128>`.][50465]
4300 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
4301   possible.][51050] This can provide up to a 40% speed increase.
4302 - [Improved error messages when using `format!`.][50610]
4303
4304 Stabilized APIs
4305 ---------------
4306 - [`Iterator::step_by`]
4307 - [`Path::ancestors`]
4308 - [`SystemTime::UNIX_EPOCH`]
4309 - [`alloc::GlobalAlloc`]
4310 - [`alloc::Layout`]
4311 - [`alloc::LayoutErr`]
4312 - [`alloc::System`]
4313 - [`alloc::alloc`]
4314 - [`alloc::alloc_zeroed`]
4315 - [`alloc::dealloc`]
4316 - [`alloc::realloc`]
4317 - [`alloc::handle_alloc_error`]
4318 - [`btree_map::Entry::or_default`]
4319 - [`fmt::Alignment`]
4320 - [`hash_map::Entry::or_default`]
4321 - [`iter::repeat_with`]
4322 - [`num::NonZeroUsize`]
4323 - [`num::NonZeroU128`]
4324 - [`num::NonZeroU16`]
4325 - [`num::NonZeroU32`]
4326 - [`num::NonZeroU64`]
4327 - [`num::NonZeroU8`]
4328 - [`ops::RangeBounds`]
4329 - [`slice::SliceIndex`]
4330 - [`slice::from_mut`]
4331 - [`slice::from_ref`]
4332 - [`{Any + Send + Sync}::downcast_mut`]
4333 - [`{Any + Send + Sync}::downcast_ref`]
4334 - [`{Any + Send + Sync}::is`]
4335
4336 Cargo
4337 -----
4338 - [Cargo will now no longer allow you to publish crates with build scripts that
4339   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
4340   considered to be immutable.
4341
4342 Misc
4343 ----
4344 - [The `suggestion_applicability` field in `rustc`'s json output is now
4345   stable.][50486] This will allow dev tools to check whether a code suggestion
4346   would apply to them.
4347
4348 Compatibility Notes
4349 -------------------
4350 - [Rust will consider trait objects with duplicated constraints to be the same
4351   type as without the duplicated constraint.][51276] For example the below code will
4352   now fail to compile.
4353   ```rust
4354   trait Trait {}
4355
4356   impl Trait + Send {
4357       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
4358   }
4359
4360   impl Trait + Send + Send {
4361       fn test(&self) { println!("two"); }
4362   }
4363   ```
4364
4365 [49546]: https://github.com/rust-lang/rust/pull/49546/
4366 [50143]: https://github.com/rust-lang/rust/pull/50143/
4367 [50170]: https://github.com/rust-lang/rust/pull/50170/
4368 [50234]: https://github.com/rust-lang/rust/pull/50234/
4369 [50265]: https://github.com/rust-lang/rust/pull/50265/
4370 [50364]: https://github.com/rust-lang/rust/pull/50364/
4371 [50385]: https://github.com/rust-lang/rust/pull/50385/
4372 [50465]: https://github.com/rust-lang/rust/pull/50465/
4373 [50486]: https://github.com/rust-lang/rust/pull/50486/
4374 [50554]: https://github.com/rust-lang/rust/pull/50554/
4375 [50610]: https://github.com/rust-lang/rust/pull/50610/
4376 [50855]: https://github.com/rust-lang/rust/pull/50855/
4377 [51050]: https://github.com/rust-lang/rust/pull/51050/
4378 [51196]: https://github.com/rust-lang/rust/pull/51196/
4379 [51241]: https://github.com/rust-lang/rust/pull/51241/
4380 [51276]: https://github.com/rust-lang/rust/pull/51276/
4381 [51298]: https://github.com/rust-lang/rust/pull/51298/
4382 [51306]: https://github.com/rust-lang/rust/pull/51306/
4383 [51562]: https://github.com/rust-lang/rust/pull/51562/
4384 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
4385 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
4386 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
4387 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
4388 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
4389 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
4390 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
4391 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
4392 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
4393 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
4394 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
4395 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
4396 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
4397 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
4398 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
4399 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
4400 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
4401 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
4402 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
4403 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
4404 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
4405 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
4406 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
4407 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
4408 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
4409 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
4410 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
4411 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
4412 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
4413 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
4414
4415 Version 1.27.2 (2018-07-20)
4416 ===========================
4417
4418 Compatibility Notes
4419 -------------------
4420
4421 - The borrow checker was fixed to avoid potential unsoundness when using
4422   match ergonomics: [#52213][52213].
4423
4424 [52213]: https://github.com/rust-lang/rust/issues/52213
4425
4426 Version 1.27.1 (2018-07-10)
4427 ===========================
4428
4429 Security Notes
4430 --------------
4431
4432 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
4433   when running, which enabled executing code as some other user on a
4434   given machine. This release fixes that vulnerability; you can read
4435   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
4436
4437   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
4438
4439 Compatibility Notes
4440 -------------------
4441
4442 - The borrow checker was fixed to avoid an additional potential unsoundness when using
4443   match ergonomics: [#51415][51415], [#49534][49534].
4444
4445 [51415]: https://github.com/rust-lang/rust/issues/51415
4446 [49534]: https://github.com/rust-lang/rust/issues/49534
4447 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
4448 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
4449
4450 Version 1.27.0 (2018-06-21)
4451 ==========================
4452
4453 Language
4454 --------
4455 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
4456   be used as an identifier.
4457 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
4458   bare `Trait` syntax, and should make it clearer when being used in tandem with
4459   `impl Trait` because it is equivalent to the following syntax:
4460   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
4461   `Box<Trait> == Box<dyn Trait>`.
4462 - [Attributes on generic parameters such as types and lifetimes are
4463   now stable.][48851] e.g.
4464   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
4465 - [The `#[must_use]` attribute can now also be used on functions as well as
4466   types.][48925] It provides a lint that by default warns users when the
4467   value returned by a function has not been used.
4468
4469 Compiler
4470 --------
4471 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
4472
4473 Libraries
4474 ---------
4475 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
4476   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
4477   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
4478   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
4479   the `cfg` attribute.
4480 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
4481   std are now available in core.][49896]
4482 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
4483   to `Self`.][49630]
4484 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
4485   that the operation isn't done in place.
4486 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
4487   the `#[must_use]` attribute][49533] to warn about unused potentially
4488   expensive allocations.
4489
4490 Stabilized APIs
4491 ---------------
4492 - [`DoubleEndedIterator::rfind`]
4493 - [`DoubleEndedIterator::rfold`]
4494 - [`DoubleEndedIterator::try_rfold`]
4495 - [`Duration::from_micros`]
4496 - [`Duration::from_nanos`]
4497 - [`Duration::subsec_micros`]
4498 - [`Duration::subsec_millis`]
4499 - [`HashMap::remove_entry`]
4500 - [`Iterator::try_fold`]
4501 - [`Iterator::try_for_each`]
4502 - [`NonNull::cast`]
4503 - [`Option::filter`]
4504 - [`String::replace_range`]
4505 - [`Take::set_limit`]
4506 - [`hint::unreachable_unchecked`]
4507 - [`os::unix::process::parent_id`]
4508 - [`ptr::swap_nonoverlapping`]
4509 - [`slice::rsplit_mut`]
4510 - [`slice::rsplit`]
4511 - [`slice::swap_with_slice`]
4512
4513 Cargo
4514 -----
4515 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
4516   `readme`, and `repository` fields.][cargo/5386]
4517 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
4518 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
4519   a different directory than `target` for placing compilation artifacts.
4520 - [Cargo will be adding automatic target inference for binaries, benchmarks,
4521   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
4522   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
4523   where cargo would infer a binary, Cargo will produce a warning. You can
4524   disable this feature ahead of time by setting any of the following to false:
4525   `autobins`, `autobenches`, `autoexamples`, `autotests`.
4526 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
4527   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
4528
4529 Misc
4530 ----
4531 - [Added “The Rustc book” into the official documentation.][49707]
4532   [“The Rustc book”] documents and teaches how to use the rustc compiler.
4533 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
4534
4535 Compatibility Notes
4536 -------------------
4537 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
4538   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
4539   compile, `"".is_empty()` will still compile.
4540 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
4541   will only print the inner type.][48553] E.g.
4542   `print!("{:?}", AtomicBool::new(true))` will print `true`,
4543   not `AtomicBool(true)`.
4544 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
4545   could enter higher numbers but they were not supported by LLVM. Up to 512MB
4546   alignment should cover all use cases.
4547 - The `.description()` method on the `std::error::Error` trait
4548   [has been soft-deprecated][50163]. It is no longer required to implement it.
4549
4550 [48553]: https://github.com/rust-lang/rust/pull/48553/
4551 [48851]: https://github.com/rust-lang/rust/pull/48851/
4552 [48925]: https://github.com/rust-lang/rust/pull/48925/
4553 [49533]: https://github.com/rust-lang/rust/pull/49533/
4554 [49623]: https://github.com/rust-lang/rust/pull/49623/
4555 [49630]: https://github.com/rust-lang/rust/pull/49630/
4556 [49664]: https://github.com/rust-lang/rust/pull/49664/
4557 [49699]: https://github.com/rust-lang/rust/pull/49699/
4558 [49707]: https://github.com/rust-lang/rust/pull/49707/
4559 [49896]: https://github.com/rust-lang/rust/pull/49896/
4560 [49968]: https://github.com/rust-lang/rust/pull/49968/
4561 [50163]: https://github.com/rust-lang/rust/pull/50163
4562 [50177]: https://github.com/rust-lang/rust/pull/50177/
4563 [50378]: https://github.com/rust-lang/rust/pull/50378/
4564 [50423]: https://github.com/rust-lang/rust/pull/50423/
4565 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
4566 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
4567 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
4568 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
4569 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
4570 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
4571 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
4572 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
4573 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
4574 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
4575 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
4576 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
4577 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
4578 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
4579 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
4580 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
4581 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
4582 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
4583 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
4584 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
4585 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
4586 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4587 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
4588 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
4589 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
4590 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
4591 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
4592 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
4593 [“The Rustc book”]: https://doc.rust-lang.org/rustc
4594
4595
4596 Version 1.26.2 (2018-06-05)
4597 ==========================
4598
4599 Compatibility Notes
4600 -------------------
4601
4602 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
4603
4604 [51117]: https://github.com/rust-lang/rust/issues/51117
4605
4606
4607 Version 1.26.1 (2018-05-29)
4608 ==========================
4609
4610 Tools
4611 -----
4612
4613 - [RLS now works on Windows.][50646]
4614 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
4615
4616
4617 Compatibility Notes
4618 --------
4619
4620 - [`fn main() -> impl Trait` no longer works for non-Termination
4621   trait.][50656]
4622   This reverts an accidental stabilization.
4623 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
4624 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
4625
4626 [50646]: https://github.com/rust-lang/rust/issues/50646
4627 [50656]: https://github.com/rust-lang/rust/pull/50656
4628 [50812]: https://github.com/rust-lang/rust/pull/50812
4629 [50950]: https://github.com/rust-lang/rust/issues/50950
4630 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
4631
4632 Version 1.26.0 (2018-05-10)
4633 ==========================
4634
4635 Language
4636 --------
4637 - [Closures now implement `Copy` and/or `Clone` if all captured variables
4638   implement either or both traits.][49299]
4639 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
4640 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
4641   lifetime can be elided.][49458]
4642 - [`impl Trait` is now stable allowing you to have abstract types in returns
4643    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
4644   `fn open(path: impl AsRef<Path>)`.
4645 - [Pattern matching will now automatically apply dereferences.][49394]
4646 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
4647 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
4648 - [A lot of operations are now available in a const context.][46882] E.g. You
4649   can now index into constant arrays, reference and dereference into constants,
4650   and use tuple struct constructors.
4651 - [Fixed entry slice patterns are now stable.][48516] E.g.
4652   ```rust
4653   let points = [1, 2, 3, 4];
4654   match points {
4655       [1, 2, 3, 4] => println!("All points were sequential."),
4656       _ => println!("Not all points were sequential."),
4657   }
4658   ```
4659
4660
4661 Compiler
4662 --------
4663 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
4664 - [Fixed exponential projection complexity on nested types.][48296]
4665   This can provide up to a ~12% reduction in compile times for certain crates.
4666 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
4667   to remap path prefixes outputted by the compiler.
4668 - [Added `powerpc-unknown-netbsd` target.][48281]
4669
4670 Libraries
4671 ---------
4672 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
4673 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
4674   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
4675 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
4676 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
4677 - [`ascii::escape_default` is now available in libcore.][48735]
4678 - [Trailing commas are now supported in std and core macros.][48056]
4679 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
4680 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
4681
4682 Stabilized APIs
4683 ---------------
4684 - [`*const T::add`]
4685 - [`*const T::copy_to_nonoverlapping`]
4686 - [`*const T::copy_to`]
4687 - [`*const T::read_unaligned`]
4688 - [`*const T::read_volatile`]
4689 - [`*const T::read`]
4690 - [`*const T::sub`]
4691 - [`*const T::wrapping_add`]
4692 - [`*const T::wrapping_sub`]
4693 - [`*mut T::add`]
4694 - [`*mut T::copy_to_nonoverlapping`]
4695 - [`*mut T::copy_to`]
4696 - [`*mut T::read_unaligned`]
4697 - [`*mut T::read_volatile`]
4698 - [`*mut T::read`]
4699 - [`*mut T::replace`]
4700 - [`*mut T::sub`]
4701 - [`*mut T::swap`]
4702 - [`*mut T::wrapping_add`]
4703 - [`*mut T::wrapping_sub`]
4704 - [`*mut T::write_bytes`]
4705 - [`*mut T::write_unaligned`]
4706 - [`*mut T::write_volatile`]
4707 - [`*mut T::write`]
4708 - [`Box::leak`]
4709 - [`FromUtf8Error::as_bytes`]
4710 - [`LocalKey::try_with`]
4711 - [`Option::cloned`]
4712 - [`btree_map::Entry::and_modify`]
4713 - [`fs::read_to_string`]
4714 - [`fs::read`]
4715 - [`fs::write`]
4716 - [`hash_map::Entry::and_modify`]
4717 - [`iter::FusedIterator`]
4718 - [`ops::RangeInclusive`]
4719 - [`ops::RangeToInclusive`]
4720 - [`process::id`]
4721 - [`slice::rotate_left`]
4722 - [`slice::rotate_right`]
4723 - [`String::retain`]
4724
4725
4726 Cargo
4727 -----
4728 - [Cargo will now output path to custom commands when `-v` is
4729   passed with `--list`][cargo/5041]
4730 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
4731
4732 Misc
4733 ----
4734 - [The second edition of "The Rust Programming Language" book is now recommended
4735   over the first.][48404]
4736
4737 Compatibility Notes
4738 -------------------
4739
4740 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
4741   syntax is now invalid.
4742   ```
4743   use std::ops::Fn as dyn;
4744   fn g(_: Box<dyn(std::fmt::Debug)>) {}
4745   ```
4746 - [The result of dereferences are no longer promoted to `'static`.][47408]
4747   e.g.
4748   ```rust
4749   fn main() {
4750       const PAIR: &(i32, i32) = &(0, 1);
4751       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
4752   }
4753   ```
4754 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
4755 - [`".e0"` will now no longer parse as `0.0` and will instead cause
4756   an error.][48235]
4757 - [Removed hoedown from rustdoc.][48274]
4758 - [Bounds on higher-kinded lifetimes a hard error.][48326]
4759
4760 [46882]: https://github.com/rust-lang/rust/pull/46882
4761 [47379]: https://github.com/rust-lang/rust/pull/47379
4762 [47408]: https://github.com/rust-lang/rust/pull/47408
4763 [47813]: https://github.com/rust-lang/rust/pull/47813
4764 [48056]: https://github.com/rust-lang/rust/pull/48056
4765 [48125]: https://github.com/rust-lang/rust/pull/48125
4766 [48235]: https://github.com/rust-lang/rust/pull/48235
4767 [48274]: https://github.com/rust-lang/rust/pull/48274
4768 [48281]: https://github.com/rust-lang/rust/pull/48281
4769 [48296]: https://github.com/rust-lang/rust/pull/48296
4770 [48326]: https://github.com/rust-lang/rust/pull/48326
4771 [48359]: https://github.com/rust-lang/rust/pull/48359
4772 [48404]: https://github.com/rust-lang/rust/pull/48404
4773 [48481]: https://github.com/rust-lang/rust/pull/48481
4774 [48516]: https://github.com/rust-lang/rust/pull/48516
4775 [48628]: https://github.com/rust-lang/rust/pull/48628
4776 [48629]: https://github.com/rust-lang/rust/pull/48629
4777 [48657]: https://github.com/rust-lang/rust/pull/48657
4778 [48735]: https://github.com/rust-lang/rust/pull/48735
4779 [48978]: https://github.com/rust-lang/rust/pull/48978
4780 [49101]: https://github.com/rust-lang/rust/pull/49101
4781 [49109]: https://github.com/rust-lang/rust/pull/49109
4782 [49162]: https://github.com/rust-lang/rust/pull/49162
4783 [49255]: https://github.com/rust-lang/rust/pull/49255
4784 [49299]: https://github.com/rust-lang/rust/pull/49299
4785 [49305]: https://github.com/rust-lang/rust/pull/49305
4786 [49394]: https://github.com/rust-lang/rust/pull/49394
4787 [49458]: https://github.com/rust-lang/rust/pull/49458
4788 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
4789 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
4790 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
4791 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
4792 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
4793 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
4794 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
4795 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
4796 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
4797 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
4798 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
4799 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
4800 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
4801 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
4802 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
4803 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
4804 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
4805 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
4806 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
4807 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
4808 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
4809 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
4810 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
4811 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
4812 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
4813 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
4814 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
4815 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
4816 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
4817 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
4818 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
4819 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
4820 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
4821 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
4822 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
4823 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
4824 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4825 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
4826 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
4827 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
4828 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
4829 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
4830
4831
4832 Version 1.25.0 (2018-03-29)
4833 ==========================
4834
4835 Language
4836 --------
4837 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
4838 - [You can now use nested groups of imports.][47948]
4839   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
4840 - [You can now have `|` at the start of a match arm.][47947] e.g.
4841 ```rust
4842 enum Foo { A, B, C }
4843
4844 fn main() {
4845     let x = Foo::A;
4846     match x {
4847         | Foo::A
4848         | Foo::B => println!("AB"),
4849         | Foo::C => println!("C"),
4850     }
4851 }
4852 ```
4853
4854 Compiler
4855 --------
4856 - [Upgraded to LLVM 6.][47828]
4857 - [Added `-C lto=val` option.][47521]
4858 - [Added `i586-unknown-linux-musl` target][47282]
4859
4860 Libraries
4861 ---------
4862 - [Impl Send for `process::Command` on Unix.][47760]
4863 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
4864 - [`UnsafeCell::into_inner` is now safe.][47204]
4865 - [Implement libstd for CloudABI.][47268]
4866 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
4867 - [Implement `AsRef<Path>` for Component][46985]
4868 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
4869 - [Moved `Duration` to libcore.][46666]
4870
4871 Stabilized APIs
4872 ---------------
4873 - [`Location::column`]
4874 - [`ptr::NonNull`]
4875
4876 The following functions can now be used in a constant expression.
4877 eg. `static MINUTE: Duration = Duration::from_secs(60);`
4878 - [`Duration::new`][47300]
4879 - [`Duration::from_secs`][47300]
4880 - [`Duration::from_millis`][47300]
4881
4882 Cargo
4883 -----
4884 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
4885 - [`cargo new` now defaults to creating a binary crate, instead of a
4886   library crate.][cargo/5029]
4887
4888 Misc
4889 ----
4890 - [Rust by example is now shipped with new releases][46196]
4891
4892 Compatibility Notes
4893 -------------------
4894 - [Deprecated `net::lookup_host`.][47510]
4895 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
4896 - The borrow checker was sometimes incorrectly permitting overlapping borrows
4897   around indexing operations (see [#47349][47349]). This has been fixed (which also
4898   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
4899 - [Removed deprecated unstable attribute `#[simd]`.][47251]
4900
4901 [33903]: https://github.com/rust-lang/rust/pull/33903
4902 [47947]: https://github.com/rust-lang/rust/pull/47947
4903 [47948]: https://github.com/rust-lang/rust/pull/47948
4904 [47760]: https://github.com/rust-lang/rust/pull/47760
4905 [47790]: https://github.com/rust-lang/rust/pull/47790
4906 [47828]: https://github.com/rust-lang/rust/pull/47828
4907 [47398]: https://github.com/rust-lang/rust/pull/47398
4908 [47510]: https://github.com/rust-lang/rust/pull/47510
4909 [47521]: https://github.com/rust-lang/rust/pull/47521
4910 [47204]: https://github.com/rust-lang/rust/pull/47204
4911 [47251]: https://github.com/rust-lang/rust/pull/47251
4912 [47268]: https://github.com/rust-lang/rust/pull/47268
4913 [47282]: https://github.com/rust-lang/rust/pull/47282
4914 [47300]: https://github.com/rust-lang/rust/pull/47300
4915 [47349]: https://github.com/rust-lang/rust/pull/47349
4916 [46931]: https://github.com/rust-lang/rust/pull/46931
4917 [46985]: https://github.com/rust-lang/rust/pull/46985
4918 [47006]: https://github.com/rust-lang/rust/pull/47006
4919 [46830]: https://github.com/rust-lang/rust/pull/46830
4920 [46095]: https://github.com/rust-lang/rust/pull/46095
4921 [46666]: https://github.com/rust-lang/rust/pull/46666
4922 [46196]: https://github.com/rust-lang/rust/pull/46196
4923 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
4924 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
4925 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
4926 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
4927 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
4928
4929
4930 Version 1.24.1 (2018-03-01)
4931 ==========================
4932
4933  - [Do not abort when unwinding through FFI][48251]
4934  - [Emit UTF-16 files for linker arguments on Windows][48318]
4935  - [Make the error index generator work again][48308]
4936  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
4937
4938 [48251]: https://github.com/rust-lang/rust/issues/48251
4939 [48308]: https://github.com/rust-lang/rust/issues/48308
4940 [48318]: https://github.com/rust-lang/rust/issues/48318
4941 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
4942
4943
4944 Version 1.24.0 (2018-02-15)
4945 ==========================
4946
4947 Language
4948 --------
4949 - [External `sysv64` ffi is now available.][46528]
4950   eg. `extern "sysv64" fn foo () {}`
4951
4952 Compiler
4953 --------
4954 - [rustc now uses 16 codegen units by default for release builds.][46910]
4955   For the fastest builds, utilize `codegen-units=1`.
4956 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
4957 - [Add `aarch64-unknown-openbsd` support][46760]
4958
4959 Libraries
4960 ---------
4961 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
4962   improvement in performance in the majority of cases.
4963 - [`OsStr`'s `Debug` implementation is now lossless and consistent
4964   with Windows.][46798]
4965 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
4966 - [impl `From<bool>` for `AtomicBool`][46293]
4967 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
4968 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
4969 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
4970 - [float::from_bits now just uses transmute.][46012] This provides
4971   some optimisations from LLVM.
4972 - [Copied `AsciiExt` methods onto `char`][46077]
4973 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
4974 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
4975 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
4976 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
4977
4978 Stabilized APIs
4979 ---------------
4980 - [`RefCell::replace`]
4981 - [`RefCell::swap`]
4982 - [`atomic::spin_loop_hint`]
4983
4984 The following functions can now be used in a constant expression.
4985 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
4986
4987 - [`AtomicBool::new`][46287]
4988 - [`AtomicUsize::new`][46287]
4989 - [`AtomicIsize::new`][46287]
4990 - [`AtomicPtr::new`][46287]
4991 - [`Cell::new`][46287]
4992 - [`{integer}::min_value`][46287]
4993 - [`{integer}::max_value`][46287]
4994 - [`mem::size_of`][46287]
4995 - [`mem::align_of`][46287]
4996 - [`ptr::null`][46287]
4997 - [`ptr::null_mut`][46287]
4998 - [`RefCell::new`][46287]
4999 - [`UnsafeCell::new`][46287]
5000
5001 Cargo
5002 -----
5003 - [Added a `workspace.default-members` config that
5004   overrides implied `--all` in virtual workspaces.][cargo/4743]
5005 - [Enable incremental by default on development builds.][cargo/4817] Also added
5006   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
5007   per-project or global basis respectively.
5008
5009 Misc
5010 ----
5011
5012 Compatibility Notes
5013 -------------------
5014 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
5015 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
5016   in accordance with IETF RFC 4291 §2.2.
5017 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
5018 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
5019   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
5020 - [Leading zeros in tuple struct members is now an error][47084]
5021 - [`column!()` macro is one-based instead of zero-based][46977]
5022 - [`fmt::Arguments` can no longer be shared across threads][45198]
5023 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
5024 - [Cargo sets a different working directory for the compiler][cargo/4788]
5025
5026 [44884]: https://github.com/rust-lang/rust/pull/44884
5027 [45198]: https://github.com/rust-lang/rust/pull/45198
5028 [45506]: https://github.com/rust-lang/rust/pull/45506
5029 [45990]: https://github.com/rust-lang/rust/pull/45990
5030 [46012]: https://github.com/rust-lang/rust/pull/46012
5031 [46077]: https://github.com/rust-lang/rust/pull/46077
5032 [46094]: https://github.com/rust-lang/rust/pull/46094
5033 [46284]: https://github.com/rust-lang/rust/pull/46284
5034 [46287]: https://github.com/rust-lang/rust/pull/46287
5035 [46293]: https://github.com/rust-lang/rust/pull/46293
5036 [46528]: https://github.com/rust-lang/rust/pull/46528
5037 [46671]: https://github.com/rust-lang/rust/pull/46671
5038 [46713]: https://github.com/rust-lang/rust/pull/46713
5039 [46735]: https://github.com/rust-lang/rust/pull/46735
5040 [46760]: https://github.com/rust-lang/rust/pull/46760
5041 [46798]: https://github.com/rust-lang/rust/pull/46798
5042 [46828]: https://github.com/rust-lang/rust/pull/46828
5043 [46831]: https://github.com/rust-lang/rust/pull/46831
5044 [46833]: https://github.com/rust-lang/rust/pull/46833
5045 [46910]: https://github.com/rust-lang/rust/pull/46910
5046 [46977]: https://github.com/rust-lang/rust/pull/46977
5047 [47018]: https://github.com/rust-lang/rust/pull/47018
5048 [47080]: https://github.com/rust-lang/rust/pull/47080
5049 [47084]: https://github.com/rust-lang/rust/pull/47084
5050 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
5051 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
5052 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
5053 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
5054 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
5055 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
5056
5057
5058 Version 1.23.0 (2018-01-04)
5059 ==========================
5060
5061 Language
5062 --------
5063 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
5064 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
5065   Which should fix some confusing errors in some operations.
5066
5067 Compiler
5068 --------
5069 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
5070   undefined behavior.][45920]
5071 - [rustc now suggests renaming import if names clash.][45660]
5072 - [Display errors/warnings correctly when there are zero-width or
5073   wide characters.][45711]
5074 - [rustc now avoids unnecessary copies of arguments that are
5075   simple bindings][45380] This should improve memory usage on average by 5-10%.
5076 - [Updated musl used to build musl rustc to 1.1.17][45393]
5077
5078 Libraries
5079 ---------
5080 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
5081 - [Implement Hash for raw pointers to unsized types][45483]
5082 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
5083 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
5084 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
5085 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
5086   and `<*mut T>::as_mut`][44932]
5087 - [Optimized `Thread::{park, unpark}` implementation][45524]
5088 - [Improved `SliceExt::binary_search` performance.][45333]
5089 - [impl `FromIterator<()>` for `()`][45379]
5090 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
5091   is now deprecated.
5092
5093 Stabilized APIs
5094 ---------------
5095
5096 Cargo
5097 -----
5098 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
5099   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
5100 - [Added unit test checking to `cargo check`][cargo/4592]
5101 - [Cargo now lets you install a specific version
5102   using `cargo install --version`][cargo/4637]
5103
5104 Misc
5105 ----
5106 - [Releases now ship with the Cargo book documentation.][45692]
5107 - [rustdoc now prints rendering warnings on every run.][45324]
5108
5109 Compatibility Notes
5110 -------------------
5111 - [Changes have been made to type equality to make it more correct,
5112   in rare cases this could break some code.][45853] [Tracking issue for
5113   further information][45852]
5114 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
5115 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
5116   Android 9, the minimum supported version is Android 14.
5117 - [Bumped the minimum LLVM to 3.9][45326]
5118
5119 [44042]: https://github.com/rust-lang/rust/pull/44042
5120 [44932]: https://github.com/rust-lang/rust/pull/44932
5121 [45267]: https://github.com/rust-lang/rust/pull/45267
5122 [45324]: https://github.com/rust-lang/rust/pull/45324
5123 [45326]: https://github.com/rust-lang/rust/pull/45326
5124 [45333]: https://github.com/rust-lang/rust/pull/45333
5125 [45379]: https://github.com/rust-lang/rust/pull/45379
5126 [45380]: https://github.com/rust-lang/rust/pull/45380
5127 [45393]: https://github.com/rust-lang/rust/pull/45393
5128 [45435]: https://github.com/rust-lang/rust/pull/45435
5129 [45483]: https://github.com/rust-lang/rust/pull/45483
5130 [45524]: https://github.com/rust-lang/rust/pull/45524
5131 [45571]: https://github.com/rust-lang/rust/pull/45571
5132 [45580]: https://github.com/rust-lang/rust/pull/45580
5133 [45610]: https://github.com/rust-lang/rust/pull/45610
5134 [45660]: https://github.com/rust-lang/rust/pull/45660
5135 [45692]: https://github.com/rust-lang/rust/pull/45692
5136 [45711]: https://github.com/rust-lang/rust/pull/45711
5137 [45772]: https://github.com/rust-lang/rust/pull/45772
5138 [45852]: https://github.com/rust-lang/rust/issues/45852
5139 [45853]: https://github.com/rust-lang/rust/pull/45853
5140 [45887]: https://github.com/rust-lang/rust/pull/45887
5141 [45920]: https://github.com/rust-lang/rust/pull/45920
5142 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
5143 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
5144 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
5145
5146
5147 Version 1.22.1 (2017-11-22)
5148 ==========================
5149
5150 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
5151
5152 [46183]: https://github.com/rust-lang/rust/pull/46183
5153
5154 Version 1.22.0 (2017-11-22)
5155 ==========================
5156
5157 Language
5158 --------
5159 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
5160 - [Now accepts underscores in unicode escapes][43716]
5161 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
5162 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
5163
5164 Compiler
5165 --------
5166 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
5167 - [rustc will no longer inline in codegen units when compiling for debug][45075]
5168   This should decrease compile times for debug builds.
5169 - [strict memory alignment now enabled on ARMv6][45094]
5170 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
5171
5172 Libraries
5173 ---------
5174 - [Allow atomic operations up to 32 bits
5175   on `armv5te_unknown_linux_gnueabi`][44978]
5176 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
5177 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
5178 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
5179 - [Properly detect overflow in `Instant += Duration`.][44220]
5180 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
5181 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
5182 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
5183
5184 Stabilized APIs
5185 ---------------
5186
5187 Cargo
5188 -----
5189 - [Cargo will now build multi file examples in subdirectories of the `examples`
5190   folder that have a `main.rs` file.][cargo/4496]
5191 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
5192   the old format will continue to work and can be updated with `cargo update`.
5193 - [Now supports vendoring git repositories][cargo/3992]
5194
5195 Misc
5196 ----
5197 - [`libbacktrace` is now available on Apple platforms.][44251]
5198 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
5199   This now lets you specify that a given code example will fail to compile.
5200
5201 Compatibility Notes
5202 -------------------
5203 - [The minimum Android version that rustc can build for has been bumped
5204   to `4.0` from `2.3`][45656]
5205 - [Allowing `T op= &T` for numeric types has broken some type
5206   inference cases][45480]
5207
5208
5209 [42526]: https://github.com/rust-lang/rust/pull/42526
5210 [43716]: https://github.com/rust-lang/rust/pull/43716
5211 [43949]: https://github.com/rust-lang/rust/pull/43949
5212 [44015]: https://github.com/rust-lang/rust/pull/44015
5213 [44220]: https://github.com/rust-lang/rust/pull/44220
5214 [44251]: https://github.com/rust-lang/rust/pull/44251
5215 [44287]: https://github.com/rust-lang/rust/pull/44287
5216 [44303]: https://github.com/rust-lang/rust/pull/44303
5217 [44456]: https://github.com/rust-lang/rust/pull/44456
5218 [44466]: https://github.com/rust-lang/rust/pull/44466
5219 [44895]: https://github.com/rust-lang/rust/pull/44895
5220 [44966]: https://github.com/rust-lang/rust/pull/44966
5221 [44978]: https://github.com/rust-lang/rust/pull/44978
5222 [45041]: https://github.com/rust-lang/rust/pull/45041
5223 [45064]: https://github.com/rust-lang/rust/pull/45064
5224 [45075]: https://github.com/rust-lang/rust/pull/45075
5225 [45094]: https://github.com/rust-lang/rust/pull/45094
5226 [45095]: https://github.com/rust-lang/rust/pull/45095
5227 [45480]: https://github.com/rust-lang/rust/issues/45480
5228 [45656]: https://github.com/rust-lang/rust/pull/45656
5229 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
5230 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
5231 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
5232
5233
5234
5235
5236
5237
5238 Version 1.21.0 (2017-10-12)
5239 ==========================
5240
5241 Language
5242 --------
5243 - [You can now use static references for literals.][43838]
5244   Example:
5245   ```rust
5246   fn main() {
5247       let x: &'static u32 = &0;
5248   }
5249   ```
5250 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
5251   Example:
5252   ```rust
5253   my_macro!(Vec<i32>::new); // Always worked
5254   my_macro!(Vec::<i32>::new); // Now works
5255   ```
5256
5257 Compiler
5258 --------
5259 - [Upgraded jemalloc to 4.5.0][43911]
5260 - [Enabled unwinding panics on Redox][43917]
5261 - [Now runs LLVM in parallel during translation phase.][43506]
5262   This should reduce peak memory usage.
5263
5264 Libraries
5265 ---------
5266 - [Generate builtin impls for `Clone` for all arrays and tuples that
5267   are `T: Clone`][43690]
5268 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
5269 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
5270   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
5271
5272 Stabilized APIs
5273 ---------------
5274
5275 [`std::mem::discriminant`]
5276
5277 Cargo
5278 -----
5279 - [You can now call `cargo install` with multiple package names][cargo/4216]
5280 - [Cargo commands inside a virtual workspace will now implicitly
5281   pass `--all`][cargo/4335]
5282 - [Added a `[patch]` section to `Cargo.toml` to handle
5283   prepublication dependencies][cargo/4123] [RFC 1969]
5284 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
5285   like patterns][cargo/4270]
5286 - [Added the `--all-targets` option][cargo/4400]
5287 - [Using required dependencies as a feature is now deprecated and emits
5288   a warning][cargo/4364]
5289
5290
5291 Misc
5292 ----
5293 - [Cargo docs are moving][43916]
5294   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
5295 - [The rustdoc book is now available][43863]
5296   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
5297 - [Added a preview of RLS has been made available through rustup][44204]
5298   Install with `rustup component add rls-preview`
5299 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
5300   Previously only showed `std::os::unix`.
5301
5302 Compatibility Notes
5303 -------------------
5304 - [Changes in method matching against higher-ranked types][43880] This may cause
5305   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
5306 - [rustc's JSON error output's byte position start at top of file.][42973]
5307   Was previously relative to the rustc's internal `CodeMap` struct which
5308   required the unstable library `libsyntax` to correctly use.
5309 - [`unused_results` lint no longer ignores booleans][43728]
5310
5311 [42565]: https://github.com/rust-lang/rust/pull/42565
5312 [42973]: https://github.com/rust-lang/rust/pull/42973
5313 [43348]: https://github.com/rust-lang/rust/pull/43348
5314 [43459]: https://github.com/rust-lang/rust/pull/43459
5315 [43506]: https://github.com/rust-lang/rust/pull/43506
5316 [43540]: https://github.com/rust-lang/rust/pull/43540
5317 [43690]: https://github.com/rust-lang/rust/pull/43690
5318 [43728]: https://github.com/rust-lang/rust/pull/43728
5319 [43838]: https://github.com/rust-lang/rust/pull/43838
5320 [43863]: https://github.com/rust-lang/rust/pull/43863
5321 [43880]: https://github.com/rust-lang/rust/pull/43880
5322 [43911]: https://github.com/rust-lang/rust/pull/43911
5323 [43916]: https://github.com/rust-lang/rust/pull/43916
5324 [43917]: https://github.com/rust-lang/rust/pull/43917
5325 [44204]: https://github.com/rust-lang/rust/pull/44204
5326 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
5327 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
5328 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5329 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
5330 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
5331 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
5332 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
5333 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
5334 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
5335
5336 Version 1.20.0 (2017-08-31)
5337 ===========================
5338
5339 Language
5340 --------
5341 - [Associated constants are now stabilised.][42809]
5342 - [A lot of macro bugs are now fixed.][42913]
5343
5344 Compiler
5345 --------
5346
5347 - [Struct fields are now properly coerced to the expected field type.][42807]
5348 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
5349   `wasm32-experimental-emscripten` target.
5350 - [Changed some of the error messages to be more helpful.][42033]
5351 - [Add support for RELRO(RELocation Read-Only) for platforms that support
5352   it.][43170]
5353 - [rustc now reports the total number of errors on compilation failure][43015]
5354   previously this was only the number of errors in the pass that failed.
5355 - [Expansion in rustc has been sped up 29x.][42533]
5356 - [added `msp430-none-elf` target.][43099]
5357 - [rustc will now suggest one-argument enum variant to fix type mismatch when
5358   applicable][43178]
5359 - [Fixes backtraces on Redox][43228]
5360 - [rustc now identifies different versions of same crate when absolute paths of
5361   different types match in an error message.][42826]
5362
5363 Libraries
5364 ---------
5365
5366
5367 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
5368 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
5369   tuples.][43011]
5370 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
5371   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
5372 - [Impl `Clone` for `DefaultHasher`.][42799]
5373 - [Impl `Sync` for `SyncSender`.][42397]
5374 - [Impl `FromStr` for `char`][42271]
5375 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
5376   NaN.][42431]
5377 - [allow messages in the `unimplemented!()` macro.][42155]
5378   ie. `unimplemented!("Waiting for 1.21 to be stable")`
5379 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
5380 - [Upgrade to Unicode 10.0.0][42999]
5381 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
5382 - [Skip the main thread's manual stack guard on Linux][43072]
5383 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in *O*(1) time][43077]
5384 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
5385   previously 2^15.
5386 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
5387
5388 Stabilized APIs
5389 ---------------
5390
5391 - [`CStr::into_c_string`]
5392 - [`CString::as_c_str`]
5393 - [`CString::into_boxed_c_str`]
5394 - [`Chain::get_mut`]
5395 - [`Chain::get_ref`]
5396 - [`Chain::into_inner`]
5397 - [`Option::get_or_insert_with`]
5398 - [`Option::get_or_insert`]
5399 - [`OsStr::into_os_string`]
5400 - [`OsString::into_boxed_os_str`]
5401 - [`Take::get_mut`]
5402 - [`Take::get_ref`]
5403 - [`Utf8Error::error_len`]
5404 - [`char::EscapeDebug`]
5405 - [`char::escape_debug`]
5406 - [`compile_error!`]
5407 - [`f32::from_bits`]
5408 - [`f32::to_bits`]
5409 - [`f64::from_bits`]
5410 - [`f64::to_bits`]
5411 - [`mem::ManuallyDrop`]
5412 - [`slice::sort_unstable_by_key`]
5413 - [`slice::sort_unstable_by`]
5414 - [`slice::sort_unstable`]
5415 - [`str::from_boxed_utf8_unchecked`]
5416 - [`str::as_bytes_mut`]
5417 - [`str::as_bytes_mut`]
5418 - [`str::from_utf8_mut`]
5419 - [`str::from_utf8_unchecked_mut`]
5420 - [`str::get_mut`]
5421 - [`str::get_unchecked_mut`]
5422 - [`str::get_unchecked`]
5423 - [`str::get`]
5424 - [`str::into_boxed_bytes`]
5425
5426
5427 Cargo
5428 -----
5429 - [Cargo API token location moved from `~/.cargo/config` to
5430   `~/.cargo/credentials`.][cargo/3978]
5431 - [Cargo will now build `main.rs` binaries that are in sub-directories of
5432   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
5433   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
5434 - [You can now specify version of a binary when installed through
5435   `cargo install` using `--vers`.][cargo/4229]
5436 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
5437   failure.][cargo/4248]
5438 - [Changed the convention around which file is the crate root.][cargo/4259]
5439
5440 Compatibility Notes
5441 -------------------
5442
5443 - [Functions with `'static` in their return types will now not be as usable as
5444   if they were using lifetime parameters instead.][42417]
5445 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
5446   takes the sign of NaN into account where previously didn't.][42430]
5447
5448 [42033]: https://github.com/rust-lang/rust/pull/42033
5449 [42155]: https://github.com/rust-lang/rust/pull/42155
5450 [42271]: https://github.com/rust-lang/rust/pull/42271
5451 [42397]: https://github.com/rust-lang/rust/pull/42397
5452 [42417]: https://github.com/rust-lang/rust/pull/42417
5453 [42430]: https://github.com/rust-lang/rust/pull/42430
5454 [42431]: https://github.com/rust-lang/rust/pull/42431
5455 [42533]: https://github.com/rust-lang/rust/pull/42533
5456 [42571]: https://github.com/rust-lang/rust/pull/42571
5457 [42613]: https://github.com/rust-lang/rust/pull/42613
5458 [42799]: https://github.com/rust-lang/rust/pull/42799
5459 [42807]: https://github.com/rust-lang/rust/pull/42807
5460 [42809]: https://github.com/rust-lang/rust/pull/42809
5461 [42822]: https://github.com/rust-lang/rust/pull/42822
5462 [42826]: https://github.com/rust-lang/rust/pull/42826
5463 [42854]: https://github.com/rust-lang/rust/pull/42854
5464 [42913]: https://github.com/rust-lang/rust/pull/42913
5465 [42999]: https://github.com/rust-lang/rust/pull/42999
5466 [43011]: https://github.com/rust-lang/rust/pull/43011
5467 [43015]: https://github.com/rust-lang/rust/pull/43015
5468 [43072]: https://github.com/rust-lang/rust/pull/43072
5469 [43077]: https://github.com/rust-lang/rust/pull/43077
5470 [43097]: https://github.com/rust-lang/rust/pull/43097
5471 [43099]: https://github.com/rust-lang/rust/pull/43099
5472 [43170]: https://github.com/rust-lang/rust/pull/43170
5473 [43178]: https://github.com/rust-lang/rust/pull/43178
5474 [43185]: https://github.com/rust-lang/rust/pull/43185
5475 [43228]: https://github.com/rust-lang/rust/pull/43228
5476 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
5477 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
5478 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
5479 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
5480 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
5481 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
5482 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
5483 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
5484 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
5485 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
5486 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
5487 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
5488 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
5489 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
5490 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
5491 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
5492 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
5493 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
5494 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
5495 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
5496 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
5497 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
5498 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
5499 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
5500 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
5501 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
5502 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
5503 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
5504 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
5505 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
5506 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
5507 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
5508 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
5509 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
5510 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
5511 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
5512 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
5513 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
5514
5515
5516 Version 1.19.0 (2017-07-20)
5517 ===========================
5518
5519 Language
5520 --------
5521
5522 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
5523   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
5524 - [Macro recursion limit increased to 1024 from 64.][41676]
5525 - [Added lint for detecting unused macros.][41907]
5526 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
5527   For example: `let x = loop { break 7; };`
5528 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
5529   contain `Copy` types and cannot have a `Drop` implementation.
5530   Example: `union Foo { bar: u8, baz: usize }`
5531 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
5532   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
5533
5534 Compiler
5535 --------
5536
5537 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
5538 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
5539   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
5540   you should use `--target armv7-linux-androideabi`.
5541 - [Fixed ICE when removing a source file between compilation sessions.][41873]
5542 - [Minor optimisation of string operations.][42037]
5543 - [Compiler error message is now `aborting due to previous error(s)` instead of
5544   `aborting due to N previous errors`][42150] This was previously inaccurate and
5545   would only count certain kinds of errors.
5546 - [The compiler now supports Visual Studio 2017][42225]
5547 - [The compiler is now built against LLVM 4.0.1 by default][42948]
5548 - [Added a lot][42264] of [new error codes][42302]
5549 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
5550   libraries with C Run-time Libraries(CRT) to be statically linked.
5551 - [Fixed various ARM codegen bugs][42740]
5552
5553 Libraries
5554 ---------
5555
5556 - [`String` now implements `FromIterator<Cow<'a, str>>` and
5557   `Extend<Cow<'a, str>>`][41449]
5558 - [`Vec` now implements `From<&mut [T]>`][41530]
5559 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
5560 - [`SplitWhitespace` now implements `Clone`][41659]
5561 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
5562   1.5x faster][41764]
5563 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
5564   macros, but for printing to stderr.
5565
5566 Stabilized APIs
5567 ---------------
5568
5569 - [`OsString::shrink_to_fit`]
5570 - [`cmp::Reverse`]
5571 - [`Command::envs`]
5572 - [`thread::ThreadId`]
5573
5574 Cargo
5575 -----
5576
5577 - [Build scripts can now add environment variables to the environment
5578   the crate is being compiled in.
5579   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
5580 - [Subcommands now replace the current process rather than spawning a new
5581   child process][cargo/3970]
5582 - [Workspace members can now accept glob file patterns][cargo/3979]
5583 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
5584   the members in a given workspace.][cargo/3988]
5585 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
5586 - [Target directory path is now in the cargo metadata][cargo/4022]
5587 - [Cargo no longer checks out a local working directory for the
5588   crates.io index][cargo/4026] This should provide smaller file size for the
5589   registry, and improve cloning times, especially on Windows machines.
5590 - [Added an `--exclude` option for excluding certain packages when using the
5591   `--all` option][cargo/4031]
5592 - [Cargo will now automatically retry when receiving a 5xx error
5593   from crates.io][cargo/4032]
5594 - [The `--features` option now accepts multiple comma or space
5595   delimited values.][cargo/4084]
5596 - [Added support for custom target specific runners][cargo/3954]
5597
5598 Misc
5599 ----
5600
5601 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
5602   Windows Debugger.
5603 - [Rust will now release XZ compressed packages][rust-installer/57]
5604 - [rustup will now prefer to download rust packages with
5605   XZ compression][rustup/1100] over GZip packages.
5606 - [Added the ability to escape `#` in rust documentation][41785] By adding
5607   additional `#`'s ie. `##` is now `#`
5608
5609 Compatibility Notes
5610 -------------------
5611
5612 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
5613 - [`-Z` flags are now no longer allowed to be used on the stable
5614   compiler.][41751] This has been a warning for a year previous to this.
5615 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
5616   longer works][42844]. Users should migrate to the built-in `check`
5617   command, which has been available since 1.16.
5618 - [Ending a float literal with `._` is now a hard error.
5619   Example: `42._` .][41946]
5620 - [Any use of a private `extern crate` outside of its module is now a
5621   hard error.][36886] This was previously a warning.
5622 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
5623   relative while the `::` prefix makes a path absolute, but was ignored and the
5624   path was relative regardless.
5625 - [Floating point constants in match patterns is now a hard error][36890]
5626   This was previously a warning.
5627 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
5628   match patterns is now a hard error][36891] This was previously a warning.
5629 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
5630   a warning.
5631 - [From the pound escape, lines consisting of multiple `#`s are
5632   now visible][41785]
5633 - [It is an error to re-export private enum variants][42460]. This is
5634   known to break a number of crates that depend on an older version of
5635   mustache.
5636 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
5637   to use it to find the linker, and the build will fail where it did
5638   not previously][42607]
5639
5640 [36886]: https://github.com/rust-lang/rust/issues/36886
5641 [36888]: https://github.com/rust-lang/rust/issues/36888
5642 [36890]: https://github.com/rust-lang/rust/issues/36890
5643 [36891]: https://github.com/rust-lang/rust/issues/36891
5644 [36892]: https://github.com/rust-lang/rust/issues/36892
5645 [37406]: https://github.com/rust-lang/rust/issues/37406
5646 [39983]: https://github.com/rust-lang/rust/pull/39983
5647 [41145]: https://github.com/rust-lang/rust/pull/41145
5648 [41192]: https://github.com/rust-lang/rust/pull/41192
5649 [41258]: https://github.com/rust-lang/rust/pull/41258
5650 [41370]: https://github.com/rust-lang/rust/pull/41370
5651 [41449]: https://github.com/rust-lang/rust/pull/41449
5652 [41530]: https://github.com/rust-lang/rust/pull/41530
5653 [41624]: https://github.com/rust-lang/rust/pull/41624
5654 [41656]: https://github.com/rust-lang/rust/pull/41656
5655 [41659]: https://github.com/rust-lang/rust/pull/41659
5656 [41676]: https://github.com/rust-lang/rust/pull/41676
5657 [41751]: https://github.com/rust-lang/rust/pull/41751
5658 [41764]: https://github.com/rust-lang/rust/pull/41764
5659 [41785]: https://github.com/rust-lang/rust/pull/41785
5660 [41873]: https://github.com/rust-lang/rust/pull/41873
5661 [41907]: https://github.com/rust-lang/rust/pull/41907
5662 [41946]: https://github.com/rust-lang/rust/pull/41946
5663 [42016]: https://github.com/rust-lang/rust/pull/42016
5664 [42037]: https://github.com/rust-lang/rust/pull/42037
5665 [42068]: https://github.com/rust-lang/rust/pull/42068
5666 [42150]: https://github.com/rust-lang/rust/pull/42150
5667 [42162]: https://github.com/rust-lang/rust/pull/42162
5668 [42225]: https://github.com/rust-lang/rust/pull/42225
5669 [42264]: https://github.com/rust-lang/rust/pull/42264
5670 [42302]: https://github.com/rust-lang/rust/pull/42302
5671 [42460]: https://github.com/rust-lang/rust/issues/42460
5672 [42607]: https://github.com/rust-lang/rust/issues/42607
5673 [42740]: https://github.com/rust-lang/rust/pull/42740
5674 [42844]: https://github.com/rust-lang/rust/issues/42844
5675 [42948]: https://github.com/rust-lang/rust/pull/42948
5676 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
5677 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
5678 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
5679 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
5680 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
5681 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
5682 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
5683 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
5684 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
5685 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
5686 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
5687 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
5688 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
5689 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
5690 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
5691 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
5692 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
5693 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
5694 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
5695 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
5696 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
5697 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
5698
5699
5700 Version 1.18.0 (2017-06-08)
5701 ===========================
5702
5703 Language
5704 --------
5705
5706 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
5707   make the item visible to just that module tree. Also accepts the keyword
5708   `crate` to make something public to the whole crate but not users of the
5709   library. Example: `pub(crate) mod utils;`. [RFC 1422].
5710 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
5711   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
5712 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
5713   types like `Write + Send`, trailing `+` are now supported in trait objects,
5714   and better error reporting for trait objects starting with `?Sized`.
5715 - [0e+10 is now a valid floating point literal][40589]
5716 - [Now warns if you bind a lifetime parameter to 'static][40734]
5717 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
5718   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
5719   representation in some cases.][40377]
5720
5721 Compiler
5722 --------
5723
5724 - [rustc can now emit mir with `--emit mir`][39891]
5725 - [Improved LLVM IR for trivial functions][40367]
5726 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
5727 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
5728   opportunities found through profiling
5729 - [Improved backtrace formatting when panicking][38165]
5730
5731 Libraries
5732 ---------
5733
5734 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
5735   iterator hasn't been advanced the original `Vec` is reassembled with no actual
5736   iteration or reallocation.
5737 - [Simplified HashMap Bucket interface][40561] provides performance
5738   improvements for iterating and cloning.
5739 - [Specialize Vec::from_elem to use calloc][40409]
5740 - [Fixed Race condition in fs::create_dir_all][39799]
5741 - [No longer caching stdio on Windows][40516]
5742 - [Optimized insertion sort in slice][40807] insertion sort in some cases
5743   2.50%~ faster and in one case now 12.50% faster.
5744 - [Optimized `AtomicBool::fetch_nand`][41143]
5745
5746 Stabilized APIs
5747 ---------------
5748
5749 - [`Child::try_wait`]
5750 - [`HashMap::retain`]
5751 - [`HashSet::retain`]
5752 - [`PeekMut::pop`]
5753 - [`TcpStream::peek`]
5754 - [`UdpSocket::peek`]
5755 - [`UdpSocket::peek_from`]
5756
5757 Cargo
5758 -----
5759
5760 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
5761   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
5762 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
5763 - [Added Android build support][cargo/3885]
5764 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
5765   of a certain type, for example `cargo build --bins` will build all
5766   binaries.
5767 - [Added support for haiku][cargo/3952]
5768
5769 Misc
5770 ----
5771
5772 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
5773 - [Rust now uses the official cross compiler for NetBSD][40612]
5774 - [rustdoc now accepts `#` at the start of files][40828]
5775 - [Fixed jemalloc support for musl][41168]
5776
5777 Compatibility Notes
5778 -------------------
5779
5780 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
5781   always placed after the sign if it exists and before the digits. With the `#`
5782   flag the zeroes are placed after the prefix and before the digits.
5783 - [Due to the struct field optimisation][40377], using `transmute` on structs
5784   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
5785   always been undefined behavior, but is now more likely to break in practice.
5786 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
5787   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
5788   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
5789 - [Overlapping inherent `impl`s are now a hard error][40728]
5790 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
5791 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
5792   `out.asm` and `out.ll` instead of only one of the filetypes.
5793 - [ calling a function that returns `Self` will no longer work][41805] when
5794   the size of `Self` cannot be statically determined.
5795 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
5796   this has caused a few regressions namely:
5797
5798   - Changed the link order of local static/dynamic libraries (respecting the
5799     order on given rather than having the compiler reorder).
5800   - Changed how MinGW is linked, native code linked to dynamic libraries
5801     may require manually linking to the gcc support library (for the native
5802     code itself)
5803
5804 [38165]: https://github.com/rust-lang/rust/pull/38165
5805 [39799]: https://github.com/rust-lang/rust/pull/39799
5806 [39891]: https://github.com/rust-lang/rust/pull/39891
5807 [40043]: https://github.com/rust-lang/rust/pull/40043
5808 [40241]: https://github.com/rust-lang/rust/pull/40241
5809 [40338]: https://github.com/rust-lang/rust/pull/40338
5810 [40367]: https://github.com/rust-lang/rust/pull/40367
5811 [40377]: https://github.com/rust-lang/rust/pull/40377
5812 [40409]: https://github.com/rust-lang/rust/pull/40409
5813 [40516]: https://github.com/rust-lang/rust/pull/40516
5814 [40556]: https://github.com/rust-lang/rust/pull/40556
5815 [40561]: https://github.com/rust-lang/rust/pull/40561
5816 [40589]: https://github.com/rust-lang/rust/pull/40589
5817 [40612]: https://github.com/rust-lang/rust/pull/40612
5818 [40723]: https://github.com/rust-lang/rust/pull/40723
5819 [40728]: https://github.com/rust-lang/rust/pull/40728
5820 [40731]: https://github.com/rust-lang/rust/pull/40731
5821 [40734]: https://github.com/rust-lang/rust/pull/40734
5822 [40805]: https://github.com/rust-lang/rust/pull/40805
5823 [40807]: https://github.com/rust-lang/rust/pull/40807
5824 [40828]: https://github.com/rust-lang/rust/pull/40828
5825 [40870]: https://github.com/rust-lang/rust/pull/40870
5826 [41085]: https://github.com/rust-lang/rust/pull/41085
5827 [41143]: https://github.com/rust-lang/rust/pull/41143
5828 [41168]: https://github.com/rust-lang/rust/pull/41168
5829 [41270]: https://github.com/rust-lang/rust/issues/41270
5830 [41469]: https://github.com/rust-lang/rust/pull/41469
5831 [41805]: https://github.com/rust-lang/rust/issues/41805
5832 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
5833 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
5834 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
5835 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
5836 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
5837 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
5838 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
5839 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
5840 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
5841 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
5842 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
5843 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
5844 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
5845 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
5846
5847
5848 Version 1.17.0 (2017-04-27)
5849 ===========================
5850
5851 Language
5852 --------
5853
5854 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
5855 * [Fields of structs may be initialized without duplicating the field/variable
5856   names][39761]. [RFC 1682]
5857 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
5858 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5859   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
5860   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
5861   `'b`. Soundness fix.
5862 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
5863 * [Static variables may contain references to other statics][40027]
5864
5865 Compiler
5866 --------
5867
5868 * [Exit quickly on only `--emit dep-info`][40336]
5869 * [Make `-C relocation-model` more correctly determine whether the linker
5870   creates a position-independent executable][40245]
5871 * [Add `-C overflow-checks` to directly control whether integer overflow
5872   panics][40037]
5873 * [The rustc type checker now checks items on demand instead of in a single
5874   in-order pass][40008]. This is mostly an internal refactoring in support of
5875   future work, including incremental type checking, but also resolves [RFC
5876   1647], allowing `Self` to appear in `impl` `where` clauses.
5877 * [Optimize vtable loads][39995]
5878 * [Turn off vectorization for Emscripten targets][39990]
5879 * [Provide suggestions for unknown macros imported with `use`][39953]
5880 * [Fix ICEs in path resolution][39939]
5881 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
5882 * [Add clearer error message using `&str + &str`][39116]
5883
5884 Stabilized APIs
5885 ---------------
5886
5887 * [`Arc::into_raw`]
5888 * [`Arc::from_raw`]
5889 * [`Arc::ptr_eq`]
5890 * [`Rc::into_raw`]
5891 * [`Rc::from_raw`]
5892 * [`Rc::ptr_eq`]
5893 * [`Ordering::then`]
5894 * [`Ordering::then_with`]
5895 * [`BTreeMap::range`]
5896 * [`BTreeMap::range_mut`]
5897 * [`collections::Bound`]
5898 * [`process::abort`]
5899 * [`ptr::read_unaligned`]
5900 * [`ptr::write_unaligned`]
5901 * [`Result::expect_err`]
5902 * [`Cell::swap`]
5903 * [`Cell::replace`]
5904 * [`Cell::into_inner`]
5905 * [`Cell::take`]
5906
5907 Libraries
5908 ---------
5909
5910 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
5911 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
5912 * [`String` implements `FromIterator<&char>`][40028]
5913 * `Box` [implements][40009] a number of new conversions:
5914   `From<Box<str>> for String`,
5915   `From<Box<[T]>> for Vec<T>`,
5916   `From<Box<CStr>> for CString`,
5917   `From<Box<OsStr>> for OsString`,
5918   `From<Box<Path>> for PathBuf`,
5919   `Into<Box<str>> for String`,
5920   `Into<Box<[T]>> for Vec<T>`,
5921   `Into<Box<CStr>> for CString`,
5922   `Into<Box<OsStr>> for OsString`,
5923   `Into<Box<Path>> for PathBuf`,
5924   `Default for Box<str>`,
5925   `Default for Box<CStr>`,
5926   `Default for Box<OsStr>`,
5927   `From<&CStr> for Box<CStr>`,
5928   `From<&OsStr> for Box<OsStr>`,
5929   `From<&Path> for Box<Path>`
5930 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
5931 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
5932 * [Slightly optimize `slice::sort`][39538]
5933 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
5934 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
5935   `Box<str>` implements `From<&str>`][39438]
5936 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
5937   `From<(I, u16)> where I: Into<IpAddr>`][39372]
5938 * [`format!` estimates the needed capacity before writing a string][39356]
5939 * [Support unprivileged symlink creation in Windows][38921]
5940 * [`PathBuf` implements `Default`][38764]
5941 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
5942 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
5943   and poor hash functions.
5944
5945 Cargo
5946 -----
5947
5948 * [Add `cargo check --all`][cargo/3731]
5949 * [Add an option to ignore SSL revocation checking][cargo/3699]
5950 * [Add `cargo run --package`][cargo/3691]
5951 * [Add `required_features`][cargo/3667]
5952 * [Assume `build.rs` is a build script][cargo/3664]
5953 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
5954
5955 Misc
5956 ----
5957
5958 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
5959   `rustbook`][39633]
5960 * [The "Unstable Book" documents nightly-only features][ubook]
5961 * [Improve the style of the sidebar in rustdoc output][40265]
5962 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
5963 * [Fix MSP430 breakage due to `i128`][40257]
5964 * [Preliminary Solaris/SPARCv9 support][39903]
5965 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
5966   run without installing the MSVC runtime.
5967 * [`rustdoc --test` includes file names in test names][39788]
5968 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
5969   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
5970 * [Initial support for `aarch64-unknown-freebsd`][39491]
5971 * [Initial support for `i686-unknown-netbsd`][39426]
5972 * [This release no longer includes the old makefile build system][39431]. Rust
5973   is built with a custom build system, written in Rust, and with Cargo.
5974 * [Add Debug implementations for libcollection structs][39002]
5975 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
5976 * [`--test-threads=0` produces an error][38945]
5977 * [`rustup` installs documentation by default][40526]
5978 * [The Rust source includes NatVis visualizations][39843]. These can be used by
5979   WinDbg and Visual Studio to improve the debugging experience.
5980
5981 Compatibility Notes
5982 -------------------
5983
5984 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
5985   workaround, either use MSVC 2015 or run vcvars.bat.
5986 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5987   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
5988   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
5989   fix.
5990 * [`format!` and `Display::to_string` panic if an underlying formatting
5991   implementation returns an error][40117]. Previously the error was silently
5992   ignored. It is incorrect for `write_fmt` to return an error when writing
5993   to a string.
5994 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
5995   crates were marked stable and could be accessed from the stable toolchain.
5996 * [Rust git source no longer includes vendored crates][39728]. Those that need
5997   to build with vendored crates should build from release tarballs.
5998 * [Fix inert attributes from `proc_macro_derives`][39572]
5999 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
6000   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
6001   build system.
6002 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
6003   existing code generally ignores the type of dead-code unless a type-hint is
6004   provided; this can cause surprising inference interactions particularly around
6005   defaulting. The new code uniformly ignores the result type of dead-code.
6006 * [Tuple-struct constructors with private fields are no longer visible][38932]
6007 * [Lifetime parameters that do not appear in the arguments are now considered
6008   early-bound][38897], resolving a soundness bug (#[32330]). The
6009   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
6010   April of 2016.
6011 * [rustdoc: fix doctests with non-feature crate attributes][38161]
6012 * [Make transmuting from fn item types to pointer-sized types a hard
6013   error][34198]
6014
6015 [27787]: https://github.com/rust-lang/rust/issues/27787
6016 [32330]: https://github.com/rust-lang/rust/issues/32330
6017 [34198]: https://github.com/rust-lang/rust/pull/34198
6018 [38161]: https://github.com/rust-lang/rust/pull/38161
6019 [38368]: https://github.com/rust-lang/rust/pull/38368
6020 [38584]: https://github.com/rust-lang/rust/issues/38584
6021 [38661]: https://github.com/rust-lang/rust/pull/38661
6022 [38764]: https://github.com/rust-lang/rust/pull/38764
6023 [38864]: https://github.com/rust-lang/rust/issues/38864
6024 [38897]: https://github.com/rust-lang/rust/pull/38897
6025 [38921]: https://github.com/rust-lang/rust/pull/38921
6026 [38932]: https://github.com/rust-lang/rust/pull/38932
6027 [38945]: https://github.com/rust-lang/rust/pull/38945
6028 [38981]: https://github.com/rust-lang/rust/pull/38981
6029 [39002]: https://github.com/rust-lang/rust/pull/39002
6030 [39116]: https://github.com/rust-lang/rust/pull/39116
6031 [39193]: https://github.com/rust-lang/rust/pull/39193
6032 [39265]: https://github.com/rust-lang/rust/pull/39265
6033 [39356]: https://github.com/rust-lang/rust/pull/39356
6034 [39372]: https://github.com/rust-lang/rust/pull/39372
6035 [39426]: https://github.com/rust-lang/rust/pull/39426
6036 [39431]: https://github.com/rust-lang/rust/pull/39431
6037 [39438]: https://github.com/rust-lang/rust/pull/39438
6038 [39440]: https://github.com/rust-lang/rust/pull/39440
6039 [39485]: https://github.com/rust-lang/rust/pull/39485
6040 [39491]: https://github.com/rust-lang/rust/pull/39491
6041 [39518]: https://github.com/rust-lang/rust/pull/39518
6042 [39538]: https://github.com/rust-lang/rust/pull/39538
6043 [39572]: https://github.com/rust-lang/rust/pull/39572
6044 [39633]: https://github.com/rust-lang/rust/pull/39633
6045 [39642]: https://github.com/rust-lang/rust/pull/39642
6046 [39728]: https://github.com/rust-lang/rust/pull/39728
6047 [39761]: https://github.com/rust-lang/rust/pull/39761
6048 [39788]: https://github.com/rust-lang/rust/pull/39788
6049 [39793]: https://github.com/rust-lang/rust/pull/39793
6050 [39837]: https://github.com/rust-lang/rust/pull/39837
6051 [39843]: https://github.com/rust-lang/rust/pull/39843
6052 [39851]: https://github.com/rust-lang/rust/pull/39851
6053 [39903]: https://github.com/rust-lang/rust/pull/39903
6054 [39939]: https://github.com/rust-lang/rust/pull/39939
6055 [39953]: https://github.com/rust-lang/rust/pull/39953
6056 [39960]: https://github.com/rust-lang/rust/pull/39960
6057 [39990]: https://github.com/rust-lang/rust/pull/39990
6058 [39995]: https://github.com/rust-lang/rust/pull/39995
6059 [40008]: https://github.com/rust-lang/rust/pull/40008
6060 [40009]: https://github.com/rust-lang/rust/pull/40009
6061 [40027]: https://github.com/rust-lang/rust/pull/40027
6062 [40028]: https://github.com/rust-lang/rust/pull/40028
6063 [40037]: https://github.com/rust-lang/rust/pull/40037
6064 [40117]: https://github.com/rust-lang/rust/pull/40117
6065 [40166]: https://github.com/rust-lang/rust/pull/40166
6066 [40245]: https://github.com/rust-lang/rust/pull/40245
6067 [40257]: https://github.com/rust-lang/rust/pull/40257
6068 [40261]: https://github.com/rust-lang/rust/pull/40261
6069 [40265]: https://github.com/rust-lang/rust/pull/40265
6070 [40319]: https://github.com/rust-lang/rust/pull/40319
6071 [40336]: https://github.com/rust-lang/rust/pull/40336
6072 [40526]: https://github.com/rust-lang/rust/pull/40526
6073 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
6074 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
6075 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
6076 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
6077 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
6078 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
6079 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
6080 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
6081 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
6082 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
6083 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
6084 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
6085 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
6086 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
6087 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
6088 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
6089 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
6090 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
6091 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
6092 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
6093 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
6094 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
6095 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
6096 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
6097 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
6098 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
6099 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
6100 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
6101 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
6102 [ubook]: https://doc.rust-lang.org/unstable-book/
6103
6104
6105 Version 1.16.0 (2017-03-16)
6106 ===========================
6107
6108 Language
6109 --------
6110
6111 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6112 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6113   match patterns][38069]
6114 * [Clean up semantics of `self` in an import list][38313]
6115 * [`Self` may appear in `impl` headers][38920]
6116 * [`Self` may appear in struct expressions][39282]
6117
6118 Compiler
6119 --------
6120
6121 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
6122   a `.rmeta` file containing only crate metadata][38571]. This can be
6123   used by tools like the Rust Language Service to perform
6124   metadata-only builds.
6125 * [Levenshtein based typo suggestions now work in most places, while
6126   previously they worked only for fields and sometimes for local
6127   variables][38927]. Together with the overhaul of "no
6128   resolution"/"unexpected resolution" errors (#[38154]) they result in
6129   large and systematic improvement in resolution diagnostics.
6130 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
6131   `U`][38670]
6132 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
6133 * [`rustc` no longer attempts to provide "consider using an explicit
6134   lifetime" suggestions][37057]. They were inaccurate.
6135
6136 Stabilized APIs
6137 ---------------
6138
6139 * [`VecDeque::truncate`]
6140 * [`VecDeque::resize`]
6141 * [`String::insert_str`]
6142 * [`Duration::checked_add`]
6143 * [`Duration::checked_sub`]
6144 * [`Duration::checked_div`]
6145 * [`Duration::checked_mul`]
6146 * [`str::replacen`]
6147 * [`str::repeat`]
6148 * [`SocketAddr::is_ipv4`]
6149 * [`SocketAddr::is_ipv6`]
6150 * [`IpAddr::is_ipv4`]
6151 * [`IpAddr::is_ipv6`]
6152 * [`Vec::dedup_by`]
6153 * [`Vec::dedup_by_key`]
6154 * [`Result::unwrap_or_default`]
6155 * [`<*const T>::wrapping_offset`]
6156 * [`<*mut T>::wrapping_offset`]
6157 * `CommandExt::creation_flags`
6158 * [`File::set_permissions`]
6159 * [`String::split_off`]
6160
6161 Libraries
6162 ---------
6163
6164 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
6165   their argument by `Borrow` parameter][37761]
6166 * [All public types in std implement `Debug`][38006]
6167 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
6168 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
6169 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6170   Windows][38274]
6171 * [std: Fix partial writes in `LineWriter`][38062]
6172 * [std: Clamp max read/write sizes on Unix][38622]
6173 * [Use more specific panic message for `&str` slicing errors][38066]
6174 * [`TcpListener::set_only_v6` is deprecated][38304]. This
6175   functionality cannot be achieved in std currently.
6176 * [`writeln!`, like `println!`, now accepts a form with no string
6177   or formatting arguments, to just print a newline][38469]
6178 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
6179 * [Reduce the size of static data in `std_unicode::tables`][38781]
6180 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
6181   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
6182   `Display`][38909]
6183 * [`Duration` implements `Sum`][38712]
6184 * [`String` implements `ToSocketAddrs`][39048]
6185
6186 Cargo
6187 -----
6188
6189 * [The `cargo check` command does a type check of a project without
6190   building it][cargo/3296]
6191 * [crates.io will display CI badges from Travis and AppVeyor, if
6192   specified in Cargo.toml][cargo/3546]
6193 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
6194 * [Compilation profiles accept integer values for `debug`, in addition
6195   to `true` and `false`. These are passed to `rustc` as the value to
6196   `-C debuginfo`][cargo/3534]
6197 * [Implement `cargo --version --verbose`][cargo/3604]
6198 * [All builds now output 'dep-info' build dependencies compatible with
6199   make and ninja][cargo/3557]
6200 * [Build all workspace members with `build --all`][cargo/3511]
6201 * [Document all workspace members with `doc --all`][cargo/3515]
6202 * [Path deps outside workspace are not members][cargo/3443]
6203
6204 Misc
6205 ----
6206
6207 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
6208   the path to the Rust implementation][38589]
6209 * [The `armv7-linux-androideabi` target no longer enables NEON
6210   extensions, per Google's ABI guide][38413]
6211 * [The stock standard library can be compiled for Redox OS][38401]
6212 * [Rust has initial SPARC support][38726]. Tier 3. No builds
6213   available.
6214 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
6215   builds available.
6216 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
6217
6218 Compatibility Notes
6219 -------------------
6220
6221 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6222   match patterns][38069]
6223 * In this release, references to uninhabited types can not be
6224   pattern-matched. This was accidentally allowed in 1.15.
6225 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6226 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6227   Windows][38274]
6228 * [Clean up semantics of `self` in an import list][38313]
6229 * Reimplemented lifetime elision. This change was almost entirely compatible
6230   with existing code, but it did close a number of small bugs and loopholes,
6231   as well as being more accepting in some other [cases][41105].
6232
6233 [37057]: https://github.com/rust-lang/rust/pull/37057
6234 [37761]: https://github.com/rust-lang/rust/pull/37761
6235 [38006]: https://github.com/rust-lang/rust/pull/38006
6236 [38051]: https://github.com/rust-lang/rust/pull/38051
6237 [38062]: https://github.com/rust-lang/rust/pull/38062
6238 [38622]: https://github.com/rust-lang/rust/pull/38622
6239 [38066]: https://github.com/rust-lang/rust/pull/38066
6240 [38069]: https://github.com/rust-lang/rust/pull/38069
6241 [38131]: https://github.com/rust-lang/rust/pull/38131
6242 [38154]: https://github.com/rust-lang/rust/pull/38154
6243 [38274]: https://github.com/rust-lang/rust/pull/38274
6244 [38304]: https://github.com/rust-lang/rust/pull/38304
6245 [38313]: https://github.com/rust-lang/rust/pull/38313
6246 [38327]: https://github.com/rust-lang/rust/pull/38327
6247 [38401]: https://github.com/rust-lang/rust/pull/38401
6248 [38413]: https://github.com/rust-lang/rust/pull/38413
6249 [38469]: https://github.com/rust-lang/rust/pull/38469
6250 [38559]: https://github.com/rust-lang/rust/pull/38559
6251 [38571]: https://github.com/rust-lang/rust/pull/38571
6252 [38580]: https://github.com/rust-lang/rust/pull/38580
6253 [38589]: https://github.com/rust-lang/rust/pull/38589
6254 [38670]: https://github.com/rust-lang/rust/pull/38670
6255 [38712]: https://github.com/rust-lang/rust/pull/38712
6256 [38726]: https://github.com/rust-lang/rust/pull/38726
6257 [38781]: https://github.com/rust-lang/rust/pull/38781
6258 [38798]: https://github.com/rust-lang/rust/pull/38798
6259 [38909]: https://github.com/rust-lang/rust/pull/38909
6260 [38920]: https://github.com/rust-lang/rust/pull/38920
6261 [38927]: https://github.com/rust-lang/rust/pull/38927
6262 [39048]: https://github.com/rust-lang/rust/pull/39048
6263 [39282]: https://github.com/rust-lang/rust/pull/39282
6264 [39379]: https://github.com/rust-lang/rust/pull/39379
6265 [41105]: https://github.com/rust-lang/rust/issues/41105
6266 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6267 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6268 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
6269 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
6270 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
6271 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
6272 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
6273 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
6274 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
6275 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
6276 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
6277 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
6278 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
6279 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
6280 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
6281 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
6282 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
6283 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
6284 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
6285 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
6286 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
6287 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
6288 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
6289 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
6290 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
6291 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
6292 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
6293 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
6294 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
6295
6296
6297 Version 1.15.1 (2017-02-09)
6298 ===========================
6299
6300 * [Fix IntoIter::as_mut_slice's signature][39466]
6301 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
6302
6303 [39466]: https://github.com/rust-lang/rust/pull/39466
6304 [39523]: https://github.com/rust-lang/rust/pull/39523
6305
6306
6307 Version 1.15.0 (2017-02-02)
6308 ===========================
6309
6310 Language
6311 --------
6312
6313 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
6314   stable. This allows popular code-generating crates like Serde and Diesel to
6315   work ergonomically. [RFC 1681].
6316 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
6317   with curly braces][36868]. Part of [RFC 1506].
6318 * [A number of minor changes to name resolution have been activated][37127].
6319   They add up to more consistent semantics, allowing for future evolution of
6320   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6321   details of what is different. The breaking changes here have been transitioned
6322   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6323 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
6324   bounds][38279]
6325 * [`?Sized` can be used in `where` clauses][37791]
6326 * [There is now a limit on the size of monomorphized types and it can be
6327   modified with the `#![type_size_limit]` crate attribute, similarly to
6328   the `#![recursion_limit]` attribute][37789]
6329
6330 Compiler
6331 --------
6332
6333 * [On Windows, the compiler will apply dllimport attributes when linking to
6334   extern functions][37973]. Additional attributes and flags can control which
6335   library kind is linked and its name. [RFC 1717].
6336 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6337 * [The `--test` flag works with procedural macro crates][38107]
6338 * [Fix `extern "aapcs" fn` ABI][37814]
6339 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
6340 * [The `format!` expander recognizes incorrect `printf` and shell-style
6341   formatting directives and suggests the correct format][37613].
6342 * [Only report one error for all unused imports in an import list][37456]
6343
6344 Compiler Performance
6345 --------------------
6346
6347 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
6348 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
6349 * [Don't clone in `UnificationTable::probe`][37848]
6350 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
6351 * [Use small vectors in type walker][37760]
6352 * [Macro expansion performance was improved][37701]
6353 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
6354 * [Replace FNV with a faster hash function][37229]
6355
6356 Stabilized APIs
6357 ---------------
6358
6359 * [`std::iter::Iterator::min_by`]
6360 * [`std::iter::Iterator::max_by`]
6361 * [`std::os::*::fs::FileExt`]
6362 * [`std::sync::atomic::Atomic*::get_mut`]
6363 * [`std::sync::atomic::Atomic*::into_inner`]
6364 * [`std::vec::IntoIter::as_slice`]
6365 * [`std::vec::IntoIter::as_mut_slice`]
6366 * [`std::sync::mpsc::Receiver::try_iter`]
6367 * [`std::os::unix::process::CommandExt::before_exec`]
6368 * [`std::rc::Rc::strong_count`]
6369 * [`std::rc::Rc::weak_count`]
6370 * [`std::sync::Arc::strong_count`]
6371 * [`std::sync::Arc::weak_count`]
6372 * [`std::char::encode_utf8`]
6373 * [`std::char::encode_utf16`]
6374 * [`std::cell::Ref::clone`]
6375 * [`std::io::Take::into_inner`]
6376
6377 Libraries
6378 ---------
6379
6380 * [The standard sorting algorithm has been rewritten for dramatic performance
6381   improvements][38192]. It is a hybrid merge sort, drawing influences from
6382   Timsort. Previously it was a naive merge sort.
6383 * [`Iterator::nth` no longer has a `Sized` bound][38134]
6384 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
6385   performance.
6386 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
6387   and `char_indices().last()`][37882]
6388 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
6389 * [Chinese characters display correctly in `fmt::Debug`][37855]
6390 * [Derive `Default` for `Duration`][37699]
6391 * [Support creation of anonymous pipes on WinXP/2k][37677]
6392 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
6393 * [Don't pass overlapped handles to processes][38835]
6394
6395 Cargo
6396 -----
6397
6398 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6399   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6400   should instead check the variable at runtime with `std::env`. That the value
6401   was set at build time was a bug, and incorrect when cross-compiling. This
6402   change is known to cause breakage.
6403 * [Add `--all` flag to `cargo test`][cargo/3221]
6404 * [Compile statically against the MSVC CRT][cargo/3363]
6405 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
6406 * [Link OpenSSL statically on OSX][cargo/3311]
6407 * [Apply new fingerprinting to build dir outputs][cargo/3310]
6408 * [Test for bad path overrides with summaries][cargo/3336]
6409 * [Require `cargo install --vers` to take a semver version][cargo/3338]
6410 * [Fix retrying crate downloads for network errors][cargo/3348]
6411 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
6412 * [Emit more info on --message-format=json][cargo/3319]
6413 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
6414 * [Don't ignore errors in workspace manifest][cargo/3409]
6415 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
6416
6417 Tooling
6418 -------
6419
6420 * [Test runners (binaries built with `--test`) now support a `--list` argument
6421   that lists the tests it contains][38185]
6422 * [Test runners now support a `--exact` argument that makes the test filter
6423   match exactly, instead of matching only a substring of the test name][38181]
6424 * [rustdoc supports a `--playground-url` flag][37763]
6425 * [rustdoc provides more details about `#[should_panic]` errors][37749]
6426
6427 Misc
6428 ----
6429
6430 * [The Rust build system is now written in Rust][37817]. The Makefiles may
6431   continue to be used in this release by passing `--disable-rustbuild` to the
6432   configure script, but they will be deleted soon. Note that the new build
6433   system uses a different on-disk layout that will likely affect any scripts
6434   building Rust.
6435 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
6436   releases.
6437 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
6438 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
6439   releases.
6440
6441 Compatibility Notes
6442 -------------------
6443
6444 * [A number of minor changes to name resolution have been activated][37127].
6445   They add up to more consistent semantics, allowing for future evolution of
6446   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6447   details of what is different. The breaking changes here have been transitioned
6448   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6449 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6450   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6451   should instead check the variable at runtime with `std::env`. That the value
6452   was set at build time was a bug, and incorrect when cross-compiling. This
6453   change is known to cause breakage.
6454 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
6455   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
6456   1.10 and is now an error by default. It will become a hard error in the near
6457   future.
6458 * [The semantics relating modules to file system directories are changing in
6459   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
6460   lint, which is a warning in this release, and will become a hard error in the
6461   future.
6462 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6463 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
6464   the underlying iterator][37834]
6465
6466 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
6467 [33685]: https://github.com/rust-lang/rust/issues/33685
6468 [36868]: https://github.com/rust-lang/rust/pull/36868
6469 [37127]: https://github.com/rust-lang/rust/pull/37127
6470 [37229]: https://github.com/rust-lang/rust/pull/37229
6471 [37456]: https://github.com/rust-lang/rust/pull/37456
6472 [37527]: https://github.com/rust-lang/rust/pull/37527
6473 [37602]: https://github.com/rust-lang/rust/pull/37602
6474 [37613]: https://github.com/rust-lang/rust/pull/37613
6475 [37615]: https://github.com/rust-lang/rust/pull/37615
6476 [37636]: https://github.com/rust-lang/rust/pull/37636
6477 [37627]: https://github.com/rust-lang/rust/pull/37627
6478 [37642]: https://github.com/rust-lang/rust/pull/37642
6479 [37677]: https://github.com/rust-lang/rust/pull/37677
6480 [37699]: https://github.com/rust-lang/rust/pull/37699
6481 [37701]: https://github.com/rust-lang/rust/pull/37701
6482 [37705]: https://github.com/rust-lang/rust/pull/37705
6483 [37749]: https://github.com/rust-lang/rust/pull/37749
6484 [37760]: https://github.com/rust-lang/rust/pull/37760
6485 [37763]: https://github.com/rust-lang/rust/pull/37763
6486 [37764]: https://github.com/rust-lang/rust/pull/37764
6487 [37789]: https://github.com/rust-lang/rust/pull/37789
6488 [37791]: https://github.com/rust-lang/rust/pull/37791
6489 [37814]: https://github.com/rust-lang/rust/pull/37814
6490 [37817]: https://github.com/rust-lang/rust/pull/37817
6491 [37834]: https://github.com/rust-lang/rust/pull/37834
6492 [37848]: https://github.com/rust-lang/rust/pull/37848
6493 [37855]: https://github.com/rust-lang/rust/pull/37855
6494 [37882]: https://github.com/rust-lang/rust/pull/37882
6495 [37888]: https://github.com/rust-lang/rust/pull/37888
6496 [37973]: https://github.com/rust-lang/rust/pull/37973
6497 [37979]: https://github.com/rust-lang/rust/pull/37979
6498 [38086]: https://github.com/rust-lang/rust/pull/38086
6499 [38107]: https://github.com/rust-lang/rust/pull/38107
6500 [38117]: https://github.com/rust-lang/rust/pull/38117
6501 [38134]: https://github.com/rust-lang/rust/pull/38134
6502 [38146]: https://github.com/rust-lang/rust/pull/38146
6503 [38181]: https://github.com/rust-lang/rust/pull/38181
6504 [38182]: https://github.com/rust-lang/rust/pull/38182
6505 [38185]: https://github.com/rust-lang/rust/pull/38185
6506 [38192]: https://github.com/rust-lang/rust/pull/38192
6507 [38279]: https://github.com/rust-lang/rust/pull/38279
6508 [38835]: https://github.com/rust-lang/rust/pull/38835
6509 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6510 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
6511 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
6512 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
6513 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
6514 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
6515 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
6516 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
6517 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
6518 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
6519 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
6520 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
6521 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
6522 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
6523 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
6524 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
6525 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
6526 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
6527 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
6528 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
6529 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
6530 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
6531 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
6532 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
6533 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
6534 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
6535 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
6536 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
6537 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
6538 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
6539 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
6540 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
6541 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
6542 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
6543 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
6544 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
6545 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
6546
6547
6548 Version 1.14.0 (2016-12-22)
6549 ===========================
6550
6551 Language
6552 --------
6553
6554 * [`..` matches multiple tuple fields in enum variants, structs
6555   and tuples][36843]. [RFC 1492].
6556 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
6557 * [`use *` and `use ::*` both glob-import from the crate root][37367]
6558 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
6559   dereferencing][36822]
6560
6561 Compiler
6562 --------
6563
6564 * [Mark enums with non-zero discriminant as non-zero][37224]
6565 * [Lower-case `static mut` names are linted like other
6566   statics and consts][37162]
6567 * [Fix ICE on some macros in const integer positions
6568    (e.g. `[u8; m!()]`)][36819]
6569 * [Improve error message and snippet for "did you mean `x`"][36798]
6570 * [Add a panic-strategy field to the target specification][36794]
6571 * [Include LLVM version in `--version --verbose`][37200]
6572
6573 Compile-time Optimizations
6574 --------------------------
6575
6576 * [Improve macro expansion performance][37569]
6577 * [Shrink `Expr_::ExprInlineAsm`][37445]
6578 * [Replace all uses of SHA-256 with BLAKE2b][37439]
6579 * [Reduce the number of bytes hashed by `IchHasher`][37427]
6580 * [Avoid more allocations when compiling html5ever][37373]
6581 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
6582 * [Avoid some allocations in the macro parser][37318]
6583 * [Use a faster deflate setting][37298]
6584 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
6585   during interning of slices][37270]
6586 * [Optimize `write_metadata`][37267]
6587 * [Don't process obligation forest cycles when stalled][37231]
6588 * [Avoid many `CrateConfig` clones][37161]
6589 * [Optimize `Substs::super_fold_with`][37108]
6590 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
6591 * [Speed up `plug_leaks`][36917]
6592
6593 Libraries
6594 ---------
6595
6596 * [`println!()`, with no arguments, prints newline][36825].
6597   Previously, an empty string was required to achieve the same.
6598 * [`Wrapping` impls standard binary and unary operators, as well as
6599    the `Sum` and `Product` iterators][37356]
6600 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
6601   Vec<T>`][37326]
6602 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
6603   `VecDeque` iterators][37315]
6604 * [Improve `SipHasher` performance on small values][37312]
6605 * [Add Iterator trait TrustedLen to enable better FromIterator /
6606   Extend][37306]
6607 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
6608 * [`ReadDir` implements `Debug`][37221]
6609 * [Implement `RefUnwindSafe` for atomic types][37178]
6610 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
6611 * [Avoid allocations in `Decoder::read_str`][37064]
6612 * [`io::Error` implements `From<io::ErrorKind>`][37037]
6613 * [Impl `Debug` for raw pointers to unsized data][36880]
6614 * [Don't reuse `HashMap` random seeds][37470]
6615 * [The internal memory layout of `HashMap` is more cache-friendly, for
6616   significant improvements in some operations][36692]
6617 * [`HashMap` uses less memory on 32-bit architectures][36595]
6618 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
6619
6620 Cargo
6621 -----
6622
6623 * [Expose rustc cfg values to build scripts][cargo/3243]
6624 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
6625 * [Fix passing --features when testing multiple packages][cargo/3280]
6626 * [Use a single profile set per workspace][cargo/3249]
6627 * [Load `replace` sections from lock files][cargo/3220]
6628 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
6629
6630 Tooling
6631 -------
6632
6633 * [rustup is the recommended Rust installation method][1.14rustup]
6634 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
6635   S390x. These are [tier 2] platforms and may have major defects. Follow the
6636   instructions on the website to install, or add the targets to an existing
6637   installation with `rustup target add`. The new target triples are:
6638   - `mips-unknown-linux-gnu`
6639   - `mipsel-unknown-linux-gnu`
6640   - `mips64-unknown-linux-gnuabi64`
6641   - `mips64el-unknown-linux-gnuabi64 `
6642   - `powerpc-unknown-linux-gnu`
6643   - `powerpc64-unknown-linux-gnu`
6644   - `powerpc64le-unknown-linux-gnu`
6645   - `s390x-unknown-linux-gnu `
6646 * This release includes target (std) builds for ARM Linux running MUSL
6647   libc. These are [tier 2] platforms and may have major defects. Add the
6648   following triples to an existing rustup installation with `rustup target add`:
6649   - `arm-unknown-linux-musleabi`
6650   - `arm-unknown-linux-musleabihf`
6651   - `armv7-unknown-linux-musleabihf`
6652 * This release includes [experimental support for WebAssembly][1.14wasm], via
6653   the `wasm32-unknown-emscripten` target. This target is known to have major
6654   defects. Please test, report, and fix.
6655 * rustup no longer installs documentation by default. Run `rustup
6656   component add rust-docs` to install.
6657 * [Fix line stepping in debugger][37310]
6658 * [Enable line number debuginfo in releases][37280]
6659
6660 Misc
6661 ----
6662
6663 * [Disable jemalloc on aarch64/powerpc/mips][37392]
6664 * [Add support for Fuchsia OS][37313]
6665 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
6666
6667 Compatibility Notes
6668 -------------------
6669
6670 * [A number of forward-compatibility lints used by the compiler
6671   to gradually introduce language changes have been converted
6672   to deny by default][36894]:
6673   - ["use of inaccessible extern crate erroneously allowed"][36886]
6674   - ["type parameter default erroneously allowed in invalid location"][36887]
6675   - ["detects super or self keywords at the beginning of global path"][36888]
6676   - ["two overlapping inherent impls define an item with the same name
6677     were erroneously allowed"][36889]
6678   - ["floating-point constants cannot be used in patterns"][36890]
6679   - ["constants of struct or enum type can only be used in a pattern if
6680      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
6681   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
6682 * [Prohibit patterns in trait methods without bodies][37378]
6683 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
6684 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
6685 * [The `$crate` macro variable is accepted in fewer locations][37213]
6686 * [Impls specifying extra region requirements beyond the trait
6687   they implement are rejected][37167]
6688 * [Enums may not be unsized][37111]. Unsized enums are intended to
6689   work but never have. For now they are forbidden.
6690 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
6691
6692 [tier 2]: https://forge.rust-lang.org/platform-support.html
6693 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
6694 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
6695 [36430]: https://github.com/rust-lang/rust/pull/36430
6696 [36595]: https://github.com/rust-lang/rust/pull/36595
6697 [36692]: https://github.com/rust-lang/rust/pull/36692
6698 [36767]: https://github.com/rust-lang/rust/pull/36767
6699 [36794]: https://github.com/rust-lang/rust/pull/36794
6700 [36798]: https://github.com/rust-lang/rust/pull/36798
6701 [36819]: https://github.com/rust-lang/rust/pull/36819
6702 [36822]: https://github.com/rust-lang/rust/pull/36822
6703 [36825]: https://github.com/rust-lang/rust/pull/36825
6704 [36843]: https://github.com/rust-lang/rust/pull/36843
6705 [36880]: https://github.com/rust-lang/rust/pull/36880
6706 [36886]: https://github.com/rust-lang/rust/issues/36886
6707 [36887]: https://github.com/rust-lang/rust/issues/36887
6708 [36888]: https://github.com/rust-lang/rust/issues/36888
6709 [36889]: https://github.com/rust-lang/rust/issues/36889
6710 [36890]: https://github.com/rust-lang/rust/issues/36890
6711 [36891]: https://github.com/rust-lang/rust/issues/36891
6712 [36892]: https://github.com/rust-lang/rust/issues/36892
6713 [36894]: https://github.com/rust-lang/rust/pull/36894
6714 [36917]: https://github.com/rust-lang/rust/pull/36917
6715 [36993]: https://github.com/rust-lang/rust/pull/36993
6716 [37037]: https://github.com/rust-lang/rust/pull/37037
6717 [37064]: https://github.com/rust-lang/rust/pull/37064
6718 [37094]: https://github.com/rust-lang/rust/pull/37094
6719 [37108]: https://github.com/rust-lang/rust/pull/37108
6720 [37111]: https://github.com/rust-lang/rust/pull/37111
6721 [37161]: https://github.com/rust-lang/rust/pull/37161
6722 [37162]: https://github.com/rust-lang/rust/pull/37162
6723 [37167]: https://github.com/rust-lang/rust/pull/37167
6724 [37178]: https://github.com/rust-lang/rust/pull/37178
6725 [37200]: https://github.com/rust-lang/rust/pull/37200
6726 [37213]: https://github.com/rust-lang/rust/pull/37213
6727 [37221]: https://github.com/rust-lang/rust/pull/37221
6728 [37224]: https://github.com/rust-lang/rust/pull/37224
6729 [37230]: https://github.com/rust-lang/rust/pull/37230
6730 [37231]: https://github.com/rust-lang/rust/pull/37231
6731 [37247]: https://github.com/rust-lang/rust/pull/37247
6732 [37267]: https://github.com/rust-lang/rust/pull/37267
6733 [37270]: https://github.com/rust-lang/rust/pull/37270
6734 [37273]: https://github.com/rust-lang/rust/pull/37273
6735 [37280]: https://github.com/rust-lang/rust/pull/37280
6736 [37298]: https://github.com/rust-lang/rust/pull/37298
6737 [37306]: https://github.com/rust-lang/rust/pull/37306
6738 [37310]: https://github.com/rust-lang/rust/pull/37310
6739 [37312]: https://github.com/rust-lang/rust/pull/37312
6740 [37313]: https://github.com/rust-lang/rust/pull/37313
6741 [37315]: https://github.com/rust-lang/rust/pull/37315
6742 [37318]: https://github.com/rust-lang/rust/pull/37318
6743 [37322]: https://github.com/rust-lang/rust/pull/37322
6744 [37326]: https://github.com/rust-lang/rust/pull/37326
6745 [37351]: https://github.com/rust-lang/rust/pull/37351
6746 [37356]: https://github.com/rust-lang/rust/pull/37356
6747 [37367]: https://github.com/rust-lang/rust/pull/37367
6748 [37373]: https://github.com/rust-lang/rust/pull/37373
6749 [37378]: https://github.com/rust-lang/rust/pull/37378
6750 [37389]: https://github.com/rust-lang/rust/pull/37389
6751 [37392]: https://github.com/rust-lang/rust/pull/37392
6752 [37427]: https://github.com/rust-lang/rust/pull/37427
6753 [37439]: https://github.com/rust-lang/rust/pull/37439
6754 [37445]: https://github.com/rust-lang/rust/pull/37445
6755 [37470]: https://github.com/rust-lang/rust/pull/37470
6756 [37569]: https://github.com/rust-lang/rust/pull/37569
6757 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6758 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
6759 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
6760 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
6761 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
6762 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
6763 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
6764
6765
6766 Version 1.13.0 (2016-11-10)
6767 ===========================
6768
6769 Language
6770 --------
6771
6772 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
6773   errors, like the `try!` macro, described in [RFC 0243].
6774 * [Stabilize macros in type position][36014]. Described in [RFC 873].
6775 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
6776 * [Fix `#[derive]` for empty tuple structs/variants][35728]
6777 * [Fix lifetime rules for 'if' conditions][36029]
6778 * [Avoid loading and parsing unconfigured non-inline modules][36482]
6779
6780 Compiler
6781 --------
6782
6783 * [Add the `-C link-arg` argument][36574]
6784 * [Remove the old AST-based backend from rustc_trans][35764]
6785 * [Don't enable NEON by default on armv7 Linux][35814]
6786 * [Fix debug line number info for macro expansions][35238]
6787 * [Do not emit "class method" debuginfo for types that are not
6788   DICompositeType][36008]
6789 * [Warn about multiple conflicting #[repr] hints][34623]
6790 * [When sizing DST, don't double-count nested struct prefixes][36351]
6791 * [Default RUST_MIN_STACK to 16MiB for now][36505]
6792 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
6793 * [Reject macros with empty repetitions to avoid infinite loop][36721]
6794 * [Expand macros without recursing to avoid stack overflows][36214]
6795
6796 Diagnostics
6797 -----------
6798
6799 * [Replace macro backtraces with labeled local uses][35702]
6800 * [Improve error message for misplaced doc comments][33922]
6801 * [Buffer unix and lock windows to prevent message interleaving][35975]
6802 * [Update lifetime errors to specifically note temporaries][36171]
6803 * [Special case a few colors for Windows][36178]
6804 * [Suggest `use self` when such an import resolves][36289]
6805 * [Be more specific when type parameter shadows primitive type][36338]
6806 * Many minor improvements
6807
6808 Compile-time Optimizations
6809 --------------------------
6810
6811 * [Compute and cache HIR hashes at beginning][35854]
6812 * [Don't hash types in loan paths][36004]
6813 * [Cache projections in trans][35761]
6814 * [Optimize the parser's last token handling][36527]
6815 * [Only instantiate #[inline] functions in codegen units referencing
6816   them][36524]. This leads to big improvements in cases where crates export
6817   define many inline functions without using them directly.
6818 * [Lazily allocate TypedArena's first chunk][36592]
6819 * [Don't allocate during default HashSet creation][36734]
6820
6821 Stabilized APIs
6822 ---------------
6823
6824 * [`checked_abs`]
6825 * [`wrapping_abs`]
6826 * [`overflowing_abs`]
6827 * [`RefCell::try_borrow`]
6828 * [`RefCell::try_borrow_mut`]
6829
6830 Libraries
6831 ---------
6832
6833 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
6834 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
6835   covariant][35354]
6836 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
6837 * [Implement `Debug` for `std::vec::IntoIter`][35707]
6838 * [`CString`: avoid excessive growth just to 0-terminate][35871]
6839 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
6840 * [Use arc4rand on FreeBSD][35884]
6841 * [memrchr: Correct aligned offset computation][35969]
6842 * [Improve Demangling of Rust Symbols][36059]
6843 * [Use monotonic time in condition variables][35048]
6844 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
6845 * [Implement conversion traits for `char`][35755]
6846 * [Fix illegal instruction caused by overflow in channel cloning][36104]
6847 * [Zero first byte of CString on drop][36264]
6848 * [Inherit overflow checks for sum and product][36372]
6849 * [Add missing Eq implementations][36423]
6850 * [Implement `Debug` for `DirEntry`][36631]
6851 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
6852   `errno`][36754]
6853 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6854 * [Implement more traits for `std::io::ErrorKind`][35911]
6855 * [Optimize BinaryHeap bounds checking][36072]
6856 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
6857   `extend_with_element`][36355]
6858 * [Fix overflow checking in unsigned pow()][34942]
6859
6860 Cargo
6861 -----
6862
6863 * This release includes security fixes to both curl and OpenSSL.
6864 * [Fix transitive doctests when panic=abort][cargo/3021]
6865 * [Add --all-features flag to cargo][cargo/3038]
6866 * [Reject path-based dependencies in `cargo package`][cargo/3060]
6867 * [Don't parse the home directory more than once][cargo/3078]
6868 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
6869 * [Update OpenSSL to 1.0.2j][cargo/3121]
6870 * [Add license and license_file to cargo metadata output][cargo/3110]
6871 * [Make crates-io registry URL optional in config; ignore all changes to
6872   source.crates-io][cargo/3089]
6873 * [Don't download dependencies from other platforms][cargo/3123]
6874 * [Build transitive dev-dependencies when needed][cargo/3125]
6875 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
6876 * [Avoid updating registry when adding existing deps][cargo/3144]
6877 * [Warn about path overrides that won't work][cargo/3136]
6878 * [Use workspaces during `cargo install`][cargo/3146]
6879 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
6880 * [Add --message-format flag][cargo/3000]
6881 * [Pass target environment for rustdoc][cargo/3205]
6882 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
6883 * [Update curl and curl-sys][cargo/3241]
6884 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
6885
6886 Tooling
6887 -------
6888
6889 * [rustdoc: Add the `--sysroot` argument][36586]
6890 * [rustdoc: Fix a couple of issues with the search results][35655]
6891 * [rustdoc: remove the `!` from macro URLs and titles][35234]
6892 * [gdb: Fix pretty-printing special-cased Rust types][35585]
6893 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
6894
6895 Misc
6896 ----
6897
6898 * [Remove unmaintained style guide][35124]
6899 * [Add s390x support][36369]
6900 * [Initial work at Haiku OS support][36727]
6901 * [Add mips-uclibc targets][35734]
6902 * [Crate-ify compiler-rt into compiler-builtins][35021]
6903 * [Add rustc version info (git hash + date) to dist tarball][36213]
6904 * Many documentation improvements
6905
6906 Compatibility Notes
6907 -------------------
6908
6909 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6910 * [Deny (by default) transmuting from fn item types to pointer-sized
6911   types][34923]. Continuing the long transition to zero-sized fn items,
6912   per [RFC 401].
6913 * [Fix `#[derive]` for empty tuple structs/variants][35728].
6914   Part of [RFC 1506].
6915 * [Issue deprecation warnings for safe accesses to extern statics][36173]
6916 * [Fix lifetime rules for 'if' conditions][36029].
6917 * [Inherit overflow checks for sum and product][36372].
6918 * [Forbid user-defined macros named "macro_rules"][36730].
6919
6920 [33922]: https://github.com/rust-lang/rust/pull/33922
6921 [34623]: https://github.com/rust-lang/rust/pull/34623
6922 [34923]: https://github.com/rust-lang/rust/pull/34923
6923 [34942]: https://github.com/rust-lang/rust/pull/34942
6924 [35021]: https://github.com/rust-lang/rust/pull/35021
6925 [35048]: https://github.com/rust-lang/rust/pull/35048
6926 [35074]: https://github.com/rust-lang/rust/pull/35074
6927 [35124]: https://github.com/rust-lang/rust/pull/35124
6928 [35234]: https://github.com/rust-lang/rust/pull/35234
6929 [35238]: https://github.com/rust-lang/rust/pull/35238
6930 [35354]: https://github.com/rust-lang/rust/pull/35354
6931 [35559]: https://github.com/rust-lang/rust/pull/35559
6932 [35585]: https://github.com/rust-lang/rust/pull/35585
6933 [35627]: https://github.com/rust-lang/rust/pull/35627
6934 [35655]: https://github.com/rust-lang/rust/pull/35655
6935 [35702]: https://github.com/rust-lang/rust/pull/35702
6936 [35707]: https://github.com/rust-lang/rust/pull/35707
6937 [35728]: https://github.com/rust-lang/rust/pull/35728
6938 [35734]: https://github.com/rust-lang/rust/pull/35734
6939 [35755]: https://github.com/rust-lang/rust/pull/35755
6940 [35761]: https://github.com/rust-lang/rust/pull/35761
6941 [35764]: https://github.com/rust-lang/rust/pull/35764
6942 [35814]: https://github.com/rust-lang/rust/pull/35814
6943 [35854]: https://github.com/rust-lang/rust/pull/35854
6944 [35871]: https://github.com/rust-lang/rust/pull/35871
6945 [35884]: https://github.com/rust-lang/rust/pull/35884
6946 [35911]: https://github.com/rust-lang/rust/pull/35911
6947 [35969]: https://github.com/rust-lang/rust/pull/35969
6948 [35975]: https://github.com/rust-lang/rust/pull/35975
6949 [36004]: https://github.com/rust-lang/rust/pull/36004
6950 [36008]: https://github.com/rust-lang/rust/pull/36008
6951 [36014]: https://github.com/rust-lang/rust/pull/36014
6952 [36029]: https://github.com/rust-lang/rust/pull/36029
6953 [36059]: https://github.com/rust-lang/rust/pull/36059
6954 [36072]: https://github.com/rust-lang/rust/pull/36072
6955 [36101]: https://github.com/rust-lang/rust/pull/36101
6956 [36104]: https://github.com/rust-lang/rust/pull/36104
6957 [36171]: https://github.com/rust-lang/rust/pull/36171
6958 [36173]: https://github.com/rust-lang/rust/pull/36173
6959 [36178]: https://github.com/rust-lang/rust/pull/36178
6960 [36213]: https://github.com/rust-lang/rust/pull/36213
6961 [36214]: https://github.com/rust-lang/rust/pull/36214
6962 [36264]: https://github.com/rust-lang/rust/pull/36264
6963 [36266]: https://github.com/rust-lang/rust/pull/36266
6964 [36289]: https://github.com/rust-lang/rust/pull/36289
6965 [36338]: https://github.com/rust-lang/rust/pull/36338
6966 [36351]: https://github.com/rust-lang/rust/pull/36351
6967 [36355]: https://github.com/rust-lang/rust/pull/36355
6968 [36369]: https://github.com/rust-lang/rust/pull/36369
6969 [36372]: https://github.com/rust-lang/rust/pull/36372
6970 [36423]: https://github.com/rust-lang/rust/pull/36423
6971 [36482]: https://github.com/rust-lang/rust/pull/36482
6972 [36505]: https://github.com/rust-lang/rust/pull/36505
6973 [36524]: https://github.com/rust-lang/rust/pull/36524
6974 [36527]: https://github.com/rust-lang/rust/pull/36527
6975 [36551]: https://github.com/rust-lang/rust/pull/36551
6976 [36574]: https://github.com/rust-lang/rust/pull/36574
6977 [36586]: https://github.com/rust-lang/rust/pull/36586
6978 [36592]: https://github.com/rust-lang/rust/pull/36592
6979 [36631]: https://github.com/rust-lang/rust/pull/36631
6980 [36721]: https://github.com/rust-lang/rust/pull/36721
6981 [36727]: https://github.com/rust-lang/rust/pull/36727
6982 [36730]: https://github.com/rust-lang/rust/pull/36730
6983 [36734]: https://github.com/rust-lang/rust/pull/36734
6984 [36754]: https://github.com/rust-lang/rust/pull/36754
6985 [36995]: https://github.com/rust-lang/rust/pull/36995
6986 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
6987 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
6988 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6989 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
6990 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
6991 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
6992 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
6993 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
6994 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
6995 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
6996 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
6997 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
6998 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
6999 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
7000 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
7001 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
7002 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
7003 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
7004 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
7005 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
7006 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
7007 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
7008 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
7009 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
7010 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
7011 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
7012 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
7013 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
7014 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
7015 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
7016 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
7017 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
7018
7019
7020 Version 1.12.1 (2016-10-20)
7021 ===========================
7022
7023 Regression Fixes
7024 ----------------
7025
7026 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
7027 * [Confusion with double negation and booleans][36856]
7028 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
7029 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
7030 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
7031 * [Corrupted memory after updated to 1.12][36936]
7032 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
7033 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
7034 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
7035
7036 [36381]: https://github.com/rust-lang/rust/issues/36381
7037 [36856]: https://github.com/rust-lang/rust/issues/36856
7038 [36875]: https://github.com/rust-lang/rust/issues/36875
7039 [36924]: https://github.com/rust-lang/rust/issues/36924
7040 [36926]: https://github.com/rust-lang/rust/issues/36926
7041 [36936]: https://github.com/rust-lang/rust/issues/36936
7042 [37026]: https://github.com/rust-lang/rust/issues/37026
7043 [37112]: https://github.com/rust-lang/rust/issues/37112
7044 [37153]: https://github.com/rust-lang/rust/issues/37153
7045
7046
7047 Version 1.12.0 (2016-09-29)
7048 ===========================
7049
7050 Highlights
7051 ----------
7052
7053 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
7054   This translation pass is far simpler than the previous AST->LLVM pass, and
7055   creates opportunities to perform new optimizations directly on the MIR. It
7056   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
7057 * [`rustc` presents a new, more readable error format, along with
7058   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
7059   Most common editors supporting Rust have been updated to work with it. It was
7060   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
7061
7062 Compiler
7063 --------
7064
7065 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
7066   This translation pass is far simpler than the previous AST->LLVM pass, and
7067   creates opportunities to perform new optimizations directly on the MIR. It
7068   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
7069 * [Print the Rust target name, not the LLVM target name, with
7070   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
7071 * [The computation of `TypeId` is correct in some cases where it was previously
7072   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
7073 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
7074 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
7075   `--print relocation-models`, and `--print code-models` print the available
7076   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
7077   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
7078 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
7079   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
7080   These targets produce statically-linked binaries. There are no binary release
7081   builds yet though.
7082
7083 Diagnostics
7084 -----------
7085
7086 * [`rustc` presents a new, more readable error format, along with
7087   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
7088   Most common editors supporting Rust have been updated to work with it. It was
7089   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
7090 * [In error descriptions, references are now described in plain English,
7091   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
7092 * [In error type descriptions, unknown numeric types are named `{integer}` or
7093   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
7094 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
7095
7096 Language
7097 --------
7098
7099 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
7100 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
7101 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
7102   useful](https://github.com/rust-lang/rust/pull/34908)
7103 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
7104   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
7105 * [Semicolons are properly required as statement delimiters inside
7106   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
7107 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
7108
7109 Stabilized APIs
7110 ---------------
7111
7112 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
7113 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
7114 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
7115 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
7116 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
7117 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
7118 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
7119 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
7120 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
7121 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
7122   Both on Unix and Windows.
7123 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
7124 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
7125 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
7126 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
7127 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
7128 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
7129 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
7130 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
7131
7132 Libraries
7133 ---------
7134
7135 * [The `format!` macro and friends now allow a single argument to be formatted
7136   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
7137 * [The lifetime bounds on `[T]::binary_search_by` and
7138   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
7139 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
7140 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
7141 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
7142 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
7143 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
7144 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
7145 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
7146 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
7147   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
7148 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
7149   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
7150 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
7151 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
7152   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
7153 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
7154 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
7155 * [`mpsc::sync_channel` `Receiver`s return any available message before
7156   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
7157 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
7158 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
7159
7160 Cargo
7161 -----
7162
7163 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
7164 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
7165 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
7166 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
7167 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
7168 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
7169 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
7170 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
7171 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
7172 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
7173 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
7174 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
7175 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
7176 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
7177 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
7178 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
7179
7180 Performance
7181 -----------
7182
7183 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
7184 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
7185
7186 Tooling
7187 -------
7188
7189 * [Test binaries now support a `--test-threads` argument to specify the number
7190   of threads used to run tests, and which acts the same as the
7191   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
7192 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
7193 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
7194 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7195 * [Rust releases now come with source packages that can be installed by rustup
7196   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
7197   The resulting source code can be used by tools and IDES, located in the
7198   sysroot under `lib/rustlib/src`.
7199
7200 Misc
7201 ----
7202
7203 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
7204 * Many minor improvements to the documentation.
7205 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
7206
7207 Compatibility Notes
7208 -------------------
7209
7210 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
7211   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
7212 * [When formatting strings, if "precision" is specified, the "fill",
7213   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
7214 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
7215
7216
7217 Version 1.11.0 (2016-08-18)
7218 ===========================
7219
7220 Language
7221 --------
7222
7223 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
7224 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
7225 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
7226 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
7227
7228 Stabilized APIs
7229 ---------------
7230
7231 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
7232 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
7233 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
7234 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
7235 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
7236 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
7237   (in libcore - previously stabilized in libstd)
7238 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
7239   (in libcore - previously stabilized in libstd)
7240 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
7241   (in libcore - previously stabilized in libstd)
7242 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
7243   (in libcore - previously stabilized in libstd)
7244 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7245 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7246 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
7247 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
7248
7249 Libraries
7250 ---------
7251
7252 * [The `thread_local!` macro supports multiple definitions in a single
7253    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
7254 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
7255 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
7256   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
7257 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
7258 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
7259 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
7260 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
7261
7262 Cargo
7263 -----
7264
7265 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
7266 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
7267 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
7268 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
7269 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
7270   and `-vv` prints warnings for all crates.
7271 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
7272 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
7273   This provides room for expansion by arbitrary tools.
7274 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
7275 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
7276 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
7277 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
7278 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
7279 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
7280 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
7281
7282 Performance
7283 -----------
7284
7285 * [Caching projections speeds up type check dramatically for some
7286   workloads](https://github.com/rust-lang/rust/pull/33816)
7287 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
7288   This hasher is faster, but is believed to provide sufficient
7289   protection from collision attacks.
7290 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
7291
7292 Rustdoc
7293 -------
7294
7295 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
7296 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
7297 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
7298 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
7299 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
7300
7301 Tooling
7302 -------
7303
7304 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
7305 * [When emitting debug info, rustc emits frame pointers for closures,
7306   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
7307 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7308 * Many more errors have been given error codes and extended
7309   explanations
7310 * API documentation continues to be improved, with many new examples
7311
7312 Misc
7313 ----
7314
7315 * [rustc no longer hangs when dependencies recursively re-export
7316   submodules](https://github.com/rust-lang/rust/pull/34542)
7317 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
7318 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
7319   rewritten](https://github.com/rust-lang/rust/pull/33895)
7320 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
7321   No targets use this yet, but it works toward AVR support.
7322
7323 Compatibility Notes
7324 -------------------
7325
7326 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
7327 * [The new follow-set rules that place restrictions on `macro_rules!`
7328   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
7329   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
7330   and has been a warning since 1.10.
7331 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
7332   This causes breakage in some corner cases.
7333
7334
7335 Version 1.10.0 (2016-07-07)
7336 ===========================
7337
7338 Language
7339 --------
7340
7341 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
7342   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
7343 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
7344 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
7345 * [`panic!` can be converted to a runtime abort with the
7346   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
7347   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7348 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
7349   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
7350   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
7351   Note that Cargo does not yet directly support cdylibs.
7352
7353 Stabilized APIs
7354 ---------------
7355
7356 * `os::windows::fs::OpenOptionsExt::access_mode`
7357 * `os::windows::fs::OpenOptionsExt::share_mode`
7358 * `os::windows::fs::OpenOptionsExt::custom_flags`
7359 * `os::windows::fs::OpenOptionsExt::attributes`
7360 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
7361 * `os::unix::fs::OpenOptionsExt::custom_flags`
7362 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
7363 * `Default for sync::Weak`
7364 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
7365 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
7366 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
7367 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
7368 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
7369 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
7370 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
7371 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
7372 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
7373 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
7374 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
7375 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
7376 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
7377 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
7378 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
7379 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
7380 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
7381 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
7382 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
7383 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
7384 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
7385 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
7386 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
7387 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
7388 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
7389 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7390 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7391 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7392 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7393 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
7394 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
7395 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
7396 * Read/Write/RawFd impls for `UnixStream`
7397 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
7398 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
7399 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
7400 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
7401 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
7402 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
7403 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
7404 * RawFd impls for `UnixListener`
7405 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
7406 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
7407 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
7408 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
7409 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
7410 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
7411 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
7412 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
7413 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
7414 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
7415 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
7416 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
7417 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
7418 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
7419 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
7420 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
7421 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
7422 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
7423 * RawFd impls for `UnixDatagram`
7424 * `{BTree,Hash}Map::values_mut`
7425 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
7426
7427 Libraries
7428 ---------
7429
7430 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
7431   The semantics of this minor method are subtle and probably not what
7432   most people want.
7433 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
7434 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
7435   will fall back to `/dev/urandom` temporarily to avoid blocking
7436   during early boot](https://github.com/rust-lang/rust/pull/33086).
7437 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
7438 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
7439 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
7440 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
7441 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
7442 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
7443   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
7444
7445 Cargo
7446 -----
7447 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
7448   This controls the runtime behavior of the `panic!` macro
7449   and can be either "unwind" (the default), or "abort".
7450   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7451 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
7452 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
7453 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
7454   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
7455 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
7456 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
7457 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
7458   By default they are retried twice, which can be customized with the
7459   `net.retry` value in `.cargo/config`.
7460 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
7461 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
7462 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
7463 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
7464   Makes it possible to install multiple crates in parallel.
7465 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
7466 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
7467 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
7468 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
7469 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
7470 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
7471
7472 Performance
7473 -----------
7474
7475 * [rustc memory usage was reduced by refactoring the context used for
7476   type checking](https://github.com/rust-lang/rust/pull/33425).
7477 * [Speed up creation of `HashMap`s by caching the random keys used
7478   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
7479 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
7480 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
7481 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
7482   10x faster than the previous lookup tables.
7483 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
7484
7485 Usability
7486 ---------
7487
7488 * Many incremental improvements to documentation and rustdoc.
7489 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
7490 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
7491 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
7492 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
7493 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
7494 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
7495 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
7496
7497 Misc
7498 ----
7499
7500 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
7501 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
7502 * [`std` no longer prints backtraces on platforms where the running
7503   module must be loaded with `env::current_exe`, which can't be relied
7504   on](https://github.com/rust-lang/rust/pull/33554).
7505 * This release includes std binaries for the i586-unknown-linux-gnu,
7506   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
7507   i586 target is for old x86 hardware without SSE2, and the armv7
7508   target is for Android running on modern ARM architectures.
7509 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
7510   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
7511 * [On Unix the runtime aborts by calling `libc::abort` instead of
7512   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
7513 * [Rust is now bootstrapped from the previous release of Rust,
7514   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
7515
7516 Compatibility Notes
7517 -------------------
7518
7519 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
7520 * [`target_env` for Linux ARM targets is just `gnu`, not
7521   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
7522 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
7523 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
7524 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
7525   Affects how macros are parsed.
7526 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
7527 * [Feature-gated attributes on macro-generated macro invocations are
7528   now rejected](https://github.com/rust-lang/rust/pull/32791).
7529 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
7530   This caused some minor changes to type inference.
7531
7532
7533 Version 1.9.0 (2016-05-26)
7534 ==========================
7535
7536 Language
7537 --------
7538
7539 * The `#[deprecated]` attribute when applied to an API will generate
7540   warnings when used. The warnings may be suppressed with
7541   `#[allow(deprecated)]`. [RFC 1270].
7542 * [`fn` item types are zero sized, and each `fn` names a unique
7543   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7544   `transmute` on a `fn` type will generate a warning for a few cycles,
7545   then will be converted to an error.
7546 * [Field and method resolution understand visibility, so private
7547   fields and methods cannot prevent the proper use of public fields
7548   and methods][1.9fv].
7549 * [The parser considers unicode codepoints in the
7550   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
7551
7552 Stabilized APIs
7553 ---------------
7554
7555 * [`std::panic`]
7556 * [`std::panic::catch_unwind`] (renamed from `recover`)
7557 * [`std::panic::resume_unwind`] (renamed from `propagate`)
7558 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
7559 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
7560 * [`str::is_char_boundary`]
7561 * [`<*const T>::as_ref`]
7562 * [`<*mut T>::as_ref`]
7563 * [`<*mut T>::as_mut`]
7564 * [`AsciiExt::make_ascii_uppercase`]
7565 * [`AsciiExt::make_ascii_lowercase`]
7566 * [`char::decode_utf16`]
7567 * [`char::DecodeUtf16`]
7568 * [`char::DecodeUtf16Error`]
7569 * [`char::DecodeUtf16Error::unpaired_surrogate`]
7570 * [`BTreeSet::take`]
7571 * [`BTreeSet::replace`]
7572 * [`BTreeSet::get`]
7573 * [`HashSet::take`]
7574 * [`HashSet::replace`]
7575 * [`HashSet::get`]
7576 * [`OsString::with_capacity`]
7577 * [`OsString::clear`]
7578 * [`OsString::capacity`]
7579 * [`OsString::reserve`]
7580 * [`OsString::reserve_exact`]
7581 * [`OsStr::is_empty`]
7582 * [`OsStr::len`]
7583 * [`std::os::unix::thread`]
7584 * [`RawPthread`]
7585 * [`JoinHandleExt`]
7586 * [`JoinHandleExt::as_pthread_t`]
7587 * [`JoinHandleExt::into_pthread_t`]
7588 * [`HashSet::hasher`]
7589 * [`HashMap::hasher`]
7590 * [`CommandExt::exec`]
7591 * [`File::try_clone`]
7592 * [`SocketAddr::set_ip`]
7593 * [`SocketAddr::set_port`]
7594 * [`SocketAddrV4::set_ip`]
7595 * [`SocketAddrV4::set_port`]
7596 * [`SocketAddrV6::set_ip`]
7597 * [`SocketAddrV6::set_port`]
7598 * [`SocketAddrV6::set_flowinfo`]
7599 * [`SocketAddrV6::set_scope_id`]
7600 * [`slice::copy_from_slice`]
7601 * [`ptr::read_volatile`]
7602 * [`ptr::write_volatile`]
7603 * [`OpenOptions::create_new`]
7604 * [`TcpStream::set_nodelay`]
7605 * [`TcpStream::nodelay`]
7606 * [`TcpStream::set_ttl`]
7607 * [`TcpStream::ttl`]
7608 * [`TcpStream::set_only_v6`]
7609 * [`TcpStream::only_v6`]
7610 * [`TcpStream::take_error`]
7611 * [`TcpStream::set_nonblocking`]
7612 * [`TcpListener::set_ttl`]
7613 * [`TcpListener::ttl`]
7614 * [`TcpListener::set_only_v6`]
7615 * [`TcpListener::only_v6`]
7616 * [`TcpListener::take_error`]
7617 * [`TcpListener::set_nonblocking`]
7618 * [`UdpSocket::set_broadcast`]
7619 * [`UdpSocket::broadcast`]
7620 * [`UdpSocket::set_multicast_loop_v4`]
7621 * [`UdpSocket::multicast_loop_v4`]
7622 * [`UdpSocket::set_multicast_ttl_v4`]
7623 * [`UdpSocket::multicast_ttl_v4`]
7624 * [`UdpSocket::set_multicast_loop_v6`]
7625 * [`UdpSocket::multicast_loop_v6`]
7626 * [`UdpSocket::set_multicast_ttl_v6`]
7627 * [`UdpSocket::multicast_ttl_v6`]
7628 * [`UdpSocket::set_ttl`]
7629 * [`UdpSocket::ttl`]
7630 * [`UdpSocket::set_only_v6`]
7631 * [`UdpSocket::only_v6`]
7632 * [`UdpSocket::join_multicast_v4`]
7633 * [`UdpSocket::join_multicast_v6`]
7634 * [`UdpSocket::leave_multicast_v4`]
7635 * [`UdpSocket::leave_multicast_v6`]
7636 * [`UdpSocket::take_error`]
7637 * [`UdpSocket::connect`]
7638 * [`UdpSocket::send`]
7639 * [`UdpSocket::recv`]
7640 * [`UdpSocket::set_nonblocking`]
7641
7642 Libraries
7643 ---------
7644
7645 * [`std::sync::Once` is poisoned if its initialization function
7646   fails][1.9o].
7647 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
7648 * [Most types implement `fmt::Debug`][1.9db].
7649 * [The default buffer size used by `BufReader` and `BufWriter` was
7650   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
7651   used by other languages.
7652 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
7653   `Duration` additionally implements `*=` and `/=`][1.9ta].
7654 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
7655 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
7656 * [`Chain` implements `BufRead`][1.9ch].
7657 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
7658
7659 Cargo
7660 -----
7661
7662 * [Cargo can now run concurrently][1.9cc].
7663 * [Top-level overrides allow specific revisions of crates to be
7664   overridden through the entire crate graph][1.9ct].  This is intended
7665   to make upgrades easier for large projects, by allowing crates to be
7666   forked temporarily until they've been upgraded and republished.
7667 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
7668 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
7669   on the commandline][1.9cf]. `rustc` arguments can also be specified
7670   in the `build.rustflags` configuration key.
7671
7672 Performance
7673 -----------
7674
7675 * [The time complexity of comparing variables for equivalence during type
7676   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
7677   to major compilation time improvement in some scenarios.
7678 * [`ToString` is specialized for `str`, giving it the same performance
7679   as `to_owned`][1.9ts].
7680 * [Spawning processes with `Command::output` no longer creates extra
7681   threads][1.9sp].
7682 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
7683   for C-like enums][1.9cl].
7684
7685 Misc
7686 ----
7687
7688 * [Passing the `--quiet` flag to a test runner will produce
7689   much-abbreviated output][1.9q].
7690 * The Rust Project now publishes std binaries for the
7691   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
7692   `i586-pc-windows-msvc` targets.
7693
7694 Compatibility Notes
7695 -------------------
7696
7697 * [`std::sync::Once` is poisoned if its initialization function
7698   fails][1.9o].
7699 * [It is illegal to define methods with the same name in overlapping
7700   inherent `impl` blocks][1.9sn].
7701 * [`fn` item types are zero sized, and each `fn` names a unique
7702   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7703   `transmute` on a `fn` type will generate a warning for a few cycles,
7704   then will be converted to an error.
7705 * [Improvements to const evaluation may trigger new errors when integer
7706   literals are out of range][1.9ce].
7707
7708
7709 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
7710 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
7711 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
7712 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
7713 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
7714 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
7715 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
7716 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
7717 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
7718 [1.9db]: https://github.com/rust-lang/rust/pull/32054
7719 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
7720 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
7721 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
7722 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
7723 [1.9o]: https://github.com/rust-lang/rust/pull/32325
7724 [1.9q]: https://github.com/rust-lang/rust/pull/31887
7725 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
7726 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
7727 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
7728 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
7729 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
7730 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
7731 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
7732 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
7733 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7734 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
7735 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7736 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
7737 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
7738 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
7739 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
7740 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
7741 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
7742 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
7743 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
7744 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
7745 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
7746 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
7747 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
7748 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
7749 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
7750 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
7751 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
7752 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
7753 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
7754 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
7755 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
7756 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
7757 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
7758 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
7759 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
7760 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
7761 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
7762 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
7763 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
7764 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
7765 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
7766 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
7767 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
7768 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
7769 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7770 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7771 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7772 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7773 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7774 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7775 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
7776 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7777 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
7778 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7779 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7780 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7781 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7782 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7783 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
7784 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
7785 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
7786 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
7787 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
7788 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
7789 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
7790 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
7791 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
7792 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
7793 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
7794 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
7795 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
7796 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
7797 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
7798 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
7799 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
7800 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
7801 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
7802 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
7803 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
7804 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
7805 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
7806 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
7807 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
7808 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
7809 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
7810 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
7811 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
7812 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
7813 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
7814 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
7815 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
7816 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
7817 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
7818 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
7819
7820
7821 Version 1.8.0 (2016-04-14)
7822 ==========================
7823
7824 Language
7825 --------
7826
7827 * Rust supports overloading of compound assignment statements like
7828   `+=` by implementing the [`AddAssign`], [`SubAssign`],
7829   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
7830   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
7831   traits. [RFC 953].
7832 * Empty structs can be defined with braces, as in `struct Foo { }`, in
7833   addition to the non-braced form, `struct Foo;`. [RFC 218].
7834
7835 Libraries
7836 ---------
7837
7838 * Stabilized APIs:
7839   * [`str::encode_utf16`] (renamed from `utf16_units`)
7840   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
7841   * [`Ref::map`]
7842   * [`RefMut::map`]
7843   * [`ptr::drop_in_place`]
7844   * [`time::Instant`]
7845   * [`time::SystemTime`]
7846   * [`Instant::now`]
7847   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
7848   * [`Instant::elapsed`]
7849   * [`SystemTime::now`]
7850   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
7851   * [`SystemTime::elapsed`]
7852   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
7853   * [`SystemTimeError`]
7854   * [`SystemTimeError::duration`]
7855   * Various impls for `SystemTimeError`
7856   * [`UNIX_EPOCH`]
7857   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
7858     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
7859     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
7860 * [The `write!` and `writeln!` macros correctly emit errors if any of
7861   their arguments can't be formatted][1.8w].
7862 * [Various I/O functions support large files on 32-bit Linux][1.8l].
7863 * [The Unix-specific `raw` modules, which contain a number of
7864   redefined C types are deprecated][1.8r], including `os::raw::unix`,
7865   `os::raw::macos`, and `os::raw::linux`. These modules defined types
7866   such as `ino_t` and `dev_t`. The inconsistency of these definitions
7867   across platforms was making it difficult to implement `std`
7868   correctly. Those that need these definitions should use the `libc`
7869   crate. [RFC 1415].
7870 * The Unix-specific `MetadataExt` traits, including
7871   `os::unix::fs::MetadataExt`, which expose values such as inode
7872   numbers [no longer return platform-specific types][1.8r], but
7873   instead return widened integers. [RFC 1415].
7874 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
7875 * [Atomic loads and stores are not volatile][1.8a].
7876 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
7877
7878 Performance
7879 -----------
7880
7881 * [Inlining hash functions lead to a 3% compile-time improvement in
7882   some workloads][1.8h].
7883 * When using jemalloc, its symbols are [unprefixed so that it
7884   overrides the libc malloc implementation][1.8h]. This means that for
7885   rustc, LLVM is now using jemalloc, which results in a 6%
7886   compile-time improvement on a specific workload.
7887 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
7888
7889 Misc
7890 ----
7891
7892 * [32-bit MSVC builds finally implement unwinding][1.8ms].
7893   i686-pc-windows-msvc is now considered a tier-1 platform.
7894 * [The `--print targets` flag prints a list of supported targets][1.8t].
7895 * [The `--print cfg` flag prints the `cfg`s defined for the current
7896   target][1.8cf].
7897 * [`rustc` can be built with an new Cargo-based build system, written
7898   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
7899   build system. To enable it configure with `configure --rustbuild`.
7900 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
7901   variants while also indicating the total number of missing variants
7902   if more than 3][1.8m].
7903 * [Executable stacks are disabled on Linux and BSD][1.8nx].
7904 * The Rust Project now publishes binary releases of the standard
7905   library for a number of tier-2 targets:
7906   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
7907   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
7908   `x86_64-rumprun-netbsd`. These can be installed with
7909   tools such as [multirust][1.8mr].
7910
7911 Cargo
7912 -----
7913
7914 * [`cargo init` creates a new Cargo project in the current
7915   directory][1.8ci].  It is otherwise like `cargo new`.
7916 * [Cargo has configuration keys for `-v` and
7917   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
7918   `[term]` section of `.cargo/config`.
7919 * [Configuration keys that evaluate to strings or integers can be set
7920   via environment variables][1.8ce]. For example the `build.jobs` key
7921   can be set via `CARGO_BUILD_JOBS`. Environment variables take
7922   precedence over config files.
7923 * [Target-specific dependencies support Rust `cfg` syntax for
7924   describing targets][1.8cfg] so that dependencies for multiple
7925   targets can be specified together. [RFC 1361].
7926 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
7927   `RUSTDOC` take precedence over the `build.target-dir`,
7928   `build.rustc`, and `build.rustdoc` configuration values][1.8cfv].
7929 * [The child process tree is killed on Windows when Cargo is
7930   killed][1.8ck].
7931 * [The `build.target` configuration value sets the target platform,
7932   like `--target`][1.8ct].
7933
7934 Compatibility Notes
7935 -------------------
7936
7937 * [Unstable compiler flags have been further restricted][1.8u]. Since
7938   1.0 `-Z` flags have been considered unstable, and other flags that
7939   were considered unstable additionally required passing `-Z
7940   unstable-options` to access. Unlike unstable language and library
7941   features though, these options have been accessible on the stable
7942   release channel. Going forward, *new unstable flags will not be
7943   available on the stable release channel*, and old unstable flags
7944   will warn about their usage. In the future, all unstable flags will
7945   be unavailable on the stable release channel.
7946 * [It is no longer possible to `match` on empty enum variants using
7947   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
7948 * The Unix-specific `MetadataExt` traits, including
7949   `os::unix::fs::MetadataExt`, which expose values such as inode
7950   numbers [no longer return platform-specific types][1.8r], but
7951   instead return widened integers. [RFC 1415].
7952 * [Modules sourced from the filesystem cannot appear within arbitrary
7953   blocks, but only within other modules][1.8mf].
7954 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
7955 * On Unix, [stack overflow triggers a runtime abort instead of a
7956   SIGSEGV][1.8so].
7957 * [`Command::spawn` and its equivalents return an error if any of
7958   its command-line arguments contain interior `NUL`s][1.8n].
7959 * [Tuple and unit enum variants from other crates are in the type
7960   namespace][1.8tn].
7961 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
7962   type instead of `.a` files][1.8st]. Additionally, for the MSVC
7963   toolchain, `rustc` emits import libraries named `foo.dll.lib`
7964   instead of `foo.lib`.
7965
7966
7967 [1.8a]: https://github.com/rust-lang/rust/pull/30962
7968 [1.8b]: https://github.com/rust-lang/rust/pull/31123
7969 [1.8c]: https://github.com/rust-lang/rust/pull/31530
7970 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
7971 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
7972 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
7973 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
7974 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
7975 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
7976 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
7977 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
7978 [1.8cfv]: https://github.com/rust-lang/cargo/issues/2365
7979 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
7980 [1.8h]: https://github.com/rust-lang/rust/pull/31460
7981 [1.8l]: https://github.com/rust-lang/rust/pull/31668
7982 [1.8m]: https://github.com/rust-lang/rust/pull/31020
7983 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
7984 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
7985 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
7986 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
7987 [1.8n]: https://github.com/rust-lang/rust/pull/31056
7988 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
7989 [1.8r]: https://github.com/rust-lang/rust/pull/31551
7990 [1.8so]: https://github.com/rust-lang/rust/pull/31333
7991 [1.8st]: https://github.com/rust-lang/rust/pull/29520
7992 [1.8t]: https://github.com/rust-lang/rust/pull/31358
7993 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
7994 [1.8u]: https://github.com/rust-lang/rust/pull/31793
7995 [1.8v]: https://github.com/rust-lang/rust/pull/31757
7996 [1.8w]: https://github.com/rust-lang/rust/pull/31904
7997 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
7998 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
7999 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
8000 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
8001 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
8002 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
8003 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
8004 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
8005 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
8006 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
8007 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
8008 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
8009 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
8010 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
8011 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
8012 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
8013 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
8014 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
8015 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
8016 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
8017 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
8018 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
8019 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
8020 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
8021 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
8022 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
8023 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
8024 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
8025 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
8026 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
8027
8028
8029 Version 1.7.0 (2016-03-03)
8030 ==========================
8031
8032 Libraries
8033 ---------
8034
8035 * Stabilized APIs
8036   * `Path`
8037     * [`Path::strip_prefix`] (renamed from relative_from)
8038     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
8039   * `Ipv4Addr`
8040     * [`Ipv4Addr::is_loopback`]
8041     * [`Ipv4Addr::is_private`]
8042     * [`Ipv4Addr::is_link_local`]
8043     * [`Ipv4Addr::is_multicast`]
8044     * [`Ipv4Addr::is_broadcast`]
8045     * [`Ipv4Addr::is_documentation`]
8046   * `Ipv6Addr`
8047     * [`Ipv6Addr::is_unspecified`]
8048     * [`Ipv6Addr::is_loopback`]
8049     * [`Ipv6Addr::is_multicast`]
8050   * `Vec`
8051     * [`Vec::as_slice`]
8052     * [`Vec::as_mut_slice`]
8053   * `String`
8054     * [`String::as_str`]
8055     * [`String::as_mut_str`]
8056   * Slices
8057     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
8058     be the same length
8059     * `<[T]>::`[`sort_by_key`]
8060   * checked, saturated, and overflowing operations
8061     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
8062     * [`i32::saturating_mul`]
8063     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
8064     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
8065     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
8066     * [`u32::saturating_mul`]
8067     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
8068     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
8069     * and checked, saturated, and overflowing operations for other primitive types
8070   * FFI
8071     * [`ffi::IntoStringError`]
8072     * [`CString::into_string`]
8073     * [`CString::into_bytes`]
8074     * [`CString::into_bytes_with_nul`]
8075     * `From<CString> for Vec<u8>`
8076   * `IntoStringError`
8077     * [`IntoStringError::into_cstring`]
8078     * [`IntoStringError::utf8_error`]
8079     * `Error for IntoStringError`
8080   * Hashing
8081     * [`std::hash::BuildHasher`]
8082     * [`BuildHasher::Hasher`]
8083     * [`BuildHasher::build_hasher`]
8084     * [`std::hash::BuildHasherDefault`]
8085     * [`HashMap::with_hasher`]
8086     * [`HashMap::with_capacity_and_hasher`]
8087     * [`HashSet::with_hasher`]
8088     * [`HashSet::with_capacity_and_hasher`]
8089     * [`std::collections::hash_map::RandomState`]
8090     * [`RandomState::new`]
8091 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
8092   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
8093   from bytes is faster.
8094 * [The performance of `LineWriter` (and thus `io::stdout`) was
8095   improved by using `memchr` to search for newlines][1.7m].
8096 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
8097   `f64` variants were stabilized previously.
8098 * [`BTreeMap` was rewritten to use less memory and improve the performance
8099   of insertion and iteration, the latter by as much as 5x][1.7bm].
8100 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
8101   covariant over their contained type][1.7bt].
8102 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
8103   over their contained type][1.7ll].
8104 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
8105   searching methods.
8106 * [`Any` is implemented for unsized types][1.7a].
8107 * [`Hash` is implemented for `Duration`][1.7h].
8108
8109 Misc
8110 ----
8111
8112 * [When running tests with `--test`, rustdoc will pass `--cfg`
8113   arguments to the compiler][1.7dt].
8114 * [The compiler is built with RPATH information by default][1.7rpa].
8115   This means that it will be possible to run `rustc` when installed in
8116   unusual configurations without configuring the dynamic linker search
8117   path explicitly.
8118 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
8119   any RPATH entries (emitted with `-C rpath`) *not* take precedence
8120   over `LD_LIBRARY_PATH`.
8121
8122 Cargo
8123 -----
8124
8125 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
8126   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
8127 * [The `rerun-if-changed` build script directive no longer causes the
8128   build script to incorrectly run twice in certain scenarios][1.7rr].
8129
8130 Compatibility Notes
8131 -------------------
8132
8133 * Soundness fixes to the interactions between associated types and
8134   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
8135   code that violates the new rules. This is a significant change that
8136   is known to break existing code, so it has emitted warnings for the
8137   new error cases since 1.4 to give crate authors time to adapt. The
8138   details of what is changing are subtle; read the RFC for more.
8139 * [Several bugs in the compiler's visibility calculations were
8140   fixed][1.7v]. Since this was found to break significant amounts of
8141   code, the new errors will be emitted as warnings for several release
8142   cycles, under the `private_in_public` lint.
8143 * Defaulted type parameters were accidentally accepted in positions
8144   that were not intended. In this release, [defaulted type parameters
8145   appearing outside of type definitions will generate a
8146   warning][1.7d], which will become an error in future releases.
8147 * [Parsing "." as a float results in an error instead of 0][1.7p].
8148   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
8149 * [Borrows of closure parameters may not outlive the closure][1.7bc].
8150
8151 [1.7a]: https://github.com/rust-lang/rust/pull/30928
8152 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
8153 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
8154 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
8155 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
8156 [1.7d]: https://github.com/rust-lang/rust/pull/30724
8157 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
8158 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
8159 [1.7f]: https://github.com/rust-lang/rust/pull/30672
8160 [1.7h]: https://github.com/rust-lang/rust/pull/30818
8161 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
8162 [1.7m]: https://github.com/rust-lang/rust/pull/30381
8163 [1.7p]: https://github.com/rust-lang/rust/pull/30681
8164 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
8165 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
8166 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
8167 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
8168 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
8169 [1.7v]: https://github.com/rust-lang/rust/pull/29973
8170 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8171 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8172 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
8173 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
8174 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
8175 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
8176 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
8177 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
8178 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
8179 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
8180 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
8181 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
8182 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
8183 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
8184 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
8185 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
8186 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
8187 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
8188 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
8189 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
8190 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
8191 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
8192 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
8193 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
8194 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
8195 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
8196 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
8197 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
8198 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
8199 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
8200 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
8201 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
8202 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
8203 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
8204 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
8205 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
8206 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
8207 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
8208 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
8209 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
8210 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
8211 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
8212 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
8213 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
8214 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
8215 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
8216 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
8217 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8218 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
8219 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8220 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
8221 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
8222 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
8223 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
8224 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
8225 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
8226 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
8227 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
8228 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
8229 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
8230
8231
8232 Version 1.6.0 (2016-01-21)
8233 ==========================
8234
8235 Language
8236 --------
8237
8238 * The `#![no_std]` attribute causes a crate to not be linked to the
8239   standard library, but only the [core library][1.6co], as described
8240   in [RFC 1184]. The core library defines common types and traits but
8241   has no platform dependencies whatsoever, and is the basis for Rust
8242   software in environments that cannot support a full port of the
8243   standard library, such as operating systems. Most of the core
8244   library is now stable.
8245
8246 Libraries
8247 ---------
8248
8249 * Stabilized APIs:
8250   [`Read::read_exact`],
8251   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
8252   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
8253   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
8254   [`os::unix::fs::DirBuilderExt`],
8255   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
8256   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
8257   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
8258   [`collections::hash_map::Drain`],
8259   [`collections::hash_map::HashMap::drain`],
8260   [`collections::hash_set::Drain`],
8261   [`collections::hash_set::HashSet::drain`],
8262   [`collections::binary_heap::Drain`],
8263   [`collections::binary_heap::BinaryHeap::drain`],
8264   [`Vec::extend_from_slice`] (renamed from `push_all`),
8265   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
8266   [`RwLock::into_inner`],
8267   [`Iterator::min_by_key`] (renamed from `min_by`),
8268   [`Iterator::max_by_key`] (renamed from `max_by`).
8269 * The [core library][1.6co] is stable, as are most of its APIs.
8270 * [The `assert_eq!` macro supports arguments that don't implement
8271   `Sized`][1.6ae], such as arrays. In this way it behaves more like
8272   `assert!`.
8273 * Several timer functions that take duration in milliseconds [are
8274   deprecated in favor of those that take `Duration`][1.6ms]. These
8275   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
8276   `thread::park_timeout_ms`.
8277 * The algorithm by which `Vec` reserves additional elements was
8278   [tweaked to not allocate excessive space][1.6a] while still growing
8279   exponentially.
8280 * `From` conversions are [implemented from integers to floats][1.6f]
8281   in cases where the conversion is lossless. Thus they are not
8282   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
8283   or `f64`. They are also not implemented for `isize` and `usize`
8284   because the implementations would be platform-specific. `From` is
8285   also implemented from `f32` to `f64`.
8286 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
8287 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
8288 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
8289 * [`BinaryHeap` was refactored][1.6bh] for modest performance
8290   improvements.
8291 * Sorting slices that are already sorted [is 50% faster in some
8292   cases][1.6s].
8293
8294 Cargo
8295 -----
8296
8297 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
8298 * Cargo build scripts can specify their dependencies by emitting the
8299   [`rerun-if-changed`][1.6rr] key.
8300 * crates.io will reject publication of crates with dependencies that
8301   have a wildcard version constraint. Crates with wildcard
8302   dependencies were seen to cause a variety of problems, as described
8303   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
8304   warning.
8305 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
8306   release folder.  A variety of artifacts that Cargo failed to clean
8307   are now correctly deleted.
8308
8309 Misc
8310 ----
8311
8312 * The `unreachable_code` lint [warns when a function call's argument
8313   diverges][1.6dv].
8314 * The parser indicates [failures that may be caused by
8315   confusingly-similar Unicode characters][1.6uc]
8316 * Certain macro errors [are reported at definition time][1.6m], not
8317   expansion.
8318
8319 Compatibility Notes
8320 -------------------
8321
8322 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
8323   environment variable when locating crates. This was a pre-cargo
8324   feature for integrating with the package manager that was
8325   accidentally never removed.
8326 * [A number of bugs were fixed in the privacy checker][1.6p] that
8327   could cause previously-accepted code to break.
8328 * [Modules and unit/tuple structs may not share the same name][1.6ts].
8329 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
8330   struct pattern syntax (`Foo(..)`) can no longer be used to match
8331   unit structs. This is a warning now, but will become an error in
8332   future releases. Patterns that share the same name as a const are
8333   now an error.
8334 * A bug was fixed that causes [rustc not to apply default type
8335   parameters][1.6xc] when resolving certain method implementations of
8336   traits defined in other crates.
8337
8338 [1.6a]: https://github.com/rust-lang/rust/pull/29454
8339 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
8340 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
8341 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
8342 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
8343 [1.6co]: http://doc.rust-lang.org/core/index.html
8344 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
8345 [1.6f]: https://github.com/rust-lang/rust/pull/29129
8346 [1.6m]: https://github.com/rust-lang/rust/pull/29828
8347 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
8348 [1.6p]: https://github.com/rust-lang/rust/pull/29726
8349 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
8350 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
8351 [1.6s]: https://github.com/rust-lang/rust/pull/29675
8352 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
8353 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
8354 [1.6us]: https://github.com/rust-lang/rust/pull/29383
8355 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
8356 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
8357 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8358 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
8359 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
8360 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
8361 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
8362 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
8363 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
8364 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
8365 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
8366 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
8367 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
8368 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
8369 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
8370 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
8371 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
8372 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
8373 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
8374 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
8375 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
8376 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
8377 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
8378 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
8379 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
8380 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
8381 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
8382 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
8383 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
8384 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
8385
8386
8387 Version 1.5.0 (2015-12-10)
8388 ==========================
8389
8390 * ~700 changes, numerous bugfixes
8391
8392 Highlights
8393 ----------
8394
8395 * Stabilized APIs:
8396   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
8397   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
8398   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
8399   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
8400   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
8401   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
8402   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
8403   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
8404   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
8405   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
8406   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
8407   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
8408   [`Path::read_link`], [`Path::symlink_metadata`],
8409   [`Utf8Error::valid_up_to`], [`Vec::resize`],
8410   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
8411   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
8412   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
8413   [`slice::split_first_mut`], [`slice::split_first`],
8414   [`slice::split_last_mut`], [`slice::split_last`],
8415   [`char::from_u32_unchecked`], [`fs::canonicalize`],
8416   [`str::MatchIndices`], [`str::RMatchIndices`],
8417   [`str::match_indices`], [`str::rmatch_indices`],
8418   [`str::slice_mut_unchecked`], [`string::ParseError`].
8419 * Rust applications hosted on crates.io can be installed locally to
8420   `~/.cargo/bin` with the [`cargo install`] command. Among other
8421   things this makes it easier to augment Cargo with new subcommands:
8422   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
8423   invoked as `cargo foo`.
8424 * Crates with wildcard (`*`) dependencies will [emit warnings when
8425   published][1.5w]. In 1.6 it will no longer be possible to publish
8426   crates with wildcard dependencies.
8427
8428 Breaking Changes
8429 ----------------
8430
8431 * The rules determining when a particular lifetime must outlive
8432   a particular value (known as '[dropck]') have been [modified
8433   to not rely on parametricity][1.5p].
8434 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
8435   and `Arc`][1.5a]. Because these smart pointer types implement
8436   `Deref`, this causes breakage in cases where the interior type
8437   contains methods of the same name.
8438 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
8439   that they could drop their content. Soundness fix.
8440 * All method invocations are [properly checked][1.5wf1] for
8441   [well-formedness][1.5wf2]. Soundness fix.
8442 * Traits whose supertraits contain `Self` are [not object
8443   safe][1.5o]. Soundness fix.
8444 * Target specifications support a [`no_default_libraries`][1.5nd]
8445   setting that controls whether `-nodefaultlibs` is passed to the
8446   linker, and in turn the `is_like_windows` setting no longer affects
8447   the `-nodefaultlibs` flag.
8448 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
8449 * The `#[inline]` and `#[repr]` attributes [can only appear
8450   in valid locations][1.5at].
8451 * Native libraries linked from the local crate are [passed to
8452   the linker before native libraries from upstream crates][1.5nl].
8453 * Two rarely-used attributes, `#[no_debug]` and
8454   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
8455 * Negation of unsigned integers, which has been a warning for
8456   several releases, [is now behind a feature gate and will
8457   generate errors][1.5nu].
8458 * The parser accidentally accepted visibility modifiers on
8459   enum variants, a bug [which has been fixed][1.5ev].
8460 * [A bug was fixed that allowed `use` statements to import unstable
8461   features][1.5use].
8462
8463 Language
8464 --------
8465
8466 * When evaluating expressions at compile-time that are not
8467   compile-time constants (const-evaluating expressions in non-const
8468   contexts), incorrect code such as overlong bitshifts and arithmetic
8469   overflow will [generate a warning instead of an error][1.5ce],
8470   delaying the error until runtime. This will allow the
8471   const-evaluator to be expanded in the future backwards-compatibly.
8472 * The `improper_ctypes` lint [no longer warns about using `isize` and
8473   `usize` in FFI][1.5ict].
8474
8475 Libraries
8476 ---------
8477
8478 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
8479   invariant][1.5c].
8480 * `Default` is [implemented for mutable slices][1.5d].
8481 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
8482 * There are now `From` conversions [between floating point
8483   types][1.5f] where the conversions are lossless.
8484 * There are now `From` conversions [between integer types][1.5i] where
8485   the conversions are lossless.
8486 * [`fs::Metadata` implements `Clone`][1.5fs].
8487 * The `parse` method [accepts a leading "+" when parsing
8488   integers][1.5pi].
8489 * [`AsMut` is implemented for `Vec`][1.5am].
8490 * The `clone_from` implementations for `String` and `BinaryHeap` [have
8491   been optimized][1.5cf] and no longer rely on the default impl.
8492 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
8493   `unsafe extern "C"` function types now [implement `Clone`,
8494   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
8495   `fmt::Debug` for up to 12 arguments][1.5fp].
8496 * [Dropping `Vec`s is much faster in unoptimized builds when the
8497   element types don't implement `Drop`][1.5dv].
8498 * A bug that caused in incorrect behavior when [combining `VecDeque`
8499   with zero-sized types][1.5vdz] was resolved.
8500 * [`PartialOrd` for slices is faster][1.5po].
8501
8502 Miscellaneous
8503 -------------
8504
8505 * [Crate metadata size was reduced by 20%][1.5md].
8506 * [Improvements to code generation reduced the size of libcore by 3.3
8507   MB and rustc's memory usage by 18MB][1.5m].
8508 * [Improvements to deref translation increased performance in
8509   unoptimized builds][1.5dr].
8510 * Various errors in trait resolution [are deduplicated to only be
8511   reported once][1.5te].
8512 * Rust has preliminary [support for rumprun kernels][1.5rr].
8513 * Rust has preliminary [support for NetBSD on amd64][1.5na].
8514
8515 [1.5use]: https://github.com/rust-lang/rust/pull/28364
8516 [1.5po]: https://github.com/rust-lang/rust/pull/28436
8517 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
8518 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
8519 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
8520 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
8521 [1.5md]: https://github.com/rust-lang/rust/pull/28521
8522 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
8523 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
8524 [1.5na]: https://github.com/rust-lang/rust/pull/28543
8525 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
8526 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
8527 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
8528 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
8529 [1.5te]: https://github.com/rust-lang/rust/pull/28645
8530 [1.5at]: https://github.com/rust-lang/rust/pull/28650
8531 [1.5am]: https://github.com/rust-lang/rust/pull/28663
8532 [1.5m]: https://github.com/rust-lang/rust/pull/28778
8533 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
8534 [1.5a]: https://github.com/rust-lang/rust/pull/28811
8535 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
8536 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
8537 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
8538 [1.5i]: https://github.com/rust-lang/rust/pull/28921
8539 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
8540 [1.5f]: https://github.com/rust-lang/rust/pull/29129
8541 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
8542 [1.5s]: https://github.com/rust-lang/rust/pull/29190
8543 [1.5d]: https://github.com/rust-lang/rust/pull/29245
8544 [1.5o]: https://github.com/rust-lang/rust/pull/29259
8545 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
8546 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8547 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
8548 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
8549 [1.5c]: https://github.com/rust-lang/rust/pull/29110
8550 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8551 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
8552 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
8553 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
8554 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
8555 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
8556 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
8557 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
8558 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
8559 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
8560 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
8561 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
8562 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
8563 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
8564 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
8565 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
8566 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
8567 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
8568 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
8569 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
8570 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
8571 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
8572 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
8573 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
8574 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
8575 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
8576 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
8577 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
8578 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
8579 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
8580 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
8581 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
8582 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
8583 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
8584 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
8585 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
8586 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
8587 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
8588 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
8589 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
8590 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
8591 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
8592 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
8593 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
8594 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
8595 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
8596 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
8597 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
8598 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
8599 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
8600 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
8601 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
8602 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
8603 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
8604
8605 Version 1.4.0 (2015-10-29)
8606 ==========================
8607
8608 * ~1200 changes, numerous bugfixes
8609
8610 Highlights
8611 ----------
8612
8613 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
8614   GNU) are now supported and recommended for use.
8615
8616 Breaking Changes
8617 ----------------
8618
8619 * [Several changes have been made to fix type soundness and improve
8620   the behavior of associated types][sound]. See [RFC 1214]. Although
8621   we have mostly introduced these changes as warnings this release, to
8622   become errors next release, there are still some scenarios that will
8623   see immediate breakage.
8624 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
8625   line breaks in addition to `\n`][crlf].
8626 * [Loans of `'static` lifetime extend to the end of a function][stat].
8627 * [`str::parse` no longer introduces avoidable rounding error when
8628   parsing floating point numbers. Together with earlier changes to
8629   float formatting/output, "round trips" like f.to_string().parse()
8630   now preserve the value of f exactly. Additionally, leading plus
8631   signs are now accepted][fp3].
8632
8633
8634 Language
8635 --------
8636
8637 * `use` statements that import multiple items [can now rename
8638   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
8639 * [Binops work correctly on fat pointers][binfat].
8640 * `pub extern crate`, which does not behave as expected, [issues a
8641   warning][pec] until a better solution is found.
8642
8643 Libraries
8644 ---------
8645
8646 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
8647   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
8648   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
8649   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
8650   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
8651   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
8652   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
8653   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
8654   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
8655   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
8656   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
8657   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
8658   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
8659   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
8660   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
8661   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
8662   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
8663   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
8664   [`thread::sleep`].
8665 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
8666   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
8667   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
8668   `f64::from_str_radix`.
8669 * [Reverse-searching strings is faster with the 'two-way'
8670   algorithm][s].
8671 * [`std::io::copy` allows `?Sized` arguments][cc].
8672 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
8673   [override `count`, `nth` and `last` with an *O*(1)
8674   implementation][it].
8675 * [`Default` is implemented for arrays up to `[T; 32]`][d].
8676 * [`IntoRawFd` has been added to the Unix-specific prelude,
8677   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
8678   prelude][pr].
8679 * [`Extend<String>` and `FromIterator<String` are both implemented for
8680   `String`][es].
8681 * [`IntoIterator` is implemented for references to `Option` and
8682   `Result`][into2].
8683 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
8684   Copy`][ext] as part of [RFC 839]. This will cause type inference
8685   breakage in rare situations.
8686 * [`BinaryHeap` implements `Debug`][bh2].
8687 * [`Borrow` and `BorrowMut` are implemented for fixed-size
8688   arrays][bm].
8689 * [`extern fn`s with the "Rust" and "C" ABIs implement common
8690   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
8691 * [String comparison is faster][faststr].
8692 * `&mut T` where `T: std::fmt::Write` [also implements
8693   `std::fmt::Write`][mutw].
8694 * [A stable regression in `VecDeque::push_back` and other
8695   capacity-altering methods that caused panics for zero-sized types
8696   was fixed][vd].
8697 * [Function pointers implement traits for up to 12 parameters][fp2].
8698
8699 Miscellaneous
8700 -------------
8701
8702 * The compiler [no longer uses the 'morestack' feature to prevent
8703   stack overflow][mm]. Instead it uses guard pages and stack
8704   probes (though stack probes are not yet implemented on any platform
8705   but Windows).
8706 * [The compiler matches traits faster when projections are involved][p].
8707 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
8708   `usize`][ffi].
8709 * [Cargo now displays useful information about what its doing during
8710   `cargo update`][cu].
8711
8712 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
8713 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
8714 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
8715 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
8716 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
8717 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
8718 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
8719 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
8720 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
8721 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
8722 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
8723 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
8724 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
8725 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
8726 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
8727 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
8728 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
8729 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
8730 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8731 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8732 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8733 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8734 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8735 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8736 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8737 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8738 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
8739 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
8740 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
8741 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
8742 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
8743 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
8744 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
8745 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
8746 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
8747 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
8748 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
8749 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
8750 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
8751 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
8752 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
8753 [bh2]: https://github.com/rust-lang/rust/pull/28156
8754 [binfat]: https://github.com/rust-lang/rust/pull/28270
8755 [bm]: https://github.com/rust-lang/rust/pull/28197
8756 [cc]: https://github.com/rust-lang/rust/pull/27531
8757 [crlf]: https://github.com/rust-lang/rust/pull/28034
8758 [cu]: https://github.com/rust-lang/cargo/pull/1931
8759 [d]: https://github.com/rust-lang/rust/pull/27825
8760 [dep]: https://github.com/rust-lang/rust/pull/28339
8761 [es]: https://github.com/rust-lang/rust/pull/27956
8762 [ext]: https://github.com/rust-lang/rust/pull/28094
8763 [faststr]: https://github.com/rust-lang/rust/pull/28338
8764 [ffi]: https://github.com/rust-lang/rust/pull/28779
8765 [fp]: https://github.com/rust-lang/rust/pull/28268
8766 [fp2]: https://github.com/rust-lang/rust/pull/28560
8767 [fp3]: https://github.com/rust-lang/rust/pull/27307
8768 [i]: https://github.com/rust-lang/rust/pull/27451
8769 [into2]: https://github.com/rust-lang/rust/pull/28039
8770 [it]: https://github.com/rust-lang/rust/pull/27652
8771 [mm]: https://github.com/rust-lang/rust/pull/27338
8772 [mutw]: https://github.com/rust-lang/rust/pull/28368
8773 [sound]: https://github.com/rust-lang/rust/pull/27641
8774 [p]: https://github.com/rust-lang/rust/pull/27866
8775 [pec]: https://github.com/rust-lang/rust/pull/28486
8776 [pr]: https://github.com/rust-lang/rust/pull/27896
8777 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8778 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8779 [s]: https://github.com/rust-lang/rust/pull/27474
8780 [stab]: https://github.com/rust-lang/rust/pull/28339
8781 [stat]: https://github.com/rust-lang/rust/pull/28321
8782 [vd]: https://github.com/rust-lang/rust/pull/28494
8783
8784 Version 1.3.0 (2015-09-17)
8785 ==============================
8786
8787 * ~900 changes, numerous bugfixes
8788
8789 Highlights
8790 ----------
8791
8792 * The [new object lifetime defaults][nold] have been [turned
8793   on][nold2] after a cycle of warnings about the change. Now types
8794   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
8795   being interpreted as `&'a Box<Trait+'a>` to `&'a
8796   Box<Trait+'static>`.
8797 * [The Rustonomicon][nom] is a new book in the official documentation
8798   that dives into writing unsafe Rust.
8799 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
8800   timekeeping is employed by other std APIs, as well as out-of-tree
8801   time crates.
8802
8803 Breaking Changes
8804 ----------------
8805
8806 * The [new object lifetime defaults][nold] have been [turned
8807   on][nold2] after a cycle of warnings about the change.
8808 * There is a known [regression][lr] in how object lifetime elision is
8809   interpreted, the proper solution for which is undetermined.
8810 * The `#[prelude_import]` attribute, an internal implementation
8811   detail, was accidentally stabilized previously. [It has been put
8812   behind the `prelude_import` feature gate][pi]. This change is
8813   believed to break no existing code.
8814 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8815   [more sane for dynamically sized types][dst3]. Code that relied on
8816   the previous behavior is thought to be broken.
8817 * The `dropck` rules, which checks that destructors can't access
8818   destroyed values, [have been updated][dropck] to match the
8819   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
8820   cause some previously-compiling code to no longer build.
8821
8822 Language
8823 --------
8824
8825 * The [new object lifetime defaults][nold] have been [turned
8826   on][nold2] after a cycle of warnings about the change.
8827 * Semicolons may [now follow types and paths in
8828   macros](https://github.com/rust-lang/rust/pull/27000).
8829 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8830   [more sane for dynamically sized types][dst3]. Code that relied on
8831   the previous behavior is not known to exist, and suspected to be
8832   broken.
8833 * `'static` variables [may now be recursive][st].
8834 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
8835   implementations correctly.
8836 * The `dropck` rules, which checks that destructors can't access
8837   destroyed values, [have been updated][dropck] to match the
8838   [RFC][dropckrfc].
8839
8840 Libraries
8841 ---------
8842
8843 * The [`Duration`] API, [has been stabilized][ds], as well as the
8844   `std::time` module, which presently contains only `Duration`.
8845 * `Box<str>` and `Box<[T]>` both implement `Clone`.
8846 * The owned C string, [`CString`], implements [`Borrow`] and the
8847   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
8848   these allow C strings to be borrowed and cloned in generic code.
8849 * [`CStr`] implements [`Debug`].
8850 * [`AtomicPtr`] implements [`Debug`].
8851 * [`Error`] trait objects [can be downcast to their concrete types][e]
8852   in many common configurations, using the [`is`], [`downcast`],
8853   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
8854   [`Any`] trait.
8855 * Searching for substrings now [employs the two-way algorithm][search]
8856   instead of doing a naive search. This gives major speedups to a
8857   number of methods, including [`contains`][sc], [`find`][sf],
8858   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
8859   [`ends_with`][sew] are also faster.
8860 * The performance of `PartialEq` for slices is [much faster][ps].
8861 * The [`Hash`] trait offers the default method, [`hash_slice`], which
8862   is overridden and optimized by the implementations for scalars.
8863 * The [`Hasher`] trait now has a number of specialized `write_*`
8864   methods for primitive types, for efficiency.
8865 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
8866   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
8867   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
8868   of [`std::error::Error::cause`][iec] also delegates to the inner
8869   error.
8870 * [`process::Child`][pc] gained the [`id`] method, which returns a
8871   `u32` representing the platform-specific process identifier.
8872 * The [`connect`] method on slices is deprecated, replaced by the new
8873   [`join`] method (note that both of these are on the *unstable*
8874   [`SliceConcatExt`] trait, but through the magic of the prelude are
8875   available to stable code anyway).
8876 * The [`Div`] operator is implemented for [`Wrapping`] types.
8877 * [`DerefMut` is implemented for `String`][dms].
8878 * Performance of SipHash (the default hasher for `HashMap`) is
8879   [better for long data][sh].
8880 * [`AtomicPtr`] implements [`Send`].
8881 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
8882   are now [specialized to use uninitialized buffers for increased
8883   performance][rte].
8884 * Lifetime parameters of foreign functions [are now resolved
8885   properly][f].
8886
8887 Misc
8888 ----
8889
8890 * Rust can now, with some coercion, [produce programs that run on
8891   Windows XP][xp], though XP is not considered a supported platform.
8892 * Porting Rust on Windows from the GNU toolchain to MSVC continues
8893   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
8894   recommended for use in 1.3, though should be fully-functional
8895   in the [64-bit 1.4 beta][b14].
8896 * On Fedora-based systems installation will [properly configure the
8897   dynamic linker][fl].
8898 * The compiler gained many new extended error descriptions, which can
8899   be accessed with the `--explain` flag.
8900 * The `dropck` pass, which checks that destructors can't access
8901   destroyed values, [has been rewritten][27261]. This fixes some
8902   soundness holes, and as such will cause some previously-compiling
8903   code to no longer build.
8904 * `rustc` now uses [LLVM to write archive files where possible][ar].
8905   Eventually this will eliminate the compiler's dependency on the ar
8906   utility.
8907 * Rust has [preliminary support for i686 FreeBSD][26959] (it has long
8908   supported FreeBSD on x86_64).
8909 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
8910   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
8911   more strict.
8912 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
8913   will kill the process instead of leaking][nlp].
8914
8915 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
8916 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
8917 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
8918 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
8919 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
8920 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8921 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8922 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
8923 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
8924 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
8925 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
8926 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
8927 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
8928 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8929 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
8930 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
8931 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
8932 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
8933 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8934 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
8935 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
8936 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
8937 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
8938 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8939 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
8940 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
8941 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
8942 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
8943 [ar]: https://github.com/rust-lang/rust/pull/26926
8944 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
8945 [dms]: https://github.com/rust-lang/rust/pull/26241
8946 [27261]: https://github.com/rust-lang/rust/pull/27261
8947 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8948 [ds]: https://github.com/rust-lang/rust/pull/26818
8949 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
8950 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
8951 [dst3]: https://github.com/rust-lang/rust/pull/27351
8952 [e]: https://github.com/rust-lang/rust/pull/24793
8953 [f]: https://github.com/rust-lang/rust/pull/26588
8954 [26959]: https://github.com/rust-lang/rust/pull/26959
8955 [fl]: https://github.com/rust-lang/rust-installer/pull/41
8956 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
8957 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
8958 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
8959 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
8960 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
8961 [lic]: https://github.com/rust-lang/rust/pull/26583
8962 [lnu]: https://github.com/rust-lang/rust/pull/27026
8963 [lr]: https://github.com/rust-lang/rust/issues/27248
8964 [lum]: https://github.com/rust-lang/rust/pull/26378
8965 [lur]: https://github.com/rust-lang/rust/pull/26783
8966 [nlp]: https://github.com/rust-lang/rust/pull/27176
8967 [nold2]: https://github.com/rust-lang/rust/pull/27045
8968 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
8969 [nom]: http://doc.rust-lang.org/nightly/nomicon/
8970 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
8971 [pi]: https://github.com/rust-lang/rust/pull/26699
8972 [ps]: https://github.com/rust-lang/rust/pull/26884
8973 [rte]: https://github.com/rust-lang/rust/pull/26950
8974 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
8975 [search]: https://github.com/rust-lang/rust/pull/26327
8976 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
8977 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
8978 [sh]: https://github.com/rust-lang/rust/pull/27280
8979 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
8980 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
8981 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
8982 [st]: https://github.com/rust-lang/rust/pull/26630
8983 [win1]: https://github.com/rust-lang/rust/pull/26569
8984 [win2]: https://github.com/rust-lang/rust/pull/26741
8985 [win3]: https://github.com/rust-lang/rust/pull/26741
8986 [win4]: https://github.com/rust-lang/rust/pull/27210
8987 [xp]: https://github.com/rust-lang/rust/pull/26569
8988
8989 Version 1.2.0 (2015-08-07)
8990 ==========================
8991
8992 * ~1200 changes, numerous bugfixes
8993
8994 Highlights
8995 ----------
8996
8997 * [Dynamically-sized-type coercions][dst] allow smart pointer types
8998   like `Rc` to contain types without a fixed size, arrays and trait
8999   objects, finally enabling use of `Rc<[T]>` and completing the
9000   implementation of DST.
9001 * [Parallel codegen][parcodegen] is now working again, which can
9002   substantially speed up large builds in debug mode; It also gets
9003   another ~33% speedup when bootstrapping on a 4 core machine (using 8
9004   jobs). It's not enabled by default, but will be "in the near
9005   future". It can be activated with the `-C codegen-units=N` flag to
9006   `rustc`.
9007 * This is the first release with [experimental support for linking
9008   with the MSVC linker and lib C on Windows (instead of using the GNU
9009   variants via MinGW)][win]. It is yet recommended only for the most
9010   intrepid Rustaceans.
9011 * Benchmark compilations are showing a 30% improvement in
9012   bootstrapping over 1.1.
9013
9014 Breaking Changes
9015 ----------------
9016
9017 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
9018   unicode case mapping, which is a previously-planned change in
9019   behavior and considered a bugfix.
9020 * [`mem::align_of`] now specifies [the *minimum alignment* for
9021   T][align], which is usually the alignment programs are interested
9022   in, and the same value reported by clang's
9023   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
9024   break real code.
9025 * [The `#[packed]` attribute is no longer silently accepted by the
9026   compiler][packed]. This attribute did nothing and code that
9027   mentioned it likely did not work as intended.
9028 * Associated type defaults are [now behind the
9029   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
9030   defaults *did not work*, but could be mentioned syntactically. As
9031   such this breakage has minimal impact.
9032
9033 Language
9034 --------
9035
9036 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
9037   matching against dereferenceable values.
9038
9039 Libraries
9040 ---------
9041
9042 * The [`Extend`] trait, which grows a collection from an iterator, is
9043   implemented over iterators of references, for `String`, `Vec`,
9044   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
9045   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
9046 * The [`iter::once`] function returns an iterator that yields a single
9047   element, and [`iter::empty`] returns an iterator that yields no
9048   elements.
9049 * The [`matches`] and [`rmatches`] methods on `str` return iterators
9050   over substring matches.
9051 * [`Cell`] and [`RefCell`] both implement `Eq`.
9052 * A number of methods for wrapping arithmetic are added to the
9053   integral types, [`wrapping_div`], [`wrapping_rem`],
9054   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
9055   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
9056   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
9057   type.. It is illegal for the default arithmetic operations in Rust
9058   to overflow; the desire to wrap must be explicit.
9059 * The `{:#?}` formatting specifier [displays the alternate,
9060   pretty-printed][debugfmt] form of the `Debug` formatter. This
9061   feature was actually introduced prior to 1.0 with little
9062   fanfare.
9063 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
9064   for writing data to formatted strings, similar to [`io::Write`].
9065 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
9066   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
9067   are used by code generators to emit implementations of [`Debug`].
9068 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
9069   methods that convert case, following Unicode case mapping.
9070 * It is now easier to handle poisoned locks. The [`PoisonError`]
9071   type, returned by failing lock operations, exposes `into_inner`,
9072   `get_ref`, and `get_mut`, which all give access to the inner lock
9073   guard, and allow the poisoned lock to continue to operate. The
9074   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
9075   poisoned lock without attempting to take the lock.
9076 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
9077   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
9078   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
9079   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
9080   `ChildStderr`.
9081 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
9082   malformed input.
9083
9084 Misc
9085 ----
9086
9087 * `rustc` employs smarter heuristics for guessing at [typos].
9088 * `rustc` emits more efficient code for [no-op conversions between
9089   unsafe pointers][nop].
9090 * Fat pointers are now [passed in pairs of immediate arguments][fat],
9091   resulting in faster compile times and smaller code.
9092
9093 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
9094 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
9095 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
9096 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
9097 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
9098 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
9099 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
9100 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
9101 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
9102 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
9103 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
9104 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
9105 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
9106 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
9107 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
9108 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
9109 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
9110 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
9111 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
9112 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
9113 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
9114 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
9115 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
9116 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
9117 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
9118 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
9119 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
9120 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
9121 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
9122 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
9123 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
9124 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
9125 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
9126 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9127 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9128 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
9129 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
9130 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
9131 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
9132 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
9133 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
9134 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
9135 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
9136 [align]: https://github.com/rust-lang/rust/pull/25646
9137 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
9138 [typos]: https://github.com/rust-lang/rust/pull/26087
9139 [nop]: https://github.com/rust-lang/rust/pull/26336
9140 [fat]: https://github.com/rust-lang/rust/pull/26411
9141 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
9142 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
9143 [packed]: https://github.com/rust-lang/rust/pull/25541
9144 [ad]: https://github.com/rust-lang/rust/pull/27382
9145 [win]: https://github.com/rust-lang/rust/pull/25350
9146
9147 Version 1.1.0 (2015-06-25)
9148 =========================
9149
9150 * ~850 changes, numerous bugfixes
9151
9152 Highlights
9153 ----------
9154
9155 * The [`std::fs` module has been expanded][fs] to expand the set of
9156   functionality exposed:
9157   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
9158     don't incur a syscall on some platforms.
9159   * A `symlink_metadata` function has been added.
9160   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
9161     access to all underlying information.
9162 * The compiler now contains extended explanations of many errors. When an error
9163   with an explanation occurs the compiler suggests using the `--explain` flag
9164   to read the explanation. Error explanations are also [available online][err-index].
9165 * Thanks to multiple [improvements][sk] to [type checking][pre], as
9166   well as other work, the time to bootstrap the compiler decreased by
9167   32%.
9168
9169 Libraries
9170 ---------
9171
9172 * The [`str::split_whitespace`] method splits a string on unicode
9173   whitespace boundaries.
9174 * On both Windows and Unix, new extension traits provide conversion of
9175   I/O types to and from the underlying system handles. On Unix, these
9176   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
9177   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
9178   `TcpListener`, and `UpdSocket`. Further implementations for
9179   `std::process` will be stabilized later.
9180 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
9181   Windows, symlinks can be created with
9182   `std::os::windows::symlink_dir` and
9183   `std::os::windows::symlink_file`.
9184 * The `mpsc::Receiver` type can now be converted into an iterator with
9185   `into_iter` on the [`IntoIterator`] trait.
9186 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
9187   implementation of the [`From`] trait.
9188 * The `Debug` implementation for `RangeFull` [creates output that is
9189   more consistent with other implementations][rf].
9190 * [`Debug` is implemented for `File`][file].
9191 * The `Default` implementation for `Arc` [no longer requires `Sync +
9192   Send`][arc].
9193 * [The `Iterator` methods `count`, `nth`, and `last` have been
9194   overridden for slices to have *O*(1) performance instead of *O*(*n*)][si].
9195 * Incorrect handling of paths on Windows has been improved in both the
9196   compiler and the standard library.
9197 * [`AtomicPtr` gained a `Default` implementation][ap].
9198 * In accordance with Rust's policy on arithmetic overflow `abs` now
9199   [panics on overflow when debug assertions are enabled][abs].
9200 * The [`Cloned`] iterator, which was accidentally left unstable for
9201   1.0 [has been stabilized][c].
9202 * The [`Incoming`] iterator, which iterates over incoming TCP
9203   connections, and which was accidentally unnamable in 1.0, [is now
9204   properly exported][inc].
9205 * [`BinaryHeap`] no longer corrupts itself [when functions called by
9206   `sift_up` or `sift_down` panic][bh].
9207 * The [`split_off`] method of `LinkedList` [no longer corrupts
9208   the list in certain scenarios][ll].
9209
9210 Misc
9211 ----
9212
9213 * Type checking performance [has improved notably][sk] with
9214   [multiple improvements][pre].
9215 * The compiler [suggests code changes][ch] for more errors.
9216 * rustc and it's build system have experimental support for [building
9217   toolchains against MUSL][m] instead of glibc on Linux.
9218 * The compiler defines the `target_env` cfg value, which is used for
9219   distinguishing toolchains that are otherwise for the same
9220   platform. Presently this is set to `gnu` for common GNU Linux
9221   targets and for MinGW targets, and `musl` for MUSL Linux targets.
9222 * The [`cargo rustc`][crc] command invokes a build with custom flags
9223   to rustc.
9224 * [Android executables are always position independent][pie].
9225 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
9226   with `Drop`][24935].
9227
9228 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
9229 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9230 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9231 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
9232 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
9233 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
9234 [rf]: https://github.com/rust-lang/rust/pull/24491
9235 [err-index]: https://doc.rust-lang.org/error-index.html
9236 [sk]: https://github.com/rust-lang/rust/pull/24615
9237 [pre]: https://github.com/rust-lang/rust/pull/25323
9238 [file]: https://github.com/rust-lang/rust/pull/24598
9239 [ch]: https://github.com/rust-lang/rust/pull/24683
9240 [arc]: https://github.com/rust-lang/rust/pull/24695
9241 [si]: https://github.com/rust-lang/rust/pull/24701
9242 [ap]: https://github.com/rust-lang/rust/pull/24834
9243 [m]: https://github.com/rust-lang/rust/pull/24777
9244 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
9245 [crc]: https://github.com/rust-lang/cargo/pull/1568
9246 [pie]: https://github.com/rust-lang/rust/pull/24953
9247 [abs]: https://github.com/rust-lang/rust/pull/25441
9248 [c]: https://github.com/rust-lang/rust/pull/25496
9249 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
9250 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
9251 [inc]: https://github.com/rust-lang/rust/pull/25522
9252 [bh]: https://github.com/rust-lang/rust/pull/25856
9253 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
9254 [ll]: https://github.com/rust-lang/rust/pull/26022
9255 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
9256 [24935]: https://github.com/rust-lang/rust/pull/24935
9257
9258 Version 1.0.0 (2015-05-15)
9259 ========================
9260
9261 * ~1500 changes, numerous bugfixes
9262
9263 Highlights
9264 ----------
9265
9266 * The vast majority of the standard library is now `#[stable]`. It is
9267   no longer possible to use unstable features with a stable build of
9268   the compiler.
9269 * Many popular crates on [crates.io] now work on the stable release
9270   channel.
9271 * Arithmetic on basic integer types now [checks for overflow in debug
9272   builds][overflow].
9273
9274 Language
9275 --------
9276
9277 * Several [restrictions have been added to trait coherence][coh] in
9278   order to make it easier for upstream authors to change traits
9279   without breaking downstream code.
9280 * Digits of binary and octal literals are [lexed more eagerly][lex] to
9281   improve error messages and macro behavior. For example, `0b1234` is
9282   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
9283 * Trait bounds [are always invariant][inv], eliminating the need for
9284   the `PhantomFn` and `MarkerTrait` lang items, which have been
9285   removed.
9286 * ["-" is no longer a valid character in crate names][cr], the `extern crate
9287   "foo" as bar` syntax has been replaced with `extern crate foo as
9288   bar`, and Cargo now automatically translates "-" in *package* names
9289   to underscore for the crate name.
9290 * [Lifetime shadowing is an error][lt].
9291 * [`Send` no longer implies `'static`][send-rfc].
9292 * [UFCS now supports trait-less associated paths][moar-ufcs] like
9293   `MyType::default()`.
9294 * Primitive types [now have inherent methods][prim-inherent],
9295   obviating the need for extension traits like `SliceExt`.
9296 * Methods with `Self: Sized` in their `where` clause are [considered
9297   object-safe][self-sized], allowing many extension traits like
9298   `IteratorExt` to be merged into the traits they extended.
9299 * You can now [refer to associated types][assoc-where] whose
9300   corresponding trait bounds appear only in a `where` clause.
9301 * The final bits of [OIBIT landed][oibit-final], meaning that traits
9302   like `Send` and `Sync` are now library-defined.
9303 * A [Reflect trait][reflect] was introduced, which means that
9304   downcasting via the `Any` trait is effectively limited to concrete
9305   types. This helps retain the potentially-important "parametricity"
9306   property: generic code cannot behave differently for different type
9307   arguments except in minor ways.
9308 * The `unsafe_destructor` feature is now deprecated in favor of the
9309   [new `dropck`][rfc769]. This change is a major reduction in unsafe
9310   code.
9311
9312 Libraries
9313 ---------
9314
9315 * The `thread_local` module [has been renamed to `std::thread`][th].
9316 * The methods of `IteratorExt` [have been moved to the `Iterator`
9317   trait itself][23300].
9318 * Several traits that implement Rust's conventions for type
9319   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
9320   [centralized in the `std::convert` module][con].
9321 * The `FromError` trait [was removed in favor of `From`][fe].
9322 * The basic sleep function [has moved to
9323   `std::thread::sleep_ms`][slp].
9324 * The `splitn` function now takes an `n` parameter that represents the
9325   number of items yielded by the returned iterator [instead of the
9326   number of 'splits'][spl].
9327 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
9328 * [Derived implementations of `PartialOrd` now order enums according
9329   to their explicitly-assigned discriminants][po].
9330 * [Methods for searching strings are generic over `Pattern`s][pat],
9331   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
9332   some others.
9333 * [In method resolution, object methods are resolved before inherent
9334   methods][meth].
9335 * [`String::from_str` has been deprecated in favor of the `From` impl,
9336   `String::from`][24517].
9337 * [`io::Error` implements `Sync`][ios].
9338 * [The `words` method on `&str` has been replaced with
9339   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
9340   a word?'
9341 * The new path and IO modules are complete and `#[stable]`. This
9342   was the major library focus for this cycle.
9343 * The path API was [revised][path-normalize] to normalize `.`,
9344   adjusting the tradeoffs in favor of the most common usage.
9345 * A large number of remaining APIs in `std` were also stabilized
9346   during this cycle; about 75% of the non-deprecated API surface
9347   is now stable.
9348 * The new [string pattern API][string-pattern] landed, which makes
9349   the string slice API much more internally consistent and flexible.
9350 * A new set of [generic conversion traits][conversion] replaced
9351   many existing ad hoc traits.
9352 * Generic numeric traits were [completely removed][num-traits]. This
9353   was made possible thanks to inherent methods for primitive types,
9354   and the removal gives maximal flexibility for designing a numeric
9355   hierarchy in the future.
9356 * The `Fn` traits are now related via [inheritance][fn-inherit]
9357   and provide ergonomic [blanket implementations][fn-blanket].
9358 * The `Index` and `IndexMut` traits were changed to
9359   [take the index by value][index-value], enabling code like
9360   `hash_map["string"]` to work.
9361 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
9362   `Copy` data is known to be `Clone` as well.
9363
9364 Misc
9365 ----
9366
9367 * Many errors now have extended explanations that can be accessed with
9368   the `--explain` flag to `rustc`.
9369 * Many new examples have been added to the standard library
9370   documentation.
9371 * rustdoc has received a number of improvements focused on completion
9372   and polish.
9373 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
9374 * Much headway was made on ecosystem-wide CI, making it possible
9375   to [compare builds for breakage][ci-compare].
9376
9377
9378 [crates.io]: http://crates.io
9379 [clo]: https://github.com/rust-lang/rust/pull/24034
9380 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
9381 [con]: https://github.com/rust-lang/rust/pull/23875
9382 [cr]: https://github.com/rust-lang/rust/pull/23419
9383 [fe]: https://github.com/rust-lang/rust/pull/23879
9384 [23300]: https://github.com/rust-lang/rust/pull/23300
9385 [inv]: https://github.com/rust-lang/rust/pull/23938
9386 [ios]: https://github.com/rust-lang/rust/pull/24133
9387 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
9388 [lt]: https://github.com/rust-lang/rust/pull/24057
9389 [meth]: https://github.com/rust-lang/rust/pull/24056
9390 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
9391 [po]: https://github.com/rust-lang/rust/pull/24270
9392 [24517]: https://github.com/rust-lang/rust/pull/24517
9393 [slp]: https://github.com/rust-lang/rust/pull/23949
9394 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
9395 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
9396 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
9397 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
9398 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
9399 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
9400 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
9401 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
9402 [self-sized]: https://github.com/rust-lang/rust/pull/22301
9403 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
9404 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
9405 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
9406 [reflect]: https://github.com/rust-lang/rust/pull/23712
9407 [conversion]: https://github.com/rust-lang/rfcs/pull/529
9408 [num-traits]: https://github.com/rust-lang/rust/pull/23549
9409 [index-value]: https://github.com/rust-lang/rust/pull/23601
9410 [rfc769]: https://github.com/rust-lang/rfcs/pull/769
9411 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
9412 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
9413 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
9414 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
9415 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
9416
9417
9418 Version 1.0.0-alpha.2 (2015-02-20)
9419 =====================================
9420
9421 * ~1300 changes, numerous bugfixes
9422
9423 * Highlights
9424
9425     * The various I/O modules were [overhauled][io-rfc] to reduce
9426       unnecessary abstractions and provide better interoperation with
9427       the underlying platform. The old `io` module remains temporarily
9428       at `std::old_io`.
9429     * The standard library now [participates in feature gating][feat],
9430       so use of unstable libraries now requires a `#![feature(...)]`
9431       attribute. The impact of this change is [described on the
9432       forum][feat-forum]. [RFC][feat-rfc].
9433
9434 * Language
9435
9436     * `for` loops [now operate on the `IntoIterator` trait][into],
9437       which eliminates the need to call `.iter()`, etc. to iterate
9438       over collections. There are some new subtleties to remember
9439       though regarding what sort of iterators various types yield, in
9440       particular that `for foo in bar { }` yields values from a move
9441       iterator, destroying the original collection. [RFC][into-rfc].
9442     * Objects now have [default lifetime bounds][obj], so you don't
9443       have to write `Box<Trait+'static>` when you don't care about
9444       storing references. [RFC][obj-rfc].
9445     * In types that implement `Drop`, [lifetimes must outlive the
9446       value][drop]. This will soon make it possible to safely
9447       implement `Drop` for types where `#[unsafe_destructor]` is now
9448       required. Read the [gorgeous RFC][drop-rfc] for details.
9449     * The fully qualified <T as Trait>::X syntax lets you set the Self
9450       type for a trait method or associated type. [RFC][ufcs-rfc].
9451     * References to types that implement `Deref<U>` now [automatically
9452       coerce to references][deref] to the dereferenced type `U`,
9453       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
9454       should eliminate many unsightly uses of `&*`, as when converting
9455       from references to vectors into references to
9456       slices. [RFC][deref-rfc].
9457     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
9458       `|:|`) is obsolete and closure kind is inferred from context.
9459     * [`Self` is a keyword][Self].
9460
9461 * Libraries
9462
9463     * The `Show` and `String` formatting traits [have been
9464       renamed][fmt] to `Debug` and `Display` to more clearly reflect
9465       their related purposes. Automatically getting a string
9466       conversion to use with `format!("{:?}", something_to_debug)` is
9467       now written `#[derive(Debug)]`.
9468     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
9469       OsStr}`, provide strings in platform-specific encodings for easier
9470       interop with system APIs. [RFC][osstr-rfc].
9471     * The `boxed::into_raw` and `Box::from_raw` functions [convert
9472       between `Box<T>` and `*mut T`][boxraw], a common pattern for
9473       creating raw pointers.
9474
9475 * Tooling
9476
9477     * Certain long error messages of the form 'expected foo found bar'
9478       are now [split neatly across multiple
9479       lines][multiline]. Examples in the PR.
9480     * On Unix Rust can be [uninstalled][un] by running
9481       `/usr/local/lib/rustlib/uninstall.sh`.
9482     * The `#[rustc_on_unimplemented]` attribute, requiring the
9483       'on_unimplemented' feature, lets rustc [display custom error
9484       messages when a trait is expected to be implemented for a type
9485       but is not][onun].
9486
9487 * Misc
9488
9489     * Rust is tested against a [LALR grammar][lalr], which parses
9490       almost all the Rust files that rustc does.
9491
9492 [boxraw]: https://github.com/rust-lang/rust/pull/21318
9493 [close]: https://github.com/rust-lang/rust/pull/21843
9494 [deref]: https://github.com/rust-lang/rust/pull/21351
9495 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
9496 [drop]: https://github.com/rust-lang/rust/pull/21972
9497 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
9498 [feat]: https://github.com/rust-lang/rust/pull/21248
9499 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
9500 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
9501 [fmt]: https://github.com/rust-lang/rust/pull/21457
9502 [into]: https://github.com/rust-lang/rust/pull/20790
9503 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
9504 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9505 [lalr]: https://github.com/rust-lang/rust/pull/21452
9506 [multiline]: https://github.com/rust-lang/rust/pull/19870
9507 [obj]: https://github.com/rust-lang/rust/pull/22230
9508 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
9509 [onun]: https://github.com/rust-lang/rust/pull/20889
9510 [osstr]: https://github.com/rust-lang/rust/pull/21488
9511 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9512 [Self]: https://github.com/rust-lang/rust/pull/22158
9513 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
9514 [un]: https://github.com/rust-lang/rust/pull/22256
9515
9516
9517 Version 1.0.0-alpha (2015-01-09)
9518 ==================================
9519
9520   * ~2400 changes, numerous bugfixes
9521
9522   * Highlights
9523
9524     * The language itself is considered feature complete for 1.0,
9525       though there will be many usability improvements and bugfixes
9526       before the final release.
9527     * Nearly 50% of the public API surface of the standard library has
9528       been declared 'stable'. Those interfaces are unlikely to change
9529       before 1.0.
9530     * The long-running debate over integer types has been
9531       [settled][ints]: Rust will ship with types named `isize` and
9532       `usize`, rather than `int` and `uint`, for pointer-sized
9533       integers. Guidelines will be rolled out during the alpha cycle.
9534     * Most crates that are not `std` have been moved out of the Rust
9535       distribution into the Cargo ecosystem so they can evolve
9536       separately and don't need to be stabilized as quickly, including
9537       'time', 'getopts', 'num', 'regex', and 'term'.
9538     * Documentation continues to be expanded with more API coverage, more
9539       examples, and more in-depth explanations. The guides have been
9540       consolidated into [The Rust Programming Language][trpl].
9541     * "[Rust By Example][rbe]" is now maintained by the Rust team.
9542     * All official Rust binary installers now come with [Cargo], the
9543       Rust package manager.
9544
9545 * Language
9546
9547     * Closures have been [completely redesigned][unboxed] to be
9548       implemented in terms of traits, can now be used as generic type
9549       bounds and thus monomorphized and inlined, or via an opaque
9550       pointer (boxed) as in the old system. The new system is often
9551       referred to as 'unboxed' closures.
9552     * Traits now support [associated types][assoc], allowing families
9553       of related types to be defined together and used generically in
9554       powerful ways.
9555     * Enum variants are [namespaced by their type names][enum].
9556     * [`where` clauses][where] provide a more versatile and attractive
9557       syntax for specifying generic bounds, though the previous syntax
9558       remains valid.
9559     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
9560       numeric types.
9561     * Rust [no longer has a runtime][rt] of any description, and only
9562       supports OS threads, not green threads.
9563     * At long last, Rust has been overhauled for 'dynamically-sized
9564       types' ([DST]), which integrates 'fat pointers' (object types,
9565       arrays, and `str`) more deeply into the type system, making it
9566       more consistent.
9567     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
9568       `..j` that produce range types and which, when combined with the
9569       `Index` operator and multidispatch, leads to a convenient slice
9570       notation, `[i..j]`.
9571     * The new range syntax revealed an ambiguity in the fixed-length
9572       array syntax, so now fixed length arrays [are written `[T;
9573       N]`][arrays].
9574     * The `Copy` trait is no longer implemented automatically. Unsafe
9575       pointers no longer implement `Sync` and `Send` so types
9576       containing them don't automatically either. `Sync` and `Send`
9577       are now 'unsafe traits' so one can "forcibly" implement them via
9578       `unsafe impl` if a type confirms to the requirements for them
9579       even though the internals do not (e.g. structs containing unsafe
9580       pointers like `Arc`). These changes are intended to prevent some
9581       footguns and are collectively known as [opt-in built-in
9582       traits][oibit] (though `Sync` and `Send` will soon become pure
9583       library types unknown to the compiler).
9584     * Operator traits now take their operands [by value][ops], and
9585       comparison traits can use multidispatch to compare one type
9586       against multiple other types, allowing e.g. `String` to be
9587       compared with `&str`.
9588     * `if let` and `while let` are no longer feature-gated.
9589     * Rust has adopted a more [uniform syntax for escaping unicode
9590       characters][unicode].
9591     * `macro_rules!` [has been declared stable][mac]. Though it is a
9592       flawed system it is sufficiently popular that it must be usable
9593       for 1.0. Effort has gone into [future-proofing][mac-future] it
9594       in ways that will allow other macro systems to be developed in
9595       parallel, and won't otherwise impact the evolution of the
9596       language.
9597     * The prelude has been [pared back significantly][prelude] such
9598       that it is the minimum necessary to support the most pervasive
9599       code patterns, and through [generalized where clauses][where]
9600       many of the prelude extension traits have been consolidated.
9601     * Rust's rudimentary reflection [has been removed][refl], as it
9602       incurred too much code generation for little benefit.
9603     * [Struct variants][structvars] are no longer feature-gated.
9604     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
9605       known as 'higher-ranked trait bounds', this crucially allows
9606       unboxed closures to work.
9607     * Macros invocations surrounded by parens or square brackets and
9608       not terminated by a semicolon are [parsed as
9609       expressions][macros], which makes expressions like `vec![1i32,
9610       2, 3].len()` work as expected.
9611     * Trait objects now implement their traits automatically, and
9612       traits that can be coerced to objects now must be [object
9613       safe][objsafe].
9614     * Automatically deriving traits is now done with `#[derive(...)]`
9615       not `#[deriving(...)]` for [consistency with other naming
9616       conventions][derive].
9617     * Importing the containing module or enum at the same time as
9618       items or variants they contain is [now done with `self` instead
9619       of `mod`][self], as in use `foo::{self, bar}`
9620     * Glob imports are no longer feature-gated.
9621     * The `box` operator and `box` patterns have been feature-gated
9622       pending a redesign. For now unique boxes should be allocated
9623       like other containers, with `Box::new`.
9624
9625 * Libraries
9626
9627     * A [series][coll1] of [efforts][coll2] to establish
9628       [conventions][coll3] for collections types has resulted in API
9629       improvements throughout the standard library.
9630     * New [APIs for error handling][err] provide ergonomic interop
9631       between error types, and [new conventions][err-conv] describe
9632       more clearly the recommended error handling strategies in Rust.
9633     * The `fail!` macro has been renamed to [`panic!`][panic] so that
9634       it is easier to discuss failure in the context of error handling
9635       without making clarifications as to whether you are referring to
9636       the 'fail' macro or failure more generally.
9637     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
9638       syscall when available.
9639     * The 'serialize' crate has been renamed 'rustc-serialize' and
9640       moved out of the distribution to Cargo. Although it is widely
9641       used now, it is expected to be superseded in the near future.
9642     * The `Show` formatter, typically implemented with
9643       `#[derive(Show)]` is [now requested with the `{:?}`
9644       specifier][show] and is intended for use by all types, for uses
9645       such as `println!` debugging. The new `String` formatter must be
9646       implemented by hand, uses the `{}` specifier, and is intended
9647       for full-fidelity conversions of things that can logically be
9648       represented as strings.
9649
9650 * Tooling
9651
9652     * [Flexible target specification][flex] allows rustc's code
9653       generation to be configured to support otherwise-unsupported
9654       platforms.
9655     * Rust comes with rust-gdb and rust-lldb scripts that launch their
9656       respective debuggers with Rust-appropriate pretty-printing.
9657     * The Windows installation of Rust is distributed with the
9658       MinGW components currently required to link binaries on that
9659       platform.
9660
9661 * Misc
9662
9663     * Nullable enum optimizations have been extended to more types so
9664       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
9665       space than the inner types themselves.
9666     * Work has begun on supporting AArch64.
9667
9668 [Cargo]: https://crates.io
9669 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
9670 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
9671 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
9672 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
9673 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
9674 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
9675 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
9676 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
9677 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
9678 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
9679 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
9680 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
9681 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
9682 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
9683 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
9684 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
9685 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
9686 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
9687 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
9688 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
9689 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
9690 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
9691 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
9692 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
9693 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
9694 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
9695 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
9696 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
9697 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
9698 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
9699 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
9700 [trpl]: https://doc.rust-lang.org/book/index.html
9701 [rbe]: http://rustbyexample.com/
9702
9703
9704 Version 0.12.0 (2014-10-09)
9705 =============================
9706
9707   * ~1900 changes, numerous bugfixes
9708
9709   * Highlights
9710
9711     * The introductory documentation (now called The Rust Guide) has
9712       been completely rewritten, as have a number of supplementary
9713       guides.
9714     * Rust's package manager, Cargo, continues to improve and is
9715       sometimes considered to be quite awesome.
9716     * Many API's in `std` have been reviewed and updated for
9717       consistency with the in-development Rust coding
9718       guidelines. The standard library documentation tracks
9719       stabilization progress.
9720     * Minor libraries have been moved out-of-tree to the rust-lang org
9721       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
9722       be installed with Cargo.
9723     * Lifetime elision allows lifetime annotations to be left off of
9724       function declarations in many common scenarios.
9725     * Rust now works on 64-bit Windows.
9726
9727   * Language
9728     * Indexing can be overloaded with the `Index` and `IndexMut`
9729       traits.
9730     * The `if let` construct takes a branch only if the `let` pattern
9731       matches, currently behind the 'if_let' feature gate.
9732     * 'where clauses', a more flexible syntax for specifying trait
9733       bounds that is more aesthetic, have been added for traits and
9734       free functions. Where clauses will in the future make it
9735       possible to constrain associated types, which would be
9736       impossible with the existing syntax.
9737     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
9738       the 'slicing_syntax' feature gate, and can be overloaded with
9739       the `Slice` or `SliceMut` traits.
9740     * The syntax for matching of sub-slices has been changed to use a
9741       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
9742       consistency with other uses of `..` and to future-proof
9743       potential additional uses of the syntax.
9744     * The syntax for matching inclusive ranges in patterns has changed
9745       from `0..3` to `0...4` to be consistent with the exclusive range
9746       syntax for slicing.
9747     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
9748       c]`) has been put behind the 'advanced_slice_patterns' feature
9749       gate and may be removed in the future.
9750     * Components of tuples and tuple structs can be extracted using
9751       the `value.0` syntax, currently behind the `tuple_indexing`
9752       feature gate.
9753     * The `#[crate_id]` attribute is no longer supported; versioning
9754       is handled by the package manager.
9755     * Renaming crate imports are now written `extern crate foo as bar`
9756       instead of `extern crate bar = foo`.
9757     * Renaming use statements are now written `use foo as bar` instead
9758       of `use bar = foo`.
9759     * `let` and `match` bindings and argument names in macros are now
9760       hygienic.
9761     * The new, more efficient, closure types ('unboxed closures') have
9762       been added under a feature gate, 'unboxed_closures'. These will
9763       soon replace the existing closure types, once higher-ranked
9764       trait lifetimes are added to the language.
9765     * `move` has been added as a keyword, for indicating closures
9766       that capture by value.
9767     * Mutation and assignment is no longer allowed in pattern guards.
9768     * Generic structs and enums can now have trait bounds.
9769     * The `Share` trait is now called `Sync` to free up the term
9770       'shared' to refer to 'shared reference' (the default reference
9771       type.
9772     * Dynamically-sized types have been mostly implemented,
9773       unifying the behavior of fat-pointer types with the rest of the
9774       type system.
9775     * As part of dynamically-sized types, the `Sized` trait has been
9776       introduced, which qualifying types implement by default, and
9777       which type parameters expect by default. To specify that a type
9778       parameter does not need to be sized, write `<Sized? T>`. Most
9779       types are `Sized`, notable exceptions being unsized arrays
9780       (`[T]`) and trait types.
9781     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
9782     * Lifetime bounds can now be applied to type parameters and object
9783       types.
9784     * The old, reference counted GC type, `Gc<T>` which was once
9785       denoted by the `@` sigil, has finally been removed. GC will be
9786       revisited in the future.
9787
9788   * Libraries
9789     * Library documentation has been improved for a number of modules.
9790     * Bit-vectors, collections::bitv has been modernized.
9791     * The url crate is deprecated in favor of
9792       http://github.com/servo/rust-url, which can be installed with
9793       Cargo.
9794     * Most I/O stream types can be cloned and subsequently closed from
9795       a different thread.
9796     * A `std::time::Duration` type has been added for use in I/O
9797       methods that rely on timers, as well as in the 'time' crate's
9798       `Timespec` arithmetic.
9799     * The runtime I/O abstraction layer that enabled the green thread
9800       scheduler to do non-thread-blocking I/O has been removed, along
9801       with the libuv-based implementation employed by the green thread
9802       scheduler. This will greatly simplify the future I/O work.
9803     * `collections::btree` has been rewritten to have a more
9804       idiomatic and efficient design.
9805
9806   * Tooling
9807     * rustdoc output now indicates the stability levels of API's.
9808     * The `--crate-name` flag can specify the name of the crate
9809       being compiled, like `#[crate_name]`.
9810     * The `-C metadata` specifies additional metadata to hash into
9811       symbol names, and `-C extra-filename` specifies additional
9812       information to put into the output filename, for use by the
9813       package manager for versioning.
9814     * debug info generation has continued to improve and should be
9815       more reliable under both gdb and lldb.
9816     * rustc has experimental support for compiling in parallel
9817       using the `-C codegen-units` flag.
9818     * rustc no longer encodes rpath information into binaries by
9819       default.
9820
9821   * Misc
9822     * Stack usage has been optimized with LLVM lifetime annotations.
9823     * Official Rust binaries on Linux are more compatible with older
9824       kernels and distributions, built on CentOS 5.10.
9825
9826
9827 Version 0.11.0 (2014-07-02)
9828 ==========================
9829
9830   * ~1700 changes, numerous bugfixes
9831
9832   * Language
9833     * ~[T] has been removed from the language. This type is superseded by
9834       the Vec<T> type.
9835     * ~str has been removed from the language. This type is superseded by
9836       the String type.
9837     * ~T has been removed from the language. This type is superseded by the
9838       Box<T> type.
9839     * @T has been removed from the language. This type is superseded by the
9840       standard library's std::gc::Gc<T> type.
9841     * Struct fields are now all private by default.
9842     * Vector indices and shift amounts are both required to be a `uint`
9843       instead of any integral type.
9844     * Byte character, byte string, and raw byte string literals are now all
9845       supported by prefixing the normal literal with a `b`.
9846     * Multiple ABIs are no longer allowed in an ABI string
9847     * The syntax for lifetimes on closures/procedures has been tweaked
9848       slightly: `<'a>|A, B|: 'b + K -> T`
9849     * Floating point modulus has been removed from the language; however it
9850       is still provided by a library implementation.
9851     * Private enum variants are now disallowed.
9852     * The `priv` keyword has been removed from the language.
9853     * A closure can no longer be invoked through a &-pointer.
9854     * The `use foo, bar, baz;` syntax has been removed from the language.
9855     * The transmute intrinsic no longer works on type parameters.
9856     * Statics now allow blocks/items in their definition.
9857     * Trait bounds are separated from objects with + instead of : now.
9858     * Objects can no longer be read while they are mutably borrowed.
9859     * The address of a static is now marked as insignificant unless the
9860       #[inline(never)] attribute is placed it.
9861     * The #[unsafe_destructor] attribute is now behind a feature gate.
9862     * Struct literals are no longer allowed in ambiguous positions such as
9863       if, while, match, and for..in.
9864     * Declaration of lang items and intrinsics are now feature-gated by
9865       default.
9866     * Integral literals no longer default to `int`, and floating point
9867       literals no longer default to `f64`. Literals must be suffixed with an
9868       appropriate type if inference cannot determine the type of the
9869       literal.
9870     * The Box<T> type is no longer implicitly borrowed to &mut T.
9871     * Procedures are now required to not capture borrowed references.
9872
9873   * Libraries
9874     * The standard library is now a "facade" over a number of underlying
9875       libraries. This means that development on the standard library should
9876       be speedier due to smaller crates, as well as a clearer line between
9877       all dependencies.
9878     * A new library, libcore, lives under the standard library's facade
9879       which is Rust's "0-assumption" library, suitable for embedded and
9880       kernel development for example.
9881     * A regex crate has been added to the standard distribution. This crate
9882       includes statically compiled regular expressions.
9883     * The unwrap/unwrap_err methods on Result require a Show bound for
9884       better error messages.
9885     * The return types of the std::comm primitives have been centralized
9886       around the Result type.
9887     * A number of I/O primitives have gained the ability to time out their
9888       operations.
9889     * A number of I/O primitives have gained the ability to close their
9890       reading/writing halves to cancel pending operations.
9891     * Reverse iterator methods have been removed in favor of `rev()` on
9892       their forward-iteration counterparts.
9893     * A bitflags! macro has been added to enable easy interop with C and
9894       management of bit flags.
9895     * A debug_assert! macro is now provided which is disabled when
9896       `--cfg ndebug` is passed to the compiler.
9897     * A graphviz crate has been added for creating .dot files.
9898     * The std::cast module has been migrated into std::mem.
9899     * The std::local_data api has been migrated from freestanding functions
9900       to being based on methods.
9901     * The Pod trait has been renamed to Copy.
9902     * jemalloc has been added as the default allocator for types.
9903     * The API for allocating memory has been changed to use proper alignment
9904       and sized deallocation
9905     * Connecting a TcpStream or binding a TcpListener is now based on a
9906       string address and a u16 port. This allows connecting to a hostname as
9907       opposed to an IP.
9908     * The Reader trait now contains a core method, read_at_least(), which
9909       correctly handles many repeated 0-length reads.
9910     * The process-spawning API is now centered around a builder-style
9911       Command struct.
9912     * The :? printing qualifier has been moved from the standard library to
9913       an external libdebug crate.
9914     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
9915       have been renamed to Eq/Ord.
9916     * The select/plural methods have been removed from format!. The escapes
9917       for { and } have also changed from \{ and \} to {{ and }},
9918       respectively.
9919     * The TaskBuilder API has been re-worked to be a true builder, and
9920       extension traits for spawning native/green tasks have been added.
9921
9922   * Tooling
9923     * All breaking changes to the language or libraries now have their
9924       commit message annotated with `[breaking-change]` to allow for easy
9925       discovery of breaking changes.
9926     * The compiler will now try to suggest how to annotate lifetimes if a
9927       lifetime-related error occurs.
9928     * Debug info continues to be improved greatly with general bug fixes and
9929       better support for situations like link time optimization (LTO).
9930     * Usage of syntax extensions when cross-compiling has been fixed.
9931     * Functionality equivalent to GCC & Clang's -ffunction-sections,
9932       -fdata-sections and --gc-sections has been enabled by default
9933     * The compiler is now stricter about where it will load module files
9934       from when a module is declared via `mod foo;`.
9935     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
9936       Syntax extensions are now discovered via a "plugin registrar" type
9937       which will be extended in the future to other various plugins.
9938     * Lints have been restructured to allow for dynamically loadable lints.
9939     * A number of rustdoc improvements:
9940       * The HTML output has been visually redesigned.
9941       * Markdown is now powered by hoedown instead of sundown.
9942       * Searching heuristics have been greatly improved.
9943       * The search index has been reduced in size by a great amount.
9944       * Cross-crate documentation via `pub use` has been greatly improved.
9945       * Primitive types are now hyperlinked and documented.
9946     * Documentation has been moved from static.rust-lang.org/doc to
9947       doc.rust-lang.org
9948     * A new sandbox, play.rust-lang.org, is available for running and
9949       sharing rust code examples on-line.
9950     * Unused attributes are now more robustly warned about.
9951     * The dead_code lint now warns about unused struct fields.
9952     * Cross-compiling to iOS is now supported.
9953     * Cross-compiling to mipsel is now supported.
9954     * Stability attributes are now inherited by default and no longer apply
9955       to intra-crate usage, only inter-crate usage.
9956     * Error message related to non-exhaustive match expressions have been
9957       greatly improved.
9958
9959
9960 Version 0.10 (2014-04-03)
9961 =========================
9962
9963   * ~1500 changes, numerous bugfixes
9964
9965   * Language
9966     * A new RFC process is now in place for modifying the language.
9967     * Patterns with `@`-pointers have been removed from the language.
9968     * Patterns with unique vectors (`~[T]`) have been removed from the
9969       language.
9970     * Patterns with unique strings (`~str`) have been removed from the
9971       language.
9972     * `@str` has been removed from the language.
9973     * `@[T]` has been removed from the language.
9974     * `@self` has been removed from the language.
9975     * `@Trait` has been removed from the language.
9976     * Headers on `~` allocations which contain `@` boxes inside the type for
9977       reference counting have been removed.
9978     * The semantics around the lifetimes of temporary expressions have changed,
9979       see #3511 and #11585 for more information.
9980     * Cross-crate syntax extensions are now possible, but feature gated. See
9981       #11151 for more information. This includes both `macro_rules!` macros as
9982       well as syntax extensions such as `format!`.
9983     * New lint modes have been added, and older ones have been turned on to be
9984       warn-by-default.
9985       * Unnecessary parentheses
9986       * Uppercase statics
9987       * Camel Case types
9988       * Uppercase variables
9989       * Publicly visible private types
9990       * `#[deriving]` with raw pointers
9991     * Unsafe functions can no longer be coerced to closures.
9992     * Various obscure macros such as `log_syntax!` are now behind feature gates.
9993     * The `#[simd]` attribute is now behind a feature gate.
9994     * Visibility is no longer allowed on `extern crate` statements, and
9995       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
9996     * Trailing commas are now allowed in argument lists and tuple patterns.
9997     * The `do` keyword has been removed, it is now a reserved keyword.
9998     * Default type parameters have been implemented, but are feature gated.
9999     * Borrowed variables through captures in closures are now considered soundly.
10000     * `extern mod` is now `extern crate`
10001     * The `Freeze` trait has been removed.
10002     * The `Share` trait has been added for types that can be shared among
10003       threads.
10004     * Labels in macros are now hygienic.
10005     * Expression/statement macro invocations can be delimited with `{}` now.
10006     * Treatment of types allowed in `static mut` locations has been tweaked.
10007     * The `*` and `.` operators are now overloadable through the `Deref` and
10008       `DerefMut` traits.
10009     * `~Trait` and `proc` no longer have `Send` bounds by default.
10010     * Partial type hints are now supported with the `_` type marker.
10011     * An `Unsafe` type was introduced for interior mutability. It is now
10012       considered undefined to transmute from `&T` to `&mut T` without using the
10013       `Unsafe` type.
10014     * The #[linkage] attribute was implemented for extern statics/functions.
10015     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
10016     * `Pod` was renamed to `Copy`.
10017
10018   * Libraries
10019     * The `libextra` library has been removed. It has now been decomposed into
10020       component libraries with smaller and more focused nuggets of
10021       functionality. The full list of libraries can be found on the
10022       documentation index page.
10023     * std: `std::condition` has been removed. All I/O errors are now propagated
10024       through the `Result` type. In order to assist with error handling, a
10025       `try!` macro for unwrapping errors with an early return and a lint for
10026       unused results has been added. See #12039 for more information.
10027     * std: The `vec` module has been renamed to `slice`.
10028     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
10029       This will become the only growable vector in the future.
10030     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
10031       are now found at `std::io::BufferedReader` instead of
10032       `std::io::buffered::BufferedReader`.
10033     * std: `print` and `println` are no longer in the prelude, the `print!` and
10034       `println!` macros are intended to be used instead.
10035     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
10036       attempts to statically prevent cycles.
10037     * std: The standard distribution is adopting the policy of pushing failure
10038       to the user rather than failing in libraries. Many functions (such as
10039       `slice::last()`) now return `Option<T>` instead of `T` + failing.
10040     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
10041       deriving mode: `#[deriving(Show)]`.
10042     * std: `ToStr` is now implemented for all types implementing `Show`.
10043     * std: The formatting trait methods now take `&self` instead of `&T`
10044     * std: The `invert()` method on iterators has been renamed to `rev()`
10045     * std: `std::num` has seen a reduction in the genericity of its traits,
10046       consolidating functionality into a few core traits.
10047     * std: Backtraces are now printed on task failure if the environment
10048       variable `RUST_BACKTRACE` is present.
10049     * std: Naming conventions for iterators have been standardized. More details
10050       can be found on the wiki's style guide.
10051     * std: `eof()` has been removed from the `Reader` trait. Specific types may
10052       still implement the function.
10053     * std: Networking types are now cloneable to allow simultaneous reads/writes.
10054     * std: `assert_approx_eq!` has been removed
10055     * std: The `e` and `E` formatting specifiers for floats have been added to
10056       print them in exponential notation.
10057     * std: The `Times` trait has been removed
10058     * std: Indications of variance and opting out of builtin bounds is done
10059       through marker types in `std::kinds::marker` now
10060     * std: `hash` has been rewritten, `IterBytes` has been removed, and
10061       `#[deriving(Hash)]` is now possible.
10062     * std: `SharedChan` has been removed, `Sender` is now cloneable.
10063     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
10064     * std: `Chan::new` is now `channel()`.
10065     * std: A new synchronous channel type has been implemented.
10066     * std: A `select!` macro is now provided for selecting over `Receiver`s.
10067     * std: `hashmap` and `trie` have been moved to `libcollections`
10068     * std: `run` has been rolled into `io::process`
10069     * std: `assert_eq!` now uses `{}` instead of `{:?}`
10070     * std: The equality and comparison traits have seen some reorganization.
10071     * std: `rand` has moved to `librand`.
10072     * std: `to_{lower,upper}case` has been implemented for `char`.
10073     * std: Logging has been moved to `liblog`.
10074     * collections: `HashMap` has been rewritten for higher performance and less
10075       memory usage.
10076     * native: The default runtime is now `libnative`. If `libgreen` is desired,
10077       it can be booted manually. The runtime guide has more information and
10078       examples.
10079     * native: All I/O functionality except signals has been implemented.
10080     * green: Task spawning with `libgreen` has been optimized with stack caching
10081       and various trimming of code.
10082     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
10083     * sync: The `extra::sync` module has been updated to modern rust (and moved
10084       to the `sync` library), tweaking and improving various interfaces while
10085       dropping redundant functionality.
10086     * sync: A new `Barrier` type has been added to the `sync` library.
10087     * sync: An efficient mutex for native and green tasks has been implemented.
10088     * serialize: The `base64` module has seen some improvement. It treats
10089       newlines better, has non-string error values, and has seen general
10090       cleanup.
10091     * fourcc: A `fourcc!` macro was introduced
10092     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
10093       hexadecimal literal.
10094
10095   * Tooling
10096     * `rustpkg` has been deprecated and removed from the main repository. Its
10097       replacement, `cargo`, is under development.
10098     * Nightly builds of rust are now available
10099     * The memory usage of rustc has been improved many times throughout this
10100       release cycle.
10101     * The build process supports disabling rpath support for the rustc binary
10102       itself.
10103     * Code generation has improved in some cases, giving more information to the
10104       LLVM optimization passes to enable more extensive optimizations.
10105     * Debuginfo compatibility with lldb on OSX has been restored.
10106     * The master branch is now gated on an android bot, making building for
10107       android much more reliable.
10108     * Output flags have been centralized into one `--emit` flag.
10109     * Crate type flags have been centralized into one `--crate-type` flag.
10110     * Codegen flags have been consolidated behind a `-C` flag.
10111     * Linking against outdated crates now has improved error messages.
10112     * Error messages with lifetimes will often suggest how to annotate the
10113       function to fix the error.
10114     * Many more types are documented in the standard library, and new guides
10115       were written.
10116     * Many `rustdoc` improvements:
10117       * code blocks are syntax highlighted.
10118       * render standalone markdown files.
10119       * the --test flag tests all code blocks by default.
10120       * exported macros are displayed.
10121       * re-exported types have their documentation inlined at the location of the
10122         first re-export.
10123       * search works across crates that have been rendered to the same output
10124         directory.
10125
10126
10127 Version 0.9 (2014-01-09)
10128 ==========================
10129
10130    * ~1800 changes, numerous bugfixes
10131
10132    * Language
10133       * The `float` type has been removed. Use `f32` or `f64` instead.
10134       * A new facility for enabling experimental features (feature gating) has
10135         been added, using the crate-level `#[feature(foo)]` attribute.
10136       * Managed boxes (@) are now behind a feature gate
10137         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
10138         standard library's `Gc` or `Rc` types instead.
10139       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
10140       * Jumping back to the top of a loop is now done with `continue` instead of
10141         `loop`.
10142       * Strings can no longer be mutated through index assignment.
10143       * Raw strings can be created via the basic `r"foo"` syntax or with matched
10144         hash delimiters, as in `r###"foo"###`.
10145       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
10146         called once.
10147       * The `&fn` type is now written `|args| -> ret` to match the literal form.
10148       * `@fn`s have been removed.
10149       * `do` only works with procs in order to make it obvious what the cost
10150         of `do` is.
10151       * Single-element tuple-like structs can no longer be dereferenced to
10152         obtain the inner value. A more comprehensive solution for overloading
10153         the dereference operator will be provided in the future.
10154       * The `#[link(...)]` attribute has been replaced with
10155         `#[crate_id = "name#vers"]`.
10156       * Empty `impl`s must be terminated with empty braces and may not be
10157         terminated with a semicolon.
10158       * Keywords are no longer allowed as lifetime names; the `self` lifetime
10159         no longer has any special meaning.
10160       * The old `fmt!` string formatting macro has been removed.
10161       * `printf!` and `printfln!` (old-style formatting) removed in favor of
10162         `print!` and `println!`.
10163       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
10164       * The `extern mod foo (name = "bar")` syntax has been removed. Use
10165         `extern mod foo = "bar"` instead.
10166       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
10167       * Macros can have attributes.
10168       * Macros can expand to items with attributes.
10169       * Macros can expand to multiple items.
10170       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
10171       * Comments may be nested.
10172       * Values automatically coerce to trait objects they implement, without
10173         an explicit `as`.
10174       * Enum discriminants are no longer an entire word but as small as needed to
10175         contain all the variants. The `repr` attribute can be used to override
10176         the discriminant size, as in `#[repr(int)]` for integer-sized, and
10177         `#[repr(C)]` to match C enums.
10178       * Non-string literals are not allowed in attributes (they never worked).
10179       * The FFI now supports variadic functions.
10180       * Octal numeric literals, as in `0o7777`.
10181       * The `concat!` syntax extension performs compile-time string concatenation.
10182       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
10183         removed as Rust no longer uses segmented stacks.
10184       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
10185       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
10186         not `*`; ignoring remaining fields of a struct is also done with `..`,
10187         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
10188       * `rustc` supports the "win64" calling convention via `extern "win64"`.
10189       * `rustc` supports the "system" calling convention, which defaults to the
10190         preferred convention for the target platform, "stdcall" on 32-bit Windows,
10191         "C" elsewhere.
10192       * The `type_overflow` lint (default: warn) checks literals for overflow.
10193       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
10194       * The `attribute_usage` lint (default: warn) warns about unknown
10195         attributes.
10196       * The `unknown_features` lint (default: warn) warns about unknown
10197         feature gates.
10198       * The `dead_code` lint (default: warn) checks for dead code.
10199       * Rust libraries can be linked statically to one another
10200       * `#[link_args]` is behind the `link_args` feature gate.
10201       * Native libraries are now linked with `#[link(name = "foo")]`
10202       * Native libraries can be statically linked to a rust crate
10203         (`#[link(name = "foo", kind = "static")]`).
10204       * Native OS X frameworks are now officially supported
10205         (`#[link(name = "foo", kind = "framework")]`).
10206       * The `#[thread_local]` attribute creates thread-local (not task-local)
10207         variables. Currently behind the `thread_local` feature gate.
10208       * The `return` keyword may be used in closures.
10209       * Types that can be copied via a memcpy implement the `Pod` kind.
10210       * The `cfg` attribute can now be used on struct fields and enum variants.
10211
10212    * Libraries
10213       * std: The `option` and `result` API's have been overhauled to make them
10214         simpler, more consistent, and more composable.
10215       * std: The entire `std::io` module has been replaced with one that is
10216         more comprehensive and that properly interfaces with the underlying
10217         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
10218         implemented.
10219       * std: `io::util` contains a number of useful implementations of
10220         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
10221         `ZeroReader`, `TeeReader`.
10222       * std: The reference counted pointer type `extra::rc` moved into std.
10223       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
10224         just a wrapper around it).
10225       * std: The `Either` type has been removed.
10226       * std: `fmt::Default` can be implemented for any type to provide default
10227         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
10228       * std: The `rand` API continues to be tweaked.
10229       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
10230         on failure in gdb, is now named `rust_fail`.
10231       * std: The `each_key` and `each_value` methods on `HashMap` have been
10232         replaced by the `keys` and `values` iterators.
10233       * std: Functions dealing with type size and alignment have moved from the
10234         `sys` module to the `mem` module.
10235       * std: The `path` module was written and API changed.
10236       * std: `str::from_utf8` has been changed to cast instead of allocate.
10237       * std: `starts_with` and `ends_with` methods added to vectors via the
10238         `ImmutableEqVector` trait, which is in the prelude.
10239       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
10240         if the index is out of bounds.
10241       * std: Task failure no longer propagates between tasks, as the model was
10242         complex, expensive, and incompatible with thread-based tasks.
10243       * std: The `Any` type can be used for dynamic typing.
10244       * std: `~Any` can be passed to the `fail!` macro and retrieved via
10245         `task::try`.
10246       * std: Methods that produce iterators generally do not have an `_iter`
10247         suffix now.
10248       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
10249         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
10250       * std: `util::ignore` renamed to `prelude::drop`.
10251       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
10252         trait.
10253       * std: `vec::raw` has seen a lot of cleanup and API changes.
10254       * std: The standard library no longer includes any C++ code, and very
10255         minimal C, eliminating the dependency on libstdc++.
10256       * std: Runtime scheduling and I/O functionality has been factored out into
10257         extensible interfaces and is now implemented by two different crates:
10258         libnative, for native threading and I/O; and libgreen, for green threading
10259         and I/O. This paves the way for using the standard library in more limited
10260         embedded environments.
10261       * std: The `comm` module has been rewritten to be much faster, have a
10262         simpler, more consistent API, and to work for both native and green
10263         threading.
10264       * std: All libuv dependencies have been moved into the rustuv crate.
10265       * native: New implementations of runtime scheduling on top of OS threads.
10266       * native: New native implementations of TCP, UDP, file I/O, process spawning,
10267         and other I/O.
10268       * green: The green thread scheduler and message passing types are almost
10269         entirely lock-free.
10270       * extra: The `flatpipes` module had bitrotted and was removed.
10271       * extra: All crypto functions have been removed and Rust now has a policy of
10272         not reimplementing crypto in the standard library. In the future crypto
10273         will be provided by external crates with bindings to established libraries.
10274       * extra: `c_vec` has been modernized.
10275       * extra: The `sort` module has been removed. Use the `sort` method on
10276         mutable slices.
10277
10278    * Tooling
10279       * The `rust` and `rusti` commands have been removed, due to lack of
10280         maintenance.
10281       * `rustdoc` was completely rewritten.
10282       * `rustdoc` can test code examples in documentation.
10283       * `rustpkg` can test packages with the argument, 'test'.
10284       * `rustpkg` supports arbitrary dependencies, including C libraries.
10285       * `rustc`'s support for generating debug info is improved again.
10286       * `rustc` has better error reporting for unbalanced delimiters.
10287       * `rustc`'s JIT support was removed due to bitrot.
10288       * Executables and static libraries can be built with LTO (-Z lto)
10289       * `rustc` adds a `--dep-info` flag for communicating dependencies to
10290         build tools.
10291
10292
10293 Version 0.8 (2013-09-26)
10294 ============================
10295
10296    * ~2200 changes, numerous bugfixes
10297
10298    * Language
10299       * The `for` loop syntax has changed to work with the `Iterator` trait.
10300       * At long last, unwinding works on Windows.
10301       * Default methods are ready for use.
10302       * Many trait inheritance bugs fixed.
10303       * Owned and borrowed trait objects work more reliably.
10304       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
10305       * rustc can omit emission of code for the `debug!` macro if it is passed
10306         `--cfg ndebug`
10307       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
10308         for foo.rs, then foo/mod.rs, and will generate an error when both are
10309         present.
10310       * Strings no longer contain trailing nulls. The new `std::c_str` module
10311         provides new mechanisms for converting to C strings.
10312       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
10313       * The FFI has been overhauled such that foreign functions are called directly,
10314         instead of through a stack-switching wrapper.
10315       * Calling a foreign function must be done through a Rust function with the
10316         `#[fixed_stack_segment]` attribute.
10317       * The `externfn!` macro can be used to declare both a foreign function and
10318         a `#[fixed_stack_segment]` wrapper at once.
10319       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
10320       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
10321       * `priv` is disallowed everywhere except for struct fields and enum variants.
10322       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
10323       * `ref` bindings in irrefutable patterns work correctly now.
10324       * `char` is now prevented from containing invalid code points.
10325       * Casting to `bool` is no longer allowed.
10326       * `\0` is now accepted as an escape in chars and strings.
10327       * `yield` is a reserved keyword.
10328       * `typeof` is a reserved keyword.
10329       * Crates may be imported by URL with `extern mod foo = "url";`.
10330       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
10331       * Static vectors can be initialized with repeating elements,
10332         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
10333       * Static structs can be initialized with functional record update,
10334         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
10335       * `cfg!` can be used to conditionally execute code based on the crate
10336         configuration, similarly to `#[cfg(...)]`.
10337       * The `unnecessary_qualification` lint detects unneeded module
10338         prefixes (default: allow).
10339       * Arithmetic operations have been implemented on the SIMD types in
10340         `std::unstable::simd`.
10341       * Exchange allocation headers were removed, reducing memory usage.
10342       * `format!` implements a completely new, extensible, and higher-performance
10343         string formatting system. It will replace `fmt!`.
10344       * `print!` and `println!` write formatted strings (using the `format!`
10345         extension) to stdout.
10346       * `write!` and `writeln!` write formatted strings (using the `format!`
10347         extension) to the new Writers in `std::rt::io`.
10348       * The library section in which a function or static is placed may
10349         be specified with `#[link_section = "..."]`.
10350       * The `proto!` syntax extension for defining bounded message protocols
10351         was removed.
10352       * `macro_rules!` is hygienic for `let` declarations.
10353       * The `#[export_name]` attribute specifies the name of a symbol.
10354       * `unreachable!` can be used to indicate unreachable code, and fails
10355         if executed.
10356
10357    * Libraries
10358       * std: Transitioned to the new runtime, written in Rust.
10359       * std: Added an experimental I/O library, `rt::io`, based on the new
10360         runtime.
10361       * std: A new generic `range` function was added to the prelude, replacing
10362         `uint::range` and friends.
10363       * std: `range_rev` no longer exists. Since range is an iterator it can be
10364         reversed with `range(lo, hi).invert()`.
10365       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
10366         renamed to `unwrap_or`.
10367       * std: The `iterator` module was renamed to `iter`.
10368       * std: Integral types now support the `checked_add`, `checked_sub`, and
10369         `checked_mul` operations for detecting overflow.
10370       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
10371         consistency.
10372       * std: Methods are standardizing on conventions for casting methods:
10373         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
10374         and cheap casts.
10375       * std: The `CString` type in `c_str` provides new ways to convert to and
10376         from C strings.
10377       * std: `DoubleEndedIterator` can yield elements in two directions.
10378       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
10379         two splices.
10380       * std: `str::from_bytes` renamed to `str::from_utf8`.
10381       * std: `pop_opt` and `shift_opt` methods added to vectors.
10382       * std: The task-local data interface no longer uses @, and keys are
10383         no longer function pointers.
10384       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
10385       * std: Added `SharedPort` to `comm`.
10386       * std: `Eq` has a default method for `ne`; only `eq` is required
10387         in implementations.
10388       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
10389         is required in implementations.
10390       * std: `is_utf8` performance is improved, impacting many string functions.
10391       * std: `os::MemoryMap` provides cross-platform mmap.
10392       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
10393         are not 'in-bounds' are considered undefined.
10394       * std: Many freestanding functions in `vec` removed in favor of methods.
10395       * std: Many freestanding functions on scalar types removed in favor of
10396         methods.
10397       * std: Many options to task builders were removed since they don't make
10398         sense in the new scheduler design.
10399       * std: More containers implement `FromIterator` so can be created by the
10400         `collect` method.
10401       * std: More complete atomic types in `unstable::atomics`.
10402       * std: `comm::PortSet` removed.
10403       * std: Mutating methods in the `Set` and `Map` traits have been moved into
10404         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
10405         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
10406         default implementations.
10407       * std: Various `from_str` functions were removed in favor of a generic
10408         `from_str` which is available in the prelude.
10409       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
10410       * extra: `dlist`, the doubly-linked list was modernized.
10411       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
10412       * extra: Added `glob` module, replacing `std::os::glob`.
10413       * extra: `rope` was removed.
10414       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
10415       * extra: `net`, and `timer` were removed. The experimental replacements
10416         are `std::rt::io::net` and `std::rt::io::timer`.
10417       * extra: Iterators implemented for `SmallIntMap`.
10418       * extra: Iterators implemented for `Bitv` and `BitvSet`.
10419       * extra: `SmallIntSet` removed. Use `BitvSet`.
10420       * extra: Performance of JSON parsing greatly improved.
10421       * extra: `semver` updated to SemVer 2.0.0.
10422       * extra: `term` handles more terminals correctly.
10423       * extra: `dbg` module removed.
10424       * extra: `par` module removed.
10425       * extra: `future` was cleaned up, with some method renames.
10426       * extra: Most free functions in `getopts` were converted to methods.
10427
10428    * Other
10429       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
10430       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
10431         similarly to gcc's `--march` flag.
10432       * rustc's performance compiling small crates is much better.
10433       * rustpkg has received many improvements.
10434       * rustpkg supports git tags as package IDs.
10435       * rustpkg builds into target-specific directories so it can be used for
10436         cross-compiling.
10437       * The number of concurrent test tasks is controlled by the environment
10438         variable RUST_TEST_TASKS.
10439       * The test harness can now report metrics for benchmarks.
10440       * All tools have man pages.
10441       * Programs compiled with `--test` now support the `-h` and `--help` flags.
10442       * The runtime uses jemalloc for allocations.
10443       * Segmented stacks are temporarily disabled as part of the transition to
10444         the new runtime. Stack overflows are possible!
10445       * A new documentation backend, rustdoc_ng, is available for use. It is
10446         still invoked through the normal `rustdoc` command.
10447
10448
10449 Version 0.7 (2013-07-03)
10450 =======================
10451
10452    * ~2000 changes, numerous bugfixes
10453
10454    * Language
10455       * `impl`s no longer accept a visibility qualifier. Put them on methods
10456         instead.
10457       * The borrow checker has been rewritten with flow-sensitivity, fixing
10458         many bugs and inconveniences.
10459       * The `self` parameter no longer implicitly means `&'self self`,
10460         and can be explicitly marked with a lifetime.
10461       * Overloadable compound operators (`+=`, etc.) have been temporarily
10462         removed due to bugs.
10463       * The `for` loop protocol now requires `for`-iterators to return `bool`
10464         so they compose better.
10465       * The `Durable` trait is replaced with the `'static` bounds.
10466       * Trait default methods work more often.
10467       * Structs with the `#[packed]` attribute have byte alignment and
10468         no padding between fields.
10469       * Type parameters bound by `Copy` must now be copied explicitly with
10470         the `copy` keyword.
10471       * It is now illegal to move out of a dereferenced unsafe pointer.
10472       * `Option<~T>` is now represented as a nullable pointer.
10473       * `@mut` does dynamic borrow checks correctly.
10474       * The `main` function is only detected at the topmost level of the crate.
10475         The `#[main]` attribute is still valid anywhere.
10476       * Struct fields may no longer be mutable. Use inherited mutability.
10477       * The `#[no_send]` attribute makes a type that would otherwise be
10478         `Send`, not.
10479       * The `#[no_freeze]` attribute makes a type that would otherwise be
10480         `Freeze`, not.
10481       * Unbounded recursion will abort the process after reaching the limit
10482         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
10483       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
10484         are never implicitly copyable.
10485       * `#[static_assert]` makes compile-time assertions about static bools.
10486       * At long last, 'argument modes' no longer exist.
10487       * The rarely used `use mod` statement no longer exists.
10488
10489    * Syntax extensions
10490       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
10491         argument list.
10492       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
10493         `Rand`, `Zero` and `ToStr` can all be automatically derived with
10494         `#[deriving(...)]`.
10495       * The `bytes!` macro returns a vector of bytes for string, u8, char,
10496         and unsuffixed integer literals.
10497
10498    * Libraries
10499       * The `core` crate was renamed to `std`.
10500       * The `std` crate was renamed to `extra`.
10501       * More and improved documentation.
10502       * std: `iterator` module for external iterator objects.
10503       * Many old-style (internal, higher-order function) iterators replaced by
10504         implementations of `Iterator`.
10505       * std: Many old internal vector and string iterators,
10506         incl. `any`, `all`. removed.
10507       * std: The `finalize` method of `Drop` renamed to `drop`.
10508       * std: The `drop` method now takes `&mut self` instead of `&self`.
10509       * std: The prelude no longer re-exports any modules, only types and traits.
10510       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
10511         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
10512       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
10513         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
10514       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
10515         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
10516       * std: Many types implement `Clone`.
10517       * std: `path` type renamed to `Path`.
10518       * std: `mut` module and `Mut` type removed.
10519       * std: Many standalone functions removed in favor of methods and iterators
10520         in `vec`, `str`. In the future methods will also work as functions.
10521       * std: `reinterpret_cast` removed. Use `transmute`.
10522       * std: ascii string handling in `std::ascii`.
10523       * std: `Rand` is implemented for ~/@.
10524       * std: `run` module for spawning processes overhauled.
10525       * std: Various atomic types added to `unstable::atomic`.
10526       * std: Various types implement `Zero`.
10527       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
10528       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
10529       * std: Added `os::mkdir_recursive`.
10530       * std: Added `os::glob` function performs filesystems globs.
10531       * std: `FuzzyEq` renamed to `ApproxEq`.
10532       * std: `Map` now defines `pop` and `swap` methods.
10533       * std: `Cell` constructors converted to static methods.
10534       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
10535       * extra: `flate` module moved from `std` to `extra`.
10536       * extra: `fileinput` module for iterating over a series of files.
10537       * extra: `Complex` number type and `complex` module.
10538       * extra: `Rational` number type and `rational` module.
10539       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
10540       * extra: `term` uses terminfo now, is more correct.
10541       * extra: `arc` functions converted to methods.
10542       * extra: Implementation of fixed output size variations of SHA-2.
10543
10544    * Tooling
10545       * `unused_variables` lint mode for unused variables (default: warn).
10546       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
10547         (default: warn).
10548       * `unused_mut` lint mode for identifying unused `mut` qualifiers
10549         (default: warn).
10550       * `dead_assignment` lint mode for unread variables (default: warn).
10551       * `unnecessary_allocation` lint mode detects some heap allocations that are
10552         immediately borrowed so could be written without allocating (default: warn).
10553       * `missing_doc` lint mode (default: allow).
10554       * `unreachable_code` lint mode (default: warn).
10555       * The `rusti` command has been rewritten and a number of bugs addressed.
10556       * rustc outputs in color on more terminals.
10557       * rustc accepts a `--link-args` flag to pass arguments to the linker.
10558       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
10559       * Compiling with `-g` will make the binary record information about
10560         dynamic borrowcheck failures for debugging.
10561       * rustdoc has a nicer stylesheet.
10562       * Various improvements to rustdoc.
10563       * Improvements to rustpkg (see the detailed release notes).
10564
10565
10566 Version 0.6 (2013-04-03)
10567 ========================
10568
10569    * ~2100 changes, numerous bugfixes
10570
10571    * Syntax changes
10572       * The self type parameter in traits is now spelled `Self`
10573       * The `self` parameter in trait and impl methods must now be explicitly
10574         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
10575       * Static methods no longer require the `static` keyword and instead
10576         are distinguished by the lack of a `self` parameter
10577       * Replaced the `Durable` trait with the `'static` lifetime
10578       * The old closure type syntax with the trailing sigil has been
10579         removed in favor of the more consistent leading sigil
10580       * `super` is a keyword, and may be prefixed to paths
10581       * Trait bounds are separated with `+` instead of whitespace
10582       * Traits are implemented with `impl Trait for Type`
10583         instead of `impl Type: Trait`
10584       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
10585       * The `export` keyword has finally been removed
10586       * The `move` keyword has been removed (see "Semantic changes")
10587       * The interior mutability qualifier on vectors, `[mut T]`, has been
10588         removed. Use `&mut [T]`, etc.
10589       * `mut` is no longer valid in `~mut T`. Use inherited mutability
10590       * `fail` is no longer a keyword. Use `fail!()`
10591       * `assert` is no longer a keyword. Use `assert!()`
10592       * `log` is no longer a keyword. use `debug!`, etc.
10593       * 1-tuples may be represented as `(T,)`
10594       * Struct fields may no longer be `mut`. Use inherited mutability,
10595         `@mut T`, `core::mut` or `core::cell`
10596       * `extern mod { ... }` is no longer valid syntax for foreign
10597         function modules. Use extern blocks: `extern { ... }`
10598       * Newtype enums removed. Use tuple-structs.
10599       * Trait implementations no longer support visibility modifiers
10600       * Pattern matching over vectors improved and expanded
10601       * `const` renamed to `static` to correspond to lifetime name,
10602         and make room for future `static mut` unsafe mutable globals.
10603       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
10604       * `Clone` implementations can be automatically generated with
10605         `#[deriving(Clone)]`
10606       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
10607         instead of `foo as Bar`.
10608       * Fixed length vector types are now written as `[int, .. 3]`
10609         instead of `[int * 3]`.
10610       * Fixed length vector types can express the length as a constant
10611         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
10612
10613    * Semantic changes
10614       * Types with owned pointers or custom destructors move by default,
10615         eliminating the `move` keyword
10616       * All foreign functions are considered unsafe
10617       * &mut is now unaliasable
10618       * Writes to borrowed @mut pointers are prevented dynamically
10619       * () has size 0
10620       * The name of the main function can be customized using #[main]
10621       * The default type of an inferred closure is &fn instead of @fn
10622       * `use` statements may no longer be "chained" - they cannot import
10623         identifiers imported by previous `use` statements
10624       * `use` statements are crate relative, importing from the "top"
10625         of the crate by default. Paths may be prefixed with `super::`
10626         or `self::` to change the search behavior.
10627       * Method visibility is inherited from the implementation declaration
10628       * Structural records have been removed
10629       * Many more types can be used in static items, including enums
10630         'static-lifetime pointers and vectors
10631       * Pattern matching over vectors improved and expanded
10632       * Typechecking of closure types has been overhauled to
10633         improve inference and eliminate unsoundness
10634       * Macros leave scope at the end of modules, unless that module is
10635         tagged with #[macro_escape]
10636
10637    * Libraries
10638       * Added big integers to `std::bigint`
10639       * Removed `core::oldcomm` module
10640       * Added pipe-based `core::comm` module
10641       * Numeric traits have been reorganized under `core::num`
10642       * `vec::slice` finally returns a slice
10643       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
10644       * Containers reorganized around traits in `core::container`
10645       * `core::dvec` removed, `~[T]` is a drop-in replacement
10646       * `core::send_map` renamed to `core::hashmap`
10647       * `std::map` removed; replaced with `core::hashmap`
10648       * `std::treemap` reimplemented as an owned balanced tree
10649       * `std::deque` and `std::smallintmap` reimplemented as owned containers
10650       * `core::trie` added as a fast ordered map for integer keys
10651       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
10652       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
10653         overload the comparison operators, whereas `TotalOrd` is used
10654         by certain container types
10655
10656    * Other
10657       * Replaced the 'cargo' package manager with 'rustpkg'
10658       * Added all-purpose 'rust' tool
10659       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
10660       * rustc now *attempts* to offer spelling suggestions
10661       * Improved support for ARM and Android
10662       * Preliminary MIPS backend
10663       * Improved foreign function ABI implementation for x86, x86_64
10664       * Various memory usage improvements
10665       * Rust code may be embedded in foreign code under limited circumstances
10666       * Inline assembler supported by new asm!() syntax extension.
10667
10668
10669 Version 0.5 (2012-12-21)
10670 ===========================
10671
10672    * ~900 changes, numerous bugfixes
10673
10674    * Syntax changes
10675       * Removed `<-` move operator
10676       * Completed the transition from the `#fmt` extension syntax to `fmt!`
10677       * Removed old fixed length vector syntax - `[T]/N`
10678       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
10679       * Macros may now expand to items and statements
10680       * `a.b()` is always parsed as a method call, never as a field projection
10681       * `Eq` and `IterBytes` implementations can be automatically generated
10682         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
10683       * Removed the special crate language for `.rc` files
10684       * Function arguments may consist of any irrefutable pattern
10685
10686    * Semantic changes
10687       * `&` and `~` pointers may point to objects
10688       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
10689       * Enum variants may be structs
10690       * Destructors can be added to all nominal types with the Drop trait
10691       * Structs and nullary enum variants may be constants
10692       * Values that cannot be implicitly copied are now automatically moved
10693         without writing `move` explicitly
10694       * `&T` may now be coerced to `*T`
10695       * Coercions happen in `let` statements as well as function calls
10696       * `use` statements now take crate-relative paths
10697       * The module and type namespaces have been merged so that static
10698         method names can be resolved under the trait in which they are
10699         declared
10700
10701    * Improved support for language features
10702       * Trait inheritance works in many scenarios
10703       * More support for explicit self arguments in methods - `self`, `&self`
10704         `@self`, and `~self` all generally work as expected
10705       * Static methods work in more situations
10706       * Experimental: Traits may declare default methods for the implementations
10707         to use
10708
10709    * Libraries
10710       * New condition handling system in `core::condition`
10711       * Timsort added to `std::sort`
10712       * New priority queue, `std::priority_queue`
10713       * Pipes for serializable types, `std::flatpipes'
10714       * Serialization overhauled to be trait-based
10715       * Expanded `getopts` definitions
10716       * Moved futures to `std`
10717       * More functions are pure now
10718       * `core::comm` renamed to `oldcomm`. Still deprecated
10719       * `rustdoc` and `cargo` are libraries now
10720
10721    * Misc
10722       * Added a preliminary REPL, `rusti`
10723       * License changed from MIT to dual MIT/APL2
10724
10725
10726 Version 0.4 (2012-10-15)
10727 ==========================
10728
10729    * ~2000 changes, numerous bugfixes
10730
10731    * Syntax
10732       * All keywords are now strict and may not be used as identifiers anywhere
10733       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
10734         'of', 'with', 'to', 'class'.
10735       * Classes are replaced with simpler structs
10736       * Explicit method self types
10737       * `ret` became `return` and `alt` became `match`
10738       * `import` is now `use`; `use is now `extern mod`
10739       * `extern mod { ... }` is now `extern { ... }`
10740       * `use mod` is the recommended way to import modules
10741       * `pub` and `priv` replace deprecated export lists
10742       * The syntax of `match` pattern arms now uses fat arrow (=>)
10743       * `main` no longer accepts an args vector; use `os::args` instead
10744
10745    * Semantics
10746       * Trait implementations are now coherent, ala Haskell typeclasses
10747       * Trait methods may be static
10748       * Argument modes are deprecated
10749       * Borrowed pointers are much more mature and recommended for use
10750       * Strings and vectors in the static region are stored in constant memory
10751       * Typestate was removed
10752       * Resolution rewritten to be more reliable
10753       * Support for 'dual-mode' data structures (freezing and thawing)
10754
10755    * Libraries
10756       * Most binary operators can now be overloaded via the traits in
10757         `core::ops'
10758       * `std::net::url` for representing URLs
10759       * Sendable hash maps in `core::send_map`
10760       * `core::task' gained a (currently unsafe) task-local storage API
10761
10762    * Concurrency
10763       * An efficient new intertask communication primitive called the pipe,
10764         along with a number of higher-level channel types, in `core::pipes`
10765       * `std::arc`, an atomically reference counted, immutable, shared memory
10766         type
10767       * `std::sync`, various exotic synchronization tools based on arcs and pipes
10768       * Futures are now based on pipes and sendable
10769       * More robust linked task failure
10770       * Improved task builder API
10771
10772    * Other
10773       * Improved error reporting
10774       * Preliminary JIT support
10775       * Preliminary work on precise GC
10776       * Extensive architectural improvements to rustc
10777       * Begun a transition away from buggy C++-based reflection (shape) code to
10778         Rust-based (visitor) code
10779       * All hash functions and tables converted to secure, randomized SipHash
10780
10781
10782 Version 0.3  (2012-07-12)
10783 ========================
10784
10785    * ~1900 changes, numerous bugfixes
10786
10787    * New coding conveniences
10788       * Integer-literal suffix inference
10789       * Per-item control over warnings, errors
10790       * #[cfg(windows)] and #[cfg(unix)] attributes
10791       * Documentation comments
10792       * More compact closure syntax
10793       * 'do' expressions for treating higher-order functions as
10794         control structures
10795       * *-patterns (wildcard extended to all constructor fields)
10796
10797    * Semantic cleanup
10798       * Name resolution pass and exhaustiveness checker rewritten
10799       * Region pointers and borrow checking supersede alias
10800         analysis
10801       * Init-ness checking is now provided by a region-based liveness
10802         pass instead of the typestate pass; same for last-use analysis
10803       * Extensive work on region pointers
10804
10805    * Experimental new language features
10806       * Slices and fixed-size, interior-allocated vectors
10807       * #!-comments for lang versioning, shell execution
10808       * Destructors and iface implementation for classes;
10809         type-parameterized classes and class methods
10810       * 'const' type kind for types that can be used to implement
10811         shared-memory concurrency patterns
10812
10813    * Type reflection
10814
10815    * Removal of various obsolete features
10816       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
10817                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
10818
10819       * Constructs: do-while loops ('do' repurposed), fn binding,
10820                     resources (replaced by destructors)
10821
10822    * Compiler reorganization
10823       * Syntax-layer of compiler split into separate crate
10824       * Clang (from LLVM project) integrated into build
10825       * Typechecker split into sub-modules
10826
10827    * New library code
10828       * New time functions
10829       * Extension methods for many built-in types
10830       * Arc: atomic-refcount read-only / exclusive-use shared cells
10831       * Par: parallel map and search routines
10832       * Extensive work on libuv interface
10833       * Much vector code moved to libraries
10834       * Syntax extensions: #line, #col, #file, #mod, #stringify,
10835         #include, #include_str, #include_bin
10836
10837    * Tool improvements
10838       * Cargo automatically resolves dependencies
10839
10840
10841 Version 0.2  (2012-03-29)
10842 =========================
10843
10844    * >1500 changes, numerous bugfixes
10845
10846    * New docs and doc tooling
10847
10848    * New port: FreeBSD x86_64
10849
10850    * Compilation model enhancements
10851       * Generics now specialized, multiply instantiated
10852       * Functions now inlined across separate crates
10853
10854    * Scheduling, stack and threading fixes
10855       * Noticeably improved message-passing performance
10856       * Explicit schedulers
10857       * Callbacks from C
10858       * Helgrind clean
10859
10860    * Experimental new language features
10861       * Operator overloading
10862       * Region pointers
10863       * Classes
10864
10865    * Various language extensions
10866       * C-callback function types: 'crust fn ...'
10867       * Infinite-loop construct: 'loop { ... }'
10868       * Shorten 'mutable' to 'mut'
10869       * Required mutable-local qualifier: 'let mut ...'
10870       * Basic glob-exporting: 'export foo::*;'
10871       * Alt now exhaustive, 'alt check' for runtime-checked
10872       * Block-function form of 'for' loop, with 'break' and 'ret'.
10873
10874    * New library code
10875       * AST quasi-quote syntax extension
10876       * Revived libuv interface
10877       * New modules: core::{future, iter}, std::arena
10878       * Merged per-platform std::{os*, fs*} to core::{libc, os}
10879       * Extensive cleanup, regularization in libstd, libcore
10880
10881
10882 Version 0.1  (2012-01-20)
10883 ===============================
10884
10885    * Most language features work, including:
10886       * Unique pointers, unique closures, move semantics
10887       * Interface-constrained generics
10888       * Static interface dispatch
10889       * Stack growth
10890       * Multithread task scheduling
10891       * Typestate predicates
10892       * Failure unwinding, destructors
10893       * Pattern matching and destructuring assignment
10894       * Lightweight block-lambda syntax
10895       * Preliminary macro-by-example
10896
10897    * Compiler works with the following configurations:
10898       * Linux: x86 and x86_64 hosts and targets
10899       * macOS: x86 and x86_64 hosts and targets
10900       * Windows: x86 hosts and targets
10901
10902    * Cross compilation / multi-target configuration supported.
10903
10904    * Preliminary API-documentation and package-management tools included.
10905
10906 Known issues:
10907
10908    * Documentation is incomplete.
10909
10910    * Performance is below intended target.
10911
10912    * Standard library APIs are subject to extensive change, reorganization.
10913
10914    * Language-level versioning is not yet operational - future code will
10915      break unexpectedly.