RELEASES.md

   1 Version 1.58.0 (2022-01-13)
   2 ==========================
   3
   4 Language
   5 --------
   6
   7 - [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.
   8 - [`*const T` pointers can now be dereferenced in const contexts.][89551]
   9 - [The rules for when a generic struct implements `Unsize` have been relaxed.][90417]
  10
  11 Compiler
  12 --------
  13
  14 - [Add LLVM CFI support to the Rust compiler][89652]
  15 - [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.
  16 - [Add support for LLVM coverage mapping format versions 5 and 6][91207]
  17 - [Emit LLVM optimization remarks when enabled with `-Cremark`][90833]
  18 - [Update the minimum external LLVM to 12][90175]
  19 - [Add `x86_64-unknown-none` at Tier 3*][89062]
  20 - [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.
  21 - [Don't abort compilation after giving a lint error][87337]
  22 - [Error messages point at the source of trait bound obligations in more places][89580]
  23
  24 \* Refer to Rust's [platform support page][platform-support-doc] for more
  25    information on Rust's tiered platform support.
  26
  27 Libraries
  28 ---------
  29
  30 - [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.
  31 - [Paths are automatically canonicalized on Windows for operations that support it][89174]
  32 - [Re-enable debug checks for `copy` and `copy_nonoverlapping`][90041]
  33 - [Implement `RefUnwindSafe` for `Rc<T>`][87467]
  34 - [Make RSplit<T, P>: Clone not require T: Clone][90117]
  35 - [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).
  36
  37 Stabilized APIs
  38 ---------------
  39
  40 - [`Metadata::is_symlink`]
  41 - [`Path::is_symlink`]
  42 - [`{integer}::saturating_div`]
  43 - [`Option::unwrap_unchecked`]
  44 - [`Result::unwrap_unchecked`]
  45 - [`Result::unwrap_err_unchecked`]
  46 - [`File::options`]
  47
  48 These APIs are now usable in const contexts:
  49
  50 - [`Duration::new`]
  51 - [`Duration::checked_add`]
  52 - [`Duration::saturating_add`]
  53 - [`Duration::checked_sub`]
  54 - [`Duration::saturating_sub`]
  55 - [`Duration::checked_mul`]
  56 - [`Duration::saturating_mul`]
  57 - [`Duration::checked_div`]
  58
  59 Cargo
  60 -----
  61
  62 - [Add --message-format for install command][cargo/10107]
  63 - [Warn when alias shadows external subcommand][cargo/10082]
  64
  65 Rustdoc
  66 -------
  67
  68 - [Show all Deref implementations recursively in rustdoc][90183]
  69 - [Use computed visibility in rustdoc][88447]
  70
  71 Compatibility Notes
  72 -------------------
  73
  74 - [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.
  75 - Windows: [`std::process::Command` will no longer search the current directory for executables.][87704]
  76 - [All proc-macro backward-compatibility lints are now deny-by-default.][88041]
  77 - [proc_macro: Append .0 to unsuffixed float if it would otherwise become int token][90297]
  78 - [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.
  79 - [rustdoc now rejects some unexpected semicolons in doctests][91026]
  80
  81 Internal Changes
  82 ----------------
  83
  84 These changes provide no direct user facing benefits, but represent significant
  85 improvements to the internals and overall performance of rustc
  86 and related tools.
  87
  88 - [Implement coherence checks for negative trait impls][90104]
  89 - [Add rustc lint, warning when iterating over hashmaps][89558]
  90 - [Optimize live point computation][90491]
  91 - [Enable verification for 1/32nd of queries loaded from disk][90361]
  92 - [Implement version of normalize_erasing_regions that allows for normalization failure][91255]
  93
  94 [87337]: https://github.com/rust-lang/rust/pull/87337/
  95 [87467]: https://github.com/rust-lang/rust/pull/87467/
  96 [87704]: https://github.com/rust-lang/rust/pull/87704/
  97 [88041]: https://github.com/rust-lang/rust/pull/88041/
  98 [88300]: https://github.com/rust-lang/rust/pull/88300/
  99 [88447]: https://github.com/rust-lang/rust/pull/88447/
 100 [88601]: https://github.com/rust-lang/rust/pull/88601/
 101 [88624]: https://github.com/rust-lang/rust/pull/88624/
 102 [89062]: https://github.com/rust-lang/rust/pull/89062/
 103 [89174]: https://github.com/rust-lang/rust/pull/89174/
 104 [89542]: https://github.com/rust-lang/rust/pull/89542/
 105 [89551]: https://github.com/rust-lang/rust/pull/89551/
 106 [89558]: https://github.com/rust-lang/rust/pull/89558/
 107 [89580]: https://github.com/rust-lang/rust/pull/89580/
 108 [89652]: https://github.com/rust-lang/rust/pull/89652/
 109 [89677]: https://github.com/rust-lang/rust/pull/89677/
 110 [89951]: https://github.com/rust-lang/rust/pull/89951/
 111 [90041]: https://github.com/rust-lang/rust/pull/90041/
 112 [90058]: https://github.com/rust-lang/rust/pull/90058/
 113 [90104]: https://github.com/rust-lang/rust/pull/90104/
 114 [90117]: https://github.com/rust-lang/rust/pull/90117/
 115 [90175]: https://github.com/rust-lang/rust/pull/90175/
 116 [90183]: https://github.com/rust-lang/rust/pull/90183/
 117 [90297]: https://github.com/rust-lang/rust/pull/90297/
 118 [90329]: https://github.com/rust-lang/rust/pull/90329/
 119 [90361]: https://github.com/rust-lang/rust/pull/90361/
 120 [90417]: https://github.com/rust-lang/rust/pull/90417/
 121 [90473]: https://github.com/rust-lang/rust/pull/90473/
 122 [90491]: https://github.com/rust-lang/rust/pull/90491/
 123 [90733]: https://github.com/rust-lang/rust/pull/90733/
 124 [90833]: https://github.com/rust-lang/rust/pull/90833/
 125 [90846]: https://github.com/rust-lang/rust/pull/90846/
 126 [90896]: https://github.com/rust-lang/rust/pull/90896/
 127 [91026]: https://github.com/rust-lang/rust/pull/91026/
 128 [91207]: https://github.com/rust-lang/rust/pull/91207/
 129 [91255]: https://github.com/rust-lang/rust/pull/91255/
 130 [91301]: https://github.com/rust-lang/rust/pull/91301/
 131 [cargo/10082]: https://github.com/rust-lang/cargo/pull/10082/
 132 [cargo/10107]: https://github.com/rust-lang/cargo/pull/10107/
 133 [`Metadata::is_symlink`]: https://doc.rust-lang.org/stable/std/fs/struct.Metadata.html#method.is_symlink
 134 [`Path::is_symlink`]: https://doc.rust-lang.org/stable/std/path/struct.Path.html#method.is_symlink
 135 [`{integer}::saturating_div`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.saturating_div
 136 [`Option::unwrap_unchecked`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.unwrap_unchecked
 137 [`Result::unwrap_unchecked`]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.unwrap_unchecked
 138 [`Result::unwrap_err_unchecked`]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.unwrap_err_unchecked
 139 [`File::options`]: https://doc.rust-lang.org/stable/std/fs/struct.File.html#method.options
 140 [`unix::process::ExitStatusExt::core_dumped`]: https://doc.rust-lang.org/stable/std/os/unix/process/trait.ExitStatusExt.html#tymethod.core_dumped
 141 [`unix::process::ExitStatusExt::stopped_signal`]: https://doc.rust-lang.org/stable/std/os/unix/process/trait.ExitStatusExt.html#tymethod.stopped_signal
 142 [`unix::process::ExitStatusExt::continued`]: https://doc.rust-lang.org/stable/std/os/unix/process/trait.ExitStatusExt.html#tymethod.continued
 143 [`unix::process::ExitStatusExt::into_raw`]: https://doc.rust-lang.org/stable/std/os/unix/process/trait.ExitStatusExt.html#tymethod.into_raw
 144 [`Duration::new`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.new
 145 [`Duration::checked_add`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.checked_add
 146 [`Duration::saturating_add`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.saturating_add
 147 [`Duration::checked_sub`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.checked_sub
 148 [`Duration::saturating_sub`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.saturating_sub
 149 [`Duration::checked_mul`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.checked_mul
 150 [`Duration::saturating_mul`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.saturating_mul
 151 [`Duration::checked_div`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.checked_div
 152 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.as_secs_f64
 153 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.as_secs_f32
 154 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.from_secs_f64
 155 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.from_secs_f32
 156 [`Duration::mul_f64`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.mul_f64
 157 [`Duration::mul_f32`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.mul_f32
 158 [`Duration::div_f64`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.div_f64
 159 [`Duration::div_f32`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.div_f32
 160 [`Duration::div_duration_f64`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.div_duration_f64
 161 [`Duration::div_duration_f32`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.div_duration_f32
 162
 163 Version 1.57.0 (2021-12-02)
 164 ==========================
 165
 166 Language
 167 --------
 168
 169 - [Macro attributes may follow `#[derive]` and will see the original (pre-`cfg`) input.][87220]
 170 - [Accept curly-brace macros in expressions, like `m!{ .. }.method()` and `m!{ .. }?`.][88690]
 171 - [Allow panicking in constant evaluation.][89508]
 172
 173 Compiler
 174 --------
 175
 176 - [Create more accurate debuginfo for vtables.][89597]
 177 - [Add `armv6k-nintendo-3ds` at Tier 3\*.][88529]
 178 - [Add `armv7-unknown-linux-uclibceabihf` at Tier 3\*.][88952]
 179 - [Add `m68k-unknown-linux-gnu` at Tier 3\*.][88321]
 180 - [Add SOLID targets at Tier 3\*:][86191] `aarch64-kmc-solid_asp3`, `armv7a-kmc-solid_asp3-eabi`, `armv7a-kmc-solid_asp3-eabihf`
 181
 182 \* Refer to Rust's [platform support page][platform-support-doc] for more
 183    information on Rust's tiered platform support.
 184
 185 Libraries
 186 ---------
 187
 188 - [Avoid allocations and copying in `Vec::leak`][89337]
 189 - [Add `#[repr(i8)]` to `Ordering`][89507]
 190 - [Optimize `File::read_to_end` and `read_to_string`][89582]
 191 - [Update to Unicode 14.0][89614]
 192 - [Many more functions are marked `#[must_use]`][89692], producing a warning
 193   when ignoring their return value. This helps catch mistakes such as expecting
 194   a function to mutate a value in place rather than return a new value.
 195
 196 Stabilised APIs
 197 ---------------
 198
 199 - [`[T; N]::as_mut_slice`][`array::as_mut_slice`]
 200 - [`[T; N]::as_slice`][`array::as_slice`]
 201 - [`collections::TryReserveError`]
 202 - [`HashMap::try_reserve`]
 203 - [`HashSet::try_reserve`]
 204 - [`String::try_reserve`]
 205 - [`String::try_reserve_exact`]
 206 - [`Vec::try_reserve`]
 207 - [`Vec::try_reserve_exact`]
 208 - [`VecDeque::try_reserve`]
 209 - [`VecDeque::try_reserve_exact`]
 210 - [`Iterator::map_while`]
 211 - [`iter::MapWhile`]
 212 - [`proc_macro::is_available`]
 213 - [`Command::get_program`]
 214 - [`Command::get_args`]
 215 - [`Command::get_envs`]
 216 - [`Command::get_current_dir`]
 217 - [`CommandArgs`]
 218 - [`CommandEnvs`]
 219
 220 These APIs are now usable in const contexts:
 221
 222 - [`hint::unreachable_unchecked`]
 223
 224 Cargo
 225 -----
 226
 227 - [Stabilize custom profiles][cargo/9943]
 228
 229 Compatibility notes
 230 -------------------
 231
 232 Internal changes
 233 ----------------
 234 These changes provide no direct user facing benefits, but represent significant
 235 improvements to the internals and overall performance of rustc
 236 and related tools.
 237
 238 - [Added an experimental backend for codegen with `libgccjit`.][87260]
 239
 240 [86191]: https://github.com/rust-lang/rust/pull/86191/
 241 [87220]: https://github.com/rust-lang/rust/pull/87220/
 242 [87260]: https://github.com/rust-lang/rust/pull/87260/
 243 [88243]: https://github.com/rust-lang/rust/pull/88243/
 244 [88321]: https://github.com/rust-lang/rust/pull/88321/
 245 [88529]: https://github.com/rust-lang/rust/pull/88529/
 246 [88690]: https://github.com/rust-lang/rust/pull/88690/
 247 [88952]: https://github.com/rust-lang/rust/pull/88952/
 248 [89337]: https://github.com/rust-lang/rust/pull/89337/
 249 [89507]: https://github.com/rust-lang/rust/pull/89507/
 250 [89508]: https://github.com/rust-lang/rust/pull/89508/
 251 [89582]: https://github.com/rust-lang/rust/pull/89582/
 252 [89597]: https://github.com/rust-lang/rust/pull/89597/
 253 [89614]: https://github.com/rust-lang/rust/pull/89614/
 254 [89692]: https://github.com/rust-lang/rust/issues/89692/
 255 [cargo/9943]: https://github.com/rust-lang/cargo/pull/9943/
 256 [`array::as_mut_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_mut_slice
 257 [`array::as_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_slice
 258 [`collections::TryReserveError`]: https://doc.rust-lang.org/std/collections/struct.TryReserveError.html
 259 [`HashMap::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_map/struct.HashMap.html#method.try_reserve
 260 [`HashSet::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_set/struct.HashSet.html#method.try_reserve
 261 [`String::try_reserve`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve
 262 [`String::try_reserve_exact`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve_exact
 263 [`Vec::try_reserve`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve
 264 [`Vec::try_reserve_exact`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve_exact
 265 [`VecDeque::try_reserve`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve
 266 [`VecDeque::try_reserve_exact`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve_exact
 267 [`Iterator::map_while`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.map_while
 268 [`iter::MapWhile`]: https://doc.rust-lang.org/std/iter/struct.MapWhile.html
 269 [`proc_macro::is_available`]: https://doc.rust-lang.org/proc_macro/fn.is_available.html
 270 [`Command::get_program`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_program
 271 [`Command::get_args`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_args
 272 [`Command::get_envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_envs
 273 [`Command::get_current_dir`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_current_dir
 274 [`CommandArgs`]: https://doc.rust-lang.org/std/process/struct.CommandArgs.html
 275 [`CommandEnvs`]: https://doc.rust-lang.org/std/process/struct.CommandEnvs.html
 276
 277 Version 1.56.1 (2021-11-01)
 278 ===========================
 279
 280 - New lints to detect the presence of bidirectional-override Unicode
 281   codepoints in the compiled source code ([CVE-2021-42574])
 282
 283 [CVE-2021-42574]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-42574
 284
 285 Version 1.56.0 (2021-10-21)
 286 ========================
 287
 288 Language
 289 --------
 290
 291 - [The 2021 Edition is now stable.][rust#88100]
 292   See [the edition guide][rust-2021-edition-guide] for more details.
 293 - [The pattern in `binding @ pattern` can now also introduce new bindings.][rust#85305]
 294 - [Union field access is permitted in `const fn`.][rust#85769]
 295
 296 [rust-2021-edition-guide]: https://doc.rust-lang.org/nightly/edition-guide/rust-2021/index.html
 297
 298 Compiler
 299 --------
 300
 301 - [Upgrade to LLVM 13.][rust#87570]
 302 - [Support memory, address, and thread sanitizers on aarch64-unknown-freebsd.][rust#88023]
 303 - [Allow specifying a deployment target version for all iOS targets][rust#87699]
 304 - [Warnings can be forced on with `--force-warn`.][rust#87472]
 305   This feature is primarily intended for usage by `cargo fix`, rather than end users.
 306 - [Promote `aarch64-apple-ios-sim` to Tier 2\*.][rust#87760]
 307 - [Add `powerpc-unknown-freebsd` at Tier 3\*.][rust#87370]
 308 - [Add `riscv32imc-esp-espidf` at Tier 3\*.][rust#87666]
 309
 310 \* Refer to Rust's [platform support page][platform-support-doc] for more
 311 information on Rust's tiered platform support.
 312
 313 Libraries
 314 ---------
 315
 316 - [Allow writing of incomplete UTF-8 sequences via stdout/stderr on Windows.][rust#83342]
 317   The Windows console still requires valid Unicode, but this change allows
 318   splitting a UTF-8 character across multiple write calls. This allows, for
 319   instance, programs that just read and write data buffers (e.g. copying a file
 320   to stdout) without regard for Unicode or character boundaries.
 321 - [Prefer `AtomicU{64,128}` over Mutex for Instant backsliding protection.][rust#83093]
 322   For this use case, atomics scale much better under contention.
 323 - [Implement `Extend<(A, B)>` for `(Extend<A>, Extend<B>)`][rust#85835]
 324 - [impl Default, Copy, Clone for std::io::Sink and std::io::Empty][rust#86744]
 325 - [`impl From<[(K, V); N]>` for all collections.][rust#84111]
 326 - [Remove `P: Unpin` bound on impl Future for Pin.][rust#81363]
 327 - [Treat invalid environment variable names as non-existent.][rust#86183]
 328   Previously, the environment functions would panic if given a variable name
 329   with an internal null character or equal sign (`=`). Now, these functions will
 330   just treat such names as non-existent variables, since the OS cannot represent
 331   the existence of a variable with such a name.
 332
 333 Stabilised APIs
 334 ---------------
 335
 336 - [`std::os::unix::fs::chroot`]
 337 - [`UnsafeCell::raw_get`]
 338 - [`BufWriter::into_parts`]
 339 - [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]
 340   These APIs were previously stable in `std`, but are now also available in `core`.
 341 - [`Vec::shrink_to`]
 342 - [`String::shrink_to`]
 343 - [`OsString::shrink_to`]
 344 - [`PathBuf::shrink_to`]
 345 - [`BinaryHeap::shrink_to`]
 346 - [`VecDeque::shrink_to`]
 347 - [`HashMap::shrink_to`]
 348 - [`HashSet::shrink_to`]
 349
 350 These APIs are now usable in const contexts:
 351
 352 - [`std::mem::transmute`]
 353 - [`[T]::first`][`slice::first`]
 354 - [`[T]::split_first`][`slice::split_first`]
 355 - [`[T]::last`][`slice::last`]
 356 - [`[T]::split_last`][`slice::split_last`]
 357
 358 Cargo
 359 -----
 360
 361 - [Cargo supports specifying a minimum supported Rust version in Cargo.toml.][`rust-version`]
 362   This has no effect at present on dependency version selection.
 363   We encourage crates to specify their minimum supported Rust version, and we encourage CI systems
 364   that support Rust code to include a crate's specified minimum version in the test matrix for that
 365   crate by default.
 366
 367 Compatibility notes
 368 -------------------
 369
 370 - [Update to new argument parsing rules on Windows.][rust#87580]
 371   This adjusts Rust's standard library to match the behavior of the standard
 372   libraries for C/C++. The rules have changed slightly over time, and this PR
 373   brings us to the latest set of rules (changed in 2008).
 374 - [Disallow the aapcs calling convention on aarch64][rust#88399]
 375   This was already not supported by LLVM; this change surfaces this lack of
 376   support with a better error message.
 377 - [Make `SEMICOLON_IN_EXPRESSIONS_FROM_MACROS` warn by default][rust#87385]
 378 - [Warn when an escaped newline skips multiple lines.][rust#87671]
 379 - [Calls to `libc::getpid` / `std::process::id` from `Command::pre_exec`
 380    may return different values on glibc <= 2.24.][rust#81825]
 381    Rust now invokes the `clone3` system call directly, when available, to use new functionality
 382    available via that system call. Older versions of glibc cache the result of `getpid`, and only
 383    update that cache when calling glibc's clone/fork functions, so a direct system call bypasses
 384    that cache update. glibc 2.25 and newer no longer cache `getpid` for exactly this reason.
 385
 386 Internal changes
 387 ----------------
 388 These changes provide no direct user facing benefits, but represent significant
 389 improvements to the internals and overall performance of rustc
 390 and related tools.
 391
 392 - [LLVM is compiled with PGO in published x86_64-unknown-linux-gnu artifacts.][rust#88069]
 393   This improves the performance of most Rust builds.
 394 - [Unify representation of macros in internal data structures.][rust#88019]
 395   This change fixes a host of bugs with the handling of macros by the compiler,
 396   as well as rustdoc.
 397
 398 [`std::os::unix::fs::chroot`]: https://doc.rust-lang.org/stable/std/os/unix/fs/fn.chroot.html
 399 [`Iterator::intersperse`]: https://doc.rust-lang.org/stable/std/iter/trait.Iterator.html#method.intersperse
 400 [`Iterator::intersperse_with`]: https://doc.rust-lang.org/stable/std/iter/trait.Iterator.html#method.intersperse
 401 [`UnsafeCell::raw_get`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.raw_get
 402 [`BufWriter::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.BufWriter.html#method.into_parts
 403 [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]: https://github.com/rust-lang/rust/pull/84662
 404 [`Vec::shrink_to`]: https://doc.rust-lang.org/stable/std/vec/struct.Vec.html#method.shrink_to
 405 [`String::shrink_to`]: https://doc.rust-lang.org/stable/std/string/struct.String.html#method.shrink_to
 406 [`OsString::shrink_to`]: https://doc.rust-lang.org/stable/std/ffi/struct.OsString.html#method.shrink_to
 407 [`PathBuf::shrink_to`]: https://doc.rust-lang.org/stable/std/path/struct.PathBuf.html#method.shrink_to
 408 [`BinaryHeap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.BinaryHeap.html#method.shrink_to
 409 [`VecDeque::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.VecDeque.html#method.shrink_to
 410 [`HashMap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_map/struct.HashMap.html#method.shrink_to
 411 [`HashSet::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_set/struct.HashSet.html#method.shrink_to
 412 [`std::mem::transmute`]: https://doc.rust-lang.org/stable/std/mem/fn.transmute.html
 413 [`slice::first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.first
 414 [`slice::split_first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_first
 415 [`slice::last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.last
 416 [`slice::split_last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_last
 417 [`rust-version`]: https://doc.rust-lang.org/nightly/cargo/reference/manifest.html#the-rust-version-field
 418 [rust#87671]: https://github.com/rust-lang/rust/pull/87671
 419 [rust#86183]: https://github.com/rust-lang/rust/pull/86183
 420 [rust#87385]: https://github.com/rust-lang/rust/pull/87385
 421 [rust#88100]: https://github.com/rust-lang/rust/pull/88100
 422 [rust#86860]: https://github.com/rust-lang/rust/pull/86860
 423 [rust#84039]: https://github.com/rust-lang/rust/pull/84039
 424 [rust#86492]: https://github.com/rust-lang/rust/pull/86492
 425 [rust#88363]: https://github.com/rust-lang/rust/pull/88363
 426 [rust#85305]: https://github.com/rust-lang/rust/pull/85305
 427 [rust#87832]: https://github.com/rust-lang/rust/pull/87832
 428 [rust#88069]: https://github.com/rust-lang/rust/pull/88069
 429 [rust#87472]: https://github.com/rust-lang/rust/pull/87472
 430 [rust#87699]: https://github.com/rust-lang/rust/pull/87699
 431 [rust#87570]: https://github.com/rust-lang/rust/pull/87570
 432 [rust#88023]: https://github.com/rust-lang/rust/pull/88023
 433 [rust#87760]: https://github.com/rust-lang/rust/pull/87760
 434 [rust#87370]: https://github.com/rust-lang/rust/pull/87370
 435 [rust#87580]: https://github.com/rust-lang/rust/pull/87580
 436 [rust#83342]: https://github.com/rust-lang/rust/pull/83342
 437 [rust#83093]: https://github.com/rust-lang/rust/pull/83093
 438 [rust#88177]: https://github.com/rust-lang/rust/pull/88177
 439 [rust#88548]: https://github.com/rust-lang/rust/pull/88548
 440 [rust#88551]: https://github.com/rust-lang/rust/pull/88551
 441 [rust#88299]: https://github.com/rust-lang/rust/pull/88299
 442 [rust#88220]: https://github.com/rust-lang/rust/pull/88220
 443 [rust#85835]: https://github.com/rust-lang/rust/pull/85835
 444 [rust#86879]: https://github.com/rust-lang/rust/pull/86879
 445 [rust#86744]: https://github.com/rust-lang/rust/pull/86744
 446 [rust#84662]: https://github.com/rust-lang/rust/pull/84662
 447 [rust#86593]: https://github.com/rust-lang/rust/pull/86593
 448 [rust#81050]: https://github.com/rust-lang/rust/pull/81050
 449 [rust#81363]: https://github.com/rust-lang/rust/pull/81363
 450 [rust#84111]: https://github.com/rust-lang/rust/pull/84111
 451 [rust#85769]: https://github.com/rust-lang/rust/pull/85769#issuecomment-854363720
 452 [rust#88490]: https://github.com/rust-lang/rust/pull/88490
 453 [rust#88269]: https://github.com/rust-lang/rust/pull/88269
 454 [rust#84176]: https://github.com/rust-lang/rust/pull/84176
 455 [rust#88399]: https://github.com/rust-lang/rust/pull/88399
 456 [rust#88227]: https://github.com/rust-lang/rust/pull/88227
 457 [rust#88200]: https://github.com/rust-lang/rust/pull/88200
 458 [rust#82776]: https://github.com/rust-lang/rust/pull/82776
 459 [rust#88077]: https://github.com/rust-lang/rust/pull/88077
 460 [rust#87728]: https://github.com/rust-lang/rust/pull/87728
 461 [rust#87050]: https://github.com/rust-lang/rust/pull/87050
 462 [rust#87619]: https://github.com/rust-lang/rust/pull/87619
 463 [rust#81825]: https://github.com/rust-lang/rust/pull/81825#issuecomment-808406918
 464 [rust#88019]: https://github.com/rust-lang/rust/pull/88019
 465 [rust#87666]: https://github.com/rust-lang/rust/pull/87666
 466
 467 Version 1.55.0 (2021-09-09)
 468 ============================
 469
 470 Language
 471 --------
 472 - [You can now write open "from" range patterns (`X..`), which will start at `X` and
 473   will end at the maximum value of the integer.][83918]
 474 - [You can now explicitly import the prelude of different editions
 475   through `std::prelude` (e.g. `use std::prelude::rust_2021::*;`).][86294]
 476
 477 Compiler
 478 --------
 479 - [Added tier 3\* support for `powerpc64le-unknown-freebsd`.][83572]
 480
 481 \* Refer to Rust's [platform support page][platform-support-doc] for more
 482    information on Rust's tiered platform support.
 483
 484 Libraries
 485 ---------
 486
 487 - [Updated std's float parsing to use the Eisel-Lemire algorithm.][86761]
 488   These improvements should in general provide faster string parsing of floats,
 489   no longer reject certain valid floating point values, and reduce
 490   the produced code size for non-stripped artifacts.
 491 - [`string::Drain` now implements `AsRef<str>` and `AsRef<[u8]>`.][86858]
 492
 493 Stabilised APIs
 494 ---------------
 495
 496 - [`Bound::cloned`]
 497 - [`Drain::as_str`]
 498 - [`IntoInnerError::into_error`]
 499 - [`IntoInnerError::into_parts`]
 500 - [`MaybeUninit::assume_init_mut`]
 501 - [`MaybeUninit::assume_init_ref`]
 502 - [`MaybeUninit::write`]
 503 - [`array::map`]
 504 - [`ops::ControlFlow`]
 505 - [`x86::_bittest`]
 506 - [`x86::_bittestandcomplement`]
 507 - [`x86::_bittestandreset`]
 508 - [`x86::_bittestandset`]
 509 - [`x86_64::_bittest64`]
 510 - [`x86_64::_bittestandcomplement64`]
 511 - [`x86_64::_bittestandreset64`]
 512 - [`x86_64::_bittestandset64`]
 513
 514 The following previously stable functions are now `const`.
 515
 516 - [`str::from_utf8_unchecked`]
 517
 518
 519 Cargo
 520 -----
 521 - [Cargo will now deduplicate compiler diagnostics to the terminal when invoking
 522   rustc in parallel such as when using `cargo test`.][cargo/9675]
 523 - [The package definition in `cargo metadata` now includes the `"default_run"`
 524   field from the manifest.][cargo/9550]
 525 - [Added `cargo d` as an alias for `cargo doc`.][cargo/9680]
 526 - [Added `{lib}` as formatting option for `cargo tree` to print the `"lib_name"`
 527   of packages.][cargo/9663]
 528
 529 Rustdoc
 530 -------
 531 - [Added "Go to item on exact match" search option.][85876]
 532 - [The "Implementors" section on traits no longer shows redundant
 533   method definitions.][85970]
 534 - [Trait implementations are toggled open by default.][86260] This should make the
 535   implementations more searchable by tools like `CTRL+F` in your browser.
 536 - [Intra-doc links should now correctly resolve associated items (e.g. methods)
 537   through type aliases.][86334]
 538 - [Traits which are marked with `#[doc(hidden)]` will no longer appear in the
 539   "Trait Implementations" section.][86513]
 540
 541
 542 Compatibility Notes
 543 -------------------
 544 - [std functions that return an `io::Error` will no longer use the
 545   `ErrorKind::Other` variant.][85746] This is to better reflect that these
 546   kinds of errors could be categorised [into newer more specific `ErrorKind`
 547   variants][79965], and that they do not represent a user error.
 548 - [Using environment variable names with `process::Command` on Windows now
 549   behaves as expected.][85270] Previously using envionment variables with
 550   `Command` would cause them to be ASCII-uppercased.
 551 - [Rustdoc will now warn on using rustdoc lints that aren't prefixed
 552   with `rustdoc::`][86849]
 553 - `RUSTFLAGS` is no longer set for build scripts. Build scripts
 554   should use `CARGO_ENCODED_RUSTFLAGS` instead. See the
 555   [documentation](https://doc.rust-lang.org/nightly/cargo/reference/environment-variables.html#environment-variables-cargo-sets-for-build-scripts)
 556   for more details.
 557
 558 [86849]: https://github.com/rust-lang/rust/pull/86849
 559 [86513]: https://github.com/rust-lang/rust/pull/86513
 560 [86334]: https://github.com/rust-lang/rust/pull/86334
 561 [86260]: https://github.com/rust-lang/rust/pull/86260
 562 [85970]: https://github.com/rust-lang/rust/pull/85970
 563 [85876]: https://github.com/rust-lang/rust/pull/85876
 564 [83572]: https://github.com/rust-lang/rust/pull/83572
 565 [86294]: https://github.com/rust-lang/rust/pull/86294
 566 [86858]: https://github.com/rust-lang/rust/pull/86858
 567 [86761]: https://github.com/rust-lang/rust/pull/86761
 568 [85769]: https://github.com/rust-lang/rust/pull/85769
 569 [85746]: https://github.com/rust-lang/rust/pull/85746
 570 [85305]: https://github.com/rust-lang/rust/pull/85305
 571 [85270]: https://github.com/rust-lang/rust/pull/85270
 572 [84111]: https://github.com/rust-lang/rust/pull/84111
 573 [83918]: https://github.com/rust-lang/rust/pull/83918
 574 [79965]: https://github.com/rust-lang/rust/pull/79965
 575 [87370]: https://github.com/rust-lang/rust/pull/87370
 576 [87298]: https://github.com/rust-lang/rust/pull/87298
 577 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
 578 [cargo/9675]: https://github.com/rust-lang/cargo/pull/9675
 579 [cargo/9550]: https://github.com/rust-lang/cargo/pull/9550
 580 [cargo/9680]: https://github.com/rust-lang/cargo/pull/9680
 581 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
 582 [`array::map`]: https://doc.rust-lang.org/stable/std/primitive.array.html#method.map
 583 [`Bound::cloned`]: https://doc.rust-lang.org/stable/std/ops/enum.Bound.html#method.cloned
 584 [`Drain::as_str`]: https://doc.rust-lang.org/stable/std/string/struct.Drain.html#method.as_str
 585 [`IntoInnerError::into_error`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_error
 586 [`IntoInnerError::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_parts
 587 [`MaybeUninit::assume_init_mut`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_mut
 588 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
 589 [`MaybeUninit::write`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.write
 590 [`Seek::rewind`]: https://doc.rust-lang.org/stable/std/io/trait.Seek.html#method.rewind
 591 [`ops::ControlFlow`]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html
 592 [`str::from_utf8_unchecked`]: https://doc.rust-lang.org/stable/std/str/fn.from_utf8_unchecked.html
 593 [`x86::_bittest`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittest.html
 594 [`x86::_bittestandcomplement`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandcomplement.html
 595 [`x86::_bittestandreset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandreset.html
 596 [`x86::_bittestandset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandset.html
 597 [`x86_64::_bittest64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittest64.html
 598 [`x86_64::_bittestandcomplement64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandcomplement64.html
 599 [`x86_64::_bittestandreset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandreset64.html
 600 [`x86_64::_bittestandset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandset64.html
 601
 602
 603 Version 1.54.0 (2021-07-29)
 604 ============================
 605
 606 Language
 607 -----------------------
 608
 609 - [You can now use macros for values in some built-in attributes.][83366]
 610   This primarily allows you to call macros within the `#[doc]` attribute. For
 611   example, to include external documentation in your crate, you can now write
 612   the following:
 613   ```rust
 614   #![doc = include_str!("README.md")]
 615   ```
 616
 617 - [You can now cast between unsized slice types (and types which contain
 618   unsized slices) in `const fn`.][85078]
 619 - [You can now use multiple generic lifetimes with `impl Trait` where the
 620    lifetimes don't explicitly outlive another.][84701] In code this means
 621    that you can now have `impl Trait<'a, 'b>` where as before you could
 622    only have `impl Trait<'a, 'b> where 'b: 'a`.
 623
 624 Compiler
 625 -----------------------
 626
 627 - [Rustc will now search for custom JSON targets in
 628   `/lib/rustlib/<target-triple>/target.json` where `/` is the "sysroot"
 629   directory.][83800] You can find your sysroot directory by running
 630   `rustc --print sysroot`.
 631 - [Added `wasm` as a `target_family` for WebAssembly platforms.][84072]
 632 - [You can now use `#[target_feature]` on safe functions when targeting
 633   WebAssembly platforms.][84988]
 634 - [Improved debugger output for enums on Windows MSVC platforms.][85292]
 635 - [Added tier 3\* support for `bpfel-unknown-none`
 636    and `bpfeb-unknown-none`.][79608]
 637 - [`-Zmutable-noalias=yes`][82834] is enabled by default when using LLVM 12 or above.
 638
 639 \* Refer to Rust's [platform support page][platform-support-doc] for more
 640    information on Rust's tiered platform support.
 641
 642 Libraries
 643 -----------------------
 644
 645 - [`panic::panic_any` will now `#[track_caller]`.][85745]
 646 - [Added `OutOfMemory` as a variant of `io::ErrorKind`.][84744]
 647 - [ `proc_macro::Literal` now implements `FromStr`.][84717]
 648 - [The implementations of vendor intrinsics in core::arch have been
 649    significantly refactored.][83278] The main user-visible changes are
 650    a 50% reduction in the size of libcore.rlib and stricter validation
 651    of constant operands passed to intrinsics. The latter is technically
 652    a breaking change, but allows Rust to more closely match the C vendor
 653    intrinsics API.
 654
 655 Stabilized APIs
 656 ---------------
 657
 658 - [`BTreeMap::into_keys`]
 659 - [`BTreeMap::into_values`]
 660 - [`HashMap::into_keys`]
 661 - [`HashMap::into_values`]
 662 - [`arch::wasm32`]
 663 - [`VecDeque::binary_search`]
 664 - [`VecDeque::binary_search_by`]
 665 - [`VecDeque::binary_search_by_key`]
 666 - [`VecDeque::partition_point`]
 667
 668 Cargo
 669 -----
 670
 671 - [Added the `--prune <spec>` option to `cargo-tree` to remove a package from
 672   the dependency graph.][cargo/9520]
 673 - [Added the `--depth` option to `cargo-tree` to print only to a certain depth
 674   in the tree ][cargo/9499]
 675 - [Added the `no-proc-macro` value to `cargo-tree --edges` to hide procedural
 676   macro dependencies.][cargo/9488]
 677 - [A new environment variable named `CARGO_TARGET_TMPDIR` is available.][cargo/9375]
 678   This variable points to a directory that integration tests and benches
 679   can use as a "scratchpad" for testing filesystem operations.
 680
 681 Compatibility Notes
 682 -------------------
 683 - [Mixing Option and Result via `?` is no longer permitted in closures for inferred types.][86831]
 684 - [Previously unsound code is no longer permitted where different constructors in branches
 685   could require different lifetimes.][85574]
 686 - As previously mentioned the [`std::arch` instrinsics now uses stricter const checking][83278]
 687   than before and may reject some previously accepted code.
 688 - [`i128` multiplication on Cortex M0+ platforms currently unconditionally causes overflow
 689    when compiled with `codegen-units = 1`.][86063]
 690
 691 [85574]: https://github.com/rust-lang/rust/issues/85574
 692 [86831]: https://github.com/rust-lang/rust/issues/86831
 693 [86063]: https://github.com/rust-lang/rust/issues/86063
 694 [86831]: https://github.com/rust-lang/rust/issues/86831
 695 [79608]: https://github.com/rust-lang/rust/pull/79608
 696 [84988]: https://github.com/rust-lang/rust/pull/84988
 697 [84701]: https://github.com/rust-lang/rust/pull/84701
 698 [84072]: https://github.com/rust-lang/rust/pull/84072
 699 [85745]: https://github.com/rust-lang/rust/pull/85745
 700 [84744]: https://github.com/rust-lang/rust/pull/84744
 701 [85078]: https://github.com/rust-lang/rust/pull/85078
 702 [84717]: https://github.com/rust-lang/rust/pull/84717
 703 [83800]: https://github.com/rust-lang/rust/pull/83800
 704 [83366]: https://github.com/rust-lang/rust/pull/83366
 705 [83278]: https://github.com/rust-lang/rust/pull/83278
 706 [85292]: https://github.com/rust-lang/rust/pull/85292
 707 [82834]: https://github.com/rust-lang/rust/pull/82834
 708 [cargo/9520]: https://github.com/rust-lang/cargo/pull/9520
 709 [cargo/9499]: https://github.com/rust-lang/cargo/pull/9499
 710 [cargo/9488]: https://github.com/rust-lang/cargo/pull/9488
 711 [cargo/9375]: https://github.com/rust-lang/cargo/pull/9375
 712 [`BTreeMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_keys
 713 [`BTreeMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_values
 714 [`HashMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_keys
 715 [`HashMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_values
 716 [`arch::wasm32`]: https://doc.rust-lang.org/core/arch/wasm32/index.html
 717 [`VecDeque::binary_search`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search
 718 [`VecDeque::binary_search_by`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by
 719
 720 [`VecDeque::binary_search_by_key`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by_key
 721
 722 [`VecDeque::partition_point`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.partition_point
 723
 724 Version 1.53.0 (2021-06-17)
 725 ============================
 726
 727 Language
 728 -----------------------
 729 - [You can now use unicode for identifiers.][83799] This allows multilingual
 730   identifiers but still doesn't allow glyphs that are not considered characters
 731   such as `◆` or `🦀`. More specifically you can now use any identifier that
 732   matches the UAX #31 "Unicode Identifier and Pattern Syntax" standard. This
 733   is the same standard as languages like Python, however Rust uses NFC
 734   normalization which may be different from other languages.
 735 - [You can now specify "or patterns" inside pattern matches.][79278]
 736   Previously you could only use `|` (OR) on complete patterns. E.g.
 737   ```rust
 738   let x = Some(2u8);
 739   // Before
 740   matches!(x, Some(1) | Some(2));
 741   // Now
 742   matches!(x, Some(1 | 2));
 743   ```
 744 - [Added the `:pat_param` `macro_rules!` matcher.][83386] This matcher
 745   has the same semantics as the `:pat` matcher. This is to allow `:pat`
 746   to change semantics to being a pattern fragment in a future edition.
 747
 748 Compiler
 749 -----------------------
 750 - [Updated the minimum external LLVM version to LLVM 10.][83387]
 751 - [Added Tier 3\* support for the `wasm64-unknown-unknown` target.][80525]
 752 - [Improved debuginfo for closures and async functions on Windows MSVC.][83941]
 753
 754 \* Refer to Rust's [platform support page][platform-support-doc] for more
 755 information on Rust's tiered platform support.
 756
 757 Libraries
 758 -----------------------
 759 - [Abort messages will now forward to `android_set_abort_message` on
 760   Android platforms when available.][81469]
 761 - [`slice::IterMut<'_, T>` now implements `AsRef<[T]>`][82771]
 762 - [Arrays of any length now implement `IntoIterator`.][84147]
 763   Currently calling `.into_iter()` as a method on an array will
 764   return `impl Iterator<Item=&T>`, but this may change in a
 765   future edition to change `Item` to `T`. Calling `IntoIterator::into_iter`
 766   directly on arrays will provide `impl Iterator<Item=T>` as expected.
 767 - [`leading_zeros`, and `trailing_zeros` are now available on all
 768   `NonZero` integer types.][84082]
 769 - [`{f32, f64}::from_str` now parse and print special values
 770   (`NaN`, `-0`) according to IEEE 754.][78618]
 771 - [You can now index into slices using `(Bound<usize>, Bound<usize>)`.][77704]
 772 - [Add the `BITS` associated constant to all numeric types.][82565]
 773
 774 Stabilised APIs
 775 ---------------
 776 - [`AtomicBool::fetch_update`]
 777 - [`AtomicPtr::fetch_update`]
 778 - [`BTreeMap::retain`]
 779 - [`BTreeSet::retain`]
 780 - [`BufReader::seek_relative`]
 781 - [`DebugStruct::non_exhaustive`]
 782 - [`Duration::MAX`]
 783 - [`Duration::ZERO`]
 784 - [`Duration::is_zero`]
 785 - [`Duration::saturating_add`]
 786 - [`Duration::saturating_mul`]
 787 - [`Duration::saturating_sub`]
 788 - [`ErrorKind::Unsupported`]
 789 - [`Option::insert`]
 790 - [`Ordering::is_eq`]
 791 - [`Ordering::is_ge`]
 792 - [`Ordering::is_gt`]
 793 - [`Ordering::is_le`]
 794 - [`Ordering::is_lt`]
 795 - [`Ordering::is_ne`]
 796 - [`OsStr::is_ascii`]
 797 - [`OsStr::make_ascii_lowercase`]
 798 - [`OsStr::make_ascii_uppercase`]
 799 - [`OsStr::to_ascii_lowercase`]
 800 - [`OsStr::to_ascii_uppercase`]
 801 - [`Peekable::peek_mut`]
 802 - [`Rc::decrement_strong_count`]
 803 - [`Rc::increment_strong_count`]
 804 - [`Vec::extend_from_within`]
 805 - [`array::from_mut`]
 806 - [`array::from_ref`]
 807 - [`cmp::max_by_key`]
 808 - [`cmp::max_by`]
 809 - [`cmp::min_by_key`]
 810 - [`cmp::min_by`]
 811 - [`f32::is_subnormal`]
 812 - [`f64::is_subnormal`]
 813
 814 Cargo
 815 -----------------------
 816 - [Cargo now supports git repositories where the default `HEAD` branch is not
 817   "master".][cargo/9392] This also includes a switch to the version 3 `Cargo.lock` format
 818   which can handle default branches correctly.
 819 - [macOS targets now default to `unpacked` split-debuginfo.][cargo/9298]
 820 - [The `authors` field is no longer included in `Cargo.toml` for new
 821   projects.][cargo/9282]
 822
 823 Rustdoc
 824 -----------------------
 825 - [Added the `rustdoc::bare_urls` lint that warns when you have URLs
 826   without hyperlinks.][81764]
 827
 828 Compatibility Notes
 829 -------------------
 830 - [Implement token-based handling of attributes during expansion][82608]
 831 - [`Ipv4::from_str` will now reject octal format IP addresses in addition
 832   to rejecting hexadecimal IP addresses.][83652] The octal format can lead
 833   to confusion and potential security vulnerabilities and [is no
 834   longer recommended][ietf6943].
 835 - [The added `BITS` constant may conflict with external definitions.][85667]
 836   In particular, this was known to be a problem in the `lexical-core` crate,
 837   but they have published fixes for semantic versions 0.4 through 0.7. To
 838   update this dependency alone, use `cargo update -p lexical-core`.
 839 - Incremental compilation remains off by default, unless one uses the `RUSTC_FORCE_INCREMENTAL=1` environment variable added in 1.52.1.
 840
 841 Internal Only
 842 -------------
 843 These changes provide no direct user facing benefits, but represent significant
 844 improvements to the internals and overall performance of rustc and
 845 related tools.
 846
 847 - [Rework the `std::sys::windows::alloc` implementation.][83065]
 848 - [rustdoc: Don't enter an infer_ctxt in get_blanket_impls for impls that aren't blanket impls.][82864]
 849 - [rustdoc: Only look at blanket impls in `get_blanket_impls`][83681]
 850 - [Rework rustdoc const type][82873]
 851
 852 [85667]: https://github.com/rust-lang/rust/pull/85667
 853 [83386]: https://github.com/rust-lang/rust/pull/83386
 854 [82771]: https://github.com/rust-lang/rust/pull/82771
 855 [84147]: https://github.com/rust-lang/rust/pull/84147
 856 [84082]: https://github.com/rust-lang/rust/pull/84082
 857 [83799]: https://github.com/rust-lang/rust/pull/83799
 858 [83681]: https://github.com/rust-lang/rust/pull/83681
 859 [83652]: https://github.com/rust-lang/rust/pull/83652
 860 [83387]: https://github.com/rust-lang/rust/pull/83387
 861 [82873]: https://github.com/rust-lang/rust/pull/82873
 862 [82864]: https://github.com/rust-lang/rust/pull/82864
 863 [82608]: https://github.com/rust-lang/rust/pull/82608
 864 [82565]: https://github.com/rust-lang/rust/pull/82565
 865 [80525]: https://github.com/rust-lang/rust/pull/80525
 866 [79278]: https://github.com/rust-lang/rust/pull/79278
 867 [78618]: https://github.com/rust-lang/rust/pull/78618
 868 [77704]: https://github.com/rust-lang/rust/pull/77704
 869 [83941]: https://github.com/rust-lang/rust/pull/83941
 870 [83065]: https://github.com/rust-lang/rust/pull/83065
 871 [81764]: https://github.com/rust-lang/rust/pull/81764
 872 [81469]: https://github.com/rust-lang/rust/pull/81469
 873 [cargo/9298]: https://github.com/rust-lang/cargo/pull/9298
 874 [cargo/9282]: https://github.com/rust-lang/cargo/pull/9282
 875 [cargo/9392]: https://github.com/rust-lang/cargo/pull/9392
 876 [`AtomicBool::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicBool.html#method.fetch_update
 877 [`AtomicPtr::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicPtr.html#method.fetch_update
 878 [`BTreeMap::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.retain
 879 [`BTreeSet::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeSet.html#method.retain
 880 [`BufReader::seek_relative`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.seek_relative
 881 [`DebugStruct::non_exhaustive`]: https://doc.rust-lang.org/std/fmt/struct.DebugStruct.html#method.finish_non_exhaustive
 882 [`Duration::MAX`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
 883 [`Duration::ZERO`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.ZERO
 884 [`Duration::is_zero`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.is_zero
 885 [`Duration::saturating_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_add
 886 [`Duration::saturating_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_mul
 887 [`Duration::saturating_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_sub
 888 [`ErrorKind::Unsupported`]: https://doc.rust-lang.org/std/io/enum.ErrorKind.html#variant.Unsupported
 889 [`Option::insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.insert
 890 [`Ordering::is_eq`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_eq
 891 [`Ordering::is_ge`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ge
 892 [`Ordering::is_gt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_gt
 893 [`Ordering::is_le`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_le
 894 [`Ordering::is_lt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_lt
 895 [`Ordering::is_ne`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ne
 896 [`OsStr::eq_ignore_ascii_case`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.eq_ignore_ascii_case
 897 [`OsStr::is_ascii`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.is_ascii
 898 [`OsStr::make_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_lowercase
 899 [`OsStr::make_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_uppercase
 900 [`OsStr::to_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_lowercase
 901 [`OsStr::to_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_uppercase
 902 [`Peekable::peek_mut`]: https://doc.rust-lang.org/std/iter/struct.Peekable.html#method.peek_mut
 903 [`Rc::decrement_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
 904 [`Rc::increment_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
 905 [`Vec::extend_from_within`]: https://doc.rust-lang.org/beta/std/vec/struct.Vec.html#method.extend_from_within
 906 [`array::from_mut`]: https://doc.rust-lang.org/beta/std/array/fn.from_mut.html
 907 [`array::from_ref`]: https://doc.rust-lang.org/beta/std/array/fn.from_ref.html
 908 [`cmp::max_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by_key.html
 909 [`cmp::max_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by.html
 910 [`cmp::min_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by_key.html
 911 [`cmp::min_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by.html
 912 [`f32::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
 913 [`f64::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
 914 [ietf6943]: https://datatracker.ietf.org/doc/html/rfc6943#section-3.1.1
 915
 916
 917 Version 1.52.1 (2021-05-10)
 918 ============================
 919
 920 This release disables incremental compilation, unless the user has explicitly
 921 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
 922
 923 This is due to the widespread, and frequently occuring, breakage encountered by
 924 Rust users due to newly enabled incremental verification in 1.52.0. Notably,
 925 Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
 926 newly added incremental verification are still present in past stable versions,
 927 and are not yet fixed on any channel. These bugs can lead to miscompilation of
 928 Rust binaries.
 929
 930 These problems only affect incremental builds, so release builds with Cargo
 931 should not be affected unless the user has explicitly opted into incremental.
 932 Debug and check builds are affected.
 933
 934 See [84970] for more details.
 935
 936 [84970]: https://github.com/rust-lang/rust/issues/84970
 937
 938 Version 1.52.0 (2021-05-06)
 939 ============================
 940
 941 Language
 942 --------
 943 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
 944   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
 945   is allowed by default, and may become a warning or hard error in a
 946   future edition.
 947 - [You can now cast mutable references to arrays to a pointer of the same type as
 948   the element.][81479]
 949
 950 Compiler
 951 --------
 952 - [Upgraded the default LLVM to LLVM 12.][81451]
 953
 954 Added tier 3\* support for the following targets.
 955
 956 - [`s390x-unknown-linux-musl`][82166]
 957 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
 958 - [`powerpc-unknown-openbsd`][82733]
 959
 960 \* Refer to Rust's [platform support page][platform-support-doc] for more
 961 information on Rust's tiered platform support.
 962
 963 Libraries
 964 ---------
 965 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
 966 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
 967 - [`Arc<impl Error>` now implements `error::Error`.][80553]
 968 - [All integer division and remainder operations are now `const`.][80962]
 969
 970 Stabilised APIs
 971 -------------
 972 - [`Arguments::as_str`]
 973 - [`char::MAX`]
 974 - [`char::REPLACEMENT_CHARACTER`]
 975 - [`char::UNICODE_VERSION`]
 976 - [`char::decode_utf16`]
 977 - [`char::from_digit`]
 978 - [`char::from_u32_unchecked`]
 979 - [`char::from_u32`]
 980 - [`slice::partition_point`]
 981 - [`str::rsplit_once`]
 982 - [`str::split_once`]
 983
 984 The following previously stable APIs are now `const`.
 985
 986 - [`char::len_utf8`]
 987 - [`char::len_utf16`]
 988 - [`char::to_ascii_uppercase`]
 989 - [`char::to_ascii_lowercase`]
 990 - [`char::eq_ignore_ascii_case`]
 991 - [`u8::to_ascii_uppercase`]
 992 - [`u8::to_ascii_lowercase`]
 993 - [`u8::eq_ignore_ascii_case`]
 994
 995 Rustdoc
 996 -------
 997 - [Rustdoc lints are now treated as a tool lint, meaning that
 998   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
 999   Using the old style is still allowed, and will become a warning in
1000   a future release.
1001 - [Rustdoc now supports argument files.][82261]
1002 - [Rustdoc now generates smart punctuation for documentation.][79423]
1003 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
1004   ```markdown
1005   - [x] Complete
1006   - [ ] Todo
1007   ```
1008
1009 Misc
1010 ----
1011 - [You can now pass multiple filters to tests.][81356] E.g.
1012   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
1013 - [Rustup now distributes PDB symbols for the `std` library on Windows,
1014   allowing you to see `std` symbols when debugging.][82218]
1015
1016 Internal Only
1017 -------------
1018 These changes provide no direct user facing benefits, but represent significant
1019 improvements to the internals and overall performance of rustc and
1020 related tools.
1021
1022 - [Check the result cache before the DepGraph when ensuring queries][81855]
1023 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
1024 - [Only store a LocalDefId in some HIR nodes][81611]
1025 - [Store HIR attributes in a side table][79519]
1026
1027 Compatibility Notes
1028 -------------------
1029 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
1030 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
1031 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
1032 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
1033   languages in code blocks.][78429]
1034 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
1035 - [Changes in how proc macros handle whitespace may lead to panics when used
1036   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
1037 - [Turn `#[derive]` into a regular macro attribute][79078]
1038
1039 [84136]: https://github.com/rust-lang/rust/issues/84136
1040 [80763]: https://github.com/rust-lang/rust/pull/80763
1041 [82166]: https://github.com/rust-lang/rust/pull/82166
1042 [82121]: https://github.com/rust-lang/rust/pull/82121
1043 [81879]: https://github.com/rust-lang/rust/pull/81879
1044 [82261]: https://github.com/rust-lang/rust/pull/82261
1045 [82218]: https://github.com/rust-lang/rust/pull/82218
1046 [82216]: https://github.com/rust-lang/rust/pull/82216
1047 [82202]: https://github.com/rust-lang/rust/pull/82202
1048 [81855]: https://github.com/rust-lang/rust/pull/81855
1049 [81766]: https://github.com/rust-lang/rust/pull/81766
1050 [81744]: https://github.com/rust-lang/rust/pull/81744
1051 [81611]: https://github.com/rust-lang/rust/pull/81611
1052 [81479]: https://github.com/rust-lang/rust/pull/81479
1053 [81451]: https://github.com/rust-lang/rust/pull/81451
1054 [81356]: https://github.com/rust-lang/rust/pull/81356
1055 [80962]: https://github.com/rust-lang/rust/pull/80962
1056 [80553]: https://github.com/rust-lang/rust/pull/80553
1057 [80527]: https://github.com/rust-lang/rust/pull/80527
1058 [79519]: https://github.com/rust-lang/rust/pull/79519
1059 [79423]: https://github.com/rust-lang/rust/pull/79423
1060 [79208]: https://github.com/rust-lang/rust/pull/79208
1061 [78429]: https://github.com/rust-lang/rust/pull/78429
1062 [82733]: https://github.com/rust-lang/rust/pull/82733
1063 [82594]: https://github.com/rust-lang/rust/pull/82594
1064 [79078]: https://github.com/rust-lang/rust/pull/79078
1065 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
1066 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
1067 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
1068 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
1069 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
1070 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
1071 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
1072 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
1073 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
1074 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
1075 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
1076 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
1077 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
1078 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
1079 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
1080 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
1081 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
1082 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
1083 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
1084 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
1085 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
1086 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
1087
1088 Version 1.51.0 (2021-03-25)
1089 ============================
1090
1091 Language
1092 --------
1093 - [You can now parameterize items such as functions, traits, and `struct`s by constant
1094   values in addition to by types and lifetimes.][79135] Also known as "const generics"
1095   E.g. you can now write the following. Note: Only values of primitive integers,
1096   `bool`, or `char` types are currently permitted.
1097   ```rust
1098   struct GenericArray<T, const LENGTH: usize> {
1099       inner: [T; LENGTH]
1100   }
1101
1102   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
1103       const fn last(&self) -> Option<&T> {
1104           if LENGTH == 0 {
1105               None
1106           } else {
1107               Some(&self.inner[LENGTH - 1])
1108           }
1109       }
1110   }
1111   ```
1112
1113
1114 Compiler
1115 --------
1116
1117 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
1118   This option controls whether debug information is split across multiple files
1119   or packed into a single file. **Note** This option is unstable on other platforms.
1120 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
1121   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
1122 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
1123 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
1124
1125 \* Refer to Rust's [platform support page][platform-support-doc] for more
1126 information on Rust's tiered platform support.
1127
1128 Libraries
1129 ---------
1130
1131 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
1132 - [`str` now implements `AsMut<str>`.][80279]
1133 - [`u64` and `u128` now implement `From<char>`.][79502]
1134 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
1135 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
1136 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
1137 - [`io::Empty` now implements `io::Seek`.][78044]
1138 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
1139   `T: ?Sized` types.][80764]
1140 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
1141
1142
1143 Stabilized APIs
1144 ---------------
1145
1146 - [`Arc::decrement_strong_count`]
1147 - [`Arc::increment_strong_count`]
1148 - [`Once::call_once_force`]
1149 - [`Peekable::next_if_eq`]
1150 - [`Peekable::next_if`]
1151 - [`Seek::stream_position`]
1152 - [`array::IntoIter`]
1153 - [`panic::panic_any`]
1154 - [`ptr::addr_of!`]
1155 - [`ptr::addr_of_mut!`]
1156 - [`slice::fill_with`]
1157 - [`slice::split_inclusive_mut`]
1158 - [`slice::split_inclusive`]
1159 - [`slice::strip_prefix`]
1160 - [`slice::strip_suffix`]
1161 - [`str::split_inclusive`]
1162 - [`sync::OnceState`]
1163 - [`task::Wake`]
1164 - [`VecDeque::range`]
1165 - [`VecDeque::range_mut`]
1166
1167 Cargo
1168 -----
1169 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
1170   codegen option.][cargo/9112]
1171 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
1172   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
1173   to avoid unifying features of dependencies where that unification could be unwanted.
1174   Such as using the same dependency with a `std` feature in a build scripts and
1175   proc-macros, while using the `no-std` feature in the final binary. See the
1176   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
1177
1178 Rustdoc
1179 -------
1180
1181 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
1182 - [You can now provide a `--default-theme` flag which sets the default theme to use for
1183   documentation.][79642]
1184
1185 Various improvements to intra-doc links:
1186
1187 - [You can link to non-path primitives such as `slice`.][80181]
1188 - [You can link to associated items.][74489]
1189 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
1190
1191 Misc
1192 ----
1193 - [You can now pass `--include-ignored` to tests (e.g. with
1194   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
1195
1196 Compatibility Notes
1197 -------------------
1198
1199 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
1200 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
1201   could fail.][80579]
1202 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
1203   for the distributed artifacts.][81521]
1204     - `armv5te-unknown-linux-gnueabi`
1205     - `sparc64-unknown-linux-gnu`
1206     - `thumbv7neon-unknown-linux-gnueabihf`
1207     - `armv7-unknown-linux-gnueabi`
1208     - `x86_64-unknown-linux-gnux32`
1209 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
1210
1211 Internal Only
1212 -------------
1213
1214 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
1215
1216 [79135]: https://github.com/rust-lang/rust/pull/79135
1217 [74489]: https://github.com/rust-lang/rust/pull/74489
1218 [76934]: https://github.com/rust-lang/rust/pull/76934
1219 [79570]: https://github.com/rust-lang/rust/pull/79570
1220 [80181]: https://github.com/rust-lang/rust/pull/80181
1221 [79642]: https://github.com/rust-lang/rust/pull/79642
1222 [80945]: https://github.com/rust-lang/rust/pull/80945
1223 [80279]: https://github.com/rust-lang/rust/pull/80279
1224 [80053]: https://github.com/rust-lang/rust/pull/80053
1225 [79502]: https://github.com/rust-lang/rust/pull/79502
1226 [75180]: https://github.com/rust-lang/rust/pull/75180
1227 [79135]: https://github.com/rust-lang/rust/pull/79135
1228 [81521]: https://github.com/rust-lang/rust/pull/81521
1229 [80968]: https://github.com/rust-lang/rust/pull/80968
1230 [80959]: https://github.com/rust-lang/rust/pull/80959
1231 [80718]: https://github.com/rust-lang/rust/pull/80718
1232 [80653]: https://github.com/rust-lang/rust/pull/80653
1233 [80579]: https://github.com/rust-lang/rust/pull/80579
1234 [79998]: https://github.com/rust-lang/rust/pull/79998
1235 [78044]: https://github.com/rust-lang/rust/pull/78044
1236 [81455]: https://github.com/rust-lang/rust/pull/81455
1237 [80764]: https://github.com/rust-lang/rust/pull/80764
1238 [80749]: https://github.com/rust-lang/rust/pull/80749
1239 [80662]: https://github.com/rust-lang/rust/pull/80662
1240 [79134]: https://github.com/rust-lang/rust/pull/79134
1241 [80966]: https://github.com/rust-lang/rust/pull/80966
1242 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
1243 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
1244 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
1245 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
1246 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
1247 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
1248 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
1249 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
1250 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
1251 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
1252 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
1253 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
1254 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
1255 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
1256 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
1257 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
1258 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
1259 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
1260 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
1261 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
1262 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
1263 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
1264 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
1265
1266 Version 1.50.0 (2021-02-11)
1267 ============================
1268
1269 Language
1270 -----------------------
1271 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
1272   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
1273 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
1274
1275 Compiler
1276 -----------------------
1277 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
1278 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
1279 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
1280 - [Dropped support for all cloudabi targets.][78439]
1281
1282 \* Refer to Rust's [platform support page][platform-support-doc] for more
1283 information on Rust's tiered platform support.
1284
1285 Libraries
1286 -----------------------
1287
1288 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
1289 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
1290 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
1291   This value cannot be a valid file descriptor, and now means `Option<File>` takes
1292   up the same amount of space as `File`.
1293
1294 Stabilized APIs
1295 ---------------
1296
1297 - [`bool::then`]
1298 - [`btree_map::Entry::or_insert_with_key`]
1299 - [`f32::clamp`]
1300 - [`f64::clamp`]
1301 - [`hash_map::Entry::or_insert_with_key`]
1302 - [`Ord::clamp`]
1303 - [`RefCell::take`]
1304 - [`slice::fill`]
1305 - [`UnsafeCell::get_mut`]
1306
1307 The following previously stable methods are now `const`.
1308
1309 - [`IpAddr::is_ipv4`]
1310 - [`IpAddr::is_ipv6`]
1311 - [`IpAddr::is_unspecified`]
1312 - [`IpAddr::is_loopback`]
1313 - [`IpAddr::is_multicast`]
1314 - [`Ipv4Addr::octets`]
1315 - [`Ipv4Addr::is_loopback`]
1316 - [`Ipv4Addr::is_private`]
1317 - [`Ipv4Addr::is_link_local`]
1318 - [`Ipv4Addr::is_multicast`]
1319 - [`Ipv4Addr::is_broadcast`]
1320 - [`Ipv4Addr::is_documentation`]
1321 - [`Ipv4Addr::to_ipv6_compatible`]
1322 - [`Ipv4Addr::to_ipv6_mapped`]
1323 - [`Ipv6Addr::segments`]
1324 - [`Ipv6Addr::is_unspecified`]
1325 - [`Ipv6Addr::is_loopback`]
1326 - [`Ipv6Addr::is_multicast`]
1327 - [`Ipv6Addr::to_ipv4`]
1328 - [`Layout::size`]
1329 - [`Layout::align`]
1330 - [`Layout::from_size_align`]
1331 - `pow` for all integer types.
1332 - `checked_pow` for all integer types.
1333 - `saturating_pow` for all integer types.
1334 - `wrapping_pow` for all integer types.
1335 - `next_power_of_two` for all unsigned integer types.
1336 - `checked_next_power_of_two` for all unsigned integer types.
1337
1338 Cargo
1339 -----------------------
1340
1341 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
1342   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
1343 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
1344   contents of that directory for changes.][cargo/8973]
1345 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
1346
1347 Misc
1348 ----
1349
1350 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
1351 - [Running tests will now print the total time taken to execute.][75752]
1352
1353 Compatibility Notes
1354 -------------------
1355
1356 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
1357   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
1358 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
1359   unhygenic `macro_rules!` macros.][79472]
1360 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
1361   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
1362 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
1363 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
1364   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
1365 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
1366
1367 [74989]: https://github.com/rust-lang/rust/pull/74989
1368 [79261]: https://github.com/rust-lang/rust/pull/79261
1369 [79896]: https://github.com/rust-lang/rust/pull/79896
1370 [79484]: https://github.com/rust-lang/rust/pull/79484
1371 [79472]: https://github.com/rust-lang/rust/pull/79472
1372 [79270]: https://github.com/rust-lang/rust/pull/79270
1373 [79003]: https://github.com/rust-lang/rust/pull/79003
1374 [78864]: https://github.com/rust-lang/rust/pull/78864
1375 [78636]: https://github.com/rust-lang/rust/pull/78636
1376 [78439]: https://github.com/rust-lang/rust/pull/78439
1377 [78343]: https://github.com/rust-lang/rust/pull/78343
1378 [78296]: https://github.com/rust-lang/rust/pull/78296
1379 [78068]: https://github.com/rust-lang/rust/pull/78068
1380 [75752]: https://github.com/rust-lang/rust/pull/75752
1381 [74699]: https://github.com/rust-lang/rust/pull/74699
1382 [78142]: https://github.com/rust-lang/rust/pull/78142
1383 [77484]: https://github.com/rust-lang/rust/pull/77484
1384 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
1385 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
1386 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
1387 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
1388 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
1389 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
1390 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
1391 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
1392 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
1393 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
1394 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
1395 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
1396 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
1397 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
1398 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
1399 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
1400 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
1401 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
1402 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
1403 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
1404 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
1405 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
1406 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
1407 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
1408 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
1409 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
1410 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
1411 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
1412 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
1413 [`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
1414 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
1415 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
1416 [`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
1417 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
1418
1419
1420 Version 1.49.0 (2020-12-31)
1421 ============================
1422
1423 Language
1424 -----------------------
1425
1426 - [Unions can now implement `Drop`, and you can now have a field in a union
1427   with `ManuallyDrop<T>`.][77547]
1428 - [You can now cast uninhabited enums to integers.][76199]
1429 - [You can now bind by reference and by move in patterns.][76119] This
1430   allows you to selectively borrow individual components of a type. E.g.
1431   ```rust
1432   #[derive(Debug)]
1433   struct Person {
1434       name: String,
1435       age: u8,
1436   }
1437
1438   let person = Person {
1439       name: String::from("Alice"),
1440       age: 20,
1441   };
1442
1443   // `name` is moved out of person, but `age` is referenced.
1444   let Person { name, ref age } = person;
1445   println!("{} {}", name, age);
1446   ```
1447
1448 Compiler
1449 -----------------------
1450
1451 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
1452 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
1453 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
1454 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
1455 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
1456 - [Output from threads spawned in tests is now captured.][78227]
1457 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
1458
1459 \* Refer to Rust's [platform support page][platform-support-doc] for more
1460 information on Rust's tiered platform support.
1461
1462 Libraries
1463 -----------------------
1464
1465 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
1466 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
1467
1468 Stabilized APIs
1469 ---------------
1470
1471 - [`slice::select_nth_unstable`]
1472 - [`slice::select_nth_unstable_by`]
1473 - [`slice::select_nth_unstable_by_key`]
1474
1475 The following previously stable methods are now `const`.
1476
1477 - [`Poll::is_ready`]
1478 - [`Poll::is_pending`]
1479
1480 Cargo
1481 -----------------------
1482 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
1483 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
1484 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
1485   variable will be set if the crate being built is one the user selected to build, either
1486   with `-p` or through defaults.
1487 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
1488
1489
1490 Compatibility Notes
1491 -------------------
1492
1493 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
1494 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
1495 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
1496   Previously such invalid or unused attributes could be ignored.
1497 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
1498   read [this post about the changes][rustdoc-ws-post] for more details.
1499 - [Trait bounds are no longer inferred for associated types.][79904]
1500
1501 Internal Only
1502 -------------
1503 These changes provide no direct user facing benefits, but represent significant
1504 improvements to the internals and overall performance of rustc and
1505 related tools.
1506
1507 - [rustc's internal crates are now compiled using the `initial-exec` Thread
1508   Local Storage model.][78201]
1509 - [Calculate visibilities once in resolve.][78077]
1510 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
1511 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
1512
1513
1514 [75991]: https://github.com/rust-lang/rust/pull/75991
1515 [78951]: https://github.com/rust-lang/rust/pull/78951
1516 [78848]: https://github.com/rust-lang/rust/pull/78848
1517 [78746]: https://github.com/rust-lang/rust/pull/78746
1518 [78376]: https://github.com/rust-lang/rust/pull/78376
1519 [78228]: https://github.com/rust-lang/rust/pull/78228
1520 [78227]: https://github.com/rust-lang/rust/pull/78227
1521 [78201]: https://github.com/rust-lang/rust/pull/78201
1522 [78109]: https://github.com/rust-lang/rust/pull/78109
1523 [78077]: https://github.com/rust-lang/rust/pull/78077
1524 [77997]: https://github.com/rust-lang/rust/pull/77997
1525 [77703]: https://github.com/rust-lang/rust/pull/77703
1526 [77547]: https://github.com/rust-lang/rust/pull/77547
1527 [77015]: https://github.com/rust-lang/rust/pull/77015
1528 [76199]: https://github.com/rust-lang/rust/pull/76199
1529 [76119]: https://github.com/rust-lang/rust/pull/76119
1530 [75914]: https://github.com/rust-lang/rust/pull/75914
1531 [79004]: https://github.com/rust-lang/rust/pull/79004
1532 [78676]: https://github.com/rust-lang/rust/pull/78676
1533 [79904]: https://github.com/rust-lang/rust/issues/79904
1534 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
1535 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
1536 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
1537 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
1538 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
1539 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
1540 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
1541 [`hint::spin_loop`]: https://doc.rust-lang.org/stable/std/hint/fn.spin_loop.html
1542 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
1543 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
1544 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
1545
1546 Version 1.48.0 (2020-11-19)
1547 ==========================
1548
1549 Language
1550 --------
1551
1552 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
1553   is still rejected *semantically*, but can now be parsed by procedural macros.
1554
1555 Compiler
1556 --------
1557 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
1558   `rustc` whether to link its own C runtime and libraries or to rely on a external
1559   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
1560 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
1561   Note: If you're using cargo you must explicitly pass the `--target` flag.
1562 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
1563
1564 \* Refer to Rust's [platform support page][platform-support-doc] for more
1565 information on Rust's tiered platform support.
1566
1567 Libraries
1568 ---------
1569 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
1570   and `&Stderr`.][76275]
1571 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
1572 - [The `matches!` macro now supports having a trailing comma.][74880]
1573 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
1574 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
1575
1576 Stabilized APIs
1577 ---------------
1578 - [`slice::as_ptr_range`]
1579 - [`slice::as_mut_ptr_range`]
1580 - [`VecDeque::make_contiguous`]
1581 - [`future::pending`]
1582 - [`future::ready`]
1583
1584 The following previously stable methods are now `const fn`'s:
1585
1586 - [`Option::is_some`]
1587 - [`Option::is_none`]
1588 - [`Option::as_ref`]
1589 - [`Result::is_ok`]
1590 - [`Result::is_err`]
1591 - [`Result::as_ref`]
1592 - [`Ordering::reverse`]
1593 - [`Ordering::then`]
1594
1595 Cargo
1596 -----
1597
1598 Rustdoc
1599 -------
1600 - [You can now link to items in `rustdoc` using the intra-doc link
1601   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
1602   a link to `std::future`'s documentation. See ["Linking to items by
1603   name"][intradoc-links] for more information.
1604 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
1605   when searching through `rustdoc`'s UI.][75740]
1606
1607 Compatibility Notes
1608 -------------------
1609 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
1610   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
1611   promoted to `'static` lifetime any more inside `const fn`s.
1612 - [Associated type bindings on trait objects are now verified to meet the bounds
1613   declared on the trait when checking that they implement the trait.][27675]
1614 - [When trait bounds on associated types or opaque types are ambiguous, the
1615   compiler no longer makes an arbitrary choice on which bound to use.][54121]
1616 - [Fixed recursive nonterminals not being expanded in macros during
1617   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
1618   correctly handling recursive nonterminal tokens.
1619 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
1620 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
1621   in places where they have no effect.][73461]
1622 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
1623   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
1624 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
1625   disallow zero-initialization.][71274]
1626 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
1627 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
1628   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
1629   see the [`catch_unwind`] documentation for further information.
1630
1631
1632
1633 Internal Only
1634 -------------
1635 These changes provide no direct user facing benefits, but represent significant
1636 improvements to the internals and overall performance of rustc and
1637 related tools.
1638
1639 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
1640   You can continue building with `make` by setting `ninja=false` in
1641   your `config.toml`.
1642 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
1643 - [Made `ensure_sufficient_stack()` non-generic][76680]
1644
1645 [78143]: https://github.com/rust-lang/rust/issues/78143
1646 [76680]: https://github.com/rust-lang/rust/pull/76680/
1647 [76030]: https://github.com/rust-lang/rust/pull/76030/
1648 [70212]: https://github.com/rust-lang/rust/pull/70212/
1649 [27675]: https://github.com/rust-lang/rust/issues/27675/
1650 [54121]: https://github.com/rust-lang/rust/issues/54121/
1651 [71274]: https://github.com/rust-lang/rust/pull/71274/
1652 [77386]: https://github.com/rust-lang/rust/pull/77386/
1653 [77153]: https://github.com/rust-lang/rust/pull/77153/
1654 [77055]: https://github.com/rust-lang/rust/pull/77055/
1655 [76275]: https://github.com/rust-lang/rust/pull/76275/
1656 [76310]: https://github.com/rust-lang/rust/pull/76310/
1657 [76420]: https://github.com/rust-lang/rust/pull/76420/
1658 [76158]: https://github.com/rust-lang/rust/pull/76158/
1659 [75857]: https://github.com/rust-lang/rust/pull/75857/
1660 [75585]: https://github.com/rust-lang/rust/pull/75585/
1661 [75740]: https://github.com/rust-lang/rust/pull/75740/
1662 [75502]: https://github.com/rust-lang/rust/pull/75502/
1663 [74880]: https://github.com/rust-lang/rust/pull/74880/
1664 [74922]: https://github.com/rust-lang/rust/pull/74922/
1665 [74430]: https://github.com/rust-lang/rust/pull/74430/
1666 [74194]: https://github.com/rust-lang/rust/pull/74194/
1667 [73461]: https://github.com/rust-lang/rust/pull/73461/
1668 [73166]: https://github.com/rust-lang/rust/pull/73166/
1669 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
1670 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
1671 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
1672 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
1673 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
1674 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
1675 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
1676 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
1677 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
1678 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
1679 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
1680 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
1681 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
1682 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
1683 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
1684
1685
1686 Version 1.47.0 (2020-10-08)
1687 ==========================
1688
1689 Language
1690 --------
1691 - [Closures will now warn when not used.][74869]
1692
1693 Compiler
1694 --------
1695 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
1696   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
1697   platforms.
1698 - [Upgraded to LLVM 11.][73526]
1699 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
1700 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
1701 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
1702
1703 \* Refer to Rust's [platform support page][platform-support-doc] for more
1704 information on Rust's tiered platform support.
1705
1706 Libraries
1707 ---------
1708 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
1709 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
1710   those of length less than 33.][74060]
1711 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
1712 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
1713   `PartialEq`, and `PartialOrd`.][73583]
1714
1715 Stabilized APIs
1716 ---------------
1717 - [`Ident::new_raw`]
1718 - [`Range::is_empty`]
1719 - [`RangeInclusive::is_empty`]
1720 - [`Result::as_deref`]
1721 - [`Result::as_deref_mut`]
1722 - [`Vec::leak`]
1723 - [`pointer::offset_from`]
1724 - [`f32::TAU`]
1725 - [`f64::TAU`]
1726
1727 The following previously stable APIs have now been made const.
1728
1729 - [The `new` method for all `NonZero` integers.][73858]
1730 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
1731   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
1732   methods for all integers.][73858]
1733 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
1734   signed integers.][73858]
1735 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
1736   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
1737   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
1738   `is_ascii_control` methods for `char` and `u8`.][73858]
1739
1740 Cargo
1741 -----
1742 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
1743   You can override this by setting the following in your `Cargo.toml`.
1744   ```toml
1745   [profile.release.build-override]
1746   opt-level = 3
1747   ```
1748 - [`cargo-help` will now display man pages for commands rather just the
1749   `--help` text.][cargo/8456]
1750 - [`cargo-metadata` now emits a `test` field indicating if a target has
1751   tests enabled.][cargo/8478]
1752 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
1753 - [`cargo-publish` will now use an alternative registry by default if it's the
1754   only registry specified in `package.publish`.][cargo/8571]
1755
1756 Misc
1757 ----
1758 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
1759   type based search.][75366]
1760 - [Added the Ayu theme to rustdoc.][71237]
1761
1762 Compatibility Notes
1763 -------------------
1764 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
1765 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
1766 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
1767   help to preserve more span information.][73084] These changes may cause
1768   compiliation errors if your macro was unhygenic or didn't correctly handle
1769   `Delimiter::None`.
1770 - [Moved support for the CloudABI target to tier 3.][75568]
1771 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
1772 - [Added the `rustc-docs` component.][75560] This allows you to install
1773   and read the documentation for the compiler internal APIs. (Currently only
1774   available for `x86_64-unknown-linux-gnu`.)
1775
1776 Internal Only
1777 --------
1778
1779 - [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.
1780
1781 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
1782 [75048]: https://github.com/rust-lang/rust/pull/75048/
1783 [74163]: https://github.com/rust-lang/rust/pull/74163/
1784 [71237]: https://github.com/rust-lang/rust/pull/71237/
1785 [74869]: https://github.com/rust-lang/rust/pull/74869/
1786 [73858]: https://github.com/rust-lang/rust/pull/73858/
1787 [75716]: https://github.com/rust-lang/rust/pull/75716/
1788 [75908]: https://github.com/rust-lang/rust/pull/75908/
1789 [75516]: https://github.com/rust-lang/rust/pull/75516/
1790 [75560]: https://github.com/rust-lang/rust/pull/75560/
1791 [75568]: https://github.com/rust-lang/rust/pull/75568/
1792 [75366]: https://github.com/rust-lang/rust/pull/75366/
1793 [75204]: https://github.com/rust-lang/rust/pull/75204/
1794 [74650]: https://github.com/rust-lang/rust/pull/74650/
1795 [74419]: https://github.com/rust-lang/rust/pull/74419/
1796 [73964]: https://github.com/rust-lang/rust/pull/73964/
1797 [74021]: https://github.com/rust-lang/rust/pull/74021/
1798 [74060]: https://github.com/rust-lang/rust/pull/74060/
1799 [73893]: https://github.com/rust-lang/rust/pull/73893/
1800 [73526]: https://github.com/rust-lang/rust/pull/73526/
1801 [73583]: https://github.com/rust-lang/rust/pull/73583/
1802 [73084]: https://github.com/rust-lang/rust/pull/73084/
1803 [73197]: https://github.com/rust-lang/rust/pull/73197/
1804 [72488]: https://github.com/rust-lang/rust/pull/72488/
1805 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
1806 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
1807 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
1808 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
1809 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
1810 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
1811 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
1812 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
1813 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
1814 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
1815 [`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
1816 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
1817 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
1818 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
1819 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
1820
1821
1822 Version 1.46.0 (2020-08-27)
1823 ==========================
1824
1825 Language
1826 --------
1827 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
1828 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
1829   const functions.][73862]
1830 - [The `#[track_caller]` attribute can now be added to functions to use the
1831   function's caller's location information for panic messages.][72445]
1832 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
1833   `x.0.0` over `(x.0).0`.
1834 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
1835   You currently can't use `mem::transmute` in constant functions.
1836
1837 Compiler
1838 --------
1839 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
1840 - [Enabled static "Position Independent Executables" by default
1841   for `x86_64-unknown-linux-musl`.][70740]
1842
1843 Libraries
1844 ---------
1845 - [`mem::forget` is now a `const fn`.][73887]
1846 - [`String` now implements `From<char>`.][73466]
1847 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
1848   integer types.][73032]
1849 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
1850 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
1851   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
1852 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
1853 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
1854 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
1855
1856 Stabilized APIs
1857 ---------------
1858 - [`Option::zip`]
1859 - [`vec::Drain::as_slice`]
1860
1861 Cargo
1862 -----
1863 Added a number of new environment variables that are now available when
1864 compiling your crate.
1865
1866 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
1867   the specific binary being compiled and the name of the crate.
1868 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
1869 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
1870
1871 Compatibility Notes
1872 -------------------
1873 - [The target configuration option `abi_blacklist` has been renamed
1874   to `unsupported_abis`.][74150] The old name will still continue to work.
1875 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
1876   This was previously accepted but will become a hard error in a future release.
1877 - [Rustc will fail to compile if you have a struct with
1878   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
1879   allowed on `enum`s.
1880 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
1881   ensure that spans have the correct information, and may cause breakage if you
1882   were relying on receiving spans with dummy information.
1883 - [The InnoSetup installer for Windows is no longer available.][72569] This was
1884   a legacy installer that was replaced by a MSI installer a few years ago but
1885   was still being built.
1886 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
1887 - [Rustc will no longer accept overlapping trait implementations that only
1888   differ in how the lifetime was bound.][72493]
1889 - [Rustc now correctly relates the lifetime of an existential associated
1890   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
1891   you to pass a shorter lifetime than expected.
1892 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
1893   The library will need to be installed for `rustc` to work, even though we
1894   expect it to be already available on most systems.
1895 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
1896   under QEMU.][74820]
1897 - [Pretty printing of some tokens in procedural macros changed.][75453] The
1898   exact output returned by rustc's pretty printing is an unstable
1899   implementation detail: we recommend any macro relying on it to switch to a
1900   more robust parsing system.
1901
1902 [75453]: https://github.com/rust-lang/rust/issues/75453/
1903 [74820]: https://github.com/rust-lang/rust/issues/74820/
1904 [74420]: https://github.com/rust-lang/rust/issues/74420/
1905 [74109]: https://github.com/rust-lang/rust/pull/74109/
1906 [74150]: https://github.com/rust-lang/rust/pull/74150/
1907 [73862]: https://github.com/rust-lang/rust/pull/73862/
1908 [73887]: https://github.com/rust-lang/rust/pull/73887/
1909 [73466]: https://github.com/rust-lang/rust/pull/73466/
1910 [73516]: https://github.com/rust-lang/rust/pull/73516/
1911 [73293]: https://github.com/rust-lang/rust/pull/73293/
1912 [73007]: https://github.com/rust-lang/rust/pull/73007/
1913 [73032]: https://github.com/rust-lang/rust/pull/73032/
1914 [72920]: https://github.com/rust-lang/rust/pull/72920/
1915 [72569]: https://github.com/rust-lang/rust/pull/72569/
1916 [72583]: https://github.com/rust-lang/rust/pull/72583/
1917 [72584]: https://github.com/rust-lang/rust/pull/72584/
1918 [72717]: https://github.com/rust-lang/rust/pull/72717/
1919 [72437]: https://github.com/rust-lang/rust/pull/72437/
1920 [72445]: https://github.com/rust-lang/rust/pull/72445/
1921 [72486]: https://github.com/rust-lang/rust/pull/72486/
1922 [72493]: https://github.com/rust-lang/rust/pull/72493/
1923 [72331]: https://github.com/rust-lang/rust/pull/72331/
1924 [71896]: https://github.com/rust-lang/rust/pull/71896/
1925 [71660]: https://github.com/rust-lang/rust/pull/71660/
1926 [71322]: https://github.com/rust-lang/rust/pull/71322/
1927 [70740]: https://github.com/rust-lang/rust/pull/70740/
1928 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
1929 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
1930 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
1931 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
1932 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
1933
1934
1935 Version 1.45.2 (2020-08-03)
1936 ==========================
1937
1938 * [Fix bindings in tuple struct patterns][74954]
1939 * [Fix track_caller integration with trait objects][74784]
1940
1941 [74954]: https://github.com/rust-lang/rust/issues/74954
1942 [74784]: https://github.com/rust-lang/rust/issues/74784
1943
1944
1945 Version 1.45.1 (2020-07-30)
1946 ==========================
1947
1948 * [Fix const propagation with references.][73613]
1949 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1950 * [Avoid spurious implicit region bound.][74509]
1951 * [Install clippy on x.py install][74457]
1952
1953 [73613]: https://github.com/rust-lang/rust/pull/73613
1954 [73078]: https://github.com/rust-lang/rust/issues/73078
1955 [74509]: https://github.com/rust-lang/rust/pull/74509
1956 [74457]: https://github.com/rust-lang/rust/pull/74457
1957
1958
1959 Version 1.45.0 (2020-07-16)
1960 ==========================
1961
1962 Language
1963 --------
1964 - [Out of range float to int conversions using `as` has been defined as a saturating
1965   conversion.][71269] This was previously undefined behaviour, but you can use the
1966    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
1967    may be desirable in rare performance sensitive situations.
1968 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
1969   using `u64`.][70705]
1970 - [Function like procedural macros can now be used in expression, pattern, and  statement
1971   positions.][68717] This means you can now use a function-like procedural macro
1972   anywhere you can use a declarative (`macro_rules!`) macro.
1973
1974 Compiler
1975 --------
1976 - [You can now override individual target features through the `target-feature`
1977   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
1978   equivalent to `-C target-feature=+avx2,+fma`.
1979 - [Added the `force-unwind-tables` flag.][69984] This option allows
1980   rustc to always generate unwind tables regardless of panic strategy.
1981 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
1982   to include LLVM bitcode into generated `rlib`s (this is on by default).
1983 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
1984 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
1985 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
1986 - [Upgraded to LLVM 10.][67759]
1987
1988 \* Refer to Rust's [platform support page][platform-support-doc] for more
1989 information on Rust's tiered platform support.
1990
1991
1992 Libraries
1993 ---------
1994 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
1995   and `Ord`.][72239]
1996 - [`proc_macro::TokenStream` now implements `Default`.][72234]
1997 - [You can now use `char` with
1998   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
1999   a range of codepoints.][72413] E.g.
2000   you can now write the following;
2001   ```rust
2002   for ch in 'a'..='z' {
2003       print!("{}", ch);
2004   }
2005   println!();
2006   // Prints "abcdefghijklmnopqrstuvwxyz"
2007   ```
2008 - [`OsString` now implements `FromStr`.][71662]
2009 - [The `saturating_neg` method has been added to all signed integer primitive
2010   types, and the `saturating_abs` method has been added for all integer
2011   primitive types.][71886]
2012 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
2013   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
2014   or `Path`.][71447]
2015 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
2016 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
2017   integer types.][69813]
2018 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
2019   integer types.][72324]
2020 - [The `fetch_update` method has been added to all atomic integer types.][71843]
2021
2022 Stabilized APIs
2023 ---------------
2024 - [`Arc::as_ptr`]
2025 - [`BTreeMap::remove_entry`]
2026 - [`Rc::as_ptr`]
2027 - [`rc::Weak::as_ptr`]
2028 - [`rc::Weak::from_raw`]
2029 - [`rc::Weak::into_raw`]
2030 - [`str::strip_prefix`]
2031 - [`str::strip_suffix`]
2032 - [`sync::Weak::as_ptr`]
2033 - [`sync::Weak::from_raw`]
2034 - [`sync::Weak::into_raw`]
2035 - [`char::UNICODE_VERSION`]
2036 - [`Span::resolved_at`]
2037 - [`Span::located_at`]
2038 - [`Span::mixed_site`]
2039 - [`unix::process::CommandExt::arg0`]
2040
2041 Cargo
2042 -----
2043
2044 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
2045   time.][cargo/8066]
2046
2047 Misc
2048 ----
2049 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
2050   `~~outdated information~~` becomes "~~outdated information~~".
2051 - [Added an emoji to Rustdoc's deprecated API message.][72014]
2052
2053 Compatibility Notes
2054 -------------------
2055 - [Trying to self initialize a static value (that is creating a value using
2056   itself) is unsound and now causes a compile error.][71140]
2057 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
2058   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
2059 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
2060   previously undocumented and not intended for public use. Rustdoc still provides
2061   a non-zero exit code on errors.
2062 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
2063   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
2064   flags while cargo is adding `embed-bitcode` itself. The recommended way to
2065   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
2066   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
2067
2068 Internals Only
2069 --------------
2070 - [Make clippy a git subtree instead of a git submodule][70655]
2071 - [Unify the undo log of all snapshot types][69464]
2072
2073 [71848]: https://github.com/rust-lang/rust/issues/71848/
2074 [73420]: https://github.com/rust-lang/rust/issues/73420/
2075 [72324]: https://github.com/rust-lang/rust/pull/72324/
2076 [71843]: https://github.com/rust-lang/rust/pull/71843/
2077 [71886]: https://github.com/rust-lang/rust/pull/71886/
2078 [72234]: https://github.com/rust-lang/rust/pull/72234/
2079 [72239]: https://github.com/rust-lang/rust/pull/72239/
2080 [72397]: https://github.com/rust-lang/rust/pull/72397/
2081 [72413]: https://github.com/rust-lang/rust/pull/72413/
2082 [72014]: https://github.com/rust-lang/rust/pull/72014/
2083 [72062]: https://github.com/rust-lang/rust/pull/72062/
2084 [72094]: https://github.com/rust-lang/rust/pull/72094/
2085 [72133]: https://github.com/rust-lang/rust/pull/72133/
2086 [67759]: https://github.com/rust-lang/rust/pull/67759/
2087 [71900]: https://github.com/rust-lang/rust/pull/71900/
2088 [71928]: https://github.com/rust-lang/rust/pull/71928/
2089 [71662]: https://github.com/rust-lang/rust/pull/71662/
2090 [71716]: https://github.com/rust-lang/rust/pull/71716/
2091 [71447]: https://github.com/rust-lang/rust/pull/71447/
2092 [71269]: https://github.com/rust-lang/rust/pull/71269/
2093 [71095]: https://github.com/rust-lang/rust/pull/71095/
2094 [71140]: https://github.com/rust-lang/rust/pull/71140/
2095 [70655]: https://github.com/rust-lang/rust/pull/70655/
2096 [70705]: https://github.com/rust-lang/rust/pull/70705/
2097 [69984]: https://github.com/rust-lang/rust/pull/69984/
2098 [69813]: https://github.com/rust-lang/rust/pull/69813/
2099 [69464]: https://github.com/rust-lang/rust/pull/69464/
2100 [68717]: https://github.com/rust-lang/rust/pull/68717/
2101 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
2102 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
2103 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
2104 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
2105 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
2106 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
2107 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
2108 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
2109 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
2110 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
2111 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
2112 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
2113 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
2114 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
2115 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
2116 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
2117 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
2118
2119
2120 Version 1.44.1 (2020-06-18)
2121 ===========================
2122
2123 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
2124 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
2125 * [Fix crashes when finding backtrace on macOS.][71397]
2126 * [Clippy applies lint levels into different files.][clippy/5356]
2127
2128 [71397]: https://github.com/rust-lang/rust/issues/71397
2129 [73078]: https://github.com/rust-lang/rust/issues/73078
2130 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
2131 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
2132
2133
2134 Version 1.44.0 (2020-06-04)
2135 ==========================
2136
2137 Language
2138 --------
2139 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
2140 - [Added the `unused_braces` lint.][70081]
2141
2142 **Syntax-only changes**
2143
2144 - [Expansion-driven outline module parsing][69838]
2145 ```rust
2146 #[cfg(FALSE)]
2147 mod foo {
2148     mod bar {
2149         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
2150     }
2151 }
2152 ```
2153
2154 These are still rejected semantically, so you will likely receive an error but
2155 these changes can be seen and parsed by macros and conditional compilation.
2156
2157 Compiler
2158 --------
2159 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
2160   Additionally when in incremental mode rustc defaults to 256 codegen units.
2161 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
2162   a panic is thrown.][67502]
2163 - [Added tier 3\* support for the `aarch64-unknown-none` and
2164   `aarch64-unknown-none-softfloat` targets.][68334]
2165 - [Added tier 3 support for `arm64-apple-tvos` and
2166   `x86_64-apple-tvos` targets.][68191]
2167
2168
2169 Libraries
2170 ---------
2171 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
2172   `vec![]` to be able to be used in `const` contexts.
2173 - [`convert::Infallible` now implements `Hash`.][70281]
2174 - [`OsString` now implements `DerefMut` and `IndexMut` returning
2175   a `&mut OsStr`.][70048]
2176 - [Unicode 13 is now supported.][69929]
2177 - [`String` now implements `From<&mut str>`.][69661]
2178 - [`IoSlice` now implements `Copy`.][69403]
2179 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
2180 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
2181 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
2182   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
2183   integer types.][69373]
2184
2185 Stabilized APIs
2186 ---------------
2187 - [`PathBuf::with_capacity`]
2188 - [`PathBuf::capacity`]
2189 - [`PathBuf::clear`]
2190 - [`PathBuf::reserve`]
2191 - [`PathBuf::reserve_exact`]
2192 - [`PathBuf::shrink_to_fit`]
2193 - [`f32::to_int_unchecked`]
2194 - [`f64::to_int_unchecked`]
2195 - [`Layout::align_to`]
2196 - [`Layout::pad_to_align`]
2197 - [`Layout::array`]
2198 - [`Layout::extend`]
2199
2200 Cargo
2201 -----
2202 - [Added the `cargo tree` command which will print a tree graph of
2203   your dependencies.][cargo/8062] E.g.
2204   ```
2205     mdbook v0.3.2 (/Users/src/rust/mdbook)
2206   ├── ammonia v3.0.0
2207   │   ├── html5ever v0.24.0
2208   │   │   ├── log v0.4.8
2209   │   │   │   └── cfg-if v0.1.9
2210   │   │   ├── mac v0.1.1
2211   │   │   └── markup5ever v0.9.0
2212   │   │       ├── log v0.4.8 (*)
2213   │   │       ├── phf v0.7.24
2214   │   │       │   └── phf_shared v0.7.24
2215   │   │       │       ├── siphasher v0.2.3
2216   │   │       │       └── unicase v1.4.2
2217   │   │       │           [build-dependencies]
2218   │   │       │           └── version_check v0.1.5
2219   ...
2220   ```
2221   You can also display dependencies on multiple versions of the same crate with
2222   `cargo tree -d` (short for `cargo tree --duplicates`).
2223
2224 Misc
2225 ----
2226 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
2227   the version in the sidebar.][69494]
2228
2229 Compatibility Notes
2230 -------------------
2231 - [Rustc now correctly generates static libraries on Windows GNU targets with
2232   the `.a` extension, rather than the previous `.lib`.][70937]
2233 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
2234 - [The `file_name` property in JSON output of macro errors now points the actual
2235   source file rather than the previous format of `<NAME macros>`.][70969]
2236   **Note:** this may not point to a file that actually exists on the user's system.
2237 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
2238 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
2239   not allow zero initialization such as `NonZeroU8`.][66059] This was
2240   previously a warning.
2241 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
2242   operator has been defined as a saturating operation.][71269] This was previously
2243   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
2244   continue using the current behaviour, which may be desirable in rare performance
2245   sensitive situations.
2246
2247 Internal Only
2248 -------------
2249 These changes provide no direct user facing benefits, but represent significant
2250 improvements to the internals and overall performance of rustc and
2251 related tools.
2252
2253 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
2254 - [Replace big JS dict with JSON parsing.][71250]
2255
2256 [69373]: https://github.com/rust-lang/rust/pull/69373/
2257 [66059]: https://github.com/rust-lang/rust/pull/66059/
2258 [68191]: https://github.com/rust-lang/rust/pull/68191/
2259 [68899]: https://github.com/rust-lang/rust/pull/68899/
2260 [71147]: https://github.com/rust-lang/rust/pull/71147/
2261 [71250]: https://github.com/rust-lang/rust/pull/71250/
2262 [70937]: https://github.com/rust-lang/rust/pull/70937/
2263 [70969]: https://github.com/rust-lang/rust/pull/70969/
2264 [70632]: https://github.com/rust-lang/rust/pull/70632/
2265 [70281]: https://github.com/rust-lang/rust/pull/70281/
2266 [70345]: https://github.com/rust-lang/rust/pull/70345/
2267 [70048]: https://github.com/rust-lang/rust/pull/70048/
2268 [70081]: https://github.com/rust-lang/rust/pull/70081/
2269 [70156]: https://github.com/rust-lang/rust/pull/70156/
2270 [71269]: https://github.com/rust-lang/rust/pull/71269/
2271 [69838]: https://github.com/rust-lang/rust/pull/69838/
2272 [69929]: https://github.com/rust-lang/rust/pull/69929/
2273 [69661]: https://github.com/rust-lang/rust/pull/69661/
2274 [69778]: https://github.com/rust-lang/rust/pull/69778/
2275 [69494]: https://github.com/rust-lang/rust/pull/69494/
2276 [69403]: https://github.com/rust-lang/rust/pull/69403/
2277 [69033]: https://github.com/rust-lang/rust/pull/69033/
2278 [68692]: https://github.com/rust-lang/rust/pull/68692/
2279 [68334]: https://github.com/rust-lang/rust/pull/68334/
2280 [67502]: https://github.com/rust-lang/rust/pull/67502/
2281 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
2282 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
2283 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
2284 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
2285 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
2286 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
2287 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
2288 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
2289 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
2290 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
2291 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
2292 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
2293 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
2294
2295
2296 Version 1.43.1 (2020-05-07)
2297 ===========================
2298
2299 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
2300 * [Fixed the stabilization of AVX-512 features.][71473]
2301 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
2302
2303 [71430]: https://github.com/rust-lang/rust/pull/71430
2304 [71473]: https://github.com/rust-lang/rust/issues/71473
2305 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
2306
2307
2308 Version 1.43.0 (2020-04-23)
2309 ==========================
2310
2311 Language
2312 --------
2313 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
2314   the type inferred correctly.][68129]
2315 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
2316
2317 **Syntax only changes**
2318 - [Allow `type Foo: Ord` syntactically.][69361]
2319 - [Fuse associated and extern items up to defaultness.][69194]
2320 - [Syntactically allow `self` in all `fn` contexts.][68764]
2321 - [Merge `fn` syntax + cleanup item parsing.][68728]
2322 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
2323   For example, you may now write:
2324   ```rust
2325   macro_rules! mac_trait {
2326       ($i:item) => {
2327           trait T { $i }
2328       }
2329   }
2330   mac_trait! {
2331       fn foo() {}
2332   }
2333   ```
2334
2335 These are still rejected *semantically*, so you will likely receive an error but
2336 these changes can be seen and parsed by macros and
2337 conditional compilation.
2338
2339
2340 Compiler
2341 --------
2342 - [You can now pass multiple lint flags to rustc to override the previous
2343   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
2344   everything in the `unused` lint group except `unused-variables` which
2345   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
2346   everything in the `unused` lint group **including** `unused-variables` since
2347   the allow flag is specified before the deny flag (and therefore overridden).
2348 - [rustc will now prefer your system MinGW libraries over its bundled libraries
2349   if they are available on `windows-gnu`.][67429]
2350 - [rustc now buffers errors/warnings printed in JSON.][69227]
2351
2352 Libraries
2353 ---------
2354 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
2355   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
2356   respectively.][69538] **Note** These conversions are only available when `N`
2357   is `0..=32`.
2358 - [You can now use associated constants on floats and integers directly, rather
2359   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
2360   `f32::NAN` with no imports.
2361 - [`u8::is_ascii` is now `const`.][68984]
2362 - [`String` now implements `AsMut<str>`.][68742]
2363 - [Added the `primitive` module to `std` and `core`.][67637] This module
2364   reexports Rust's primitive types. This is mainly useful in macros
2365   where you want avoid these types being shadowed.
2366 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
2367 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
2368
2369 Stabilized APIs
2370 ---------------
2371 - [`Once::is_completed`]
2372 - [`f32::LOG10_2`]
2373 - [`f32::LOG2_10`]
2374 - [`f64::LOG10_2`]
2375 - [`f64::LOG2_10`]
2376 - [`iter::once_with`]
2377
2378 Cargo
2379 -----
2380 - [You can now set config `[profile]`s in your `.cargo/config`, or through
2381   your environment.][cargo/7823]
2382 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
2383   executable path when running integration tests or benchmarks.][cargo/7697]
2384   `<name>` is the name of your binary as-is e.g. If you wanted the executable
2385   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
2386
2387 Misc
2388 ----
2389 - [Certain checks in the `const_err` lint were deemed unrelated to const
2390   evaluation][69185], and have been moved to the `unconditional_panic` and
2391   `arithmetic_overflow` lints.
2392
2393 Compatibility Notes
2394 -------------------
2395
2396 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
2397   has been a warning since 1.36.0.
2398 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
2399   led to some instances being accepted, and now correctly emits a hard error.
2400
2401 [69340]: https://github.com/rust-lang/rust/pull/69340
2402
2403 Internal Only
2404 -------------
2405 These changes provide no direct user facing benefits, but represent significant
2406 improvements to the internals and overall performance of `rustc` and
2407 related tools.
2408
2409 - [All components are now built with `opt-level=3` instead of `2`.][67878]
2410 - [Improved how rustc generates drop code.][67332]
2411 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
2412 - [traits: preallocate 2 Vecs of known initial size][69022]
2413 - [Avoid exponential behaviour when relating types][68772]
2414 - [Skip `Drop` terminators for enum variants without drop glue][68943]
2415 - [Improve performance of coherence checks][68966]
2416 - [Deduplicate types in the generator witness][68672]
2417 - [Invert control in struct_lint_level.][68725]
2418
2419 [67332]: https://github.com/rust-lang/rust/pull/67332/
2420 [67429]: https://github.com/rust-lang/rust/pull/67429/
2421 [67637]: https://github.com/rust-lang/rust/pull/67637/
2422 [67642]: https://github.com/rust-lang/rust/pull/67642/
2423 [67878]: https://github.com/rust-lang/rust/pull/67878/
2424 [67885]: https://github.com/rust-lang/rust/pull/67885/
2425 [68129]: https://github.com/rust-lang/rust/pull/68129/
2426 [68672]: https://github.com/rust-lang/rust/pull/68672/
2427 [68725]: https://github.com/rust-lang/rust/pull/68725/
2428 [68728]: https://github.com/rust-lang/rust/pull/68728/
2429 [68738]: https://github.com/rust-lang/rust/pull/68738/
2430 [68742]: https://github.com/rust-lang/rust/pull/68742/
2431 [68764]: https://github.com/rust-lang/rust/pull/68764/
2432 [68772]: https://github.com/rust-lang/rust/pull/68772/
2433 [68943]: https://github.com/rust-lang/rust/pull/68943/
2434 [68952]: https://github.com/rust-lang/rust/pull/68952/
2435 [68966]: https://github.com/rust-lang/rust/pull/68966/
2436 [68984]: https://github.com/rust-lang/rust/pull/68984/
2437 [69022]: https://github.com/rust-lang/rust/pull/69022/
2438 [69185]: https://github.com/rust-lang/rust/pull/69185/
2439 [69194]: https://github.com/rust-lang/rust/pull/69194/
2440 [69201]: https://github.com/rust-lang/rust/pull/69201/
2441 [69227]: https://github.com/rust-lang/rust/pull/69227/
2442 [69548]: https://github.com/rust-lang/rust/pull/69548/
2443 [69256]: https://github.com/rust-lang/rust/pull/69256/
2444 [69361]: https://github.com/rust-lang/rust/pull/69361/
2445 [69366]: https://github.com/rust-lang/rust/pull/69366/
2446 [69538]: https://github.com/rust-lang/rust/pull/69538/
2447 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
2448 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
2449 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
2450 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
2451 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
2452 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
2453 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
2454 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
2455
2456
2457 Version 1.42.0 (2020-03-12)
2458 ==========================
2459
2460 Language
2461 --------
2462 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
2463   ```rust
2464   fn foo(words: &[&str]) {
2465       match words {
2466           ["Hello", "World", "!", ..] => println!("Hello World!"),
2467           ["Foo", "Bar", ..] => println!("Baz"),
2468           rest => println!("{:?}", rest),
2469       }
2470   }
2471   ```
2472 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
2473   that you can create an enum that has the exact layout and ABI of the type
2474   it contains.
2475 - [You can now use outer attribute procedural macros on inline modules.][64273]
2476 - [There are some *syntax-only* changes:][67131]
2477    - `default` is syntactically allowed before items in `trait` definitions.
2478    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
2479      leave out their bodies in favor of `;`.
2480    - Bounds on associated types in `impl`s are now syntactically allowed
2481      (e.g. `type Foo: Ord;`).
2482    - `...` (the C-variadic type) may occur syntactically directly as the type of
2483       any function parameter.
2484
2485   These are still rejected *semantically*, so you will likely receive an error
2486   but these changes can be seen and parsed by procedural macros and
2487   conditional compilation.
2488
2489 Compiler
2490 --------
2491 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
2492 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
2493 - [`Option::{expect,unwrap}` and
2494    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
2495    pointing to the location where they were called, rather than
2496    `core`'s internals. ][67887]
2497
2498 \* Refer to Rust's [platform support page][platform-support-doc] for more
2499 information on Rust's tiered platform support.
2500
2501 Libraries
2502 ---------
2503 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
2504 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
2505    to implement `Sized`.][67935]
2506 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
2507 - [`Layout::new` is now `const`.][66254]
2508 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
2509
2510
2511 Stabilized APIs
2512 ---------------
2513 - [`CondVar::wait_while`]
2514 - [`CondVar::wait_timeout_while`]
2515 - [`DebugMap::key`]
2516 - [`DebugMap::value`]
2517 - [`ManuallyDrop::take`]
2518 - [`matches!`]
2519 - [`ptr::slice_from_raw_parts_mut`]
2520 - [`ptr::slice_from_raw_parts`]
2521
2522 Cargo
2523 -----
2524 - [You no longer need to include `extern crate proc_macro;` to be able to
2525   `use proc_macro;` in the `2018` edition.][cargo/7700]
2526
2527 Compatibility Notes
2528 -------------------
2529 - [`Error::description` has been deprecated, and its use will now produce a
2530   warning.][66919] It's recommended to use `Display`/`to_string` instead.
2531
2532 [68253]: https://github.com/rust-lang/rust/pull/68253/
2533 [68348]: https://github.com/rust-lang/rust/pull/68348/
2534 [67935]: https://github.com/rust-lang/rust/pull/67935/
2535 [68339]: https://github.com/rust-lang/rust/pull/68339/
2536 [68122]: https://github.com/rust-lang/rust/pull/68122/
2537 [64273]: https://github.com/rust-lang/rust/pull/64273/
2538 [67712]: https://github.com/rust-lang/rust/pull/67712/
2539 [67887]: https://github.com/rust-lang/rust/pull/67887/
2540 [67131]: https://github.com/rust-lang/rust/pull/67131/
2541 [67233]: https://github.com/rust-lang/rust/pull/67233/
2542 [66899]: https://github.com/rust-lang/rust/pull/66899/
2543 [66919]: https://github.com/rust-lang/rust/pull/66919/
2544 [66254]: https://github.com/rust-lang/rust/pull/66254/
2545 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
2546 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
2547 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
2548 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
2549 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
2550 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
2551 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
2552 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
2553 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
2554
2555
2556 Version 1.41.1 (2020-02-27)
2557 ===========================
2558
2559 * [Always check types of static items][69145]
2560 * [Always check lifetime bounds of `Copy` impls][69145]
2561 * [Fix miscompilation in callers of `Layout::repeat`][69225]
2562
2563 [69225]: https://github.com/rust-lang/rust/issues/69225
2564 [69145]: https://github.com/rust-lang/rust/pull/69145
2565
2566
2567 Version 1.41.0 (2020-01-30)
2568 ===========================
2569
2570 Language
2571 --------
2572
2573 - [You can now pass type parameters to foreign items when implementing
2574   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
2575 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
2576   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
2577   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
2578 - [You can now use any valid identifier in a `format_args` macro.][66847]
2579   Previously identifiers starting with an underscore were not allowed.
2580 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
2581   enum variants.][66183] These are still rejected semantically, but
2582   can be seen and parsed by procedural macros and conditional compilation.
2583 - [You can now define a Rust `extern "C"` function with `Box<T>` and use `T*` as the corresponding
2584   type on the C side.][62514] Please see [the documentation][box-memory-layout] for more information,
2585   including the important caveat about preferring to avoid `Box<T>` in Rust signatures for functions defined in C.
2586
2587 [box-memory-layout]: https://doc.rust-lang.org/std/boxed/index.html#memory-layout
2588
2589 Compiler
2590 --------
2591
2592 - [Rustc will now warn if you have unused loop `'label`s.][66325]
2593 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
2594 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
2595 - [You can now pass an arguments file passing the `@path` syntax
2596   to rustc.][66172] Note that the format differs somewhat from what is
2597   found in other tooling; please see [the documentation][argfile-docs] for
2598   more information.
2599 - [You can now provide `--extern` flag without a path, indicating that it is
2600   available from the search path or specified with an `-L` flag.][64882]
2601
2602 \* Refer to Rust's [platform support page][platform-support-doc] for more
2603 information on Rust's tiered platform support.
2604
2605 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
2606
2607 Libraries
2608 ---------
2609
2610 - [The `core::panic` module is now stable.][66771] It was already stable
2611   through `std`.
2612 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
2613   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
2614 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
2615
2616 Stabilized APIs
2617 ---------------
2618
2619 - [`Result::map_or`]
2620 - [`Result::map_or_else`]
2621 - [`std::rc::Weak::weak_count`]
2622 - [`std::rc::Weak::strong_count`]
2623 - [`std::sync::Weak::weak_count`]
2624 - [`std::sync::Weak::strong_count`]
2625
2626 Cargo
2627 -----
2628
2629 - [Cargo will now document all the private items for binary crates
2630   by default.][cargo/7593]
2631 - [`cargo-install` will now reinstall the package if it detects that it is out
2632   of date.][cargo/7560]
2633 - [Cargo.lock now uses a more git friendly format that should help to reduce
2634   merge conflicts.][cargo/7579]
2635 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
2636   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
2637   optimisation level to `2` for debug builds. You can also use
2638   `[profile.<profile>.build-override]` to override build scripts and
2639   their dependencies.
2640
2641 Misc
2642 ----
2643
2644 - [You can now specify `edition` in documentation code blocks to compile the block
2645   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
2646   should be compiled the 2018 edition of Rust.
2647 - [You can now provide custom themes to rustdoc with `--theme`, and check the
2648   current theme with `--check-theme`.][54733]
2649 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
2650
2651 Compatibility Notes
2652 -------------------
2653
2654 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
2655   Apple targets.][apple-32bit-drop] This means that the source code is still
2656   available to build, but the targets are no longer being tested and release
2657   binaries for those platforms will no longer be distributed by the Rust project.
2658   Please refer to the linked blog post for more information.
2659
2660 [54733]: https://github.com/rust-lang/rust/pull/54733/
2661 [61351]: https://github.com/rust-lang/rust/pull/61351/
2662 [62514]: https://github.com/rust-lang/rust/pull/62514/
2663 [67255]: https://github.com/rust-lang/rust/pull/67255/
2664 [66661]: https://github.com/rust-lang/rust/pull/66661/
2665 [66771]: https://github.com/rust-lang/rust/pull/66771/
2666 [66847]: https://github.com/rust-lang/rust/pull/66847/
2667 [66238]: https://github.com/rust-lang/rust/pull/66238/
2668 [66277]: https://github.com/rust-lang/rust/pull/66277/
2669 [66325]: https://github.com/rust-lang/rust/pull/66325/
2670 [66172]: https://github.com/rust-lang/rust/pull/66172/
2671 [66183]: https://github.com/rust-lang/rust/pull/66183/
2672 [65879]: https://github.com/rust-lang/rust/pull/65879/
2673 [65013]: https://github.com/rust-lang/rust/pull/65013/
2674 [64882]: https://github.com/rust-lang/rust/pull/64882/
2675 [64325]: https://github.com/rust-lang/rust/pull/64325/
2676 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
2677 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
2678 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
2679 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
2680 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
2681 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
2682 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
2683 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
2684 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
2685 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
2686 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
2687
2688 Version 1.40.0 (2019-12-19)
2689 ===========================
2690
2691 Language
2692 --------
2693 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
2694   `const` contexts.][65188] e.g.
2695
2696   ```rust
2697   pub struct Point(i32, i32);
2698
2699   const ORIGIN: Point = {
2700       let constructor = Point;
2701
2702       constructor(0, 0)
2703   };
2704   ```
2705
2706 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
2707   indicate that there may be variants or fields added in the future.][64639]
2708   For example this requires adding a wild-card branch (`_ => {}`) to any match
2709   statements on a non-exhaustive `enum`. [(RFC 2008)]
2710 - [You can now use function-like procedural macros in `extern` blocks and in
2711   type positions.][63931] e.g. `type Generated = macro!();`
2712 - [Function-like and attribute procedural macros can now emit
2713   `macro_rules!` items, so you can now have your macros generate macros.][64035]
2714 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
2715   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
2716   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
2717
2718 Compiler
2719 --------
2720 - [Added tier 3 support\* for the
2721   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
2722 - [Added tier 3 support for the
2723   `aarch64-unknown-none-softfloat` target.][64589]
2724 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
2725   `mips64el-unknown-linux-muslabi64` targets.][65843]
2726
2727 \* Refer to Rust's [platform support page][platform-support-doc] for more
2728   information on Rust's tiered platform support.
2729
2730 Libraries
2731 ---------
2732 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
2733
2734 Stabilized APIs
2735 ---------------
2736 - [`BTreeMap::get_key_value`]
2737 - [`HashMap::get_key_value`]
2738 - [`Option::as_deref_mut`]
2739 - [`Option::as_deref`]
2740 - [`Option::flatten`]
2741 - [`UdpSocket::peer_addr`]
2742 - [`f32::to_be_bytes`]
2743 - [`f32::to_le_bytes`]
2744 - [`f32::to_ne_bytes`]
2745 - [`f64::to_be_bytes`]
2746 - [`f64::to_le_bytes`]
2747 - [`f64::to_ne_bytes`]
2748 - [`f32::from_be_bytes`]
2749 - [`f32::from_le_bytes`]
2750 - [`f32::from_ne_bytes`]
2751 - [`f64::from_be_bytes`]
2752 - [`f64::from_le_bytes`]
2753 - [`f64::from_ne_bytes`]
2754 - [`mem::take`]
2755 - [`slice::repeat`]
2756 - [`todo!`]
2757
2758 Cargo
2759 -----
2760 - [Cargo will now always display warnings, rather than only on
2761   fresh builds.][cargo/7450]
2762 - [Feature flags (except `--all-features`) passed to a virtual workspace will
2763   now produce an error.][cargo/7507] Previously these flags were ignored.
2764 - [You can now publish `dev-dependencies` without including
2765   a `version`.][cargo/7333]
2766
2767 Misc
2768 ----
2769 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
2770   when running documentation tests with `rustdoc`.][63803]
2771
2772 Compatibility Notes
2773 -------------------
2774 - [As previously announced, any previous NLL warnings in the 2015 edition are
2775   now hard errors.][64221]
2776 - [The `include!` macro will now warn if it failed to include the
2777   entire file.][64284] The `include!` macro unintentionally only includes the
2778   first _expression_ in a file, and this can be unintuitive. This will become
2779   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
2780 - [Using `#[inline]` on function prototypes and consts now emits a warning under
2781   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
2782   or `extern` blocks now correctly emits a hard error.
2783
2784 [65294]: https://github.com/rust-lang/rust/pull/65294/
2785 [66103]: https://github.com/rust-lang/rust/pull/66103/
2786 [65843]: https://github.com/rust-lang/rust/pull/65843/
2787 [65188]: https://github.com/rust-lang/rust/pull/65188/
2788 [65092]: https://github.com/rust-lang/rust/pull/65092/
2789 [64589]: https://github.com/rust-lang/rust/pull/64589/
2790 [64639]: https://github.com/rust-lang/rust/pull/64639/
2791 [64221]: https://github.com/rust-lang/rust/pull/64221/
2792 [64284]: https://github.com/rust-lang/rust/pull/64284/
2793 [63931]: https://github.com/rust-lang/rust/pull/63931/
2794 [64035]: https://github.com/rust-lang/rust/pull/64035/
2795 [63674]: https://github.com/rust-lang/rust/pull/63674/
2796 [63803]: https://github.com/rust-lang/rust/pull/63803/
2797 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
2798 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
2799 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
2800 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
2801 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
2802 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
2803 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
2804 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
2805 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
2806 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
2807 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
2808 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
2809 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
2810 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
2811 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
2812 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
2813 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
2814 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
2815 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
2816 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
2817 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
2818 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
2819 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
2820 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
2821 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
2822 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
2823
2824
2825 Version 1.39.0 (2019-11-07)
2826 ===========================
2827
2828 Language
2829 --------
2830 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
2831   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
2832 - [You can now use certain attributes on function, closure, and function pointer
2833   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
2834   `deny`, `forbid` as well as inert helper attributes used by procedural macro
2835   attributes applied to items. e.g.
2836   ```rust
2837   fn len(
2838       #[cfg(windows)] slice: &[u16],
2839       #[cfg(not(windows))] slice: &[u8],
2840   ) -> usize {
2841       slice.len()
2842   }
2843   ```
2844 - [You can now take shared references to bind-by-move patterns in the `if` guards
2845   of `match` arms.][63118] e.g.
2846   ```rust
2847   fn main() {
2848       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
2849
2850       match array {
2851           nums
2852   //      ---- `nums` is bound by move.
2853               if nums.iter().sum::<u8>() == 10
2854   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
2855           => {
2856               drop(nums);
2857   //          ----------- Legal as `nums` was bound by move and so we have ownership.
2858           }
2859           _ => unreachable!(),
2860       }
2861   }
2862   ```
2863
2864
2865
2866 Compiler
2867 --------
2868 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
2869 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
2870 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
2871   **Note** Cargo currently doesn't use this feature. Refer to
2872   [cargo#7315][cargo/7315] to track this feature's progress.
2873 - [You can now pass `--show-output` argument to test binaries to print the
2874   output of successful tests.][62600]
2875
2876
2877 \* Refer to Rust's [platform support page][platform-support-doc] for more
2878 information on Rust's tiered platform support.
2879
2880 Libraries
2881 ---------
2882 - [`Vec::new` and `String::new` are now `const` functions.][64028]
2883 - [`LinkedList::new` is now a `const` function.][63684]
2884 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
2885 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
2886   now `const`.][63786]
2887
2888 Stabilized APIs
2889 ---------------
2890 - [`Pin::into_inner`]
2891 - [`Instant::checked_duration_since`]
2892 - [`Instant::saturating_duration_since`]
2893
2894 Cargo
2895 -----
2896 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
2897 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
2898   `--all` is now deprecated.
2899
2900 Misc
2901 ----
2902 - [You can now pass `-Clinker` to rustdoc to control the linker used
2903   for compiling doctests.][63834]
2904
2905 Compatibility Notes
2906 -------------------
2907 - [Code that was previously accepted by the old borrow checker, but rejected by
2908   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
2909   previously a warning, and will also become a hard error in the Rust 2015
2910   edition in the 1.40.0 release.
2911 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
2912   run tests.][63827] This should improve performance when running a large
2913   amount of doctests.
2914 - [The `try!` macro will now issue a deprecation warning.][62672] It is
2915   recommended to use the `?` operator instead.
2916 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
2917   returned `0.0`.
2918
2919 [62600]: https://github.com/rust-lang/rust/pull/62600/
2920 [62672]: https://github.com/rust-lang/rust/pull/62672/
2921 [63118]: https://github.com/rust-lang/rust/pull/63118/
2922 [63209]: https://github.com/rust-lang/rust/pull/63209/
2923 [63402]: https://github.com/rust-lang/rust/pull/63402/
2924 [63565]: https://github.com/rust-lang/rust/pull/63565/
2925 [63595]: https://github.com/rust-lang/rust/pull/63595/
2926 [63684]: https://github.com/rust-lang/rust/pull/63684/
2927 [63698]: https://github.com/rust-lang/rust/pull/63698/
2928 [63770]: https://github.com/rust-lang/rust/pull/63770/
2929 [63786]: https://github.com/rust-lang/rust/pull/63786/
2930 [63827]: https://github.com/rust-lang/rust/pull/63827/
2931 [63834]: https://github.com/rust-lang/rust/pull/63834/
2932 [63927]: https://github.com/rust-lang/rust/pull/63927/
2933 [63933]: https://github.com/rust-lang/rust/pull/63933/
2934 [63934]: https://github.com/rust-lang/rust/pull/63934/
2935 [63938]: https://github.com/rust-lang/rust/pull/63938/
2936 [63940]: https://github.com/rust-lang/rust/pull/63940/
2937 [63941]: https://github.com/rust-lang/rust/pull/63941/
2938 [63945]: https://github.com/rust-lang/rust/pull/63945/
2939 [64010]: https://github.com/rust-lang/rust/pull/64010/
2940 [64028]: https://github.com/rust-lang/rust/pull/64028/
2941 [64334]: https://github.com/rust-lang/rust/pull/64334/
2942 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
2943 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
2944 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
2945 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
2946 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
2947 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
2948
2949 Version 1.38.0 (2019-09-26)
2950 ==========================
2951
2952 Language
2953 --------
2954 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
2955 - [The `#[deprecated]` attribute can now be used on macros.][62042]
2956
2957 Compiler
2958 --------
2959 - [Added pipelined compilation support to `rustc`.][62766] This will
2960   improve compilation times in some cases. For further information please refer
2961   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
2962 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
2963   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
2964   `x86_64-uwp-windows-msvc` targets.][60260]
2965 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
2966   `armv7-unknown-linux-musleabi` targets.][63107]
2967 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
2968 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
2969 - [Upgraded to LLVM 9.][62592]
2970
2971 \* Refer to Rust's [platform support page][platform-support-doc] for more
2972 information on Rust's tiered platform support.
2973
2974 Libraries
2975 ---------
2976 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
2977 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
2978   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
2979   is available at `std::clone::Clone`). This also makes all built-in macros
2980   available in `std`/`core` root. e.g. `std::include_bytes!`.
2981 - [`str::Chars` now implements `Debug`.][63000]
2982 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
2983 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
2984 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
2985 - [Added euclidean remainder and division operations (`div_euclid`,
2986   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
2987   `overflowing`, and `wrapping` versions are available for all
2988   integer primitives.
2989 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
2990   `PartialEq`.][61491]
2991 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
2992
2993 Stabilized APIs
2994 ---------------
2995 - [`<*const T>::cast`]
2996 - [`<*mut T>::cast`]
2997 - [`Duration::as_secs_f32`]
2998 - [`Duration::as_secs_f64`]
2999 - [`Duration::div_f32`]
3000 - [`Duration::div_f64`]
3001 - [`Duration::from_secs_f32`]
3002 - [`Duration::from_secs_f64`]
3003 - [`Duration::mul_f32`]
3004 - [`Duration::mul_f64`]
3005 - [`any::type_name`]
3006
3007 Cargo
3008 -----
3009 - [Added pipelined compilation support to `cargo`.][cargo/7143]
3010 - [You can now pass the `--features` option multiple times to enable
3011   multiple features.][cargo/7084]
3012
3013 Rustdoc
3014 -------
3015
3016 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
3017
3018 Misc
3019 ----
3020 - [`rustc` will now warn about some incorrect uses of
3021   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
3022
3023 Compatibility Notes
3024 -------------------
3025 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
3026   1.38.0.
3027 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
3028   issues][62896] with certain crates such as libc.
3029
3030 [60260]: https://github.com/rust-lang/rust/pull/60260/
3031 [61457]: https://github.com/rust-lang/rust/pull/61457/
3032 [61491]: https://github.com/rust-lang/rust/pull/61491/
3033 [61884]: https://github.com/rust-lang/rust/pull/61884/
3034 [61953]: https://github.com/rust-lang/rust/pull/61953/
3035 [62042]: https://github.com/rust-lang/rust/pull/62042/
3036 [62528]: https://github.com/rust-lang/rust/pull/62528/
3037 [62583]: https://github.com/rust-lang/rust/pull/62583/
3038 [62735]: https://github.com/rust-lang/rust/pull/62735/
3039 [62766]: https://github.com/rust-lang/rust/pull/62766/
3040 [62784]: https://github.com/rust-lang/rust/pull/62784/
3041 [62592]: https://github.com/rust-lang/rust/pull/62592/
3042 [62785]: https://github.com/rust-lang/rust/issues/62785/
3043 [62814]: https://github.com/rust-lang/rust/pull/62814/
3044 [62896]: https://github.com/rust-lang/rust/issues/62896/
3045 [63000]: https://github.com/rust-lang/rust/pull/63000/
3046 [63056]: https://github.com/rust-lang/rust/pull/63056/
3047 [63107]: https://github.com/rust-lang/rust/pull/63107/
3048 [63346]: https://github.com/rust-lang/rust/pull/63346/
3049 [63421]: https://github.com/rust-lang/rust/pull/63421/
3050 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
3051 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
3052 [63048]: https://github.com/rust-lang/rust/pull/63048
3053 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
3054 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
3055 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
3056 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
3057 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
3058 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
3059 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
3060 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
3061 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
3062 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
3063 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
3064 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
3065 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
3066
3067 Version 1.37.0 (2019-08-15)
3068 ==========================
3069
3070 Language
3071 --------
3072 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
3073   [`Box`][62228], or an [array][62235] and unused.
3074 - [You can now use the `cfg` and `cfg_attr` attributes on
3075   generic parameters.][61547]
3076 - [You can now use enum variants through type alias.][61682] e.g. You can
3077   write the following:
3078   ```rust
3079   type MyOption = Option<u8>;
3080
3081   fn increment_or_zero(x: MyOption) -> u8 {
3082       match x {
3083           MyOption::Some(y) => y + 1,
3084           MyOption::None => 0,
3085       }
3086   }
3087   ```
3088 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
3089   `const _: u32 = 5;`.
3090 - [You can now use `#[repr(align(X)]` on enums.][61229]
3091 - [The  `?` Kleene macro operator is now available in the
3092   2015 edition.][60932]
3093
3094 Compiler
3095 --------
3096 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
3097   and `-C profile-use` flags.][61268] For more information on how to use profile
3098   guided optimization, please refer to the [rustc book][rustc-book-pgo].
3099 - [The `rust-lldb` wrapper script should now work again.][61827]
3100
3101 Libraries
3102 ---------
3103 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
3104
3105 Stabilized APIs
3106 ---------------
3107 - [`BufReader::buffer`]
3108 - [`BufWriter::buffer`]
3109 - [`Cell::from_mut`]
3110 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
3111 - [`DoubleEndedIterator::nth_back`]
3112 - [`Option::xor`]
3113 - [`Wrapping::reverse_bits`]
3114 - [`i128::reverse_bits`]
3115 - [`i16::reverse_bits`]
3116 - [`i32::reverse_bits`]
3117 - [`i64::reverse_bits`]
3118 - [`i8::reverse_bits`]
3119 - [`isize::reverse_bits`]
3120 - [`slice::copy_within`]
3121 - [`u128::reverse_bits`]
3122 - [`u16::reverse_bits`]
3123 - [`u32::reverse_bits`]
3124 - [`u64::reverse_bits`]
3125 - [`u8::reverse_bits`]
3126 - [`usize::reverse_bits`]
3127
3128 Cargo
3129 -----
3130 - [`Cargo.lock` files are now included by default when publishing executable crates
3131   with executables.][cargo/7026]
3132 - [You can now specify `default-run="foo"` in `[package]` to specify the
3133   default executable to use for `cargo run`.][cargo/7056]
3134
3135 Misc
3136 ----
3137
3138 Compatibility Notes
3139 -------------------
3140 - [Using `...` for inclusive range patterns will now warn by default.][61342]
3141   Please transition your code to using the `..=` syntax for inclusive
3142   ranges instead.
3143 - [Using a trait object without the `dyn` will now warn by default.][61203]
3144   Please transition your code to use `dyn Trait` for trait objects instead.
3145
3146 [62228]: https://github.com/rust-lang/rust/pull/62228/
3147 [62235]: https://github.com/rust-lang/rust/pull/62235/
3148 [61802]: https://github.com/rust-lang/rust/pull/61802/
3149 [61827]: https://github.com/rust-lang/rust/pull/61827/
3150 [61547]: https://github.com/rust-lang/rust/pull/61547/
3151 [61682]: https://github.com/rust-lang/rust/pull/61682/
3152 [61268]: https://github.com/rust-lang/rust/pull/61268/
3153 [61342]: https://github.com/rust-lang/rust/pull/61342/
3154 [61347]: https://github.com/rust-lang/rust/pull/61347/
3155 [61100]: https://github.com/rust-lang/rust/pull/61100/
3156 [61203]: https://github.com/rust-lang/rust/pull/61203/
3157 [61229]: https://github.com/rust-lang/rust/pull/61229/
3158 [60932]: https://github.com/rust-lang/rust/pull/60932/
3159 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
3160 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
3161 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
3162 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
3163 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
3164 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
3165 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
3166 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
3167 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
3168 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
3169 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
3170 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
3171 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
3172 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
3173 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
3174 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
3175 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
3176 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
3177 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
3178 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
3179 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
3180 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
3181 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
3182 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
3183
3184
3185 Version 1.36.0 (2019-07-04)
3186 ==========================
3187
3188 Language
3189 --------
3190 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
3191 - [The order of traits in trait objects no longer affects the semantics of that
3192   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
3193   `dyn fmt::Debug + Send`, where this was previously not the case.
3194
3195 Libraries
3196 ---------
3197 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
3198 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
3199 - [`mem::needs_drop` is now available as a const fn.][60364]
3200 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
3201 - [`String` now implements `BorrowMut<str>`.][60404]
3202 - [`io::Cursor` now implements `Default`.][60234]
3203 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
3204 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
3205   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
3206   environment has access to heap memory allocation.
3207 - [`String` now implements `From<&String>`.][59825]
3208 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
3209   return a tuple of each argument when there is multiple arguments.
3210 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
3211   not used.][59648]
3212
3213 Stabilized APIs
3214 ---------------
3215 - [`VecDeque::rotate_left`]
3216 - [`VecDeque::rotate_right`]
3217 - [`Iterator::copied`]
3218 - [`io::IoSlice`]
3219 - [`io::IoSliceMut`]
3220 - [`Read::read_vectored`]
3221 - [`Write::write_vectored`]
3222 - [`str::as_mut_ptr`]
3223 - [`mem::MaybeUninit`]
3224 - [`pointer::align_offset`]
3225 - [`future::Future`]
3226 - [`task::Context`]
3227 - [`task::RawWaker`]
3228 - [`task::RawWakerVTable`]
3229 - [`task::Waker`]
3230 - [`task::Poll`]
3231
3232 Cargo
3233 -----
3234 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
3235 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
3236
3237 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
3238
3239 Clippy
3240 ------
3241 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
3242
3243 Misc
3244 ----
3245
3246 Compatibility Notes
3247 -------------------
3248 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
3249   longer recommended, and will be deprecated in 1.39.0.
3250
3251 [60318]: https://github.com/rust-lang/rust/pull/60318/
3252 [60364]: https://github.com/rust-lang/rust/pull/60364/
3253 [60370]: https://github.com/rust-lang/rust/pull/60370/
3254 [60404]: https://github.com/rust-lang/rust/pull/60404/
3255 [60234]: https://github.com/rust-lang/rust/pull/60234/
3256 [60244]: https://github.com/rust-lang/rust/pull/60244/
3257 [58623]: https://github.com/rust-lang/rust/pull/58623/
3258 [59648]: https://github.com/rust-lang/rust/pull/59648/
3259 [59675]: https://github.com/rust-lang/rust/pull/59675/
3260 [59825]: https://github.com/rust-lang/rust/pull/59825/
3261 [59826]: https://github.com/rust-lang/rust/pull/59826/
3262 [59445]: https://github.com/rust-lang/rust/pull/59445/
3263 [59114]: https://github.com/rust-lang/rust/pull/59114/
3264 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
3265 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
3266 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
3267 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
3268 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
3269 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
3270 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
3271 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
3272 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
3273 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
3274 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
3275 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
3276 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
3277 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
3278 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
3279 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
3280 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
3281 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
3282 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
3283 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
3284
3285
3286 Version 1.35.0 (2019-05-23)
3287 ==========================
3288
3289 Language
3290 --------
3291 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
3292   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
3293 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
3294   ```rust
3295   unsafe fn call_unsafe(func: unsafe fn()) {
3296       func()
3297   }
3298
3299   pub fn main() {
3300       unsafe { call_unsafe(|| {}); }
3301   }
3302   ```
3303
3304
3305 Compiler
3306 --------
3307 - [Added the `armv6-unknown-freebsd-gnueabihf` and
3308   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
3309 - [Added the `wasm32-unknown-wasi` target.][59464]
3310
3311
3312 Libraries
3313 ---------
3314 - [`Thread` will now show its ID in `Debug` output.][59460]
3315 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
3316 - [`alloc::System` now implements `Default`.][59451]
3317 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
3318   last field.][59076]
3319 - [`char::{ToLowercase, ToUppercase}` now
3320   implement `ExactSizeIterator`.][58778]
3321 - [All `NonZero` numeric types now implement `FromStr`.][58717]
3322 - [Removed the `Read` trait bounds
3323   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
3324 - [You can now call the `dbg!` macro without any parameters to print the file
3325   and line where it is called.][57847]
3326 - [In place ASCII case conversions are now up to 4× faster.][59283]
3327   e.g. `str::make_ascii_lowercase`
3328 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
3329   and `Send`.][58369]
3330
3331 Stabilized APIs
3332 ---------------
3333 - [`f32::copysign`]
3334 - [`f64::copysign`]
3335 - [`RefCell::replace_with`]
3336 - [`RefCell::map_split`]
3337 - [`ptr::hash`]
3338 - [`Range::contains`]
3339 - [`RangeFrom::contains`]
3340 - [`RangeTo::contains`]
3341 - [`RangeInclusive::contains`]
3342 - [`RangeToInclusive::contains`]
3343 - [`Option::copied`]
3344
3345 Cargo
3346 -----
3347 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
3348   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
3349   platform specific.
3350
3351 Misc
3352 ----
3353 - [The Rust toolchain is now available natively for musl based distros.][58575]
3354
3355 [59460]: https://github.com/rust-lang/rust/pull/59460/
3356 [59464]: https://github.com/rust-lang/rust/pull/59464/
3357 [59500]: https://github.com/rust-lang/rust/pull/59500/
3358 [59512]: https://github.com/rust-lang/rust/pull/59512/
3359 [59580]: https://github.com/rust-lang/rust/pull/59580/
3360 [59283]: https://github.com/rust-lang/rust/pull/59283/
3361 [59451]: https://github.com/rust-lang/rust/pull/59451/
3362 [59076]: https://github.com/rust-lang/rust/pull/59076/
3363 [58778]: https://github.com/rust-lang/rust/pull/58778/
3364 [58717]: https://github.com/rust-lang/rust/pull/58717/
3365 [58369]: https://github.com/rust-lang/rust/pull/58369/
3366 [58423]: https://github.com/rust-lang/rust/pull/58423/
3367 [58080]: https://github.com/rust-lang/rust/pull/58080/
3368 [57847]: https://github.com/rust-lang/rust/pull/57847/
3369 [58575]: https://github.com/rust-lang/rust/pull/58575
3370 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
3371 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
3372 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
3373 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
3374 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
3375 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
3376 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
3377 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
3378 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
3379 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
3380 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
3381 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
3382
3383 Version 1.34.2 (2019-05-14)
3384 ===========================
3385
3386 * [Destabilize the `Error::type_id` function due to a security
3387    vulnerability][60785] ([CVE-2019-12083])
3388
3389 [60785]: https://github.com/rust-lang/rust/pull/60785
3390 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
3391
3392 Version 1.34.1 (2019-04-25)
3393 ===========================
3394
3395 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
3396 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
3397 * [Fix Clippy panic when checking some macros][clippy/3805]
3398
3399 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
3400 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
3401 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
3402
3403 Version 1.34.0 (2019-04-11)
3404 ==========================
3405
3406 Language
3407 --------
3408 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
3409   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
3410   but had no effect.
3411 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
3412   `#[attr{}]` procedural macros.][57367]
3413 - [You can now write `extern crate self as foo;`][57407] to import your
3414   crate's root into the extern prelude.
3415
3416
3417 Compiler
3418 --------
3419 - [You can now target `riscv64imac-unknown-none-elf` and
3420   `riscv64gc-unknown-none-elf`.][58406]
3421 - [You can now enable linker plugin LTO optimisations with
3422   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
3423   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
3424   boundaries.
3425 - [You can now target `powerpc64-unknown-freebsd`.][57809]
3426
3427
3428 Libraries
3429 ---------
3430 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
3431   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
3432   the `Hash` trait to create an iterator.
3433 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
3434   methods.][58421] Most notably you no longer require the `Ord` trait to create
3435   an iterator.
3436 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
3437   for all numeric types.][58044]
3438 - [Indexing a `str` is now generic over all types that
3439   implement `SliceIndex<str>`.][57604]
3440 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
3441   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
3442   produce a warning if their returning type is unused.
3443 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
3444   `overflowing_pow` are now available for all numeric types.][57873] These are
3445   equivalent to methods such as `wrapping_add` for the `pow` operation.
3446
3447
3448 Stabilized APIs
3449 ---------------
3450
3451 #### std & core
3452 * [`Any::type_id`]
3453 * [`Error::type_id`]
3454 * [`atomic::AtomicI16`]
3455 * [`atomic::AtomicI32`]
3456 * [`atomic::AtomicI64`]
3457 * [`atomic::AtomicI8`]
3458 * [`atomic::AtomicU16`]
3459 * [`atomic::AtomicU32`]
3460 * [`atomic::AtomicU64`]
3461 * [`atomic::AtomicU8`]
3462 * [`convert::Infallible`]
3463 * [`convert::TryFrom`]
3464 * [`convert::TryInto`]
3465 * [`iter::from_fn`]
3466 * [`iter::successors`]
3467 * [`num::NonZeroI128`]
3468 * [`num::NonZeroI16`]
3469 * [`num::NonZeroI32`]
3470 * [`num::NonZeroI64`]
3471 * [`num::NonZeroI8`]
3472 * [`num::NonZeroIsize`]
3473 * [`slice::sort_by_cached_key`]
3474 * [`str::escape_debug`]
3475 * [`str::escape_default`]
3476 * [`str::escape_unicode`]
3477 * [`str::split_ascii_whitespace`]
3478
3479 #### std
3480 * [`Instant::checked_add`]
3481 * [`Instant::checked_sub`]
3482 * [`SystemTime::checked_add`]
3483 * [`SystemTime::checked_sub`]
3484
3485 Cargo
3486 -----
3487 - [You can now use alternative registries to crates.io.][cargo/6654]
3488
3489 Misc
3490 ----
3491 - [You can now use the `?` operator in your documentation tests without manually
3492   adding `fn main() -> Result<(), _> {}`.][56470]
3493
3494 Compatibility Notes
3495 -------------------
3496 - [`Command::before_exec` is being replaced by the unsafe method
3497   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
3498 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
3499   can now use `const` functions in `static` variables.
3500
3501 [58370]: https://github.com/rust-lang/rust/pull/58370/
3502 [58406]: https://github.com/rust-lang/rust/pull/58406/
3503 [58421]: https://github.com/rust-lang/rust/pull/58421/
3504 [58166]: https://github.com/rust-lang/rust/pull/58166/
3505 [58044]: https://github.com/rust-lang/rust/pull/58044/
3506 [58057]: https://github.com/rust-lang/rust/pull/58057/
3507 [58059]: https://github.com/rust-lang/rust/pull/58059/
3508 [57809]: https://github.com/rust-lang/rust/pull/57809/
3509 [57873]: https://github.com/rust-lang/rust/pull/57873/
3510 [57604]: https://github.com/rust-lang/rust/pull/57604/
3511 [57367]: https://github.com/rust-lang/rust/pull/57367/
3512 [57407]: https://github.com/rust-lang/rust/pull/57407/
3513 [57425]: https://github.com/rust-lang/rust/pull/57425/
3514 [57106]: https://github.com/rust-lang/rust/pull/57106/
3515 [56470]: https://github.com/rust-lang/rust/pull/56470/
3516 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
3517 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
3518 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
3519 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
3520 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
3521 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
3522 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
3523 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
3524 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
3525 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
3526 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
3527 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
3528 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
3529 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
3530 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
3531 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
3532 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
3533 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
3534 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
3535 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
3536 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
3537 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
3538 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
3539 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
3540 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
3541 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
3542 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
3543 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
3544 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
3545 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
3546 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
3547
3548
3549 Version 1.33.0 (2019-02-28)
3550 ==========================
3551
3552 Language
3553 --------
3554 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
3555   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
3556 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
3557   E.g. You can have match statement on a `u8` that covers `0..=255` and
3558   you would no longer be required to have a `_ => unreachable!()` case.
3559 - [You can now have multiple patterns in `if let` and `while let`
3560   expressions.][57532] You can do this with the same syntax as a `match`
3561   expression. E.g.
3562   ```rust
3563   enum Creature {
3564       Crab(String),
3565       Lobster(String),
3566       Person(String),
3567   }
3568
3569   fn main() {
3570       let state = Creature::Crab("Ferris");
3571
3572       if let Creature::Crab(name) | Creature::Person(name) = state {
3573           println!("This creature's name is: {}", name);
3574       }
3575   }
3576   ```
3577 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
3578   this feature will by default produce a warning as this behaviour can be
3579   unintuitive. E.g. `if let _ = 5 {}`
3580 - [You can now use `let` bindings, assignments, expression statements,
3581   and irrefutable pattern destructuring in const functions.][57175]
3582 - [You can now call unsafe const functions.][57067] E.g.
3583   ```rust
3584   const unsafe fn foo() -> i32 { 5 }
3585   const fn bar() -> i32 {
3586       unsafe { foo() }
3587   }
3588   ```
3589 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
3590   E.g. `#[cfg_attr(all(), must_use, optimize)]`
3591 - [You can now specify a specific alignment with the `#[repr(packed)]`
3592   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
3593   with an alignment of 2 bytes and a size of 6 bytes.
3594 - [You can now import an item from a module as an `_`.][56303] This allows you to
3595   import a trait's impls, and not have the name in the namespace. E.g.
3596   ```rust
3597   use std::io::Read as _;
3598
3599   // Allowed as there is only one `Read` in the module.
3600   pub trait Read {}
3601   ```
3602 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
3603
3604 Compiler
3605 --------
3606 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
3607   command line argument.][56351]
3608 - [The minimum required LLVM version has been bumped to 6.0.][56642]
3609 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
3610 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
3611   tier 2 support.][57130] Visit the [platform support][platform-support] page for
3612   information on Rust's platform support.
3613 - [Added support for the `thumbv7neon-linux-androideabi` and
3614   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
3615 - [Added support for the `x86_64-unknown-uefi` target.][56769]
3616
3617 Libraries
3618 ---------
3619 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
3620   functions for all numeric types.][57566]
3621 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
3622   are now `const` functions for all numeric types.][57105]
3623 - [The methods `is_positive` and `is_negative` are now `const` functions for
3624   all signed numeric types.][57105]
3625 - [The `get` method for all `NonZero` types is now `const`.][57167]
3626 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
3627   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
3628   numeric types.][57234]
3629 - [`Ipv4Addr::new` is now a `const` function][57234]
3630
3631 Stabilized APIs
3632 ---------------
3633 - [`unix::FileExt::read_exact_at`]
3634 - [`unix::FileExt::write_all_at`]
3635 - [`Option::transpose`]
3636 - [`Result::transpose`]
3637 - [`convert::identity`]
3638 - [`pin::Pin`]
3639 - [`marker::Unpin`]
3640 - [`marker::PhantomPinned`]
3641 - [`Vec::resize_with`]
3642 - [`VecDeque::resize_with`]
3643 - [`Duration::as_millis`]
3644 - [`Duration::as_micros`]
3645 - [`Duration::as_nanos`]
3646
3647
3648 Cargo
3649 -----
3650 - [You can now publish crates that require a feature flag to compile with
3651   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
3652 - [Cargo should now rebuild a crate if a file was modified during the initial
3653   build.][cargo/6484]
3654
3655 Compatibility Notes
3656 -------------------
3657 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
3658   are now deprecated in the standard library, and their usage will now produce a warning.
3659   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
3660   methods instead.
3661 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
3662   downcasting.
3663 - [Libtest no longer creates a new thread for each test when
3664   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
3665
3666 [55982]: https://github.com/rust-lang/rust/pull/55982/
3667 [56243]: https://github.com/rust-lang/rust/pull/56243
3668 [56303]: https://github.com/rust-lang/rust/pull/56303/
3669 [56351]: https://github.com/rust-lang/rust/pull/56351/
3670 [56362]: https://github.com/rust-lang/rust/pull/56362
3671 [56642]: https://github.com/rust-lang/rust/pull/56642/
3672 [56769]: https://github.com/rust-lang/rust/pull/56769/
3673 [56805]: https://github.com/rust-lang/rust/pull/56805
3674 [56947]: https://github.com/rust-lang/rust/pull/56947/
3675 [57049]: https://github.com/rust-lang/rust/pull/57049/
3676 [57067]: https://github.com/rust-lang/rust/pull/57067/
3677 [57105]: https://github.com/rust-lang/rust/pull/57105
3678 [57130]: https://github.com/rust-lang/rust/pull/57130/
3679 [57167]: https://github.com/rust-lang/rust/pull/57167/
3680 [57175]: https://github.com/rust-lang/rust/pull/57175/
3681 [57234]: https://github.com/rust-lang/rust/pull/57234/
3682 [57332]: https://github.com/rust-lang/rust/pull/57332/
3683 [57465]: https://github.com/rust-lang/rust/pull/57465/
3684 [57532]: https://github.com/rust-lang/rust/pull/57532/
3685 [57535]: https://github.com/rust-lang/rust/pull/57535/
3686 [57566]: https://github.com/rust-lang/rust/pull/57566/
3687 [57615]: https://github.com/rust-lang/rust/pull/57615/
3688 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
3689 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
3690 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
3691 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
3692 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
3693 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
3694 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
3695 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
3696 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
3697 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
3698 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
3699 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
3700 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
3701 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
3702 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
3703 [platform-support]: https://forge.rust-lang.org/platform-support.html
3704
3705 Version 1.32.0 (2019-01-17)
3706 ==========================
3707
3708 Language
3709 --------
3710 #### 2018 edition
3711 - [You can now use the `?` operator in macro definitions.][56245] The `?`
3712   operator allows you to specify zero or one repetitions similar to the `*` and
3713   `+` operators.
3714 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
3715   now always resolve to the item (`enum`, `struct`, etc.) available in the
3716   module if present, before resolving to a external crate or an item the prelude.][56759]
3717   E.g.
3718   ```rust
3719   enum Color { Red, Green, Blue }
3720
3721   use Color::*;
3722   ```
3723
3724 #### All editions
3725 - [You can now match against `PhantomData<T>` types.][55837]
3726 - [You can now match against literals in macros with the `literal`
3727   specifier.][56072] This will match against a literal of any type.
3728   E.g. `1`, `'A'`, `"Hello World"`
3729 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
3730   ```rust
3731   struct Point(i32, i32);
3732
3733   impl Point {
3734       pub fn new(x: i32, y: i32) -> Self {
3735           Self(x, y)
3736       }
3737
3738       pub fn is_origin(&self) -> bool {
3739           match self {
3740               Self(0, 0) => true,
3741               _ => false,
3742           }
3743       }
3744   }
3745   ```
3746 - [Self can also now be used in type definitions.][56366] E.g.
3747   ```rust
3748   enum List<T>
3749   where
3750       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
3751   {
3752       Nil,
3753       Cons(T, Box<Self>) // likewise here
3754   }
3755   ```
3756 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
3757   a `impl Trait` or `dyn Trait` is returned and unused in the program.
3758
3759 Compiler
3760 --------
3761 - [The default allocator has changed from jemalloc to the default allocator on
3762   your system.][55238] The compiler itself on Linux & macOS will still use
3763   jemalloc, but programs compiled with it will use the system allocator.
3764 - [Added the `aarch64-pc-windows-msvc` target.][55702]
3765
3766 Libraries
3767 ---------
3768 - [`PathBuf` now implements `FromStr`.][55148]
3769 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
3770 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
3771   easily debug expressions in your rust program. E.g.
3772   ```rust
3773   let a = 2;
3774   let b = dbg!(a * 2) + 1;
3775   //      ^-- prints: [src/main.rs:4] a * 2 = 4
3776   assert_eq!(b, 5);
3777   ```
3778
3779 The following APIs are now `const` functions and can be used in a
3780 `const` context.
3781
3782 - [`Cell::as_ptr`]
3783 - [`UnsafeCell::get`]
3784 - [`char::is_ascii`]
3785 - [`iter::empty`]
3786 - [`ManuallyDrop::new`]
3787 - [`ManuallyDrop::into_inner`]
3788 - [`RangeInclusive::start`]
3789 - [`RangeInclusive::end`]
3790 - [`NonNull::as_ptr`]
3791 - [`slice::as_ptr`]
3792 - [`str::as_ptr`]
3793 - [`Duration::as_secs`]
3794 - [`Duration::subsec_millis`]
3795 - [`Duration::subsec_micros`]
3796 - [`Duration::subsec_nanos`]
3797 - [`CStr::as_ptr`]
3798 - [`Ipv4Addr::is_unspecified`]
3799 - [`Ipv6Addr::new`]
3800 - [`Ipv6Addr::octets`]
3801
3802 Stabilized APIs
3803 ---------------
3804 - [`i8::to_be_bytes`]
3805 - [`i8::to_le_bytes`]
3806 - [`i8::to_ne_bytes`]
3807 - [`i8::from_be_bytes`]
3808 - [`i8::from_le_bytes`]
3809 - [`i8::from_ne_bytes`]
3810 - [`i16::to_be_bytes`]
3811 - [`i16::to_le_bytes`]
3812 - [`i16::to_ne_bytes`]
3813 - [`i16::from_be_bytes`]
3814 - [`i16::from_le_bytes`]
3815 - [`i16::from_ne_bytes`]
3816 - [`i32::to_be_bytes`]
3817 - [`i32::to_le_bytes`]
3818 - [`i32::to_ne_bytes`]
3819 - [`i32::from_be_bytes`]
3820 - [`i32::from_le_bytes`]
3821 - [`i32::from_ne_bytes`]
3822 - [`i64::to_be_bytes`]
3823 - [`i64::to_le_bytes`]
3824 - [`i64::to_ne_bytes`]
3825 - [`i64::from_be_bytes`]
3826 - [`i64::from_le_bytes`]
3827 - [`i64::from_ne_bytes`]
3828 - [`i128::to_be_bytes`]
3829 - [`i128::to_le_bytes`]
3830 - [`i128::to_ne_bytes`]
3831 - [`i128::from_be_bytes`]
3832 - [`i128::from_le_bytes`]
3833 - [`i128::from_ne_bytes`]
3834 - [`isize::to_be_bytes`]
3835 - [`isize::to_le_bytes`]
3836 - [`isize::to_ne_bytes`]
3837 - [`isize::from_be_bytes`]
3838 - [`isize::from_le_bytes`]
3839 - [`isize::from_ne_bytes`]
3840 - [`u8::to_be_bytes`]
3841 - [`u8::to_le_bytes`]
3842 - [`u8::to_ne_bytes`]
3843 - [`u8::from_be_bytes`]
3844 - [`u8::from_le_bytes`]
3845 - [`u8::from_ne_bytes`]
3846 - [`u16::to_be_bytes`]
3847 - [`u16::to_le_bytes`]
3848 - [`u16::to_ne_bytes`]
3849 - [`u16::from_be_bytes`]
3850 - [`u16::from_le_bytes`]
3851 - [`u16::from_ne_bytes`]
3852 - [`u32::to_be_bytes`]
3853 - [`u32::to_le_bytes`]
3854 - [`u32::to_ne_bytes`]
3855 - [`u32::from_be_bytes`]
3856 - [`u32::from_le_bytes`]
3857 - [`u32::from_ne_bytes`]
3858 - [`u64::to_be_bytes`]
3859 - [`u64::to_le_bytes`]
3860 - [`u64::to_ne_bytes`]
3861 - [`u64::from_be_bytes`]
3862 - [`u64::from_le_bytes`]
3863 - [`u64::from_ne_bytes`]
3864 - [`u128::to_be_bytes`]
3865 - [`u128::to_le_bytes`]
3866 - [`u128::to_ne_bytes`]
3867 - [`u128::from_be_bytes`]
3868 - [`u128::from_le_bytes`]
3869 - [`u128::from_ne_bytes`]
3870 - [`usize::to_be_bytes`]
3871 - [`usize::to_le_bytes`]
3872 - [`usize::to_ne_bytes`]
3873 - [`usize::from_be_bytes`]
3874 - [`usize::from_le_bytes`]
3875 - [`usize::from_ne_bytes`]
3876
3877 Cargo
3878 -----
3879 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
3880 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
3881
3882 Misc
3883 ----
3884 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
3885
3886 Compatibility Notes
3887 -------------------
3888 - [The argument types for AVX's
3889   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
3890   been changed from `*const` to `*mut` as the previous implementation
3891   was unsound.
3892
3893
3894 [55148]: https://github.com/rust-lang/rust/pull/55148/
3895 [55238]: https://github.com/rust-lang/rust/pull/55238/
3896 [55280]: https://github.com/rust-lang/rust/pull/55280/
3897 [55610]: https://github.com/rust-lang/rust/pull/55610/
3898 [55663]: https://github.com/rust-lang/rust/pull/55663/
3899 [55702]: https://github.com/rust-lang/rust/pull/55702/
3900 [55837]: https://github.com/rust-lang/rust/pull/55837/
3901 [55843]: https://github.com/rust-lang/rust/pull/55843/
3902 [56072]: https://github.com/rust-lang/rust/pull/56072/
3903 [56245]: https://github.com/rust-lang/rust/pull/56245/
3904 [56365]: https://github.com/rust-lang/rust/pull/56365/
3905 [56366]: https://github.com/rust-lang/rust/pull/56366/
3906 [56395]: https://github.com/rust-lang/rust/pull/56395/
3907 [56759]: https://github.com/rust-lang/rust/pull/56759/
3908 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
3909 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
3910 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
3911 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
3912 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
3913 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3914 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3915 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
3916 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
3917 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
3918 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
3919 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
3920 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
3921 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
3922 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
3923 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
3924 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
3925 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
3926 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
3927 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
3928 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
3929 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
3930 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
3931 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
3932 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
3933 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
3934 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
3935 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
3936 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
3937 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
3938 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
3939 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
3940 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
3941 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
3942 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
3943 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
3944 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
3945 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
3946 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
3947 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
3948 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
3949 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
3950 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
3951 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
3952 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
3953 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
3954 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
3955 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
3956 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
3957 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
3958 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
3959 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
3960 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
3961 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
3962 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
3963 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
3964 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
3965 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
3966 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
3967 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
3968 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
3969 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
3970 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
3971 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
3972 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
3973 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
3974 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
3975 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
3976 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
3977 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
3978 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
3979 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
3980 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
3981 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
3982 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
3983 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
3984 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
3985 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
3986 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
3987 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
3988 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
3989 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
3990 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
3991 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
3992 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
3993 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
3994 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
3995 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
3996 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
3997 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
3998 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
3999 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
4000 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
4001
4002
4003 Version 1.31.1 (2018-12-20)
4004 ===========================
4005
4006 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
4007 - [Fix broken go-to-definition in RLS][rls/1171]
4008 - [Fix infinite loop on hover in RLS][rls/1170]
4009
4010 [56562]: https://github.com/rust-lang/rust/pull/56562
4011 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
4012 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
4013
4014 Version 1.31.0 (2018-12-06)
4015 ==========================
4016
4017 Language
4018 --------
4019 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
4020 - [New lifetime elision rules now allow for eliding lifetimes in functions and
4021   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
4022   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
4023   in structs.
4024 - [You can now define and use `const` functions.][54835] These are currently
4025   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
4026   [language reference][const-reference] for what exactly is available.
4027 - [You can now use tool lints, which allow you to scope lints from external
4028   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
4029 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
4030   a crate, not just in exported functions.][54451]
4031 - [You can now use parentheses in pattern matches.][54497]
4032
4033 Compiler
4034 --------
4035 - [Updated musl to 1.1.20][54430]
4036
4037 Libraries
4038 ---------
4039 - [You can now convert `num::NonZero*` types to their raw equivalents using the
4040   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
4041 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
4042   into `Option<&mut T>` using the `From` trait.][53218]
4043 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
4044
4045
4046 Stabilized APIs
4047 ---------------
4048 - [`slice::align_to`]
4049 - [`slice::align_to_mut`]
4050 - [`slice::chunks_exact`]
4051 - [`slice::chunks_exact_mut`]
4052 - [`slice::rchunks`]
4053 - [`slice::rchunks_mut`]
4054 - [`slice::rchunks_exact`]
4055 - [`slice::rchunks_exact_mut`]
4056 - [`Option::replace`]
4057
4058 Cargo
4059 -----
4060 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
4061 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
4062   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
4063
4064 [52813]: https://github.com/rust-lang/rust/pull/52813/
4065 [53218]: https://github.com/rust-lang/rust/pull/53218/
4066 [53555]: https://github.com/rust-lang/rust/issues/53555/
4067 [54057]: https://github.com/rust-lang/rust/pull/54057/
4068 [54240]: https://github.com/rust-lang/rust/pull/54240/
4069 [54430]: https://github.com/rust-lang/rust/pull/54430/
4070 [54451]: https://github.com/rust-lang/rust/pull/54451/
4071 [54497]: https://github.com/rust-lang/rust/pull/54497/
4072 [54778]: https://github.com/rust-lang/rust/pull/54778/
4073 [54835]: https://github.com/rust-lang/rust/pull/54835/
4074 [54870]: https://github.com/rust-lang/rust/pull/54870/
4075 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
4076 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
4077 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
4078 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
4079 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
4080 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
4081 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
4082 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
4083 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
4084 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
4085 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
4086 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
4087 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
4088 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
4089
4090 Version 1.30.1 (2018-11-08)
4091 ===========================
4092
4093 - [Fixed overflow ICE in rustdoc][54199]
4094 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
4095
4096 [54199]: https://github.com/rust-lang/rust/pull/54199
4097 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
4098
4099 Version 1.30.0 (2018-10-25)
4100 ==========================
4101
4102 Language
4103 --------
4104 - [Procedural macros are now available.][52081] These kinds of macros allow for
4105   more powerful code generation. There is a [new chapter available][proc-macros]
4106   in the Rust Programming Language book that goes further in depth.
4107 - [You can now use keywords as identifiers using the raw identifiers
4108   syntax (`r#`),][53236] e.g. `let r#for = true;`
4109 - [Using anonymous parameters in traits is now deprecated with a warning and
4110   will be a hard error in the 2018 edition.][53272]
4111 - [You can now use `crate` in paths.][54404] This allows you to refer to the
4112   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
4113 - [Using a external crate no longer requires being prefixed with `::`.][54404]
4114   Previously, using a external crate in a module without a use statement
4115   required `let json = ::serde_json::from_str(foo);` but can now be written
4116   as `let json = serde_json::from_str(foo);`.
4117 - [You can now apply the `#[used]` attribute to static items to prevent the
4118   compiler from optimising them away, even if they appear to be unused,][51363]
4119   e.g. `#[used] static FOO: u32 = 1;`
4120 - [You can now import and reexport macros from other crates with the `use`
4121   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
4122   the root module of the crate. If your macro relies on calling other local
4123   macros, it is recommended to export with the
4124   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
4125   those macros.
4126 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
4127   using the `vis` specifier.][53370]
4128 - [Non-macro attributes now allow all forms of literals, not just
4129   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
4130   write `#[attr(true)]`.
4131 - [You can now specify a function to handle a panic in the Rust runtime with the
4132   `#[panic_handler]` attribute.][51366]
4133
4134 Compiler
4135 --------
4136 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
4137 - [Added the `aarch64-unknown-netbsd` target][53165]
4138 - [Upgraded to LLVM 8.][53611]
4139
4140 Libraries
4141 ---------
4142 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
4143
4144 Stabilized APIs
4145 ---------------
4146 - [`Ipv4Addr::BROADCAST`]
4147 - [`Ipv4Addr::LOCALHOST`]
4148 - [`Ipv4Addr::UNSPECIFIED`]
4149 - [`Ipv6Addr::LOCALHOST`]
4150 - [`Ipv6Addr::UNSPECIFIED`]
4151 - [`Iterator::find_map`]
4152
4153   The following methods are replacement methods for `trim_left`, `trim_right`,
4154   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
4155   in 1.33.0:
4156 - [`str::trim_end_matches`]
4157 - [`str::trim_end`]
4158 - [`str::trim_start_matches`]
4159 - [`str::trim_start`]
4160
4161 Cargo
4162 ----
4163 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
4164 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
4165   equivalent to calling `rustdoc --error-format=json`.
4166 - [Cargo will now provide a progress bar for builds.][cargo/5995]
4167
4168 Misc
4169 ----
4170 - [`rustdoc` allows you to specify what edition to treat your code as with the
4171   `--edition` option.][54057]
4172 - [`rustdoc` now has the `--color` (specify whether to output color) and
4173   `--error-format` (specify error format, e.g. `json`) options.][53003]
4174 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
4175   debug symbols.][53774]
4176 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
4177   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
4178
4179 [50911]: https://github.com/rust-lang/rust/pull/50911/
4180 [51363]: https://github.com/rust-lang/rust/pull/51363/
4181 [51366]: https://github.com/rust-lang/rust/pull/51366/
4182 [52081]: https://github.com/rust-lang/rust/pull/52081/
4183 [53003]: https://github.com/rust-lang/rust/pull/53003/
4184 [53033]: https://github.com/rust-lang/rust/pull/53033/
4185 [53044]: https://github.com/rust-lang/rust/pull/53044/
4186 [53165]: https://github.com/rust-lang/rust/pull/53165/
4187 [53611]: https://github.com/rust-lang/rust/pull/53611/
4188 [53213]: https://github.com/rust-lang/rust/pull/53213/
4189 [53236]: https://github.com/rust-lang/rust/pull/53236/
4190 [53272]: https://github.com/rust-lang/rust/pull/53272/
4191 [53370]: https://github.com/rust-lang/rust/pull/53370/
4192 [53459]: https://github.com/rust-lang/rust/pull/53459/
4193 [53774]: https://github.com/rust-lang/rust/pull/53774/
4194 [53822]: https://github.com/rust-lang/rust/pull/53822/
4195 [54057]: https://github.com/rust-lang/rust/pull/54057/
4196 [54146]: https://github.com/rust-lang/rust/pull/54146/
4197 [54404]: https://github.com/rust-lang/rust/pull/54404/
4198 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
4199 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
4200 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
4201 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
4202
4203 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
4204 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
4205 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
4206 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
4207 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
4208 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
4209 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
4210 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
4211 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
4212 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
4213
4214
4215 Version 1.29.2 (2018-10-11)
4216 ===========================
4217
4218 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
4219 - The `rls-preview` component on the windows-gnu targets has been restored.
4220
4221 [54639]: https://github.com/rust-lang/rust/pull/54639
4222
4223
4224 Version 1.29.1 (2018-09-25)
4225 ===========================
4226
4227 Security Notes
4228 --------------
4229
4230 - The standard library's `str::repeat` function contained an out of bounds write
4231   caused by an integer overflow. This has been fixed by deterministically
4232   panicking when an overflow happens.
4233
4234   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
4235   us.
4236
4237
4238 Version 1.29.0 (2018-09-13)
4239 ==========================
4240
4241 Compiler
4242 --------
4243 - [Bumped minimum LLVM version to 5.0.][51899]
4244 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
4245 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
4246 - [Upgraded to LLVM 7.][51966]
4247
4248 Libraries
4249 ---------
4250 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
4251 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
4252 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
4253 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
4254   for `&str`.][51178]
4255 - [`Cell<T>` now allows `T` to be unsized.][50494]
4256 - [`SocketAddr` is now stable on Redox.][52656]
4257
4258 Stabilized APIs
4259 ---------------
4260 - [`Arc::downcast`]
4261 - [`Iterator::flatten`]
4262 - [`Rc::downcast`]
4263
4264 Cargo
4265 -----
4266 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
4267   `--locked` to disable this behavior.
4268 - [`cargo-install` will now allow you to cross compile an install
4269   using `--target`.][cargo/5614]
4270 - [Added the `cargo-fix` subcommand to automatically move project code from
4271   2015 edition to 2018.][cargo/5723]
4272 - [`cargo doc` can now optionally document private types using the
4273   `--document-private-items` flag.][cargo/5543]
4274
4275 Misc
4276 ----
4277 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
4278   the specified level to that level.][52354] For example `--cap-lints warn`
4279   will demote `deny` and `forbid` lints to `warn`.
4280 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
4281   fails and `101` if there is a panic.][52197]
4282 - [A preview of clippy has been made available through rustup.][51122]
4283   You can install the preview with `rustup component add clippy-preview`.
4284
4285 Compatibility Notes
4286 -------------------
4287 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
4288   Use `str::get_unchecked(begin..end)` instead.
4289 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
4290   Consider using the `home_dir` function from
4291   https://crates.io/crates/dirs instead.
4292 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
4293 - [`cfg` attributes and `--cfg` command line flags are now more
4294   strictly validated.][53893]
4295
4296 [53893]: https://github.com/rust-lang/rust/pull/53893/
4297 [52861]: https://github.com/rust-lang/rust/pull/52861/
4298 [51966]: https://github.com/rust-lang/rust/pull/51966/
4299 [52656]: https://github.com/rust-lang/rust/pull/52656/
4300 [52239]: https://github.com/rust-lang/rust/pull/52239/
4301 [52330]: https://github.com/rust-lang/rust/pull/52330/
4302 [52354]: https://github.com/rust-lang/rust/pull/52354/
4303 [52402]: https://github.com/rust-lang/rust/pull/52402/
4304 [52103]: https://github.com/rust-lang/rust/pull/52103/
4305 [52197]: https://github.com/rust-lang/rust/pull/52197/
4306 [51807]: https://github.com/rust-lang/rust/pull/51807/
4307 [51899]: https://github.com/rust-lang/rust/pull/51899/
4308 [51912]: https://github.com/rust-lang/rust/pull/51912/
4309 [51511]: https://github.com/rust-lang/rust/pull/51511/
4310 [51619]: https://github.com/rust-lang/rust/pull/51619/
4311 [51656]: https://github.com/rust-lang/rust/pull/51656/
4312 [51178]: https://github.com/rust-lang/rust/pull/51178/
4313 [51122]: https://github.com/rust-lang/rust/pull/51122
4314 [50494]: https://github.com/rust-lang/rust/pull/50494/
4315 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
4316 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
4317 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
4318 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
4319 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
4320 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
4321 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
4322
4323
4324 Version 1.28.0 (2018-08-02)
4325 ===========================
4326
4327 Language
4328 --------
4329 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
4330   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
4331   the inner type across Foreign Function Interface (FFI) boundaries.
4332 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
4333   and can now be used as identifiers.][51196]
4334 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
4335   stable.][51241] This will allow users to specify a global allocator for
4336   their program.
4337 - [Unit test functions marked with the `#[test]` attribute can now return
4338   `Result<(), E: Debug>` in addition to `()`.][51298]
4339 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
4340   allows macros to easily target lifetimes.
4341
4342 Compiler
4343 --------
4344 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
4345   prioritise making smaller binary sizes. `z` is the same as `s` with the
4346   exception that it does not vectorise loops, which typically results in an even
4347   smaller binary.
4348 - [The short error format is now stable.][49546] Specified with
4349   `--error-format=short` this option will provide a more compressed output of
4350   rust error messages.
4351 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
4352 - [Reduced the number of allocations in the macro parser.][50855] This can
4353   improve compile times of macro heavy crates on average by 5%.
4354
4355 Libraries
4356 ---------
4357 - [Implemented `Default` for `&mut str`.][51306]
4358 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
4359 - [Implemented `Extend` for `()`.][50234]
4360 - [The `Debug` implementation of `time::Duration` should now be more easily
4361   human readable.][50364] Previously a `Duration` of one second would printed as
4362   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
4363 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
4364   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
4365   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
4366   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
4367   for `PathBuf`.][50170]
4368 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
4369   and `Wrapping<i128>`.][50465]
4370 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
4371   possible.][51050] This can provide up to a 40% speed increase.
4372 - [Improved error messages when using `format!`.][50610]
4373
4374 Stabilized APIs
4375 ---------------
4376 - [`Iterator::step_by`]
4377 - [`Path::ancestors`]
4378 - [`SystemTime::UNIX_EPOCH`]
4379 - [`alloc::GlobalAlloc`]
4380 - [`alloc::Layout`]
4381 - [`alloc::LayoutErr`]
4382 - [`alloc::System`]
4383 - [`alloc::alloc`]
4384 - [`alloc::alloc_zeroed`]
4385 - [`alloc::dealloc`]
4386 - [`alloc::realloc`]
4387 - [`alloc::handle_alloc_error`]
4388 - [`btree_map::Entry::or_default`]
4389 - [`fmt::Alignment`]
4390 - [`hash_map::Entry::or_default`]
4391 - [`iter::repeat_with`]
4392 - [`num::NonZeroUsize`]
4393 - [`num::NonZeroU128`]
4394 - [`num::NonZeroU16`]
4395 - [`num::NonZeroU32`]
4396 - [`num::NonZeroU64`]
4397 - [`num::NonZeroU8`]
4398 - [`ops::RangeBounds`]
4399 - [`slice::SliceIndex`]
4400 - [`slice::from_mut`]
4401 - [`slice::from_ref`]
4402 - [`{Any + Send + Sync}::downcast_mut`]
4403 - [`{Any + Send + Sync}::downcast_ref`]
4404 - [`{Any + Send + Sync}::is`]
4405
4406 Cargo
4407 -----
4408 - [Cargo will now no longer allow you to publish crates with build scripts that
4409   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
4410   considered to be immutable.
4411
4412 Misc
4413 ----
4414 - [The `suggestion_applicability` field in `rustc`'s json output is now
4415   stable.][50486] This will allow dev tools to check whether a code suggestion
4416   would apply to them.
4417
4418 Compatibility Notes
4419 -------------------
4420 - [Rust will consider trait objects with duplicated constraints to be the same
4421   type as without the duplicated constraint.][51276] For example the below code will
4422   now fail to compile.
4423   ```rust
4424   trait Trait {}
4425
4426   impl Trait + Send {
4427       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
4428   }
4429
4430   impl Trait + Send + Send {
4431       fn test(&self) { println!("two"); }
4432   }
4433   ```
4434
4435 [49546]: https://github.com/rust-lang/rust/pull/49546/
4436 [50143]: https://github.com/rust-lang/rust/pull/50143/
4437 [50170]: https://github.com/rust-lang/rust/pull/50170/
4438 [50234]: https://github.com/rust-lang/rust/pull/50234/
4439 [50265]: https://github.com/rust-lang/rust/pull/50265/
4440 [50364]: https://github.com/rust-lang/rust/pull/50364/
4441 [50385]: https://github.com/rust-lang/rust/pull/50385/
4442 [50465]: https://github.com/rust-lang/rust/pull/50465/
4443 [50486]: https://github.com/rust-lang/rust/pull/50486/
4444 [50554]: https://github.com/rust-lang/rust/pull/50554/
4445 [50610]: https://github.com/rust-lang/rust/pull/50610/
4446 [50855]: https://github.com/rust-lang/rust/pull/50855/
4447 [51050]: https://github.com/rust-lang/rust/pull/51050/
4448 [51196]: https://github.com/rust-lang/rust/pull/51196/
4449 [51200]: https://github.com/rust-lang/rust/pull/51200/
4450 [51241]: https://github.com/rust-lang/rust/pull/51241/
4451 [51276]: https://github.com/rust-lang/rust/pull/51276/
4452 [51298]: https://github.com/rust-lang/rust/pull/51298/
4453 [51306]: https://github.com/rust-lang/rust/pull/51306/
4454 [51562]: https://github.com/rust-lang/rust/pull/51562/
4455 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
4456 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
4457 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
4458 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
4459 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
4460 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
4461 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
4462 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
4463 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
4464 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
4465 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
4466 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
4467 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
4468 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
4469 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
4470 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
4471 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
4472 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
4473 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
4474 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
4475 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
4476 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
4477 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
4478 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
4479 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
4480 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
4481 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
4482 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
4483 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
4484 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
4485
4486 Version 1.27.2 (2018-07-20)
4487 ===========================
4488
4489 Compatibility Notes
4490 -------------------
4491
4492 - The borrow checker was fixed to avoid potential unsoundness when using
4493   match ergonomics: [#52213][52213].
4494
4495 [52213]: https://github.com/rust-lang/rust/issues/52213
4496
4497 Version 1.27.1 (2018-07-10)
4498 ===========================
4499
4500 Security Notes
4501 --------------
4502
4503 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
4504   when running, which enabled executing code as some other user on a
4505   given machine. This release fixes that vulnerability; you can read
4506   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
4507
4508   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
4509
4510 Compatibility Notes
4511 -------------------
4512
4513 - The borrow checker was fixed to avoid an additional potential unsoundness when using
4514   match ergonomics: [#51415][51415], [#49534][49534].
4515
4516 [51415]: https://github.com/rust-lang/rust/issues/51415
4517 [49534]: https://github.com/rust-lang/rust/issues/49534
4518 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
4519 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
4520
4521 Version 1.27.0 (2018-06-21)
4522 ==========================
4523
4524 Language
4525 --------
4526 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
4527   be used as an identifier.
4528 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
4529   bare `Trait` syntax, and should make it clearer when being used in tandem with
4530   `impl Trait` because it is equivalent to the following syntax:
4531   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
4532   `Box<Trait> == Box<dyn Trait>`.
4533 - [Attributes on generic parameters such as types and lifetimes are
4534   now stable.][48851] e.g.
4535   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
4536 - [The `#[must_use]` attribute can now also be used on functions as well as
4537   types.][48925] It provides a lint that by default warns users when the
4538   value returned by a function has not been used.
4539
4540 Compiler
4541 --------
4542 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
4543
4544 Libraries
4545 ---------
4546 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
4547   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
4548   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
4549   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
4550   the `cfg` attribute.
4551 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
4552   std are now available in core.][49896]
4553 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
4554   to `Self`.][49630]
4555 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
4556   that the operation isn't done in place.
4557 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
4558   the `#[must_use]` attribute][49533] to warn about unused potentially
4559   expensive allocations.
4560
4561 Stabilized APIs
4562 ---------------
4563 - [`DoubleEndedIterator::rfind`]
4564 - [`DoubleEndedIterator::rfold`]
4565 - [`DoubleEndedIterator::try_rfold`]
4566 - [`Duration::from_micros`]
4567 - [`Duration::from_nanos`]
4568 - [`Duration::subsec_micros`]
4569 - [`Duration::subsec_millis`]
4570 - [`HashMap::remove_entry`]
4571 - [`Iterator::try_fold`]
4572 - [`Iterator::try_for_each`]
4573 - [`NonNull::cast`]
4574 - [`Option::filter`]
4575 - [`String::replace_range`]
4576 - [`Take::set_limit`]
4577 - [`hint::unreachable_unchecked`]
4578 - [`os::unix::process::parent_id`]
4579 - [`ptr::swap_nonoverlapping`]
4580 - [`slice::rsplit_mut`]
4581 - [`slice::rsplit`]
4582 - [`slice::swap_with_slice`]
4583
4584 Cargo
4585 -----
4586 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
4587   `readme`, and `repository` fields.][cargo/5386]
4588 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
4589 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
4590   a different directory than `target` for placing compilation artifacts.
4591 - [Cargo will be adding automatic target inference for binaries, benchmarks,
4592   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
4593   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
4594   where cargo would infer a binary, Cargo will produce a warning. You can
4595   disable this feature ahead of time by setting any of the following to false:
4596   `autobins`, `autobenches`, `autoexamples`, `autotests`.
4597 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
4598   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
4599
4600 Misc
4601 ----
4602 - [Added “The Rustc book” into the official documentation.][49707]
4603   [“The Rustc book”] documents and teaches how to use the rustc compiler.
4604 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
4605
4606 Compatibility Notes
4607 -------------------
4608 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
4609   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
4610   compile, `"".is_empty()` will still compile.
4611 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
4612   will only print the inner type.][48553] E.g.
4613   `print!("{:?}", AtomicBool::new(true))` will print `true`,
4614   not `AtomicBool(true)`.
4615 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
4616   could enter higher numbers but they were not supported by LLVM. Up to 512MB
4617   alignment should cover all use cases.
4618 - The `.description()` method on the `std::error::Error` trait
4619   [has been soft-deprecated][50163]. It is no longer required to implement it.
4620
4621 [48553]: https://github.com/rust-lang/rust/pull/48553/
4622 [48851]: https://github.com/rust-lang/rust/pull/48851/
4623 [48925]: https://github.com/rust-lang/rust/pull/48925/
4624 [49533]: https://github.com/rust-lang/rust/pull/49533/
4625 [49623]: https://github.com/rust-lang/rust/pull/49623/
4626 [49630]: https://github.com/rust-lang/rust/pull/49630/
4627 [49664]: https://github.com/rust-lang/rust/pull/49664/
4628 [49699]: https://github.com/rust-lang/rust/pull/49699/
4629 [49707]: https://github.com/rust-lang/rust/pull/49707/
4630 [49719]: https://github.com/rust-lang/rust/pull/49719/
4631 [49896]: https://github.com/rust-lang/rust/pull/49896/
4632 [49968]: https://github.com/rust-lang/rust/pull/49968/
4633 [50163]: https://github.com/rust-lang/rust/pull/50163
4634 [50177]: https://github.com/rust-lang/rust/pull/50177/
4635 [50378]: https://github.com/rust-lang/rust/pull/50378/
4636 [50398]: https://github.com/rust-lang/rust/pull/50398/
4637 [50423]: https://github.com/rust-lang/rust/pull/50423/
4638 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
4639 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
4640 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
4641 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
4642 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
4643 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
4644 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
4645 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
4646 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
4647 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
4648 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
4649 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
4650 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
4651 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
4652 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
4653 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
4654 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
4655 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
4656 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
4657 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
4658 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
4659 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
4660 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4661 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
4662 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
4663 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
4664 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
4665 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
4666 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
4667 [“The Rustc book”]: https://doc.rust-lang.org/rustc
4668
4669
4670 Version 1.26.2 (2018-06-05)
4671 ==========================
4672
4673 Compatibility Notes
4674 -------------------
4675
4676 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
4677
4678 [51117]: https://github.com/rust-lang/rust/issues/51117
4679
4680
4681 Version 1.26.1 (2018-05-29)
4682 ==========================
4683
4684 Tools
4685 -----
4686
4687 - [RLS now works on Windows.][50646]
4688 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
4689
4690
4691 Compatibility Notes
4692 --------
4693
4694 - [`fn main() -> impl Trait` no longer works for non-Termination
4695   trait.][50656]
4696   This reverts an accidental stabilization.
4697 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
4698 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
4699
4700 [50646]: https://github.com/rust-lang/rust/issues/50646
4701 [50656]: https://github.com/rust-lang/rust/pull/50656
4702 [50812]: https://github.com/rust-lang/rust/pull/50812
4703 [50950]: https://github.com/rust-lang/rust/issues/50950
4704 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
4705
4706 Version 1.26.0 (2018-05-10)
4707 ==========================
4708
4709 Language
4710 --------
4711 - [Closures now implement `Copy` and/or `Clone` if all captured variables
4712   implement either or both traits.][49299]
4713 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
4714 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
4715   lifetime can be elided.][49458]
4716 - [`impl Trait` is now stable allowing you to have abstract types in returns
4717    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
4718   `fn open(path: impl AsRef<Path>)`.
4719 - [Pattern matching will now automatically apply dereferences.][49394]
4720 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
4721 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
4722 - [A lot of operations are now available in a const context.][46882] E.g. You
4723   can now index into constant arrays, reference and dereference into constants,
4724   and use tuple struct constructors.
4725 - [Fixed entry slice patterns are now stable.][48516] E.g.
4726   ```rust
4727   let points = [1, 2, 3, 4];
4728   match points {
4729       [1, 2, 3, 4] => println!("All points were sequential."),
4730       _ => println!("Not all points were sequential."),
4731   }
4732   ```
4733
4734
4735 Compiler
4736 --------
4737 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
4738 - [Fixed exponential projection complexity on nested types.][48296]
4739   This can provide up to a ~12% reduction in compile times for certain crates.
4740 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
4741   to remap path prefixes outputted by the compiler.
4742 - [Added `powerpc-unknown-netbsd` target.][48281]
4743
4744 Libraries
4745 ---------
4746 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
4747 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
4748   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
4749 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
4750 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
4751 - [`ascii::escape_default` is now available in libcore.][48735]
4752 - [Trailing commas are now supported in std and core macros.][48056]
4753 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
4754 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
4755
4756 Stabilized APIs
4757 ---------------
4758 - [`*const T::add`]
4759 - [`*const T::copy_to_nonoverlapping`]
4760 - [`*const T::copy_to`]
4761 - [`*const T::read_unaligned`]
4762 - [`*const T::read_volatile`]
4763 - [`*const T::read`]
4764 - [`*const T::sub`]
4765 - [`*const T::wrapping_add`]
4766 - [`*const T::wrapping_sub`]
4767 - [`*mut T::add`]
4768 - [`*mut T::copy_to_nonoverlapping`]
4769 - [`*mut T::copy_to`]
4770 - [`*mut T::read_unaligned`]
4771 - [`*mut T::read_volatile`]
4772 - [`*mut T::read`]
4773 - [`*mut T::replace`]
4774 - [`*mut T::sub`]
4775 - [`*mut T::swap`]
4776 - [`*mut T::wrapping_add`]
4777 - [`*mut T::wrapping_sub`]
4778 - [`*mut T::write_bytes`]
4779 - [`*mut T::write_unaligned`]
4780 - [`*mut T::write_volatile`]
4781 - [`*mut T::write`]
4782 - [`Box::leak`]
4783 - [`FromUtf8Error::as_bytes`]
4784 - [`LocalKey::try_with`]
4785 - [`Option::cloned`]
4786 - [`btree_map::Entry::and_modify`]
4787 - [`fs::read_to_string`]
4788 - [`fs::read`]
4789 - [`fs::write`]
4790 - [`hash_map::Entry::and_modify`]
4791 - [`iter::FusedIterator`]
4792 - [`ops::RangeInclusive`]
4793 - [`ops::RangeToInclusive`]
4794 - [`process::id`]
4795 - [`slice::rotate_left`]
4796 - [`slice::rotate_right`]
4797 - [`String::retain`]
4798
4799
4800 Cargo
4801 -----
4802 - [Cargo will now output path to custom commands when `-v` is
4803   passed with `--list`][cargo/5041]
4804 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
4805
4806 Misc
4807 ----
4808 - [The second edition of "The Rust Programming Language" book is now recommended
4809   over the first.][48404]
4810
4811 Compatibility Notes
4812 -------------------
4813
4814 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
4815   syntax is now invalid.
4816   ```
4817   use std::ops::Fn as dyn;
4818   fn g(_: Box<dyn(std::fmt::Debug)>) {}
4819   ```
4820 - [The result of dereferences are no longer promoted to `'static`.][47408]
4821   e.g.
4822   ```rust
4823   fn main() {
4824       const PAIR: &(i32, i32) = &(0, 1);
4825       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
4826   }
4827   ```
4828 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
4829 - [`".e0"` will now no longer parse as `0.0` and will instead cause
4830   an error.][48235]
4831 - [Removed hoedown from rustdoc.][48274]
4832 - [Bounds on higher-kinded lifetimes a hard error.][48326]
4833
4834 [46882]: https://github.com/rust-lang/rust/pull/46882
4835 [47379]: https://github.com/rust-lang/rust/pull/47379
4836 [47408]: https://github.com/rust-lang/rust/pull/47408
4837 [47813]: https://github.com/rust-lang/rust/pull/47813
4838 [48056]: https://github.com/rust-lang/rust/pull/48056
4839 [48125]: https://github.com/rust-lang/rust/pull/48125
4840 [48166]: https://github.com/rust-lang/rust/pull/48166
4841 [48235]: https://github.com/rust-lang/rust/pull/48235
4842 [48274]: https://github.com/rust-lang/rust/pull/48274
4843 [48281]: https://github.com/rust-lang/rust/pull/48281
4844 [48296]: https://github.com/rust-lang/rust/pull/48296
4845 [48326]: https://github.com/rust-lang/rust/pull/48326
4846 [48359]: https://github.com/rust-lang/rust/pull/48359
4847 [48404]: https://github.com/rust-lang/rust/pull/48404
4848 [48481]: https://github.com/rust-lang/rust/pull/48481
4849 [48516]: https://github.com/rust-lang/rust/pull/48516
4850 [48628]: https://github.com/rust-lang/rust/pull/48628
4851 [48629]: https://github.com/rust-lang/rust/pull/48629
4852 [48657]: https://github.com/rust-lang/rust/pull/48657
4853 [48735]: https://github.com/rust-lang/rust/pull/48735
4854 [48978]: https://github.com/rust-lang/rust/pull/48978
4855 [49101]: https://github.com/rust-lang/rust/pull/49101
4856 [49109]: https://github.com/rust-lang/rust/pull/49109
4857 [49121]: https://github.com/rust-lang/rust/pull/49121
4858 [49162]: https://github.com/rust-lang/rust/pull/49162
4859 [49184]: https://github.com/rust-lang/rust/pull/49184
4860 [49234]: https://github.com/rust-lang/rust/pull/49234
4861 [49255]: https://github.com/rust-lang/rust/pull/49255
4862 [49299]: https://github.com/rust-lang/rust/pull/49299
4863 [49305]: https://github.com/rust-lang/rust/pull/49305
4864 [49394]: https://github.com/rust-lang/rust/pull/49394
4865 [49458]: https://github.com/rust-lang/rust/pull/49458
4866 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
4867 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
4868 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
4869 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
4870 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
4871 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
4872 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
4873 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
4874 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
4875 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
4876 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
4877 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
4878 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
4879 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
4880 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
4881 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
4882 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
4883 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
4884 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
4885 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
4886 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
4887 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
4888 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
4889 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
4890 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
4891 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
4892 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
4893 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
4894 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
4895 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
4896 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
4897 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
4898 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
4899 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
4900 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
4901 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
4902 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4903 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
4904 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
4905 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
4906 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
4907 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
4908
4909
4910 Version 1.25.0 (2018-03-29)
4911 ==========================
4912
4913 Language
4914 --------
4915 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
4916 - [You can now use nested groups of imports.][47948]
4917   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
4918 - [You can now have `|` at the start of a match arm.][47947] e.g.
4919 ```rust
4920 enum Foo { A, B, C }
4921
4922 fn main() {
4923     let x = Foo::A;
4924     match x {
4925         | Foo::A
4926         | Foo::B => println!("AB"),
4927         | Foo::C => println!("C"),
4928     }
4929 }
4930 ```
4931
4932 Compiler
4933 --------
4934 - [Upgraded to LLVM 6.][47828]
4935 - [Added `-C lto=val` option.][47521]
4936 - [Added `i586-unknown-linux-musl` target][47282]
4937
4938 Libraries
4939 ---------
4940 - [Impl Send for `process::Command` on Unix.][47760]
4941 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
4942 - [`UnsafeCell::into_inner` is now safe.][47204]
4943 - [Implement libstd for CloudABI.][47268]
4944 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
4945 - [Implement `AsRef<Path>` for Component][46985]
4946 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
4947 - [Moved `Duration` to libcore.][46666]
4948
4949 Stabilized APIs
4950 ---------------
4951 - [`Location::column`]
4952 - [`ptr::NonNull`]
4953
4954 The following functions can now be used in a constant expression.
4955 eg. `static MINUTE: Duration = Duration::from_secs(60);`
4956 - [`Duration::new`][47300]
4957 - [`Duration::from_secs`][47300]
4958 - [`Duration::from_millis`][47300]
4959
4960 Cargo
4961 -----
4962 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
4963 - [`cargo new` now defaults to creating a binary crate, instead of a
4964   library crate.][cargo/5029]
4965
4966 Misc
4967 ----
4968 - [Rust by example is now shipped with new releases][46196]
4969
4970 Compatibility Notes
4971 -------------------
4972 - [Deprecated `net::lookup_host`.][47510]
4973 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
4974 - The borrow checker was sometimes incorrectly permitting overlapping borrows
4975   around indexing operations (see [#47349][47349]). This has been fixed (which also
4976   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
4977 - [Removed deprecated unstable attribute `#[simd]`.][47251]
4978
4979 [33903]: https://github.com/rust-lang/rust/pull/33903
4980 [47947]: https://github.com/rust-lang/rust/pull/47947
4981 [47948]: https://github.com/rust-lang/rust/pull/47948
4982 [47760]: https://github.com/rust-lang/rust/pull/47760
4983 [47790]: https://github.com/rust-lang/rust/pull/47790
4984 [47828]: https://github.com/rust-lang/rust/pull/47828
4985 [47398]: https://github.com/rust-lang/rust/pull/47398
4986 [47510]: https://github.com/rust-lang/rust/pull/47510
4987 [47521]: https://github.com/rust-lang/rust/pull/47521
4988 [47204]: https://github.com/rust-lang/rust/pull/47204
4989 [47251]: https://github.com/rust-lang/rust/pull/47251
4990 [47268]: https://github.com/rust-lang/rust/pull/47268
4991 [47282]: https://github.com/rust-lang/rust/pull/47282
4992 [47300]: https://github.com/rust-lang/rust/pull/47300
4993 [47349]: https://github.com/rust-lang/rust/pull/47349
4994 [46931]: https://github.com/rust-lang/rust/pull/46931
4995 [46985]: https://github.com/rust-lang/rust/pull/46985
4996 [47006]: https://github.com/rust-lang/rust/pull/47006
4997 [46830]: https://github.com/rust-lang/rust/pull/46830
4998 [46095]: https://github.com/rust-lang/rust/pull/46095
4999 [46666]: https://github.com/rust-lang/rust/pull/46666
5000 [46196]: https://github.com/rust-lang/rust/pull/46196
5001 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
5002 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
5003 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
5004 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
5005 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
5006
5007
5008 Version 1.24.1 (2018-03-01)
5009 ==========================
5010
5011  - [Do not abort when unwinding through FFI][48251]
5012  - [Emit UTF-16 files for linker arguments on Windows][48318]
5013  - [Make the error index generator work again][48308]
5014  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
5015
5016 [48251]: https://github.com/rust-lang/rust/issues/48251
5017 [48308]: https://github.com/rust-lang/rust/issues/48308
5018 [48318]: https://github.com/rust-lang/rust/issues/48318
5019 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
5020
5021
5022 Version 1.24.0 (2018-02-15)
5023 ==========================
5024
5025 Language
5026 --------
5027 - [External `sysv64` ffi is now available.][46528]
5028   eg. `extern "sysv64" fn foo () {}`
5029
5030 Compiler
5031 --------
5032 - [rustc now uses 16 codegen units by default for release builds.][46910]
5033   For the fastest builds, utilize `codegen-units=1`.
5034 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
5035 - [Add `aarch64-unknown-openbsd` support][46760]
5036
5037 Libraries
5038 ---------
5039 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
5040   improvement in performance in the majority of cases.
5041 - [`OsStr`'s `Debug` implementation is now lossless and consistent
5042   with Windows.][46798]
5043 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
5044 - [impl `From<bool>` for `AtomicBool`][46293]
5045 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
5046 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
5047 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
5048 - [float::from_bits now just uses transmute.][46012] This provides
5049   some optimisations from LLVM.
5050 - [Copied `AsciiExt` methods onto `char`][46077]
5051 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
5052 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
5053 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
5054 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
5055
5056 Stabilized APIs
5057 ---------------
5058 - [`RefCell::replace`]
5059 - [`RefCell::swap`]
5060 - [`atomic::spin_loop_hint`]
5061
5062 The following functions can now be used in a constant expression.
5063 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
5064
5065 - [`AtomicBool::new`][46287]
5066 - [`AtomicUsize::new`][46287]
5067 - [`AtomicIsize::new`][46287]
5068 - [`AtomicPtr::new`][46287]
5069 - [`Cell::new`][46287]
5070 - [`{integer}::min_value`][46287]
5071 - [`{integer}::max_value`][46287]
5072 - [`mem::size_of`][46287]
5073 - [`mem::align_of`][46287]
5074 - [`ptr::null`][46287]
5075 - [`ptr::null_mut`][46287]
5076 - [`RefCell::new`][46287]
5077 - [`UnsafeCell::new`][46287]
5078
5079 Cargo
5080 -----
5081 - [Added a `workspace.default-members` config that
5082   overrides implied `--all` in virtual workspaces.][cargo/4743]
5083 - [Enable incremental by default on development builds.][cargo/4817] Also added
5084   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
5085   per-project or global basis respectively.
5086
5087 Misc
5088 ----
5089
5090 Compatibility Notes
5091 -------------------
5092 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
5093 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
5094   in accordance with IETF RFC 4291 §2.2.
5095 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
5096 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
5097   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
5098 - [Leading zeros in tuple struct members is now an error][47084]
5099 - [`column!()` macro is one-based instead of zero-based][46977]
5100 - [`fmt::Arguments` can no longer be shared across threads][45198]
5101 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
5102 - [Cargo sets a different working directory for the compiler][cargo/4788]
5103
5104 [44884]: https://github.com/rust-lang/rust/pull/44884
5105 [45198]: https://github.com/rust-lang/rust/pull/45198
5106 [45506]: https://github.com/rust-lang/rust/pull/45506
5107 [45904]: https://github.com/rust-lang/rust/pull/45904
5108 [45990]: https://github.com/rust-lang/rust/pull/45990
5109 [46012]: https://github.com/rust-lang/rust/pull/46012
5110 [46077]: https://github.com/rust-lang/rust/pull/46077
5111 [46094]: https://github.com/rust-lang/rust/pull/46094
5112 [46284]: https://github.com/rust-lang/rust/pull/46284
5113 [46287]: https://github.com/rust-lang/rust/pull/46287
5114 [46293]: https://github.com/rust-lang/rust/pull/46293
5115 [46528]: https://github.com/rust-lang/rust/pull/46528
5116 [46671]: https://github.com/rust-lang/rust/pull/46671
5117 [46713]: https://github.com/rust-lang/rust/pull/46713
5118 [46735]: https://github.com/rust-lang/rust/pull/46735
5119 [46749]: https://github.com/rust-lang/rust/pull/46749
5120 [46760]: https://github.com/rust-lang/rust/pull/46760
5121 [46798]: https://github.com/rust-lang/rust/pull/46798
5122 [46828]: https://github.com/rust-lang/rust/pull/46828
5123 [46831]: https://github.com/rust-lang/rust/pull/46831
5124 [46833]: https://github.com/rust-lang/rust/pull/46833
5125 [46910]: https://github.com/rust-lang/rust/pull/46910
5126 [46977]: https://github.com/rust-lang/rust/pull/46977
5127 [47018]: https://github.com/rust-lang/rust/pull/47018
5128 [47080]: https://github.com/rust-lang/rust/pull/47080
5129 [47084]: https://github.com/rust-lang/rust/pull/47084
5130 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
5131 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
5132 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
5133 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
5134 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
5135 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
5136
5137
5138 Version 1.23.0 (2018-01-04)
5139 ==========================
5140
5141 Language
5142 --------
5143 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
5144 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
5145   Which should fix some confusing errors in some operations.
5146
5147 Compiler
5148 --------
5149 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
5150   undefined behavior.][45920]
5151 - [rustc now suggests renaming import if names clash.][45660]
5152 - [Display errors/warnings correctly when there are zero-width or
5153   wide characters.][45711]
5154 - [rustc now avoids unnecessary copies of arguments that are
5155   simple bindings][45380] This should improve memory usage on average by 5-10%.
5156 - [Updated musl used to build musl rustc to 1.1.17][45393]
5157
5158 Libraries
5159 ---------
5160 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
5161 - [Implement Hash for raw pointers to unsized types][45483]
5162 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
5163 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
5164 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
5165 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
5166   and `<*mut T>::as_mut`][44932]
5167 - [Optimized `Thread::{park, unpark}` implementation][45524]
5168 - [Improved `SliceExt::binary_search` performance.][45333]
5169 - [impl `FromIterator<()>` for `()`][45379]
5170 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
5171   is now deprecated.
5172
5173 Stabilized APIs
5174 ---------------
5175
5176 Cargo
5177 -----
5178 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
5179   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
5180 - [Added unit test checking to `cargo check`][cargo/4592]
5181 - [Cargo now lets you install a specific version
5182   using `cargo install --version`][cargo/4637]
5183
5184 Misc
5185 ----
5186 - [Releases now ship with the Cargo book documentation.][45692]
5187 - [rustdoc now prints rendering warnings on every run.][45324]
5188
5189 Compatibility Notes
5190 -------------------
5191 - [Changes have been made to type equality to make it more correct,
5192   in rare cases this could break some code.][45853] [Tracking issue for
5193   further information][45852]
5194 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
5195 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
5196   Android 9, the minimum supported version is Android 14.
5197 - [Bumped the minimum LLVM to 3.9][45326]
5198
5199 [44042]: https://github.com/rust-lang/rust/pull/44042
5200 [44932]: https://github.com/rust-lang/rust/pull/44932
5201 [45267]: https://github.com/rust-lang/rust/pull/45267
5202 [45324]: https://github.com/rust-lang/rust/pull/45324
5203 [45326]: https://github.com/rust-lang/rust/pull/45326
5204 [45333]: https://github.com/rust-lang/rust/pull/45333
5205 [45379]: https://github.com/rust-lang/rust/pull/45379
5206 [45380]: https://github.com/rust-lang/rust/pull/45380
5207 [45393]: https://github.com/rust-lang/rust/pull/45393
5208 [45435]: https://github.com/rust-lang/rust/pull/45435
5209 [45483]: https://github.com/rust-lang/rust/pull/45483
5210 [45524]: https://github.com/rust-lang/rust/pull/45524
5211 [45571]: https://github.com/rust-lang/rust/pull/45571
5212 [45580]: https://github.com/rust-lang/rust/pull/45580
5213 [45610]: https://github.com/rust-lang/rust/pull/45610
5214 [45660]: https://github.com/rust-lang/rust/pull/45660
5215 [45692]: https://github.com/rust-lang/rust/pull/45692
5216 [45711]: https://github.com/rust-lang/rust/pull/45711
5217 [45772]: https://github.com/rust-lang/rust/pull/45772
5218 [45852]: https://github.com/rust-lang/rust/issues/45852
5219 [45853]: https://github.com/rust-lang/rust/pull/45853
5220 [45887]: https://github.com/rust-lang/rust/pull/45887
5221 [45920]: https://github.com/rust-lang/rust/pull/45920
5222 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
5223 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
5224 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
5225
5226
5227 Version 1.22.1 (2017-11-22)
5228 ==========================
5229
5230 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
5231
5232 [46183]: https://github.com/rust-lang/rust/pull/46183
5233
5234 Version 1.22.0 (2017-11-22)
5235 ==========================
5236
5237 Language
5238 --------
5239 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
5240 - [Now accepts underscores in unicode escapes][43716]
5241 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
5242 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
5243
5244 Compiler
5245 --------
5246 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
5247 - [rustc will no longer inline in codegen units when compiling for debug][45075]
5248   This should decrease compile times for debug builds.
5249 - [strict memory alignment now enabled on ARMv6][45094]
5250 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
5251
5252 Libraries
5253 ---------
5254 - [Allow atomic operations up to 32 bits
5255   on `armv5te_unknown_linux_gnueabi`][44978]
5256 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
5257 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
5258 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
5259 - [Properly detect overflow in `Instant += Duration`.][44220]
5260 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
5261 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
5262 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
5263
5264 Stabilized APIs
5265 ---------------
5266
5267 Cargo
5268 -----
5269 - [Cargo will now build multi file examples in subdirectories of the `examples`
5270   folder that have a `main.rs` file.][cargo/4496]
5271 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
5272   the old format will continue to work and can be updated with `cargo update`.
5273 - [Now supports vendoring git repositories][cargo/3992]
5274
5275 Misc
5276 ----
5277 - [`libbacktrace` is now available on Apple platforms.][44251]
5278 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
5279   This now lets you specify that a given code example will fail to compile.
5280
5281 Compatibility Notes
5282 -------------------
5283 - [The minimum Android version that rustc can build for has been bumped
5284   to `4.0` from `2.3`][45656]
5285 - [Allowing `T op= &T` for numeric types has broken some type
5286   inference cases][45480]
5287
5288
5289 [42526]: https://github.com/rust-lang/rust/pull/42526
5290 [43017]: https://github.com/rust-lang/rust/pull/43017
5291 [43716]: https://github.com/rust-lang/rust/pull/43716
5292 [43949]: https://github.com/rust-lang/rust/pull/43949
5293 [44015]: https://github.com/rust-lang/rust/pull/44015
5294 [44220]: https://github.com/rust-lang/rust/pull/44220
5295 [44251]: https://github.com/rust-lang/rust/pull/44251
5296 [44287]: https://github.com/rust-lang/rust/pull/44287
5297 [44303]: https://github.com/rust-lang/rust/pull/44303
5298 [44456]: https://github.com/rust-lang/rust/pull/44456
5299 [44466]: https://github.com/rust-lang/rust/pull/44466
5300 [44895]: https://github.com/rust-lang/rust/pull/44895
5301 [44966]: https://github.com/rust-lang/rust/pull/44966
5302 [44978]: https://github.com/rust-lang/rust/pull/44978
5303 [45041]: https://github.com/rust-lang/rust/pull/45041
5304 [45064]: https://github.com/rust-lang/rust/pull/45064
5305 [45075]: https://github.com/rust-lang/rust/pull/45075
5306 [45094]: https://github.com/rust-lang/rust/pull/45094
5307 [45095]: https://github.com/rust-lang/rust/pull/45095
5308 [45480]: https://github.com/rust-lang/rust/issues/45480
5309 [45656]: https://github.com/rust-lang/rust/pull/45656
5310 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
5311 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
5312 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
5313
5314
5315
5316
5317
5318
5319 Version 1.21.0 (2017-10-12)
5320 ==========================
5321
5322 Language
5323 --------
5324 - [You can now use static references for literals.][43838]
5325   Example:
5326   ```rust
5327   fn main() {
5328       let x: &'static u32 = &0;
5329   }
5330   ```
5331 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
5332   Example:
5333   ```rust
5334   my_macro!(Vec<i32>::new); // Always worked
5335   my_macro!(Vec::<i32>::new); // Now works
5336   ```
5337
5338 Compiler
5339 --------
5340 - [Upgraded jemalloc to 4.5.0][43911]
5341 - [Enabled unwinding panics on Redox][43917]
5342 - [Now runs LLVM in parallel during translation phase.][43506]
5343   This should reduce peak memory usage.
5344
5345 Libraries
5346 ---------
5347 - [Generate builtin impls for `Clone` for all arrays and tuples that
5348   are `T: Clone`][43690]
5349 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
5350 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
5351   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
5352
5353 Stabilized APIs
5354 ---------------
5355
5356 [`std::mem::discriminant`]
5357
5358 Cargo
5359 -----
5360 - [You can now call `cargo install` with multiple package names][cargo/4216]
5361 - [Cargo commands inside a virtual workspace will now implicitly
5362   pass `--all`][cargo/4335]
5363 - [Added a `[patch]` section to `Cargo.toml` to handle
5364   prepublication dependencies][cargo/4123] [RFC 1969]
5365 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
5366   like patterns][cargo/4270]
5367 - [Added the `--all-targets` option][cargo/4400]
5368 - [Using required dependencies as a feature is now deprecated and emits
5369   a warning][cargo/4364]
5370
5371
5372 Misc
5373 ----
5374 - [Cargo docs are moving][43916]
5375   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
5376 - [The rustdoc book is now available][43863]
5377   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
5378 - [Added a preview of RLS has been made available through rustup][44204]
5379   Install with `rustup component add rls-preview`
5380 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
5381   Previously only showed `std::os::unix`.
5382
5383 Compatibility Notes
5384 -------------------
5385 - [Changes in method matching against higher-ranked types][43880] This may cause
5386   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
5387 - [rustc's JSON error output's byte position start at top of file.][42973]
5388   Was previously relative to the rustc's internal `CodeMap` struct which
5389   required the unstable library `libsyntax` to correctly use.
5390 - [`unused_results` lint no longer ignores booleans][43728]
5391
5392 [42565]: https://github.com/rust-lang/rust/pull/42565
5393 [42973]: https://github.com/rust-lang/rust/pull/42973
5394 [43348]: https://github.com/rust-lang/rust/pull/43348
5395 [43459]: https://github.com/rust-lang/rust/pull/43459
5396 [43506]: https://github.com/rust-lang/rust/pull/43506
5397 [43540]: https://github.com/rust-lang/rust/pull/43540
5398 [43690]: https://github.com/rust-lang/rust/pull/43690
5399 [43728]: https://github.com/rust-lang/rust/pull/43728
5400 [43838]: https://github.com/rust-lang/rust/pull/43838
5401 [43863]: https://github.com/rust-lang/rust/pull/43863
5402 [43880]: https://github.com/rust-lang/rust/pull/43880
5403 [43911]: https://github.com/rust-lang/rust/pull/43911
5404 [43916]: https://github.com/rust-lang/rust/pull/43916
5405 [43917]: https://github.com/rust-lang/rust/pull/43917
5406 [44204]: https://github.com/rust-lang/rust/pull/44204
5407 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
5408 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
5409 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5410 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
5411 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
5412 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
5413 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
5414 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
5415 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
5416
5417 Version 1.20.0 (2017-08-31)
5418 ===========================
5419
5420 Language
5421 --------
5422 - [Associated constants are now stabilised.][42809]
5423 - [A lot of macro bugs are now fixed.][42913]
5424
5425 Compiler
5426 --------
5427
5428 - [Struct fields are now properly coerced to the expected field type.][42807]
5429 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
5430   `wasm32-experimental-emscripten` target.
5431 - [Changed some of the error messages to be more helpful.][42033]
5432 - [Add support for RELRO(RELocation Read-Only) for platforms that support
5433   it.][43170]
5434 - [rustc now reports the total number of errors on compilation failure][43015]
5435   previously this was only the number of errors in the pass that failed.
5436 - [Expansion in rustc has been sped up 29x.][42533]
5437 - [added `msp430-none-elf` target.][43099]
5438 - [rustc will now suggest one-argument enum variant to fix type mismatch when
5439   applicable][43178]
5440 - [Fixes backtraces on Redox][43228]
5441 - [rustc now identifies different versions of same crate when absolute paths of
5442   different types match in an error message.][42826]
5443
5444 Libraries
5445 ---------
5446
5447
5448 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
5449 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
5450   tuples.][43011]
5451 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
5452   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
5453 - [Impl `Clone` for `DefaultHasher`.][42799]
5454 - [Impl `Sync` for `SyncSender`.][42397]
5455 - [Impl `FromStr` for `char`][42271]
5456 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
5457   NaN.][42431]
5458 - [allow messages in the `unimplemented!()` macro.][42155]
5459   ie. `unimplemented!("Waiting for 1.21 to be stable")`
5460 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
5461 - [Upgrade to Unicode 10.0.0][42999]
5462 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
5463 - [Skip the main thread's manual stack guard on Linux][43072]
5464 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in *O*(1) time][43077]
5465 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
5466   previously 2^15.
5467 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
5468
5469 Stabilized APIs
5470 ---------------
5471
5472 - [`CStr::into_c_string`]
5473 - [`CString::as_c_str`]
5474 - [`CString::into_boxed_c_str`]
5475 - [`Chain::get_mut`]
5476 - [`Chain::get_ref`]
5477 - [`Chain::into_inner`]
5478 - [`Option::get_or_insert_with`]
5479 - [`Option::get_or_insert`]
5480 - [`OsStr::into_os_string`]
5481 - [`OsString::into_boxed_os_str`]
5482 - [`Take::get_mut`]
5483 - [`Take::get_ref`]
5484 - [`Utf8Error::error_len`]
5485 - [`char::EscapeDebug`]
5486 - [`char::escape_debug`]
5487 - [`compile_error!`]
5488 - [`f32::from_bits`]
5489 - [`f32::to_bits`]
5490 - [`f64::from_bits`]
5491 - [`f64::to_bits`]
5492 - [`mem::ManuallyDrop`]
5493 - [`slice::sort_unstable_by_key`]
5494 - [`slice::sort_unstable_by`]
5495 - [`slice::sort_unstable`]
5496 - [`str::from_boxed_utf8_unchecked`]
5497 - [`str::as_bytes_mut`]
5498 - [`str::as_bytes_mut`]
5499 - [`str::from_utf8_mut`]
5500 - [`str::from_utf8_unchecked_mut`]
5501 - [`str::get_mut`]
5502 - [`str::get_unchecked_mut`]
5503 - [`str::get_unchecked`]
5504 - [`str::get`]
5505 - [`str::into_boxed_bytes`]
5506
5507
5508 Cargo
5509 -----
5510 - [Cargo API token location moved from `~/.cargo/config` to
5511   `~/.cargo/credentials`.][cargo/3978]
5512 - [Cargo will now build `main.rs` binaries that are in sub-directories of
5513   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
5514   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
5515 - [You can now specify version of a binary when installed through
5516   `cargo install` using `--vers`.][cargo/4229]
5517 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
5518   failure.][cargo/4248]
5519 - [Changed the convention around which file is the crate root.][cargo/4259]
5520 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
5521   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
5522
5523 Compatibility Notes
5524 -------------------
5525
5526 - [Functions with `'static` in their return types will now not be as usable as
5527   if they were using lifetime parameters instead.][42417]
5528 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
5529   takes the sign of NaN into account where previously didn't.][42430]
5530
5531 [42033]: https://github.com/rust-lang/rust/pull/42033
5532 [42155]: https://github.com/rust-lang/rust/pull/42155
5533 [42271]: https://github.com/rust-lang/rust/pull/42271
5534 [42397]: https://github.com/rust-lang/rust/pull/42397
5535 [42417]: https://github.com/rust-lang/rust/pull/42417
5536 [42430]: https://github.com/rust-lang/rust/pull/42430
5537 [42431]: https://github.com/rust-lang/rust/pull/42431
5538 [42533]: https://github.com/rust-lang/rust/pull/42533
5539 [42571]: https://github.com/rust-lang/rust/pull/42571
5540 [42613]: https://github.com/rust-lang/rust/pull/42613
5541 [42799]: https://github.com/rust-lang/rust/pull/42799
5542 [42807]: https://github.com/rust-lang/rust/pull/42807
5543 [42809]: https://github.com/rust-lang/rust/pull/42809
5544 [42822]: https://github.com/rust-lang/rust/pull/42822
5545 [42826]: https://github.com/rust-lang/rust/pull/42826
5546 [42854]: https://github.com/rust-lang/rust/pull/42854
5547 [42913]: https://github.com/rust-lang/rust/pull/42913
5548 [42999]: https://github.com/rust-lang/rust/pull/42999
5549 [43011]: https://github.com/rust-lang/rust/pull/43011
5550 [43015]: https://github.com/rust-lang/rust/pull/43015
5551 [43072]: https://github.com/rust-lang/rust/pull/43072
5552 [43077]: https://github.com/rust-lang/rust/pull/43077
5553 [43097]: https://github.com/rust-lang/rust/pull/43097
5554 [43099]: https://github.com/rust-lang/rust/pull/43099
5555 [43170]: https://github.com/rust-lang/rust/pull/43170
5556 [43178]: https://github.com/rust-lang/rust/pull/43178
5557 [43185]: https://github.com/rust-lang/rust/pull/43185
5558 [43228]: https://github.com/rust-lang/rust/pull/43228
5559 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
5560 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
5561 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
5562 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
5563 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
5564 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5565 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
5566 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
5567 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
5568 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
5569 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
5570 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
5571 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
5572 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
5573 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
5574 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
5575 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
5576 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
5577 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
5578 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
5579 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
5580 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
5581 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
5582 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
5583 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
5584 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
5585 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
5586 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
5587 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
5588 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
5589 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
5590 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
5591 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
5592 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
5593 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
5594 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
5595 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
5596 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
5597 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
5598
5599
5600 Version 1.19.0 (2017-07-20)
5601 ===========================
5602
5603 Language
5604 --------
5605
5606 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
5607   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
5608 - [Macro recursion limit increased to 1024 from 64.][41676]
5609 - [Added lint for detecting unused macros.][41907]
5610 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
5611   For example: `let x = loop { break 7; };`
5612 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
5613   contain `Copy` types and cannot have a `Drop` implementation.
5614   Example: `union Foo { bar: u8, baz: usize }`
5615 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
5616   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
5617
5618 Compiler
5619 --------
5620
5621 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
5622 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
5623   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
5624   you should use `--target armv7-linux-androideabi`.
5625 - [Fixed ICE when removing a source file between compilation sessions.][41873]
5626 - [Minor optimisation of string operations.][42037]
5627 - [Compiler error message is now `aborting due to previous error(s)` instead of
5628   `aborting due to N previous errors`][42150] This was previously inaccurate and
5629   would only count certain kinds of errors.
5630 - [The compiler now supports Visual Studio 2017][42225]
5631 - [The compiler is now built against LLVM 4.0.1 by default][42948]
5632 - [Added a lot][42264] of [new error codes][42302]
5633 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
5634   libraries with C Run-time Libraries(CRT) to be statically linked.
5635 - [Fixed various ARM codegen bugs][42740]
5636
5637 Libraries
5638 ---------
5639
5640 - [`String` now implements `FromIterator<Cow<'a, str>>` and
5641   `Extend<Cow<'a, str>>`][41449]
5642 - [`Vec` now implements `From<&mut [T]>`][41530]
5643 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
5644 - [`SplitWhitespace` now implements `Clone`][41659]
5645 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
5646   1.5x faster][41764]
5647 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
5648   macros, but for printing to stderr.
5649
5650 Stabilized APIs
5651 ---------------
5652
5653 - [`OsString::shrink_to_fit`]
5654 - [`cmp::Reverse`]
5655 - [`Command::envs`]
5656 - [`thread::ThreadId`]
5657
5658 Cargo
5659 -----
5660
5661 - [Build scripts can now add environment variables to the environment
5662   the crate is being compiled in.
5663   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
5664 - [Subcommands now replace the current process rather than spawning a new
5665   child process][cargo/3970]
5666 - [Workspace members can now accept glob file patterns][cargo/3979]
5667 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
5668   the members in a given workspace.][cargo/3988]
5669 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
5670 - [Target directory path is now in the cargo metadata][cargo/4022]
5671 - [Cargo no longer checks out a local working directory for the
5672   crates.io index][cargo/4026] This should provide smaller file size for the
5673   registry, and improve cloning times, especially on Windows machines.
5674 - [Added an `--exclude` option for excluding certain packages when using the
5675   `--all` option][cargo/4031]
5676 - [Cargo will now automatically retry when receiving a 5xx error
5677   from crates.io][cargo/4032]
5678 - [The `--features` option now accepts multiple comma or space
5679   delimited values.][cargo/4084]
5680 - [Added support for custom target specific runners][cargo/3954]
5681
5682 Misc
5683 ----
5684
5685 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
5686   Windows Debugger.
5687 - [Rust will now release XZ compressed packages][rust-installer/57]
5688 - [rustup will now prefer to download rust packages with
5689   XZ compression][rustup/1100] over GZip packages.
5690 - [Added the ability to escape `#` in rust documentation][41785] By adding
5691   additional `#`'s ie. `##` is now `#`
5692
5693 Compatibility Notes
5694 -------------------
5695
5696 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
5697 - [`-Z` flags are now no longer allowed to be used on the stable
5698   compiler.][41751] This has been a warning for a year previous to this.
5699 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
5700   longer works][42844]. Users should migrate to the built-in `check`
5701   command, which has been available since 1.16.
5702 - [Ending a float literal with `._` is now a hard error.
5703   Example: `42._` .][41946]
5704 - [Any use of a private `extern crate` outside of its module is now a
5705   hard error.][36886] This was previously a warning.
5706 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
5707   relative while the `::` prefix makes a path absolute, but was ignored and the
5708   path was relative regardless.
5709 - [Floating point constants in match patterns is now a hard error][36890]
5710   This was previously a warning.
5711 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
5712   match patterns is now a hard error][36891] This was previously a warning.
5713 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
5714   a warning.
5715 - [From the pound escape, lines consisting of multiple `#`s are
5716   now visible][41785]
5717 - [It is an error to re-export private enum variants][42460]. This is
5718   known to break a number of crates that depend on an older version of
5719   mustache.
5720 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
5721   to use it to find the linker, and the build will fail where it did
5722   not previously][42607]
5723
5724 [36886]: https://github.com/rust-lang/rust/issues/36886
5725 [36888]: https://github.com/rust-lang/rust/issues/36888
5726 [36890]: https://github.com/rust-lang/rust/issues/36890
5727 [36891]: https://github.com/rust-lang/rust/issues/36891
5728 [36892]: https://github.com/rust-lang/rust/issues/36892
5729 [37406]: https://github.com/rust-lang/rust/issues/37406
5730 [39983]: https://github.com/rust-lang/rust/pull/39983
5731 [41145]: https://github.com/rust-lang/rust/pull/41145
5732 [41192]: https://github.com/rust-lang/rust/pull/41192
5733 [41258]: https://github.com/rust-lang/rust/pull/41258
5734 [41370]: https://github.com/rust-lang/rust/pull/41370
5735 [41449]: https://github.com/rust-lang/rust/pull/41449
5736 [41530]: https://github.com/rust-lang/rust/pull/41530
5737 [41624]: https://github.com/rust-lang/rust/pull/41624
5738 [41656]: https://github.com/rust-lang/rust/pull/41656
5739 [41659]: https://github.com/rust-lang/rust/pull/41659
5740 [41676]: https://github.com/rust-lang/rust/pull/41676
5741 [41751]: https://github.com/rust-lang/rust/pull/41751
5742 [41764]: https://github.com/rust-lang/rust/pull/41764
5743 [41785]: https://github.com/rust-lang/rust/pull/41785
5744 [41873]: https://github.com/rust-lang/rust/pull/41873
5745 [41907]: https://github.com/rust-lang/rust/pull/41907
5746 [41946]: https://github.com/rust-lang/rust/pull/41946
5747 [42016]: https://github.com/rust-lang/rust/pull/42016
5748 [42037]: https://github.com/rust-lang/rust/pull/42037
5749 [42068]: https://github.com/rust-lang/rust/pull/42068
5750 [42150]: https://github.com/rust-lang/rust/pull/42150
5751 [42162]: https://github.com/rust-lang/rust/pull/42162
5752 [42225]: https://github.com/rust-lang/rust/pull/42225
5753 [42264]: https://github.com/rust-lang/rust/pull/42264
5754 [42302]: https://github.com/rust-lang/rust/pull/42302
5755 [42460]: https://github.com/rust-lang/rust/issues/42460
5756 [42607]: https://github.com/rust-lang/rust/issues/42607
5757 [42740]: https://github.com/rust-lang/rust/pull/42740
5758 [42844]: https://github.com/rust-lang/rust/issues/42844
5759 [42948]: https://github.com/rust-lang/rust/pull/42948
5760 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
5761 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
5762 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
5763 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
5764 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
5765 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
5766 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
5767 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
5768 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
5769 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
5770 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
5771 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
5772 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
5773 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
5774 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
5775 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
5776 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
5777 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
5778 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
5779 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
5780 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
5781 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
5782
5783
5784 Version 1.18.0 (2017-06-08)
5785 ===========================
5786
5787 Language
5788 --------
5789
5790 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
5791   make the item visible to just that module tree. Also accepts the keyword
5792   `crate` to make something public to the whole crate but not users of the
5793   library. Example: `pub(crate) mod utils;`. [RFC 1422].
5794 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
5795   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
5796 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
5797   types like `Write + Send`, trailing `+` are now supported in trait objects,
5798   and better error reporting for trait objects starting with `?Sized`.
5799 - [0e+10 is now a valid floating point literal][40589]
5800 - [Now warns if you bind a lifetime parameter to 'static][40734]
5801 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
5802   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
5803   representation in some cases.][40377]
5804
5805 Compiler
5806 --------
5807
5808 - [rustc can now emit mir with `--emit mir`][39891]
5809 - [Improved LLVM IR for trivial functions][40367]
5810 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
5811 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
5812   opportunities found through profiling
5813 - [Improved backtrace formatting when panicking][38165]
5814
5815 Libraries
5816 ---------
5817
5818 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
5819   iterator hasn't been advanced the original `Vec` is reassembled with no actual
5820   iteration or reallocation.
5821 - [Simplified HashMap Bucket interface][40561] provides performance
5822   improvements for iterating and cloning.
5823 - [Specialize Vec::from_elem to use calloc][40409]
5824 - [Fixed Race condition in fs::create_dir_all][39799]
5825 - [No longer caching stdio on Windows][40516]
5826 - [Optimized insertion sort in slice][40807] insertion sort in some cases
5827   2.50%~ faster and in one case now 12.50% faster.
5828 - [Optimized `AtomicBool::fetch_nand`][41143]
5829
5830 Stabilized APIs
5831 ---------------
5832
5833 - [`Child::try_wait`]
5834 - [`HashMap::retain`]
5835 - [`HashSet::retain`]
5836 - [`PeekMut::pop`]
5837 - [`TcpStream::peek`]
5838 - [`UdpSocket::peek`]
5839 - [`UdpSocket::peek_from`]
5840
5841 Cargo
5842 -----
5843
5844 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
5845   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
5846 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
5847 - [Added Android build support][cargo/3885]
5848 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
5849   of a certain type, for example `cargo build --bins` will build all
5850   binaries.
5851 - [Added support for haiku][cargo/3952]
5852
5853 Misc
5854 ----
5855
5856 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
5857 - [Added rust-windbg script for better debugging on Windows][39983]
5858 - [Rust now uses the official cross compiler for NetBSD][40612]
5859 - [rustdoc now accepts `#` at the start of files][40828]
5860 - [Fixed jemalloc support for musl][41168]
5861
5862 Compatibility Notes
5863 -------------------
5864
5865 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
5866   always placed after the sign if it exists and before the digits. With the `#`
5867   flag the zeroes are placed after the prefix and before the digits.
5868 - [Due to the struct field optimisation][40377], using `transmute` on structs
5869   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
5870   always been undefined behavior, but is now more likely to break in practice.
5871 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
5872   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
5873   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
5874 - [Overlapping inherent `impl`s are now a hard error][40728]
5875 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
5876 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
5877   `out.asm` and `out.ll` instead of only one of the filetypes.
5878 - [ calling a function that returns `Self` will no longer work][41805] when
5879   the size of `Self` cannot be statically determined.
5880 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
5881   this has caused a few regressions namely:
5882
5883   - Changed the link order of local static/dynamic libraries (respecting the
5884     order on given rather than having the compiler reorder).
5885   - Changed how MinGW is linked, native code linked to dynamic libraries
5886     may require manually linking to the gcc support library (for the native
5887     code itself)
5888
5889 [38165]: https://github.com/rust-lang/rust/pull/38165
5890 [39799]: https://github.com/rust-lang/rust/pull/39799
5891 [39891]: https://github.com/rust-lang/rust/pull/39891
5892 [39983]: https://github.com/rust-lang/rust/pull/39983
5893 [40043]: https://github.com/rust-lang/rust/pull/40043
5894 [40241]: https://github.com/rust-lang/rust/pull/40241
5895 [40338]: https://github.com/rust-lang/rust/pull/40338
5896 [40367]: https://github.com/rust-lang/rust/pull/40367
5897 [40377]: https://github.com/rust-lang/rust/pull/40377
5898 [40409]: https://github.com/rust-lang/rust/pull/40409
5899 [40516]: https://github.com/rust-lang/rust/pull/40516
5900 [40556]: https://github.com/rust-lang/rust/pull/40556
5901 [40561]: https://github.com/rust-lang/rust/pull/40561
5902 [40589]: https://github.com/rust-lang/rust/pull/40589
5903 [40612]: https://github.com/rust-lang/rust/pull/40612
5904 [40723]: https://github.com/rust-lang/rust/pull/40723
5905 [40728]: https://github.com/rust-lang/rust/pull/40728
5906 [40731]: https://github.com/rust-lang/rust/pull/40731
5907 [40734]: https://github.com/rust-lang/rust/pull/40734
5908 [40805]: https://github.com/rust-lang/rust/pull/40805
5909 [40807]: https://github.com/rust-lang/rust/pull/40807
5910 [40828]: https://github.com/rust-lang/rust/pull/40828
5911 [40870]: https://github.com/rust-lang/rust/pull/40870
5912 [41085]: https://github.com/rust-lang/rust/pull/41085
5913 [41143]: https://github.com/rust-lang/rust/pull/41143
5914 [41168]: https://github.com/rust-lang/rust/pull/41168
5915 [41270]: https://github.com/rust-lang/rust/issues/41270
5916 [41469]: https://github.com/rust-lang/rust/pull/41469
5917 [41805]: https://github.com/rust-lang/rust/issues/41805
5918 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
5919 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
5920 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
5921 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
5922 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
5923 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
5924 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
5925 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
5926 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
5927 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
5928 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
5929 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
5930 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
5931 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
5932
5933
5934 Version 1.17.0 (2017-04-27)
5935 ===========================
5936
5937 Language
5938 --------
5939
5940 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
5941 * [Fields of structs may be initialized without duplicating the field/variable
5942   names][39761]. [RFC 1682]
5943 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
5944 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5945   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
5946   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
5947   `'b`. Soundness fix.
5948 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
5949 * [Static variables may contain references to other statics][40027]
5950
5951 Compiler
5952 --------
5953
5954 * [Exit quickly on only `--emit dep-info`][40336]
5955 * [Make `-C relocation-model` more correctly determine whether the linker
5956   creates a position-independent executable][40245]
5957 * [Add `-C overflow-checks` to directly control whether integer overflow
5958   panics][40037]
5959 * [The rustc type checker now checks items on demand instead of in a single
5960   in-order pass][40008]. This is mostly an internal refactoring in support of
5961   future work, including incremental type checking, but also resolves [RFC
5962   1647], allowing `Self` to appear in `impl` `where` clauses.
5963 * [Optimize vtable loads][39995]
5964 * [Turn off vectorization for Emscripten targets][39990]
5965 * [Provide suggestions for unknown macros imported with `use`][39953]
5966 * [Fix ICEs in path resolution][39939]
5967 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
5968 * [Add clearer error message using `&str + &str`][39116]
5969
5970 Stabilized APIs
5971 ---------------
5972
5973 * [`Arc::into_raw`]
5974 * [`Arc::from_raw`]
5975 * [`Arc::ptr_eq`]
5976 * [`Rc::into_raw`]
5977 * [`Rc::from_raw`]
5978 * [`Rc::ptr_eq`]
5979 * [`Ordering::then`]
5980 * [`Ordering::then_with`]
5981 * [`BTreeMap::range`]
5982 * [`BTreeMap::range_mut`]
5983 * [`collections::Bound`]
5984 * [`process::abort`]
5985 * [`ptr::read_unaligned`]
5986 * [`ptr::write_unaligned`]
5987 * [`Result::expect_err`]
5988 * [`Cell::swap`]
5989 * [`Cell::replace`]
5990 * [`Cell::into_inner`]
5991 * [`Cell::take`]
5992
5993 Libraries
5994 ---------
5995
5996 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
5997 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
5998 * [`String` implements `FromIterator<&char>`][40028]
5999 * `Box` [implements][40009] a number of new conversions:
6000   `From<Box<str>> for String`,
6001   `From<Box<[T]>> for Vec<T>`,
6002   `From<Box<CStr>> for CString`,
6003   `From<Box<OsStr>> for OsString`,
6004   `From<Box<Path>> for PathBuf`,
6005   `Into<Box<str>> for String`,
6006   `Into<Box<[T]>> for Vec<T>`,
6007   `Into<Box<CStr>> for CString`,
6008   `Into<Box<OsStr>> for OsString`,
6009   `Into<Box<Path>> for PathBuf`,
6010   `Default for Box<str>`,
6011   `Default for Box<CStr>`,
6012   `Default for Box<OsStr>`,
6013   `From<&CStr> for Box<CStr>`,
6014   `From<&OsStr> for Box<OsStr>`,
6015   `From<&Path> for Box<Path>`
6016 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
6017 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
6018 * [Slightly optimize `slice::sort`][39538]
6019 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
6020 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
6021   `Box<str>` implements `From<&str>`][39438]
6022 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
6023   `From<(I, u16)> where I: Into<IpAddr>`][39372]
6024 * [`format!` estimates the needed capacity before writing a string][39356]
6025 * [Support unprivileged symlink creation in Windows][38921]
6026 * [`PathBuf` implements `Default`][38764]
6027 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
6028 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
6029   and poor hash functions.
6030
6031 Cargo
6032 -----
6033
6034 * [Add `cargo check --all`][cargo/3731]
6035 * [Add an option to ignore SSL revocation checking][cargo/3699]
6036 * [Add `cargo run --package`][cargo/3691]
6037 * [Add `required_features`][cargo/3667]
6038 * [Assume `build.rs` is a build script][cargo/3664]
6039 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
6040
6041 Misc
6042 ----
6043
6044 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
6045   `rustbook`][39633]
6046 * [The "Unstable Book" documents nightly-only features][ubook]
6047 * [Improve the style of the sidebar in rustdoc output][40265]
6048 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
6049 * [Fix MSP430 breakage due to `i128`][40257]
6050 * [Preliminary Solaris/SPARCv9 support][39903]
6051 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
6052   run without installing the MSVC runtime.
6053 * [`rustdoc --test` includes file names in test names][39788]
6054 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
6055   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
6056 * [Initial support for `aarch64-unknown-freebsd`][39491]
6057 * [Initial support for `i686-unknown-netbsd`][39426]
6058 * [This release no longer includes the old makefile build system][39431]. Rust
6059   is built with a custom build system, written in Rust, and with Cargo.
6060 * [Add Debug implementations for libcollection structs][39002]
6061 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
6062 * [`--test-threads=0` produces an error][38945]
6063 * [`rustup` installs documentation by default][40526]
6064 * [The Rust source includes NatVis visualizations][39843]. These can be used by
6065   WinDbg and Visual Studio to improve the debugging experience.
6066
6067 Compatibility Notes
6068 -------------------
6069
6070 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
6071   workaround, either use MSVC 2015 or run vcvars.bat.
6072 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
6073   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
6074   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
6075   fix.
6076 * [`format!` and `Display::to_string` panic if an underlying formatting
6077   implementation returns an error][40117]. Previously the error was silently
6078   ignored. It is incorrect for `write_fmt` to return an error when writing
6079   to a string.
6080 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
6081   crates were marked stable and could be accessed from the stable toolchain.
6082 * [Rust git source no longer includes vendored crates][39728]. Those that need
6083   to build with vendored crates should build from release tarballs.
6084 * [Fix inert attributes from `proc_macro_derives`][39572]
6085 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
6086   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
6087   build system.
6088 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
6089   existing code generally ignores the type of dead-code unless a type-hint is
6090   provided; this can cause surprising inference interactions particularly around
6091   defaulting. The new code uniformly ignores the result type of dead-code.
6092 * [Tuple-struct constructors with private fields are no longer visible][38932]
6093 * [Lifetime parameters that do not appear in the arguments are now considered
6094   early-bound][38897], resolving a soundness bug (#[32330]). The
6095   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
6096   April of 2016.
6097 * [rustdoc: fix doctests with non-feature crate attributes][38161]
6098 * [Make transmuting from fn item types to pointer-sized types a hard
6099   error][34198]
6100
6101 [27787]: https://github.com/rust-lang/rust/issues/27787
6102 [32330]: https://github.com/rust-lang/rust/issues/32330
6103 [34198]: https://github.com/rust-lang/rust/pull/34198
6104 [38161]: https://github.com/rust-lang/rust/pull/38161
6105 [38368]: https://github.com/rust-lang/rust/pull/38368
6106 [38584]: https://github.com/rust-lang/rust/issues/38584
6107 [38661]: https://github.com/rust-lang/rust/pull/38661
6108 [38764]: https://github.com/rust-lang/rust/pull/38764
6109 [38864]: https://github.com/rust-lang/rust/issues/38864
6110 [38897]: https://github.com/rust-lang/rust/pull/38897
6111 [38921]: https://github.com/rust-lang/rust/pull/38921
6112 [38932]: https://github.com/rust-lang/rust/pull/38932
6113 [38945]: https://github.com/rust-lang/rust/pull/38945
6114 [38981]: https://github.com/rust-lang/rust/pull/38981
6115 [39002]: https://github.com/rust-lang/rust/pull/39002
6116 [39116]: https://github.com/rust-lang/rust/pull/39116
6117 [39193]: https://github.com/rust-lang/rust/pull/39193
6118 [39265]: https://github.com/rust-lang/rust/pull/39265
6119 [39356]: https://github.com/rust-lang/rust/pull/39356
6120 [39372]: https://github.com/rust-lang/rust/pull/39372
6121 [39426]: https://github.com/rust-lang/rust/pull/39426
6122 [39431]: https://github.com/rust-lang/rust/pull/39431
6123 [39438]: https://github.com/rust-lang/rust/pull/39438
6124 [39440]: https://github.com/rust-lang/rust/pull/39440
6125 [39485]: https://github.com/rust-lang/rust/pull/39485
6126 [39491]: https://github.com/rust-lang/rust/pull/39491
6127 [39518]: https://github.com/rust-lang/rust/pull/39518
6128 [39538]: https://github.com/rust-lang/rust/pull/39538
6129 [39572]: https://github.com/rust-lang/rust/pull/39572
6130 [39633]: https://github.com/rust-lang/rust/pull/39633
6131 [39642]: https://github.com/rust-lang/rust/pull/39642
6132 [39728]: https://github.com/rust-lang/rust/pull/39728
6133 [39761]: https://github.com/rust-lang/rust/pull/39761
6134 [39788]: https://github.com/rust-lang/rust/pull/39788
6135 [39793]: https://github.com/rust-lang/rust/pull/39793
6136 [39837]: https://github.com/rust-lang/rust/pull/39837
6137 [39843]: https://github.com/rust-lang/rust/pull/39843
6138 [39851]: https://github.com/rust-lang/rust/pull/39851
6139 [39903]: https://github.com/rust-lang/rust/pull/39903
6140 [39939]: https://github.com/rust-lang/rust/pull/39939
6141 [39953]: https://github.com/rust-lang/rust/pull/39953
6142 [39960]: https://github.com/rust-lang/rust/pull/39960
6143 [39990]: https://github.com/rust-lang/rust/pull/39990
6144 [39995]: https://github.com/rust-lang/rust/pull/39995
6145 [40008]: https://github.com/rust-lang/rust/pull/40008
6146 [40009]: https://github.com/rust-lang/rust/pull/40009
6147 [40027]: https://github.com/rust-lang/rust/pull/40027
6148 [40028]: https://github.com/rust-lang/rust/pull/40028
6149 [40037]: https://github.com/rust-lang/rust/pull/40037
6150 [40117]: https://github.com/rust-lang/rust/pull/40117
6151 [40166]: https://github.com/rust-lang/rust/pull/40166
6152 [40245]: https://github.com/rust-lang/rust/pull/40245
6153 [40257]: https://github.com/rust-lang/rust/pull/40257
6154 [40261]: https://github.com/rust-lang/rust/pull/40261
6155 [40265]: https://github.com/rust-lang/rust/pull/40265
6156 [40319]: https://github.com/rust-lang/rust/pull/40319
6157 [40336]: https://github.com/rust-lang/rust/pull/40336
6158 [40526]: https://github.com/rust-lang/rust/pull/40526
6159 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
6160 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
6161 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
6162 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
6163 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
6164 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
6165 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
6166 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
6167 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
6168 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
6169 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
6170 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
6171 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
6172 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
6173 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
6174 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
6175 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
6176 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
6177 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
6178 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
6179 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
6180 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
6181 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
6182 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
6183 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
6184 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
6185 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
6186 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
6187 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
6188 [mdbook]: https://crates.io/crates/mdbook
6189 [ubook]: https://doc.rust-lang.org/unstable-book/
6190
6191
6192 Version 1.16.0 (2017-03-16)
6193 ===========================
6194
6195 Language
6196 --------
6197
6198 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6199 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6200   match patterns][38069]
6201 * [Clean up semantics of `self` in an import list][38313]
6202 * [`Self` may appear in `impl` headers][38920]
6203 * [`Self` may appear in struct expressions][39282]
6204
6205 Compiler
6206 --------
6207
6208 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
6209   a `.rmeta` file containing only crate metadata][38571]. This can be
6210   used by tools like the Rust Language Service to perform
6211   metadata-only builds.
6212 * [Levenshtein based typo suggestions now work in most places, while
6213   previously they worked only for fields and sometimes for local
6214   variables][38927]. Together with the overhaul of "no
6215   resolution"/"unexpected resolution" errors (#[38154]) they result in
6216   large and systematic improvement in resolution diagnostics.
6217 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
6218   `U`][38670]
6219 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
6220 * [`rustc` no longer attempts to provide "consider using an explicit
6221   lifetime" suggestions][37057]. They were inaccurate.
6222
6223 Stabilized APIs
6224 ---------------
6225
6226 * [`VecDeque::truncate`]
6227 * [`VecDeque::resize`]
6228 * [`String::insert_str`]
6229 * [`Duration::checked_add`]
6230 * [`Duration::checked_sub`]
6231 * [`Duration::checked_div`]
6232 * [`Duration::checked_mul`]
6233 * [`str::replacen`]
6234 * [`str::repeat`]
6235 * [`SocketAddr::is_ipv4`]
6236 * [`SocketAddr::is_ipv6`]
6237 * [`IpAddr::is_ipv4`]
6238 * [`IpAddr::is_ipv6`]
6239 * [`Vec::dedup_by`]
6240 * [`Vec::dedup_by_key`]
6241 * [`Result::unwrap_or_default`]
6242 * [`<*const T>::wrapping_offset`]
6243 * [`<*mut T>::wrapping_offset`]
6244 * `CommandExt::creation_flags`
6245 * [`File::set_permissions`]
6246 * [`String::split_off`]
6247
6248 Libraries
6249 ---------
6250
6251 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
6252   their argument by `Borrow` parameter][37761]
6253 * [All public types in std implement `Debug`][38006]
6254 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
6255 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
6256 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6257   Windows][38274]
6258 * [std: Fix partial writes in `LineWriter`][38062]
6259 * [std: Clamp max read/write sizes on Unix][38062]
6260 * [Use more specific panic message for `&str` slicing errors][38066]
6261 * [`TcpListener::set_only_v6` is deprecated][38304]. This
6262   functionality cannot be achieved in std currently.
6263 * [`writeln!`, like `println!`, now accepts a form with no string
6264   or formatting arguments, to just print a newline][38469]
6265 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
6266 * [Reduce the size of static data in `std_unicode::tables`][38781]
6267 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
6268   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
6269   `Display`][38909]
6270 * [`Duration` implements `Sum`][38712]
6271 * [`String` implements `ToSocketAddrs`][39048]
6272
6273 Cargo
6274 -----
6275
6276 * [The `cargo check` command does a type check of a project without
6277   building it][cargo/3296]
6278 * [crates.io will display CI badges from Travis and AppVeyor, if
6279   specified in Cargo.toml][cargo/3546]
6280 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
6281 * [Compilation profiles accept integer values for `debug`, in addition
6282   to `true` and `false`. These are passed to `rustc` as the value to
6283   `-C debuginfo`][cargo/3534]
6284 * [Implement `cargo --version --verbose`][cargo/3604]
6285 * [All builds now output 'dep-info' build dependencies compatible with
6286   make and ninja][cargo/3557]
6287 * [Build all workspace members with `build --all`][cargo/3511]
6288 * [Document all workspace members with `doc --all`][cargo/3515]
6289 * [Path deps outside workspace are not members][cargo/3443]
6290
6291 Misc
6292 ----
6293
6294 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
6295   the path to the Rust implementation][38589]
6296 * [The `armv7-linux-androideabi` target no longer enables NEON
6297   extensions, per Google's ABI guide][38413]
6298 * [The stock standard library can be compiled for Redox OS][38401]
6299 * [Rust has initial SPARC support][38726]. Tier 3. No builds
6300   available.
6301 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
6302   builds available.
6303 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
6304
6305 Compatibility Notes
6306 -------------------
6307
6308 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6309   match patterns][38069]
6310 * In this release, references to uninhabited types can not be
6311   pattern-matched. This was accidentally allowed in 1.15.
6312 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6313 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6314   Windows][38274]
6315 * [Clean up semantics of `self` in an import list][38313]
6316 * Reimplemented lifetime elision. This change was almost entirely compatible
6317   with existing code, but it did close a number of small bugs and loopholes,
6318   as well as being more accepting in some other [cases][41105].
6319
6320 [37057]: https://github.com/rust-lang/rust/pull/37057
6321 [37761]: https://github.com/rust-lang/rust/pull/37761
6322 [38006]: https://github.com/rust-lang/rust/pull/38006
6323 [38051]: https://github.com/rust-lang/rust/pull/38051
6324 [38062]: https://github.com/rust-lang/rust/pull/38062
6325 [38062]: https://github.com/rust-lang/rust/pull/38622
6326 [38066]: https://github.com/rust-lang/rust/pull/38066
6327 [38069]: https://github.com/rust-lang/rust/pull/38069
6328 [38131]: https://github.com/rust-lang/rust/pull/38131
6329 [38154]: https://github.com/rust-lang/rust/pull/38154
6330 [38274]: https://github.com/rust-lang/rust/pull/38274
6331 [38304]: https://github.com/rust-lang/rust/pull/38304
6332 [38313]: https://github.com/rust-lang/rust/pull/38313
6333 [38314]: https://github.com/rust-lang/rust/pull/38314
6334 [38327]: https://github.com/rust-lang/rust/pull/38327
6335 [38401]: https://github.com/rust-lang/rust/pull/38401
6336 [38413]: https://github.com/rust-lang/rust/pull/38413
6337 [38469]: https://github.com/rust-lang/rust/pull/38469
6338 [38559]: https://github.com/rust-lang/rust/pull/38559
6339 [38571]: https://github.com/rust-lang/rust/pull/38571
6340 [38580]: https://github.com/rust-lang/rust/pull/38580
6341 [38589]: https://github.com/rust-lang/rust/pull/38589
6342 [38670]: https://github.com/rust-lang/rust/pull/38670
6343 [38712]: https://github.com/rust-lang/rust/pull/38712
6344 [38726]: https://github.com/rust-lang/rust/pull/38726
6345 [38781]: https://github.com/rust-lang/rust/pull/38781
6346 [38798]: https://github.com/rust-lang/rust/pull/38798
6347 [38909]: https://github.com/rust-lang/rust/pull/38909
6348 [38920]: https://github.com/rust-lang/rust/pull/38920
6349 [38927]: https://github.com/rust-lang/rust/pull/38927
6350 [39048]: https://github.com/rust-lang/rust/pull/39048
6351 [39282]: https://github.com/rust-lang/rust/pull/39282
6352 [39379]: https://github.com/rust-lang/rust/pull/39379
6353 [41105]: https://github.com/rust-lang/rust/issues/41105
6354 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6355 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6356 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
6357 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
6358 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
6359 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
6360 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
6361 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
6362 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
6363 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
6364 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
6365 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
6366 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
6367 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
6368 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
6369 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
6370 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
6371 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
6372 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
6373 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
6374 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
6375 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
6376 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
6377 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
6378 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
6379 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
6380 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
6381 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
6382 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
6383 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
6384
6385
6386 Version 1.15.1 (2017-02-09)
6387 ===========================
6388
6389 * [Fix IntoIter::as_mut_slice's signature][39466]
6390 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
6391
6392 [39466]: https://github.com/rust-lang/rust/pull/39466
6393 [39523]: https://github.com/rust-lang/rust/pull/39523
6394
6395
6396 Version 1.15.0 (2017-02-02)
6397 ===========================
6398
6399 Language
6400 --------
6401
6402 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
6403   stable. This allows popular code-generating crates like Serde and Diesel to
6404   work ergonomically. [RFC 1681].
6405 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
6406   with curly braces][36868]. Part of [RFC 1506].
6407 * [A number of minor changes to name resolution have been activated][37127].
6408   They add up to more consistent semantics, allowing for future evolution of
6409   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6410   details of what is different. The breaking changes here have been transitioned
6411   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6412 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
6413   bounds][38279]
6414 * [`?Sized` can be used in `where` clauses][37791]
6415 * [There is now a limit on the size of monomorphized types and it can be
6416   modified with the `#![type_size_limit]` crate attribute, similarly to
6417   the `#![recursion_limit]` attribute][37789]
6418
6419 Compiler
6420 --------
6421
6422 * [On Windows, the compiler will apply dllimport attributes when linking to
6423   extern functions][37973]. Additional attributes and flags can control which
6424   library kind is linked and its name. [RFC 1717].
6425 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6426 * [The `--test` flag works with procedural macro crates][38107]
6427 * [Fix `extern "aapcs" fn` ABI][37814]
6428 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
6429 * [The `format!` expander recognizes incorrect `printf` and shell-style
6430   formatting directives and suggests the correct format][37613].
6431 * [Only report one error for all unused imports in an import list][37456]
6432
6433 Compiler Performance
6434 --------------------
6435
6436 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
6437 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
6438 * [Don't clone in `UnificationTable::probe`][37848]
6439 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
6440 * [Use small vectors in type walker][37760]
6441 * [Macro expansion performance was improved][37701]
6442 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
6443 * [Replace FNV with a faster hash function][37229]
6444
6445 Stabilized APIs
6446 ---------------
6447
6448 * [`std::iter::Iterator::min_by`]
6449 * [`std::iter::Iterator::max_by`]
6450 * [`std::os::*::fs::FileExt`]
6451 * [`std::sync::atomic::Atomic*::get_mut`]
6452 * [`std::sync::atomic::Atomic*::into_inner`]
6453 * [`std::vec::IntoIter::as_slice`]
6454 * [`std::vec::IntoIter::as_mut_slice`]
6455 * [`std::sync::mpsc::Receiver::try_iter`]
6456 * [`std::os::unix::process::CommandExt::before_exec`]
6457 * [`std::rc::Rc::strong_count`]
6458 * [`std::rc::Rc::weak_count`]
6459 * [`std::sync::Arc::strong_count`]
6460 * [`std::sync::Arc::weak_count`]
6461 * [`std::char::encode_utf8`]
6462 * [`std::char::encode_utf16`]
6463 * [`std::cell::Ref::clone`]
6464 * [`std::io::Take::into_inner`]
6465
6466 Libraries
6467 ---------
6468
6469 * [The standard sorting algorithm has been rewritten for dramatic performance
6470   improvements][38192]. It is a hybrid merge sort, drawing influences from
6471   Timsort. Previously it was a naive merge sort.
6472 * [`Iterator::nth` no longer has a `Sized` bound][38134]
6473 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
6474   performance.
6475 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
6476   and `char_indices().last()`][37882]
6477 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
6478 * [Chinese characters display correctly in `fmt::Debug`][37855]
6479 * [Derive `Default` for `Duration`][37699]
6480 * [Support creation of anonymous pipes on WinXP/2k][37677]
6481 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
6482 * [Don't pass overlapped handles to processes][38835]
6483
6484 Cargo
6485 -----
6486
6487 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6488   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6489   should instead check the variable at runtime with `std::env`. That the value
6490   was set at build time was a bug, and incorrect when cross-compiling. This
6491   change is known to cause breakage.
6492 * [Add `--all` flag to `cargo test`][cargo/3221]
6493 * [Compile statically against the MSVC CRT][cargo/3363]
6494 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
6495 * [Link OpenSSL statically on OSX][cargo/3311]
6496 * [Apply new fingerprinting to build dir outputs][cargo/3310]
6497 * [Test for bad path overrides with summaries][cargo/3336]
6498 * [Require `cargo install --vers` to take a semver version][cargo/3338]
6499 * [Fix retrying crate downloads for network errors][cargo/3348]
6500 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
6501 * [Emit more info on --message-format=json][cargo/3319]
6502 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
6503 * [Don't ignore errors in workspace manifest][cargo/3409]
6504 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
6505
6506 Tooling
6507 -------
6508
6509 * [Test runners (binaries built with `--test`) now support a `--list` argument
6510   that lists the tests it contains][38185]
6511 * [Test runners now support a `--exact` argument that makes the test filter
6512   match exactly, instead of matching only a substring of the test name][38181]
6513 * [rustdoc supports a `--playground-url` flag][37763]
6514 * [rustdoc provides more details about `#[should_panic]` errors][37749]
6515
6516 Misc
6517 ----
6518
6519 * [The Rust build system is now written in Rust][37817]. The Makefiles may
6520   continue to be used in this release by passing `--disable-rustbuild` to the
6521   configure script, but they will be deleted soon. Note that the new build
6522   system uses a different on-disk layout that will likely affect any scripts
6523   building Rust.
6524 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
6525   releases.
6526 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
6527 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
6528   releases.
6529
6530 Compatibility Notes
6531 -------------------
6532
6533 * [A number of minor changes to name resolution have been activated][37127].
6534   They add up to more consistent semantics, allowing for future evolution of
6535   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6536   details of what is different. The breaking changes here have been transitioned
6537   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6538 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6539   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6540   should instead check the variable at runtime with `std::env`. That the value
6541   was set at build time was a bug, and incorrect when cross-compiling. This
6542   change is known to cause breakage.
6543 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
6544   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
6545   1.10 and is now an error by default. It will become a hard error in the near
6546   future.
6547 * [The semantics relating modules to file system directories are changing in
6548   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
6549   lint, which is a warning in this release, and will become a hard error in the
6550   future.
6551 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6552 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
6553   the underlying iterator][37834]
6554
6555 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
6556 [33685]: https://github.com/rust-lang/rust/issues/33685
6557 [36868]: https://github.com/rust-lang/rust/pull/36868
6558 [37127]: https://github.com/rust-lang/rust/pull/37127
6559 [37229]: https://github.com/rust-lang/rust/pull/37229
6560 [37456]: https://github.com/rust-lang/rust/pull/37456
6561 [37527]: https://github.com/rust-lang/rust/pull/37527
6562 [37602]: https://github.com/rust-lang/rust/pull/37602
6563 [37613]: https://github.com/rust-lang/rust/pull/37613
6564 [37615]: https://github.com/rust-lang/rust/pull/37615
6565 [37636]: https://github.com/rust-lang/rust/pull/37636
6566 [37627]: https://github.com/rust-lang/rust/pull/37627
6567 [37642]: https://github.com/rust-lang/rust/pull/37642
6568 [37677]: https://github.com/rust-lang/rust/pull/37677
6569 [37699]: https://github.com/rust-lang/rust/pull/37699
6570 [37701]: https://github.com/rust-lang/rust/pull/37701
6571 [37705]: https://github.com/rust-lang/rust/pull/37705
6572 [37749]: https://github.com/rust-lang/rust/pull/37749
6573 [37760]: https://github.com/rust-lang/rust/pull/37760
6574 [37763]: https://github.com/rust-lang/rust/pull/37763
6575 [37764]: https://github.com/rust-lang/rust/pull/37764
6576 [37789]: https://github.com/rust-lang/rust/pull/37789
6577 [37791]: https://github.com/rust-lang/rust/pull/37791
6578 [37814]: https://github.com/rust-lang/rust/pull/37814
6579 [37817]: https://github.com/rust-lang/rust/pull/37817
6580 [37834]: https://github.com/rust-lang/rust/pull/37834
6581 [37848]: https://github.com/rust-lang/rust/pull/37848
6582 [37855]: https://github.com/rust-lang/rust/pull/37855
6583 [37882]: https://github.com/rust-lang/rust/pull/37882
6584 [37888]: https://github.com/rust-lang/rust/pull/37888
6585 [37973]: https://github.com/rust-lang/rust/pull/37973
6586 [37979]: https://github.com/rust-lang/rust/pull/37979
6587 [38086]: https://github.com/rust-lang/rust/pull/38086
6588 [38107]: https://github.com/rust-lang/rust/pull/38107
6589 [38117]: https://github.com/rust-lang/rust/pull/38117
6590 [38134]: https://github.com/rust-lang/rust/pull/38134
6591 [38146]: https://github.com/rust-lang/rust/pull/38146
6592 [38181]: https://github.com/rust-lang/rust/pull/38181
6593 [38182]: https://github.com/rust-lang/rust/pull/38182
6594 [38185]: https://github.com/rust-lang/rust/pull/38185
6595 [38192]: https://github.com/rust-lang/rust/pull/38192
6596 [38279]: https://github.com/rust-lang/rust/pull/38279
6597 [38835]: https://github.com/rust-lang/rust/pull/38835
6598 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6599 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6600 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
6601 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
6602 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
6603 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
6604 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
6605 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
6606 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
6607 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
6608 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
6609 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
6610 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
6611 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
6612 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
6613 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
6614 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
6615 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
6616 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
6617 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
6618 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
6619 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
6620 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
6621 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
6622 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
6623 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
6624 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
6625 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
6626 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
6627 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
6628 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
6629 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
6630 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
6631 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
6632 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
6633 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
6634 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
6635 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
6636
6637
6638 Version 1.14.0 (2016-12-22)
6639 ===========================
6640
6641 Language
6642 --------
6643
6644 * [`..` matches multiple tuple fields in enum variants, structs
6645   and tuples][36843]. [RFC 1492].
6646 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
6647 * [`use *` and `use ::*` both glob-import from the crate root][37367]
6648 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
6649   dereferencing][36822]
6650
6651 Compiler
6652 --------
6653
6654 * [Mark enums with non-zero discriminant as non-zero][37224]
6655 * [Lower-case `static mut` names are linted like other
6656   statics and consts][37162]
6657 * [Fix ICE on some macros in const integer positions
6658    (e.g. `[u8; m!()]`)][36819]
6659 * [Improve error message and snippet for "did you mean `x`"][36798]
6660 * [Add a panic-strategy field to the target specification][36794]
6661 * [Include LLVM version in `--version --verbose`][37200]
6662
6663 Compile-time Optimizations
6664 --------------------------
6665
6666 * [Improve macro expansion performance][37569]
6667 * [Shrink `Expr_::ExprInlineAsm`][37445]
6668 * [Replace all uses of SHA-256 with BLAKE2b][37439]
6669 * [Reduce the number of bytes hashed by `IchHasher`][37427]
6670 * [Avoid more allocations when compiling html5ever][37373]
6671 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
6672 * [Avoid some allocations in the macro parser][37318]
6673 * [Use a faster deflate setting][37298]
6674 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
6675   during interning of slices][37270]
6676 * [Optimize `write_metadata`][37267]
6677 * [Don't process obligation forest cycles when stalled][37231]
6678 * [Avoid many `CrateConfig` clones][37161]
6679 * [Optimize `Substs::super_fold_with`][37108]
6680 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
6681 * [Speed up `plug_leaks`][36917]
6682
6683 Libraries
6684 ---------
6685
6686 * [`println!()`, with no arguments, prints newline][36825].
6687   Previously, an empty string was required to achieve the same.
6688 * [`Wrapping` impls standard binary and unary operators, as well as
6689    the `Sum` and `Product` iterators][37356]
6690 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
6691   Vec<T>`][37326]
6692 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
6693   `VecDeque` iterators][37315]
6694 * [Improve `SipHasher` performance on small values][37312]
6695 * [Add Iterator trait TrustedLen to enable better FromIterator /
6696   Extend][37306]
6697 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
6698 * [`ReadDir` implements `Debug`][37221]
6699 * [Implement `RefUnwindSafe` for atomic types][37178]
6700 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
6701 * [Avoid allocations in `Decoder::read_str`][37064]
6702 * [`io::Error` implements `From<io::ErrorKind>`][37037]
6703 * [Impl `Debug` for raw pointers to unsized data][36880]
6704 * [Don't reuse `HashMap` random seeds][37470]
6705 * [The internal memory layout of `HashMap` is more cache-friendly, for
6706   significant improvements in some operations][36692]
6707 * [`HashMap` uses less memory on 32-bit architectures][36595]
6708 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
6709
6710 Cargo
6711 -----
6712
6713 * [Expose rustc cfg values to build scripts][cargo/3243]
6714 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
6715 * [Fix passing --features when testing multiple packages][cargo/3280]
6716 * [Use a single profile set per workspace][cargo/3249]
6717 * [Load `replace` sections from lock files][cargo/3220]
6718 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
6719
6720 Tooling
6721 -------
6722
6723 * [rustup is the recommended Rust installation method][1.14rustup]
6724 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
6725   S390x. These are [tier 2] platforms and may have major defects. Follow the
6726   instructions on the website to install, or add the targets to an existing
6727   installation with `rustup target add`. The new target triples are:
6728   - `mips-unknown-linux-gnu`
6729   - `mipsel-unknown-linux-gnu`
6730   - `mips64-unknown-linux-gnuabi64`
6731   - `mips64el-unknown-linux-gnuabi64 `
6732   - `powerpc-unknown-linux-gnu`
6733   - `powerpc64-unknown-linux-gnu`
6734   - `powerpc64le-unknown-linux-gnu`
6735   - `s390x-unknown-linux-gnu `
6736 * This release includes target (std) builds for ARM Linux running MUSL
6737   libc. These are [tier 2] platforms and may have major defects. Add the
6738   following triples to an existing rustup installation with `rustup target add`:
6739   - `arm-unknown-linux-musleabi`
6740   - `arm-unknown-linux-musleabihf`
6741   - `armv7-unknown-linux-musleabihf`
6742 * This release includes [experimental support for WebAssembly][1.14wasm], via
6743   the `wasm32-unknown-emscripten` target. This target is known to have major
6744   defects. Please test, report, and fix.
6745 * rustup no longer installs documentation by default. Run `rustup
6746   component add rust-docs` to install.
6747 * [Fix line stepping in debugger][37310]
6748 * [Enable line number debuginfo in releases][37280]
6749
6750 Misc
6751 ----
6752
6753 * [Disable jemalloc on aarch64/powerpc/mips][37392]
6754 * [Add support for Fuchsia OS][37313]
6755 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
6756
6757 Compatibility Notes
6758 -------------------
6759
6760 * [A number of forward-compatibility lints used by the compiler
6761   to gradually introduce language changes have been converted
6762   to deny by default][36894]:
6763   - ["use of inaccessible extern crate erroneously allowed"][36886]
6764   - ["type parameter default erroneously allowed in invalid location"][36887]
6765   - ["detects super or self keywords at the beginning of global path"][36888]
6766   - ["two overlapping inherent impls define an item with the same name
6767     were erroneously allowed"][36889]
6768   - ["floating-point constants cannot be used in patterns"][36890]
6769   - ["constants of struct or enum type can only be used in a pattern if
6770      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
6771   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
6772 * [Prohibit patterns in trait methods without bodies][37378]
6773 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
6774 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
6775 * [The `$crate` macro variable is accepted in fewer locations][37213]
6776 * [Impls specifying extra region requirements beyond the trait
6777   they implement are rejected][37167]
6778 * [Enums may not be unsized][37111]. Unsized enums are intended to
6779   work but never have. For now they are forbidden.
6780 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
6781
6782 [tier 2]: https://forge.rust-lang.org/platform-support.html
6783 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
6784 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
6785 [36430]: https://github.com/rust-lang/rust/pull/36430
6786 [36595]: https://github.com/rust-lang/rust/pull/36595
6787 [36595]: https://github.com/rust-lang/rust/pull/36595
6788 [36692]: https://github.com/rust-lang/rust/pull/36692
6789 [36767]: https://github.com/rust-lang/rust/pull/36767
6790 [36794]: https://github.com/rust-lang/rust/pull/36794
6791 [36798]: https://github.com/rust-lang/rust/pull/36798
6792 [36819]: https://github.com/rust-lang/rust/pull/36819
6793 [36822]: https://github.com/rust-lang/rust/pull/36822
6794 [36825]: https://github.com/rust-lang/rust/pull/36825
6795 [36843]: https://github.com/rust-lang/rust/pull/36843
6796 [36880]: https://github.com/rust-lang/rust/pull/36880
6797 [36886]: https://github.com/rust-lang/rust/issues/36886
6798 [36887]: https://github.com/rust-lang/rust/issues/36887
6799 [36888]: https://github.com/rust-lang/rust/issues/36888
6800 [36889]: https://github.com/rust-lang/rust/issues/36889
6801 [36890]: https://github.com/rust-lang/rust/issues/36890
6802 [36891]: https://github.com/rust-lang/rust/issues/36891
6803 [36892]: https://github.com/rust-lang/rust/issues/36892
6804 [36894]: https://github.com/rust-lang/rust/pull/36894
6805 [36917]: https://github.com/rust-lang/rust/pull/36917
6806 [36993]: https://github.com/rust-lang/rust/pull/36993
6807 [37037]: https://github.com/rust-lang/rust/pull/37037
6808 [37064]: https://github.com/rust-lang/rust/pull/37064
6809 [37094]: https://github.com/rust-lang/rust/pull/37094
6810 [37108]: https://github.com/rust-lang/rust/pull/37108
6811 [37111]: https://github.com/rust-lang/rust/pull/37111
6812 [37161]: https://github.com/rust-lang/rust/pull/37161
6813 [37162]: https://github.com/rust-lang/rust/pull/37162
6814 [37167]: https://github.com/rust-lang/rust/pull/37167
6815 [37178]: https://github.com/rust-lang/rust/pull/37178
6816 [37200]: https://github.com/rust-lang/rust/pull/37200
6817 [37213]: https://github.com/rust-lang/rust/pull/37213
6818 [37221]: https://github.com/rust-lang/rust/pull/37221
6819 [37224]: https://github.com/rust-lang/rust/pull/37224
6820 [37230]: https://github.com/rust-lang/rust/pull/37230
6821 [37231]: https://github.com/rust-lang/rust/pull/37231
6822 [37247]: https://github.com/rust-lang/rust/pull/37247
6823 [37267]: https://github.com/rust-lang/rust/pull/37267
6824 [37270]: https://github.com/rust-lang/rust/pull/37270
6825 [37273]: https://github.com/rust-lang/rust/pull/37273
6826 [37280]: https://github.com/rust-lang/rust/pull/37280
6827 [37298]: https://github.com/rust-lang/rust/pull/37298
6828 [37306]: https://github.com/rust-lang/rust/pull/37306
6829 [37310]: https://github.com/rust-lang/rust/pull/37310
6830 [37312]: https://github.com/rust-lang/rust/pull/37312
6831 [37313]: https://github.com/rust-lang/rust/pull/37313
6832 [37315]: https://github.com/rust-lang/rust/pull/37315
6833 [37318]: https://github.com/rust-lang/rust/pull/37318
6834 [37322]: https://github.com/rust-lang/rust/pull/37322
6835 [37326]: https://github.com/rust-lang/rust/pull/37326
6836 [37351]: https://github.com/rust-lang/rust/pull/37351
6837 [37356]: https://github.com/rust-lang/rust/pull/37356
6838 [37367]: https://github.com/rust-lang/rust/pull/37367
6839 [37373]: https://github.com/rust-lang/rust/pull/37373
6840 [37378]: https://github.com/rust-lang/rust/pull/37378
6841 [37389]: https://github.com/rust-lang/rust/pull/37389
6842 [37392]: https://github.com/rust-lang/rust/pull/37392
6843 [37427]: https://github.com/rust-lang/rust/pull/37427
6844 [37439]: https://github.com/rust-lang/rust/pull/37439
6845 [37445]: https://github.com/rust-lang/rust/pull/37445
6846 [37470]: https://github.com/rust-lang/rust/pull/37470
6847 [37569]: https://github.com/rust-lang/rust/pull/37569
6848 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6849 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
6850 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
6851 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
6852 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
6853 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
6854 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
6855
6856
6857 Version 1.13.0 (2016-11-10)
6858 ===========================
6859
6860 Language
6861 --------
6862
6863 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
6864   errors, like the `try!` macro, described in [RFC 0243].
6865 * [Stabilize macros in type position][36014]. Described in [RFC 873].
6866 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
6867 * [Fix `#[derive]` for empty tuple structs/variants][35728]
6868 * [Fix lifetime rules for 'if' conditions][36029]
6869 * [Avoid loading and parsing unconfigured non-inline modules][36482]
6870
6871 Compiler
6872 --------
6873
6874 * [Add the `-C link-arg` argument][36574]
6875 * [Remove the old AST-based backend from rustc_trans][35764]
6876 * [Don't enable NEON by default on armv7 Linux][35814]
6877 * [Fix debug line number info for macro expansions][35238]
6878 * [Do not emit "class method" debuginfo for types that are not
6879   DICompositeType][36008]
6880 * [Warn about multiple conflicting #[repr] hints][34623]
6881 * [When sizing DST, don't double-count nested struct prefixes][36351]
6882 * [Default RUST_MIN_STACK to 16MiB for now][36505]
6883 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
6884 * [Reject macros with empty repetitions to avoid infinite loop][36721]
6885 * [Expand macros without recursing to avoid stack overflows][36214]
6886
6887 Diagnostics
6888 -----------
6889
6890 * [Replace macro backtraces with labeled local uses][35702]
6891 * [Improve error message for misplaced doc comments][33922]
6892 * [Buffer unix and lock windows to prevent message interleaving][35975]
6893 * [Update lifetime errors to specifically note temporaries][36171]
6894 * [Special case a few colors for Windows][36178]
6895 * [Suggest `use self` when such an import resolves][36289]
6896 * [Be more specific when type parameter shadows primitive type][36338]
6897 * Many minor improvements
6898
6899 Compile-time Optimizations
6900 --------------------------
6901
6902 * [Compute and cache HIR hashes at beginning][35854]
6903 * [Don't hash types in loan paths][36004]
6904 * [Cache projections in trans][35761]
6905 * [Optimize the parser's last token handling][36527]
6906 * [Only instantiate #[inline] functions in codegen units referencing
6907   them][36524]. This leads to big improvements in cases where crates export
6908   define many inline functions without using them directly.
6909 * [Lazily allocate TypedArena's first chunk][36592]
6910 * [Don't allocate during default HashSet creation][36734]
6911
6912 Stabilized APIs
6913 ---------------
6914
6915 * [`checked_abs`]
6916 * [`wrapping_abs`]
6917 * [`overflowing_abs`]
6918 * [`RefCell::try_borrow`]
6919 * [`RefCell::try_borrow_mut`]
6920
6921 Libraries
6922 ---------
6923
6924 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
6925 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
6926   covariant][35354]
6927 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
6928 * [Implement `Debug` for `std::vec::IntoIter`][35707]
6929 * [`CString`: avoid excessive growth just to 0-terminate][35871]
6930 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
6931 * [Use arc4rand on FreeBSD][35884]
6932 * [memrchr: Correct aligned offset computation][35969]
6933 * [Improve Demangling of Rust Symbols][36059]
6934 * [Use monotonic time in condition variables][35048]
6935 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
6936 * [Implement conversion traits for `char`][35755]
6937 * [Fix illegal instruction caused by overflow in channel cloning][36104]
6938 * [Zero first byte of CString on drop][36264]
6939 * [Inherit overflow checks for sum and product][36372]
6940 * [Add missing Eq implementations][36423]
6941 * [Implement `Debug` for `DirEntry`][36631]
6942 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
6943   `errno`][36754]
6944 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6945 * [Implement more traits for `std::io::ErrorKind`][35911]
6946 * [Optimize BinaryHeap bounds checking][36072]
6947 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
6948   `extend_with_element`][36355]
6949 * [Fix overflow checking in unsigned pow()][34942]
6950
6951 Cargo
6952 -----
6953
6954 * This release includes security fixes to both curl and OpenSSL.
6955 * [Fix transitive doctests when panic=abort][cargo/3021]
6956 * [Add --all-features flag to cargo][cargo/3038]
6957 * [Reject path-based dependencies in `cargo package`][cargo/3060]
6958 * [Don't parse the home directory more than once][cargo/3078]
6959 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
6960 * [Update OpenSSL to 1.0.2j][cargo/3121]
6961 * [Add license and license_file to cargo metadata output][cargo/3110]
6962 * [Make crates-io registry URL optional in config; ignore all changes to
6963   source.crates-io][cargo/3089]
6964 * [Don't download dependencies from other platforms][cargo/3123]
6965 * [Build transitive dev-dependencies when needed][cargo/3125]
6966 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
6967 * [Avoid updating registry when adding existing deps][cargo/3144]
6968 * [Warn about path overrides that won't work][cargo/3136]
6969 * [Use workspaces during `cargo install`][cargo/3146]
6970 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
6971 * [Add --message-format flag][cargo/3000]
6972 * [Pass target environment for rustdoc][cargo/3205]
6973 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
6974 * [Update curl and curl-sys][cargo/3241]
6975 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
6976
6977 Tooling
6978 -------
6979
6980 * [rustdoc: Add the `--sysroot` argument][36586]
6981 * [rustdoc: Fix a couple of issues with the search results][35655]
6982 * [rustdoc: remove the `!` from macro URLs and titles][35234]
6983 * [gdb: Fix pretty-printing special-cased Rust types][35585]
6984 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
6985
6986 Misc
6987 ----
6988
6989 * [Remove unmaintained style guide][35124]
6990 * [Add s390x support][36369]
6991 * [Initial work at Haiku OS support][36727]
6992 * [Add mips-uclibc targets][35734]
6993 * [Crate-ify compiler-rt into compiler-builtins][35021]
6994 * [Add rustc version info (git hash + date) to dist tarball][36213]
6995 * Many documentation improvements
6996
6997 Compatibility Notes
6998 -------------------
6999
7000 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
7001 * [Deny (by default) transmuting from fn item types to pointer-sized
7002   types][34923]. Continuing the long transition to zero-sized fn items,
7003   per [RFC 401].
7004 * [Fix `#[derive]` for empty tuple structs/variants][35728].
7005   Part of [RFC 1506].
7006 * [Issue deprecation warnings for safe accesses to extern statics][36173]
7007 * [Fix lifetime rules for 'if' conditions][36029].
7008 * [Inherit overflow checks for sum and product][36372].
7009 * [Forbid user-defined macros named "macro_rules"][36730].
7010
7011 [33922]: https://github.com/rust-lang/rust/pull/33922
7012 [34623]: https://github.com/rust-lang/rust/pull/34623
7013 [34923]: https://github.com/rust-lang/rust/pull/34923
7014 [34942]: https://github.com/rust-lang/rust/pull/34942
7015 [34982]: https://github.com/rust-lang/rust/pull/34982
7016 [35021]: https://github.com/rust-lang/rust/pull/35021
7017 [35048]: https://github.com/rust-lang/rust/pull/35048
7018 [35074]: https://github.com/rust-lang/rust/pull/35074
7019 [35124]: https://github.com/rust-lang/rust/pull/35124
7020 [35234]: https://github.com/rust-lang/rust/pull/35234
7021 [35238]: https://github.com/rust-lang/rust/pull/35238
7022 [35354]: https://github.com/rust-lang/rust/pull/35354
7023 [35559]: https://github.com/rust-lang/rust/pull/35559
7024 [35585]: https://github.com/rust-lang/rust/pull/35585
7025 [35627]: https://github.com/rust-lang/rust/pull/35627
7026 [35655]: https://github.com/rust-lang/rust/pull/35655
7027 [35702]: https://github.com/rust-lang/rust/pull/35702
7028 [35707]: https://github.com/rust-lang/rust/pull/35707
7029 [35728]: https://github.com/rust-lang/rust/pull/35728
7030 [35734]: https://github.com/rust-lang/rust/pull/35734
7031 [35755]: https://github.com/rust-lang/rust/pull/35755
7032 [35761]: https://github.com/rust-lang/rust/pull/35761
7033 [35764]: https://github.com/rust-lang/rust/pull/35764
7034 [35814]: https://github.com/rust-lang/rust/pull/35814
7035 [35854]: https://github.com/rust-lang/rust/pull/35854
7036 [35871]: https://github.com/rust-lang/rust/pull/35871
7037 [35884]: https://github.com/rust-lang/rust/pull/35884
7038 [35911]: https://github.com/rust-lang/rust/pull/35911
7039 [35969]: https://github.com/rust-lang/rust/pull/35969
7040 [35975]: https://github.com/rust-lang/rust/pull/35975
7041 [36004]: https://github.com/rust-lang/rust/pull/36004
7042 [36008]: https://github.com/rust-lang/rust/pull/36008
7043 [36014]: https://github.com/rust-lang/rust/pull/36014
7044 [36029]: https://github.com/rust-lang/rust/pull/36029
7045 [36059]: https://github.com/rust-lang/rust/pull/36059
7046 [36072]: https://github.com/rust-lang/rust/pull/36072
7047 [36101]: https://github.com/rust-lang/rust/pull/36101
7048 [36104]: https://github.com/rust-lang/rust/pull/36104
7049 [36171]: https://github.com/rust-lang/rust/pull/36171
7050 [36173]: https://github.com/rust-lang/rust/pull/36173
7051 [36178]: https://github.com/rust-lang/rust/pull/36178
7052 [36213]: https://github.com/rust-lang/rust/pull/36213
7053 [36214]: https://github.com/rust-lang/rust/pull/36214
7054 [36264]: https://github.com/rust-lang/rust/pull/36264
7055 [36266]: https://github.com/rust-lang/rust/pull/36266
7056 [36289]: https://github.com/rust-lang/rust/pull/36289
7057 [36338]: https://github.com/rust-lang/rust/pull/36338
7058 [36351]: https://github.com/rust-lang/rust/pull/36351
7059 [36355]: https://github.com/rust-lang/rust/pull/36355
7060 [36369]: https://github.com/rust-lang/rust/pull/36369
7061 [36372]: https://github.com/rust-lang/rust/pull/36372
7062 [36423]: https://github.com/rust-lang/rust/pull/36423
7063 [36482]: https://github.com/rust-lang/rust/pull/36482
7064 [36505]: https://github.com/rust-lang/rust/pull/36505
7065 [36524]: https://github.com/rust-lang/rust/pull/36524
7066 [36527]: https://github.com/rust-lang/rust/pull/36527
7067 [36551]: https://github.com/rust-lang/rust/pull/36551
7068 [36574]: https://github.com/rust-lang/rust/pull/36574
7069 [36586]: https://github.com/rust-lang/rust/pull/36586
7070 [36592]: https://github.com/rust-lang/rust/pull/36592
7071 [36631]: https://github.com/rust-lang/rust/pull/36631
7072 [36639]: https://github.com/rust-lang/rust/pull/36639
7073 [36721]: https://github.com/rust-lang/rust/pull/36721
7074 [36727]: https://github.com/rust-lang/rust/pull/36727
7075 [36730]: https://github.com/rust-lang/rust/pull/36730
7076 [36734]: https://github.com/rust-lang/rust/pull/36734
7077 [36754]: https://github.com/rust-lang/rust/pull/36754
7078 [36995]: https://github.com/rust-lang/rust/pull/36995
7079 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
7080 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
7081 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
7082 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
7083 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
7084 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
7085 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
7086 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
7087 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
7088 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
7089 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
7090 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
7091 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
7092 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
7093 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
7094 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
7095 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
7096 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
7097 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
7098 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
7099 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
7100 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
7101 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
7102 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
7103 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
7104 [rustup]: https://www.rustup.rs
7105 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
7106 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
7107 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
7108 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
7109 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
7110 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
7111 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
7112
7113
7114 Version 1.12.1 (2016-10-20)
7115 ===========================
7116
7117 Regression Fixes
7118 ----------------
7119
7120 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
7121 * [Confusion with double negation and booleans][36856]
7122 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
7123 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
7124 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
7125 * [Corrupted memory after updated to 1.12][36936]
7126 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
7127 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
7128 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
7129
7130 [36381]: https://github.com/rust-lang/rust/issues/36381
7131 [36856]: https://github.com/rust-lang/rust/issues/36856
7132 [36875]: https://github.com/rust-lang/rust/issues/36875
7133 [36924]: https://github.com/rust-lang/rust/issues/36924
7134 [36926]: https://github.com/rust-lang/rust/issues/36926
7135 [36936]: https://github.com/rust-lang/rust/issues/36936
7136 [37026]: https://github.com/rust-lang/rust/issues/37026
7137 [37112]: https://github.com/rust-lang/rust/issues/37112
7138 [37153]: https://github.com/rust-lang/rust/issues/37153
7139
7140
7141 Version 1.12.0 (2016-09-29)
7142 ===========================
7143
7144 Highlights
7145 ----------
7146
7147 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
7148   This translation pass is far simpler than the previous AST->LLVM pass, and
7149   creates opportunities to perform new optimizations directly on the MIR. It
7150   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
7151 * [`rustc` presents a new, more readable error format, along with
7152   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
7153   Most common editors supporting Rust have been updated to work with it. It was
7154   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
7155
7156 Compiler
7157 --------
7158
7159 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
7160   This translation pass is far simpler than the previous AST->LLVM pass, and
7161   creates opportunities to perform new optimizations directly on the MIR. It
7162   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
7163 * [Print the Rust target name, not the LLVM target name, with
7164   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
7165 * [The computation of `TypeId` is correct in some cases where it was previously
7166   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
7167 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
7168 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
7169   `--print relocation-models`, and `--print code-models` print the available
7170   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
7171   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
7172 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
7173   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
7174   These targets produce statically-linked binaries. There are no binary release
7175   builds yet though.
7176
7177 Diagnostics
7178 -----------
7179
7180 * [`rustc` presents a new, more readable error format, along with
7181   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
7182   Most common editors supporting Rust have been updated to work with it. It was
7183   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
7184 * [In error descriptions, references are now described in plain English,
7185   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
7186 * [In error type descriptions, unknown numeric types are named `{integer}` or
7187   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
7188 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
7189
7190 Language
7191 --------
7192
7193 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
7194 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
7195 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
7196   useful](https://github.com/rust-lang/rust/pull/34908)
7197 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
7198   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
7199 * [Semicolons are properly required as statement delimiters inside
7200   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
7201 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
7202
7203 Stabilized APIs
7204 ---------------
7205
7206 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
7207 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
7208 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
7209 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
7210 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
7211 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
7212 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
7213 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
7214 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
7215 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
7216   Both on Unix and Windows.
7217 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
7218 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
7219 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
7220 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
7221 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
7222 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
7223 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
7224 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
7225
7226 Libraries
7227 ---------
7228
7229 * [The `format!` macro and friends now allow a single argument to be formatted
7230   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
7231 * [The lifetime bounds on `[T]::binary_search_by` and
7232   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
7233 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
7234 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
7235 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
7236 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
7237 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
7238 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
7239 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
7240 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
7241   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
7242 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
7243   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
7244 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
7245 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
7246   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
7247 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
7248 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
7249 * [`mpsc::sync_channel` `Receiver`s return any available message before
7250   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
7251 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
7252 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
7253
7254 Cargo
7255 -----
7256
7257 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
7258 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
7259 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
7260 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
7261 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
7262 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
7263 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
7264 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
7265 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
7266 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
7267 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
7268 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
7269 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
7270 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
7271 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
7272 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
7273
7274 Performance
7275 -----------
7276
7277 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
7278 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
7279
7280 Tooling
7281 -------
7282
7283 * [Test binaries now support a `--test-threads` argument to specify the number
7284   of threads used to run tests, and which acts the same as the
7285   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
7286 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
7287 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
7288 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7289 * [Rust releases now come with source packages that can be installed by rustup
7290   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
7291   The resulting source code can be used by tools and IDES, located in the
7292   sysroot under `lib/rustlib/src`.
7293
7294 Misc
7295 ----
7296
7297 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
7298 * Many minor improvements to the documentation.
7299 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
7300
7301 Compatibility Notes
7302 -------------------
7303
7304 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
7305   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
7306 * [When formatting strings, if "precision" is specified, the "fill",
7307   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
7308 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
7309
7310
7311 Version 1.11.0 (2016-08-18)
7312 ===========================
7313
7314 Language
7315 --------
7316
7317 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
7318 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
7319 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
7320 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
7321
7322 Stabilized APIs
7323 ---------------
7324
7325 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
7326 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
7327 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
7328 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
7329 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
7330 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
7331   (in libcore - previously stabilized in libstd)
7332 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
7333   (in libcore - previously stabilized in libstd)
7334 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
7335   (in libcore - previously stabilized in libstd)
7336 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
7337   (in libcore - previously stabilized in libstd)
7338 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7339 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7340 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
7341 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
7342
7343 Libraries
7344 ---------
7345
7346 * [The `thread_local!` macro supports multiple definitions in a single
7347    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
7348 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
7349 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
7350   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
7351 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
7352 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
7353 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
7354 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
7355
7356 Cargo
7357 -----
7358
7359 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
7360 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
7361 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
7362 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
7363 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
7364   and `-vv` prints warnings for all crates.
7365 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
7366 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
7367   This provides room for expansion by arbitrary tools.
7368 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
7369 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
7370 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
7371 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
7372 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
7373 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
7374 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
7375
7376 Performance
7377 -----------
7378
7379 * [Caching projections speeds up type check dramatically for some
7380   workloads](https://github.com/rust-lang/rust/pull/33816)
7381 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
7382   This hasher is faster, but is believed to provide sufficient
7383   protection from collision attacks.
7384 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
7385
7386 Rustdoc
7387 -------
7388
7389 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
7390 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
7391 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
7392 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
7393 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
7394
7395 Tooling
7396 -------
7397
7398 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
7399 * [When emitting debug info, rustc emits frame pointers for closures,
7400   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
7401 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7402 * Many more errors have been given error codes and extended
7403   explanations
7404 * API documentation continues to be improved, with many new examples
7405
7406 Misc
7407 ----
7408
7409 * [rustc no longer hangs when dependencies recursively re-export
7410   submodules](https://github.com/rust-lang/rust/pull/34542)
7411 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
7412 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
7413   rewritten](https://github.com/rust-lang/rust/pull/33895)
7414 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
7415   No targets use this yet, but it works toward AVR support.
7416
7417 Compatibility Notes
7418 -------------------
7419
7420 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
7421 * [The new follow-set rules that place restrictions on `macro_rules!`
7422   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
7423   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
7424   and has been a warning since 1.10.
7425 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
7426   This causes breakage in some corner cases.
7427
7428
7429 Version 1.10.0 (2016-07-07)
7430 ===========================
7431
7432 Language
7433 --------
7434
7435 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
7436   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
7437 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
7438 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
7439 * [`panic!` can be converted to a runtime abort with the
7440   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
7441   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7442 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
7443   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
7444   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
7445   Note that Cargo does not yet directly support cdylibs.
7446
7447 Stabilized APIs
7448 ---------------
7449
7450 * `os::windows::fs::OpenOptionsExt::access_mode`
7451 * `os::windows::fs::OpenOptionsExt::share_mode`
7452 * `os::windows::fs::OpenOptionsExt::custom_flags`
7453 * `os::windows::fs::OpenOptionsExt::attributes`
7454 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
7455 * `os::unix::fs::OpenOptionsExt::custom_flags`
7456 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
7457 * `Default for sync::Weak`
7458 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
7459 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
7460 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
7461 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
7462 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
7463 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
7464 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
7465 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
7466 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
7467 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
7468 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
7469 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
7470 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
7471 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
7472 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
7473 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
7474 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
7475 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
7476 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
7477 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
7478 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
7479 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
7480 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
7481 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
7482 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
7483 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7484 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7485 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7486 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7487 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
7488 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
7489 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
7490 * Read/Write/RawFd impls for `UnixStream`
7491 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
7492 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
7493 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
7494 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
7495 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
7496 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
7497 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
7498 * RawFd impls for `UnixListener`
7499 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
7500 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
7501 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
7502 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
7503 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
7504 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
7505 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
7506 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
7507 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
7508 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
7509 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
7510 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
7511 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
7512 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
7513 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
7514 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
7515 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
7516 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
7517 * RawFd impls for `UnixDatagram`
7518 * `{BTree,Hash}Map::values_mut`
7519 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
7520
7521 Libraries
7522 ---------
7523
7524 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
7525   The semantics of this minor method are subtle and probably not what
7526   most people want.
7527 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
7528 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
7529   will fall back to `/dev/urandom` temporarily to avoid blocking
7530   during early boot](https://github.com/rust-lang/rust/pull/33086).
7531 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
7532 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
7533 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
7534 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
7535 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
7536 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
7537   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
7538
7539 Cargo
7540 -----
7541 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
7542   This controls the runtime behavior of the `panic!` macro
7543   and can be either "unwind" (the default), or "abort".
7544   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7545 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
7546 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
7547 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
7548   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
7549 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
7550 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
7551 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
7552   By default they are retried twice, which can be customized with the
7553   `net.retry` value in `.cargo/config`.
7554 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
7555 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
7556 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
7557 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
7558   Makes it possible to install multiple crates in parallel.
7559 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
7560 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
7561 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
7562 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
7563 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
7564 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
7565
7566 Performance
7567 -----------
7568
7569 * [rustc memory usage was reduced by refactoring the context used for
7570   type checking](https://github.com/rust-lang/rust/pull/33425).
7571 * [Speed up creation of `HashMap`s by caching the random keys used
7572   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
7573 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
7574 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
7575 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
7576   10x faster than the previous lookup tables.
7577 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
7578
7579 Usability
7580 ---------
7581
7582 * Many incremental improvements to documentation and rustdoc.
7583 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
7584 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
7585 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
7586 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
7587 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
7588 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
7589 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
7590
7591 Misc
7592 ----
7593
7594 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
7595 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
7596 * [`std` no longer prints backtraces on platforms where the running
7597   module must be loaded with `env::current_exe`, which can't be relied
7598   on](https://github.com/rust-lang/rust/pull/33554).
7599 * This release includes std binaries for the i586-unknown-linux-gnu,
7600   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
7601   i586 target is for old x86 hardware without SSE2, and the armv7
7602   target is for Android running on modern ARM architectures.
7603 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
7604   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
7605 * [On Unix the runtime aborts by calling `libc::abort` instead of
7606   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
7607 * [Rust is now bootstrapped from the previous release of Rust,
7608   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
7609
7610 Compatibility Notes
7611 -------------------
7612
7613 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
7614 * [`target_env` for Linux ARM targets is just `gnu`, not
7615   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
7616 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
7617 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
7618 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
7619   Affects how macros are parsed.
7620 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
7621 * [Feature-gated attributes on macro-generated macro invocations are
7622   now rejected](https://github.com/rust-lang/rust/pull/32791).
7623 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
7624   This caused some minor changes to type inference.
7625
7626
7627 Version 1.9.0 (2016-05-26)
7628 ==========================
7629
7630 Language
7631 --------
7632
7633 * The `#[deprecated]` attribute when applied to an API will generate
7634   warnings when used. The warnings may be suppressed with
7635   `#[allow(deprecated)]`. [RFC 1270].
7636 * [`fn` item types are zero sized, and each `fn` names a unique
7637   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7638   `transmute` on a `fn` type will generate a warning for a few cycles,
7639   then will be converted to an error.
7640 * [Field and method resolution understand visibility, so private
7641   fields and methods cannot prevent the proper use of public fields
7642   and methods][1.9fv].
7643 * [The parser considers unicode codepoints in the
7644   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
7645
7646 Stabilized APIs
7647 ---------------
7648
7649 * [`std::panic`]
7650 * [`std::panic::catch_unwind`] (renamed from `recover`)
7651 * [`std::panic::resume_unwind`] (renamed from `propagate`)
7652 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
7653 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
7654 * [`str::is_char_boundary`]
7655 * [`<*const T>::as_ref`]
7656 * [`<*mut T>::as_ref`]
7657 * [`<*mut T>::as_mut`]
7658 * [`AsciiExt::make_ascii_uppercase`]
7659 * [`AsciiExt::make_ascii_lowercase`]
7660 * [`char::decode_utf16`]
7661 * [`char::DecodeUtf16`]
7662 * [`char::DecodeUtf16Error`]
7663 * [`char::DecodeUtf16Error::unpaired_surrogate`]
7664 * [`BTreeSet::take`]
7665 * [`BTreeSet::replace`]
7666 * [`BTreeSet::get`]
7667 * [`HashSet::take`]
7668 * [`HashSet::replace`]
7669 * [`HashSet::get`]
7670 * [`OsString::with_capacity`]
7671 * [`OsString::clear`]
7672 * [`OsString::capacity`]
7673 * [`OsString::reserve`]
7674 * [`OsString::reserve_exact`]
7675 * [`OsStr::is_empty`]
7676 * [`OsStr::len`]
7677 * [`std::os::unix::thread`]
7678 * [`RawPthread`]
7679 * [`JoinHandleExt`]
7680 * [`JoinHandleExt::as_pthread_t`]
7681 * [`JoinHandleExt::into_pthread_t`]
7682 * [`HashSet::hasher`]
7683 * [`HashMap::hasher`]
7684 * [`CommandExt::exec`]
7685 * [`File::try_clone`]
7686 * [`SocketAddr::set_ip`]
7687 * [`SocketAddr::set_port`]
7688 * [`SocketAddrV4::set_ip`]
7689 * [`SocketAddrV4::set_port`]
7690 * [`SocketAddrV6::set_ip`]
7691 * [`SocketAddrV6::set_port`]
7692 * [`SocketAddrV6::set_flowinfo`]
7693 * [`SocketAddrV6::set_scope_id`]
7694 * [`slice::copy_from_slice`]
7695 * [`ptr::read_volatile`]
7696 * [`ptr::write_volatile`]
7697 * [`OpenOptions::create_new`]
7698 * [`TcpStream::set_nodelay`]
7699 * [`TcpStream::nodelay`]
7700 * [`TcpStream::set_ttl`]
7701 * [`TcpStream::ttl`]
7702 * [`TcpStream::set_only_v6`]
7703 * [`TcpStream::only_v6`]
7704 * [`TcpStream::take_error`]
7705 * [`TcpStream::set_nonblocking`]
7706 * [`TcpListener::set_ttl`]
7707 * [`TcpListener::ttl`]
7708 * [`TcpListener::set_only_v6`]
7709 * [`TcpListener::only_v6`]
7710 * [`TcpListener::take_error`]
7711 * [`TcpListener::set_nonblocking`]
7712 * [`UdpSocket::set_broadcast`]
7713 * [`UdpSocket::broadcast`]
7714 * [`UdpSocket::set_multicast_loop_v4`]
7715 * [`UdpSocket::multicast_loop_v4`]
7716 * [`UdpSocket::set_multicast_ttl_v4`]
7717 * [`UdpSocket::multicast_ttl_v4`]
7718 * [`UdpSocket::set_multicast_loop_v6`]
7719 * [`UdpSocket::multicast_loop_v6`]
7720 * [`UdpSocket::set_multicast_ttl_v6`]
7721 * [`UdpSocket::multicast_ttl_v6`]
7722 * [`UdpSocket::set_ttl`]
7723 * [`UdpSocket::ttl`]
7724 * [`UdpSocket::set_only_v6`]
7725 * [`UdpSocket::only_v6`]
7726 * [`UdpSocket::join_multicast_v4`]
7727 * [`UdpSocket::join_multicast_v6`]
7728 * [`UdpSocket::leave_multicast_v4`]
7729 * [`UdpSocket::leave_multicast_v6`]
7730 * [`UdpSocket::take_error`]
7731 * [`UdpSocket::connect`]
7732 * [`UdpSocket::send`]
7733 * [`UdpSocket::recv`]
7734 * [`UdpSocket::set_nonblocking`]
7735
7736 Libraries
7737 ---------
7738
7739 * [`std::sync::Once` is poisoned if its initialization function
7740   fails][1.9o].
7741 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
7742 * [Most types implement `fmt::Debug`][1.9db].
7743 * [The default buffer size used by `BufReader` and `BufWriter` was
7744   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
7745   used by other languages.
7746 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
7747   `Duration` additionally implements `*=` and `/=`][1.9ta].
7748 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
7749 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
7750 * [`Chain` implements `BufRead`][1.9ch].
7751 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
7752
7753 Cargo
7754 -----
7755
7756 * [Cargo can now run concurrently][1.9cc].
7757 * [Top-level overrides allow specific revisions of crates to be
7758   overridden through the entire crate graph][1.9ct].  This is intended
7759   to make upgrades easier for large projects, by allowing crates to be
7760   forked temporarily until they've been upgraded and republished.
7761 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
7762 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
7763   on the commandline][1.9cf]. `rustc` arguments can also be specified
7764   in the `build.rustflags` configuration key.
7765
7766 Performance
7767 -----------
7768
7769 * [The time complexity of comparing variables for equivalence during type
7770   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
7771   to major compilation time improvement in some scenarios.
7772 * [`ToString` is specialized for `str`, giving it the same performance
7773   as `to_owned`][1.9ts].
7774 * [Spawning processes with `Command::output` no longer creates extra
7775   threads][1.9sp].
7776 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
7777   for C-like enums][1.9cl].
7778
7779 Misc
7780 ----
7781
7782 * [Passing the `--quiet` flag to a test runner will produce
7783   much-abbreviated output][1.9q].
7784 * The Rust Project now publishes std binaries for the
7785   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
7786   `i586-pc-windows-msvc` targets.
7787
7788 Compatibility Notes
7789 -------------------
7790
7791 * [`std::sync::Once` is poisoned if its initialization function
7792   fails][1.9o].
7793 * [It is illegal to define methods with the same name in overlapping
7794   inherent `impl` blocks][1.9sn].
7795 * [`fn` item types are zero sized, and each `fn` names a unique
7796   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7797   `transmute` on a `fn` type will generate a warning for a few cycles,
7798   then will be converted to an error.
7799 * [Improvements to const evaluation may trigger new errors when integer
7800   literals are out of range][1.9ce].
7801
7802
7803 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
7804 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
7805 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
7806 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
7807 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
7808 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
7809 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
7810 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
7811 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
7812 [1.9db]: https://github.com/rust-lang/rust/pull/32054
7813 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
7814 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
7815 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
7816 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
7817 [1.9o]: https://github.com/rust-lang/rust/pull/32325
7818 [1.9q]: https://github.com/rust-lang/rust/pull/31887
7819 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
7820 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
7821 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
7822 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
7823 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
7824 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
7825 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
7826 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
7827 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7828 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
7829 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7830 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
7831 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
7832 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
7833 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
7834 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
7835 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
7836 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
7837 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
7838 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
7839 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
7840 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
7841 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
7842 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
7843 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
7844 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
7845 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
7846 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
7847 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
7848 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
7849 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
7850 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
7851 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
7852 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
7853 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
7854 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
7855 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
7856 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
7857 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
7858 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
7859 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
7860 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
7861 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
7862 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
7863 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7864 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7865 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7866 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7867 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7868 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7869 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
7870 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7871 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
7872 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7873 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7874 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7875 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7876 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7877 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
7878 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
7879 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
7880 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
7881 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
7882 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
7883 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
7884 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
7885 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
7886 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
7887 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
7888 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
7889 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
7890 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
7891 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
7892 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
7893 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
7894 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
7895 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
7896 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
7897 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
7898 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
7899 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
7900 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
7901 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
7902 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
7903 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
7904 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
7905 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
7906 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
7907 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
7908 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
7909 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
7910 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
7911 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
7912 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
7913
7914
7915 Version 1.8.0 (2016-04-14)
7916 ==========================
7917
7918 Language
7919 --------
7920
7921 * Rust supports overloading of compound assignment statements like
7922   `+=` by implementing the [`AddAssign`], [`SubAssign`],
7923   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
7924   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
7925   traits. [RFC 953].
7926 * Empty structs can be defined with braces, as in `struct Foo { }`, in
7927   addition to the non-braced form, `struct Foo;`. [RFC 218].
7928
7929 Libraries
7930 ---------
7931
7932 * Stabilized APIs:
7933   * [`str::encode_utf16`] (renamed from `utf16_units`)
7934   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
7935   * [`Ref::map`]
7936   * [`RefMut::map`]
7937   * [`ptr::drop_in_place`]
7938   * [`time::Instant`]
7939   * [`time::SystemTime`]
7940   * [`Instant::now`]
7941   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
7942   * [`Instant::elapsed`]
7943   * [`SystemTime::now`]
7944   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
7945   * [`SystemTime::elapsed`]
7946   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
7947   * [`SystemTimeError`]
7948   * [`SystemTimeError::duration`]
7949   * Various impls for `SystemTimeError`
7950   * [`UNIX_EPOCH`]
7951   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
7952     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
7953     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
7954 * [The `write!` and `writeln!` macros correctly emit errors if any of
7955   their arguments can't be formatted][1.8w].
7956 * [Various I/O functions support large files on 32-bit Linux][1.8l].
7957 * [The Unix-specific `raw` modules, which contain a number of
7958   redefined C types are deprecated][1.8r], including `os::raw::unix`,
7959   `os::raw::macos`, and `os::raw::linux`. These modules defined types
7960   such as `ino_t` and `dev_t`. The inconsistency of these definitions
7961   across platforms was making it difficult to implement `std`
7962   correctly. Those that need these definitions should use the `libc`
7963   crate. [RFC 1415].
7964 * The Unix-specific `MetadataExt` traits, including
7965   `os::unix::fs::MetadataExt`, which expose values such as inode
7966   numbers [no longer return platform-specific types][1.8r], but
7967   instead return widened integers. [RFC 1415].
7968 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
7969 * [Atomic loads and stores are not volatile][1.8a].
7970 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
7971
7972 Performance
7973 -----------
7974
7975 * [Inlining hash functions lead to a 3% compile-time improvement in
7976   some workloads][1.8h].
7977 * When using jemalloc, its symbols are [unprefixed so that it
7978   overrides the libc malloc implementation][1.8h]. This means that for
7979   rustc, LLVM is now using jemalloc, which results in a 6%
7980   compile-time improvement on a specific workload.
7981 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
7982
7983 Misc
7984 ----
7985
7986 * [32-bit MSVC builds finally implement unwinding][1.8ms].
7987   i686-pc-windows-msvc is now considered a tier-1 platform.
7988 * [The `--print targets` flag prints a list of supported targets][1.8t].
7989 * [The `--print cfg` flag prints the `cfg`s defined for the current
7990   target][1.8cf].
7991 * [`rustc` can be built with an new Cargo-based build system, written
7992   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
7993   build system. To enable it configure with `configure --rustbuild`.
7994 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
7995   variants while also indicating the total number of missing variants
7996   if more than 3][1.8m].
7997 * [Executable stacks are disabled on Linux and BSD][1.8nx].
7998 * The Rust Project now publishes binary releases of the standard
7999   library for a number of tier-2 targets:
8000   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
8001   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
8002   `x86_64-rumprun-netbsd`. These can be installed with
8003   tools such as [multirust][1.8mr].
8004
8005 Cargo
8006 -----
8007
8008 * [`cargo init` creates a new Cargo project in the current
8009   directory][1.8ci].  It is otherwise like `cargo new`.
8010 * [Cargo has configuration keys for `-v` and
8011   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
8012   `[term]` section of `.cargo/config`.
8013 * [Configuration keys that evaluate to strings or integers can be set
8014   via environment variables][1.8ce]. For example the `build.jobs` key
8015   can be set via `CARGO_BUILD_JOBS`. Environment variables take
8016   precedence over config files.
8017 * [Target-specific dependencies support Rust `cfg` syntax for
8018   describing targets][1.8cfg] so that dependencies for multiple
8019   targets can be specified together. [RFC 1361].
8020 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
8021   `RUSTDOC` take precedence over the `build.target-dir`,
8022   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
8023 * [The child process tree is killed on Windows when Cargo is
8024   killed][1.8ck].
8025 * [The `build.target` configuration value sets the target platform,
8026   like `--target`][1.8ct].
8027
8028 Compatibility Notes
8029 -------------------
8030
8031 * [Unstable compiler flags have been further restricted][1.8u]. Since
8032   1.0 `-Z` flags have been considered unstable, and other flags that
8033   were considered unstable additionally required passing `-Z
8034   unstable-options` to access. Unlike unstable language and library
8035   features though, these options have been accessible on the stable
8036   release channel. Going forward, *new unstable flags will not be
8037   available on the stable release channel*, and old unstable flags
8038   will warn about their usage. In the future, all unstable flags will
8039   be unavailable on the stable release channel.
8040 * [It is no longer possible to `match` on empty enum variants using
8041   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
8042 * The Unix-specific `MetadataExt` traits, including
8043   `os::unix::fs::MetadataExt`, which expose values such as inode
8044   numbers [no longer return platform-specific types][1.8r], but
8045   instead return widened integers. [RFC 1415].
8046 * [Modules sourced from the filesystem cannot appear within arbitrary
8047   blocks, but only within other modules][1.8mf].
8048 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
8049 * On Unix, [stack overflow triggers a runtime abort instead of a
8050   SIGSEGV][1.8so].
8051 * [`Command::spawn` and its equivalents return an error if any of
8052   its command-line arguments contain interior `NUL`s][1.8n].
8053 * [Tuple and unit enum variants from other crates are in the type
8054   namespace][1.8tn].
8055 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
8056   type instead of `.a` files][1.8st]. Additionally, for the MSVC
8057   toolchain, `rustc` emits import libraries named `foo.dll.lib`
8058   instead of `foo.lib`.
8059
8060
8061 [1.8a]: https://github.com/rust-lang/rust/pull/30962
8062 [1.8b]: https://github.com/rust-lang/rust/pull/31123
8063 [1.8c]: https://github.com/rust-lang/rust/pull/31530
8064 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
8065 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
8066 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
8067 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
8068 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
8069 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
8070 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
8071 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
8072 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
8073 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
8074 [1.8h]: https://github.com/rust-lang/rust/pull/31460
8075 [1.8l]: https://github.com/rust-lang/rust/pull/31668
8076 [1.8m]: https://github.com/rust-lang/rust/pull/31020
8077 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
8078 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
8079 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
8080 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
8081 [1.8n]: https://github.com/rust-lang/rust/pull/31056
8082 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
8083 [1.8r]: https://github.com/rust-lang/rust/pull/31551
8084 [1.8so]: https://github.com/rust-lang/rust/pull/31333
8085 [1.8st]: https://github.com/rust-lang/rust/pull/29520
8086 [1.8t]: https://github.com/rust-lang/rust/pull/31358
8087 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
8088 [1.8u]: https://github.com/rust-lang/rust/pull/31793
8089 [1.8v]: https://github.com/rust-lang/rust/pull/31757
8090 [1.8w]: https://github.com/rust-lang/rust/pull/31904
8091 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
8092 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
8093 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
8094 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
8095 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
8096 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
8097 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
8098 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
8099 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
8100 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
8101 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
8102 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
8103 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
8104 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
8105 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
8106 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
8107 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
8108 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
8109 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
8110 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
8111 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
8112 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
8113 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
8114 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
8115 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
8116 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
8117 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
8118 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
8119 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
8120 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
8121
8122
8123 Version 1.7.0 (2016-03-03)
8124 ==========================
8125
8126 Libraries
8127 ---------
8128
8129 * Stabilized APIs
8130   * `Path`
8131     * [`Path::strip_prefix`] (renamed from relative_from)
8132     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
8133   * `Ipv4Addr`
8134     * [`Ipv4Addr::is_loopback`]
8135     * [`Ipv4Addr::is_private`]
8136     * [`Ipv4Addr::is_link_local`]
8137     * [`Ipv4Addr::is_multicast`]
8138     * [`Ipv4Addr::is_broadcast`]
8139     * [`Ipv4Addr::is_documentation`]
8140   * `Ipv6Addr`
8141     * [`Ipv6Addr::is_unspecified`]
8142     * [`Ipv6Addr::is_loopback`]
8143     * [`Ipv6Addr::is_multicast`]
8144   * `Vec`
8145     * [`Vec::as_slice`]
8146     * [`Vec::as_mut_slice`]
8147   * `String`
8148     * [`String::as_str`]
8149     * [`String::as_mut_str`]
8150   * Slices
8151     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
8152     be the same length
8153     * `<[T]>::`[`sort_by_key`]
8154   * checked, saturated, and overflowing operations
8155     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
8156     * [`i32::saturating_mul`]
8157     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
8158     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
8159     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
8160     * [`u32::saturating_mul`]
8161     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
8162     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
8163     * and checked, saturated, and overflowing operations for other primitive types
8164   * FFI
8165     * [`ffi::IntoStringError`]
8166     * [`CString::into_string`]
8167     * [`CString::into_bytes`]
8168     * [`CString::into_bytes_with_nul`]
8169     * `From<CString> for Vec<u8>`
8170   * `IntoStringError`
8171     * [`IntoStringError::into_cstring`]
8172     * [`IntoStringError::utf8_error`]
8173     * `Error for IntoStringError`
8174   * Hashing
8175     * [`std::hash::BuildHasher`]
8176     * [`BuildHasher::Hasher`]
8177     * [`BuildHasher::build_hasher`]
8178     * [`std::hash::BuildHasherDefault`]
8179     * [`HashMap::with_hasher`]
8180     * [`HashMap::with_capacity_and_hasher`]
8181     * [`HashSet::with_hasher`]
8182     * [`HashSet::with_capacity_and_hasher`]
8183     * [`std::collections::hash_map::RandomState`]
8184     * [`RandomState::new`]
8185 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
8186   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
8187   from bytes is faster.
8188 * [The performance of `LineWriter` (and thus `io::stdout`) was
8189   improved by using `memchr` to search for newlines][1.7m].
8190 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
8191   `f64` variants were stabilized previously.
8192 * [`BTreeMap` was rewritten to use less memory and improve the performance
8193   of insertion and iteration, the latter by as much as 5x][1.7bm].
8194 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
8195   covariant over their contained type][1.7bt].
8196 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
8197   over their contained type][1.7ll].
8198 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
8199   searching methods.
8200 * [`Any` is implemented for unsized types][1.7a].
8201 * [`Hash` is implemented for `Duration`][1.7h].
8202
8203 Misc
8204 ----
8205
8206 * [When running tests with `--test`, rustdoc will pass `--cfg`
8207   arguments to the compiler][1.7dt].
8208 * [The compiler is built with RPATH information by default][1.7rpa].
8209   This means that it will be possible to run `rustc` when installed in
8210   unusual configurations without configuring the dynamic linker search
8211   path explicitly.
8212 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
8213   any RPATH entries (emitted with `-C rpath`) *not* take precedence
8214   over `LD_LIBRARY_PATH`.
8215
8216 Cargo
8217 -----
8218
8219 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
8220   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
8221 * [The `rerun-if-changed` build script directive no longer causes the
8222   build script to incorrectly run twice in certain scenarios][1.7rr].
8223
8224 Compatibility Notes
8225 -------------------
8226
8227 * Soundness fixes to the interactions between associated types and
8228   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
8229   code that violates the new rules. This is a significant change that
8230   is known to break existing code, so it has emitted warnings for the
8231   new error cases since 1.4 to give crate authors time to adapt. The
8232   details of what is changing are subtle; read the RFC for more.
8233 * [Several bugs in the compiler's visibility calculations were
8234   fixed][1.7v]. Since this was found to break significant amounts of
8235   code, the new errors will be emitted as warnings for several release
8236   cycles, under the `private_in_public` lint.
8237 * Defaulted type parameters were accidentally accepted in positions
8238   that were not intended. In this release, [defaulted type parameters
8239   appearing outside of type definitions will generate a
8240   warning][1.7d], which will become an error in future releases.
8241 * [Parsing "." as a float results in an error instead of 0][1.7p].
8242   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
8243 * [Borrows of closure parameters may not outlive the closure][1.7bc].
8244
8245 [1.7a]: https://github.com/rust-lang/rust/pull/30928
8246 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
8247 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
8248 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
8249 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
8250 [1.7d]: https://github.com/rust-lang/rust/pull/30724
8251 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
8252 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
8253 [1.7f]: https://github.com/rust-lang/rust/pull/30672
8254 [1.7h]: https://github.com/rust-lang/rust/pull/30818
8255 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
8256 [1.7m]: https://github.com/rust-lang/rust/pull/30381
8257 [1.7p]: https://github.com/rust-lang/rust/pull/30681
8258 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
8259 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
8260 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
8261 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
8262 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
8263 [1.7v]: https://github.com/rust-lang/rust/pull/29973
8264 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8265 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8266 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
8267 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
8268 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
8269 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
8270 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
8271 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
8272 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
8273 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
8274 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
8275 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
8276 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
8277 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
8278 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
8279 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
8280 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
8281 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
8282 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
8283 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
8284 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
8285 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
8286 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
8287 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
8288 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
8289 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
8290 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
8291 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
8292 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
8293 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
8294 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
8295 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
8296 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
8297 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
8298 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
8299 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
8300 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
8301 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
8302 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
8303 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
8304 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
8305 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
8306 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
8307 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
8308 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
8309 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
8310 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
8311 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8312 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
8313 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8314 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
8315 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
8316 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
8317 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
8318 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
8319 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
8320 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
8321 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
8322 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
8323 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
8324
8325
8326 Version 1.6.0 (2016-01-21)
8327 ==========================
8328
8329 Language
8330 --------
8331
8332 * The `#![no_std]` attribute causes a crate to not be linked to the
8333   standard library, but only the [core library][1.6co], as described
8334   in [RFC 1184]. The core library defines common types and traits but
8335   has no platform dependencies whatsoever, and is the basis for Rust
8336   software in environments that cannot support a full port of the
8337   standard library, such as operating systems. Most of the core
8338   library is now stable.
8339
8340 Libraries
8341 ---------
8342
8343 * Stabilized APIs:
8344   [`Read::read_exact`],
8345   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
8346   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
8347   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
8348   [`os::unix::fs::DirBuilderExt`],
8349   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
8350   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
8351   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
8352   [`collections::hash_map::Drain`],
8353   [`collections::hash_map::HashMap::drain`],
8354   [`collections::hash_set::Drain`],
8355   [`collections::hash_set::HashSet::drain`],
8356   [`collections::binary_heap::Drain`],
8357   [`collections::binary_heap::BinaryHeap::drain`],
8358   [`Vec::extend_from_slice`] (renamed from `push_all`),
8359   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
8360   [`RwLock::into_inner`],
8361   [`Iterator::min_by_key`] (renamed from `min_by`),
8362   [`Iterator::max_by_key`] (renamed from `max_by`).
8363 * The [core library][1.6co] is stable, as are most of its APIs.
8364 * [The `assert_eq!` macro supports arguments that don't implement
8365   `Sized`][1.6ae], such as arrays. In this way it behaves more like
8366   `assert!`.
8367 * Several timer functions that take duration in milliseconds [are
8368   deprecated in favor of those that take `Duration`][1.6ms]. These
8369   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
8370   `thread::park_timeout_ms`.
8371 * The algorithm by which `Vec` reserves additional elements was
8372   [tweaked to not allocate excessive space][1.6a] while still growing
8373   exponentially.
8374 * `From` conversions are [implemented from integers to floats][1.6f]
8375   in cases where the conversion is lossless. Thus they are not
8376   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
8377   or `f64`. They are also not implemented for `isize` and `usize`
8378   because the implementations would be platform-specific. `From` is
8379   also implemented from `f32` to `f64`.
8380 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
8381 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
8382 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
8383 * [`BinaryHeap` was refactored][1.6bh] for modest performance
8384   improvements.
8385 * Sorting slices that are already sorted [is 50% faster in some
8386   cases][1.6s].
8387
8388 Cargo
8389 -----
8390
8391 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
8392 * Cargo build scripts can specify their dependencies by emitting the
8393   [`rerun-if-changed`][1.6rr] key.
8394 * crates.io will reject publication of crates with dependencies that
8395   have a wildcard version constraint. Crates with wildcard
8396   dependencies were seen to cause a variety of problems, as described
8397   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
8398   warning.
8399 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
8400   release folder.  A variety of artifacts that Cargo failed to clean
8401   are now correctly deleted.
8402
8403 Misc
8404 ----
8405
8406 * The `unreachable_code` lint [warns when a function call's argument
8407   diverges][1.6dv].
8408 * The parser indicates [failures that may be caused by
8409   confusingly-similar Unicode characters][1.6uc]
8410 * Certain macro errors [are reported at definition time][1.6m], not
8411   expansion.
8412
8413 Compatibility Notes
8414 -------------------
8415
8416 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
8417   environment variable when locating crates. This was a pre-cargo
8418   feature for integrating with the package manager that was
8419   accidentally never removed.
8420 * [A number of bugs were fixed in the privacy checker][1.6p] that
8421   could cause previously-accepted code to break.
8422 * [Modules and unit/tuple structs may not share the same name][1.6ts].
8423 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
8424   struct pattern syntax (`Foo(..)`) can no longer be used to match
8425   unit structs. This is a warning now, but will become an error in
8426   future releases. Patterns that share the same name as a const are
8427   now an error.
8428 * A bug was fixed that causes [rustc not to apply default type
8429   parameters][1.6xc] when resolving certain method implementations of
8430   traits defined in other crates.
8431
8432 [1.6a]: https://github.com/rust-lang/rust/pull/29454
8433 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
8434 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
8435 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
8436 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
8437 [1.6co]: http://doc.rust-lang.org/core/index.html
8438 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
8439 [1.6f]: https://github.com/rust-lang/rust/pull/29129
8440 [1.6m]: https://github.com/rust-lang/rust/pull/29828
8441 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
8442 [1.6p]: https://github.com/rust-lang/rust/pull/29726
8443 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
8444 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
8445 [1.6s]: https://github.com/rust-lang/rust/pull/29675
8446 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
8447 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
8448 [1.6us]: https://github.com/rust-lang/rust/pull/29383
8449 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
8450 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
8451 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8452 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
8453 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
8454 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
8455 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
8456 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
8457 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
8458 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
8459 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
8460 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
8461 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
8462 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
8463 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
8464 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
8465 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
8466 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
8467 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
8468 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
8469 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
8470 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
8471 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
8472 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
8473 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
8474 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
8475 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
8476 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
8477 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
8478 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
8479
8480
8481 Version 1.5.0 (2015-12-10)
8482 ==========================
8483
8484 * ~700 changes, numerous bugfixes
8485
8486 Highlights
8487 ----------
8488
8489 * Stabilized APIs:
8490   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
8491   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
8492   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
8493   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
8494   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
8495   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
8496   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
8497   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
8498   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
8499   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
8500   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
8501   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
8502   [`Path::read_link`], [`Path::symlink_metadata`],
8503   [`Utf8Error::valid_up_to`], [`Vec::resize`],
8504   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
8505   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
8506   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
8507   [`slice::split_first_mut`], [`slice::split_first`],
8508   [`slice::split_last_mut`], [`slice::split_last`],
8509   [`char::from_u32_unchecked`], [`fs::canonicalize`],
8510   [`str::MatchIndices`], [`str::RMatchIndices`],
8511   [`str::match_indices`], [`str::rmatch_indices`],
8512   [`str::slice_mut_unchecked`], [`string::ParseError`].
8513 * Rust applications hosted on crates.io can be installed locally to
8514   `~/.cargo/bin` with the [`cargo install`] command. Among other
8515   things this makes it easier to augment Cargo with new subcommands:
8516   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
8517   invoked as `cargo foo`.
8518 * Crates with wildcard (`*`) dependencies will [emit warnings when
8519   published][1.5w]. In 1.6 it will no longer be possible to publish
8520   crates with wildcard dependencies.
8521
8522 Breaking Changes
8523 ----------------
8524
8525 * The rules determining when a particular lifetime must outlive
8526   a particular value (known as '[dropck]') have been [modified
8527   to not rely on parametricity][1.5p].
8528 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
8529   and `Arc`][1.5a]. Because these smart pointer types implement
8530   `Deref`, this causes breakage in cases where the interior type
8531   contains methods of the same name.
8532 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
8533   that they could drop their content. Soundness fix.
8534 * All method invocations are [properly checked][1.5wf1] for
8535   [well-formedness][1.5wf2]. Soundness fix.
8536 * Traits whose supertraits contain `Self` are [not object
8537   safe][1.5o]. Soundness fix.
8538 * Target specifications support a [`no_default_libraries`][1.5nd]
8539   setting that controls whether `-nodefaultlibs` is passed to the
8540   linker, and in turn the `is_like_windows` setting no longer affects
8541   the `-nodefaultlibs` flag.
8542 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
8543 * The `#[inline]` and `#[repr]` attributes [can only appear
8544   in valid locations][1.5at].
8545 * Native libraries linked from the local crate are [passed to
8546   the linker before native libraries from upstream crates][1.5nl].
8547 * Two rarely-used attributes, `#[no_debug]` and
8548   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
8549 * Negation of unsigned integers, which has been a warning for
8550   several releases, [is now behind a feature gate and will
8551   generate errors][1.5nu].
8552 * The parser accidentally accepted visibility modifiers on
8553   enum variants, a bug [which has been fixed][1.5ev].
8554 * [A bug was fixed that allowed `use` statements to import unstable
8555   features][1.5use].
8556
8557 Language
8558 --------
8559
8560 * When evaluating expressions at compile-time that are not
8561   compile-time constants (const-evaluating expressions in non-const
8562   contexts), incorrect code such as overlong bitshifts and arithmetic
8563   overflow will [generate a warning instead of an error][1.5ce],
8564   delaying the error until runtime. This will allow the
8565   const-evaluator to be expanded in the future backwards-compatibly.
8566 * The `improper_ctypes` lint [no longer warns about using `isize` and
8567   `usize` in FFI][1.5ict].
8568
8569 Libraries
8570 ---------
8571
8572 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
8573   invariant][1.5c].
8574 * `Default` is [implemented for mutable slices][1.5d].
8575 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
8576 * There are now `From` conversions [between floating point
8577   types][1.5f] where the conversions are lossless.
8578 * There are now `From` conversions [between integer types][1.5i] where
8579   the conversions are lossless.
8580 * [`fs::Metadata` implements `Clone`][1.5fs].
8581 * The `parse` method [accepts a leading "+" when parsing
8582   integers][1.5pi].
8583 * [`AsMut` is implemented for `Vec`][1.5am].
8584 * The `clone_from` implementations for `String` and `BinaryHeap` [have
8585   been optimized][1.5cf] and no longer rely on the default impl.
8586 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
8587   `unsafe extern "C"` function types now [implement `Clone`,
8588   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
8589   `fmt::Debug` for up to 12 arguments][1.5fp].
8590 * [Dropping `Vec`s is much faster in unoptimized builds when the
8591   element types don't implement `Drop`][1.5dv].
8592 * A bug that caused in incorrect behavior when [combining `VecDeque`
8593   with zero-sized types][1.5vdz] was resolved.
8594 * [`PartialOrd` for slices is faster][1.5po].
8595
8596 Miscellaneous
8597 -------------
8598
8599 * [Crate metadata size was reduced by 20%][1.5md].
8600 * [Improvements to code generation reduced the size of libcore by 3.3
8601   MB and rustc's memory usage by 18MB][1.5m].
8602 * [Improvements to deref translation increased performance in
8603   unoptimized builds][1.5dr].
8604 * Various errors in trait resolution [are deduplicated to only be
8605   reported once][1.5te].
8606 * Rust has preliminary [support for rumprun kernels][1.5rr].
8607 * Rust has preliminary [support for NetBSD on amd64][1.5na].
8608
8609 [1.5use]: https://github.com/rust-lang/rust/pull/28364
8610 [1.5po]: https://github.com/rust-lang/rust/pull/28436
8611 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
8612 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
8613 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
8614 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
8615 [1.5md]: https://github.com/rust-lang/rust/pull/28521
8616 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
8617 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
8618 [1.5na]: https://github.com/rust-lang/rust/pull/28543
8619 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
8620 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
8621 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
8622 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
8623 [1.5te]: https://github.com/rust-lang/rust/pull/28645
8624 [1.5at]: https://github.com/rust-lang/rust/pull/28650
8625 [1.5am]: https://github.com/rust-lang/rust/pull/28663
8626 [1.5m]: https://github.com/rust-lang/rust/pull/28778
8627 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
8628 [1.5a]: https://github.com/rust-lang/rust/pull/28811
8629 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
8630 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
8631 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
8632 [1.5i]: https://github.com/rust-lang/rust/pull/28921
8633 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
8634 [1.5f]: https://github.com/rust-lang/rust/pull/29129
8635 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
8636 [1.5s]: https://github.com/rust-lang/rust/pull/29190
8637 [1.5d]: https://github.com/rust-lang/rust/pull/29245
8638 [1.5o]: https://github.com/rust-lang/rust/pull/29259
8639 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
8640 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8641 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
8642 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
8643 [1.5c]: https://github.com/rust-lang/rust/pull/29110
8644 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8645 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
8646 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
8647 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
8648 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
8649 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
8650 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
8651 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
8652 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
8653 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
8654 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
8655 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
8656 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
8657 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
8658 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
8659 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
8660 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
8661 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
8662 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
8663 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
8664 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
8665 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
8666 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
8667 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
8668 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
8669 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
8670 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
8671 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
8672 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
8673 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
8674 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
8675 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
8676 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
8677 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
8678 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
8679 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
8680 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
8681 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
8682 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
8683 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
8684 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
8685 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
8686 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
8687 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
8688 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
8689 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
8690 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
8691 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
8692 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
8693 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
8694 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
8695 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
8696 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
8697 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
8698
8699 Version 1.4.0 (2015-10-29)
8700 ==========================
8701
8702 * ~1200 changes, numerous bugfixes
8703
8704 Highlights
8705 ----------
8706
8707 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
8708   GNU) are now supported and recommended for use.
8709
8710 Breaking Changes
8711 ----------------
8712
8713 * [Several changes have been made to fix type soundness and improve
8714   the behavior of associated types][sound]. See [RFC 1214]. Although
8715   we have mostly introduced these changes as warnings this release, to
8716   become errors next release, there are still some scenarios that will
8717   see immediate breakage.
8718 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
8719   line breaks in addition to `\n`][crlf].
8720 * [Loans of `'static` lifetime extend to the end of a function][stat].
8721 * [`str::parse` no longer introduces avoidable rounding error when
8722   parsing floating point numbers. Together with earlier changes to
8723   float formatting/output, "round trips" like f.to_string().parse()
8724   now preserve the value of f exactly. Additionally, leading plus
8725   signs are now accepted][fp3].
8726
8727
8728 Language
8729 --------
8730
8731 * `use` statements that import multiple items [can now rename
8732   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
8733 * [Binops work correctly on fat pointers][binfat].
8734 * `pub extern crate`, which does not behave as expected, [issues a
8735   warning][pec] until a better solution is found.
8736
8737 Libraries
8738 ---------
8739
8740 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
8741   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
8742   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
8743   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
8744   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
8745   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
8746   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
8747   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
8748   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
8749   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
8750   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
8751   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
8752   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
8753   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
8754   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
8755   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
8756   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
8757   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
8758   [`thread::sleep`].
8759 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
8760   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
8761   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
8762   `f64::from_str_radix`.
8763 * [Reverse-searching strings is faster with the 'two-way'
8764   algorithm][s].
8765 * [`std::io::copy` allows `?Sized` arguments][cc].
8766 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
8767   [override `count`, `nth` and `last` with an *O*(1)
8768   implementation][it].
8769 * [`Default` is implemented for arrays up to `[T; 32]`][d].
8770 * [`IntoRawFd` has been added to the Unix-specific prelude,
8771   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
8772   prelude][pr].
8773 * [`Extend<String>` and `FromIterator<String` are both implemented for
8774   `String`][es].
8775 * [`IntoIterator` is implemented for references to `Option` and
8776   `Result`][into2].
8777 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
8778   Copy`][ext] as part of [RFC 839]. This will cause type inference
8779   breakage in rare situations.
8780 * [`BinaryHeap` implements `Debug`][bh2].
8781 * [`Borrow` and `BorrowMut` are implemented for fixed-size
8782   arrays][bm].
8783 * [`extern fn`s with the "Rust" and "C" ABIs implement common
8784   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
8785 * [String comparison is faster][faststr].
8786 * `&mut T` where `T: std::fmt::Write` [also implements
8787   `std::fmt::Write`][mutw].
8788 * [A stable regression in `VecDeque::push_back` and other
8789   capacity-altering methods that caused panics for zero-sized types
8790   was fixed][vd].
8791 * [Function pointers implement traits for up to 12 parameters][fp2].
8792
8793 Miscellaneous
8794 -------------
8795
8796 * The compiler [no longer uses the 'morestack' feature to prevent
8797   stack overflow][mm]. Instead it uses guard pages and stack
8798   probes (though stack probes are not yet implemented on any platform
8799   but Windows).
8800 * [The compiler matches traits faster when projections are involved][p].
8801 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
8802   `usize`][ffi].
8803 * [Cargo now displays useful information about what its doing during
8804   `cargo update`][cu].
8805
8806 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
8807 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
8808 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
8809 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
8810 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
8811 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
8812 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
8813 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
8814 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
8815 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
8816 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
8817 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
8818 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
8819 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
8820 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
8821 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
8822 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
8823 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
8824 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8825 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8826 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8827 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8828 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8829 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8830 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8831 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8832 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
8833 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
8834 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
8835 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
8836 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
8837 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
8838 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
8839 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
8840 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
8841 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
8842 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
8843 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
8844 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
8845 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
8846 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
8847 [bh2]: https://github.com/rust-lang/rust/pull/28156
8848 [binfat]: https://github.com/rust-lang/rust/pull/28270
8849 [bm]: https://github.com/rust-lang/rust/pull/28197
8850 [cc]: https://github.com/rust-lang/rust/pull/27531
8851 [crlf]: https://github.com/rust-lang/rust/pull/28034
8852 [cu]: https://github.com/rust-lang/cargo/pull/1931
8853 [d]: https://github.com/rust-lang/rust/pull/27825
8854 [dep]: https://github.com/rust-lang/rust/pull/28339
8855 [es]: https://github.com/rust-lang/rust/pull/27956
8856 [ext]: https://github.com/rust-lang/rust/pull/28094
8857 [faststr]: https://github.com/rust-lang/rust/pull/28338
8858 [ffi]: https://github.com/rust-lang/rust/pull/28779
8859 [fp]: https://github.com/rust-lang/rust/pull/28268
8860 [fp2]: https://github.com/rust-lang/rust/pull/28560
8861 [fp3]: https://github.com/rust-lang/rust/pull/27307
8862 [i]: https://github.com/rust-lang/rust/pull/27451
8863 [into2]: https://github.com/rust-lang/rust/pull/28039
8864 [it]: https://github.com/rust-lang/rust/pull/27652
8865 [mm]: https://github.com/rust-lang/rust/pull/27338
8866 [mutw]: https://github.com/rust-lang/rust/pull/28368
8867 [sound]: https://github.com/rust-lang/rust/pull/27641
8868 [p]: https://github.com/rust-lang/rust/pull/27866
8869 [pec]: https://github.com/rust-lang/rust/pull/28486
8870 [pr]: https://github.com/rust-lang/rust/pull/27896
8871 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8872 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8873 [s]: https://github.com/rust-lang/rust/pull/27474
8874 [stab]: https://github.com/rust-lang/rust/pull/28339
8875 [stat]: https://github.com/rust-lang/rust/pull/28321
8876 [vd]: https://github.com/rust-lang/rust/pull/28494
8877
8878 Version 1.3.0 (2015-09-17)
8879 ==============================
8880
8881 * ~900 changes, numerous bugfixes
8882
8883 Highlights
8884 ----------
8885
8886 * The [new object lifetime defaults][nold] have been [turned
8887   on][nold2] after a cycle of warnings about the change. Now types
8888   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
8889   being interpreted as `&'a Box<Trait+'a>` to `&'a
8890   Box<Trait+'static>`.
8891 * [The Rustonomicon][nom] is a new book in the official documentation
8892   that dives into writing unsafe Rust.
8893 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
8894   timekeeping is employed by other std APIs, as well as out-of-tree
8895   time crates.
8896
8897 Breaking Changes
8898 ----------------
8899
8900 * The [new object lifetime defaults][nold] have been [turned
8901   on][nold2] after a cycle of warnings about the change.
8902 * There is a known [regression][lr] in how object lifetime elision is
8903   interpreted, the proper solution for which is undetermined.
8904 * The `#[prelude_import]` attribute, an internal implementation
8905   detail, was accidentally stabilized previously. [It has been put
8906   behind the `prelude_import` feature gate][pi]. This change is
8907   believed to break no existing code.
8908 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8909   [more sane for dynamically sized types][dst3]. Code that relied on
8910   the previous behavior is thought to be broken.
8911 * The `dropck` rules, which checks that destructors can't access
8912   destroyed values, [have been updated][dropck] to match the
8913   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
8914   cause some previously-compiling code to no longer build.
8915
8916 Language
8917 --------
8918
8919 * The [new object lifetime defaults][nold] have been [turned
8920   on][nold2] after a cycle of warnings about the change.
8921 * Semicolons may [now follow types and paths in
8922   macros](https://github.com/rust-lang/rust/pull/27000).
8923 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8924   [more sane for dynamically sized types][dst3]. Code that relied on
8925   the previous behavior is not known to exist, and suspected to be
8926   broken.
8927 * `'static` variables [may now be recursive][st].
8928 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
8929   implementations correctly.
8930 * The `dropck` rules, which checks that destructors can't access
8931   destroyed values, [have been updated][dropck] to match the
8932   [RFC][dropckrfc].
8933
8934 Libraries
8935 ---------
8936
8937 * The [`Duration`] API, [has been stabilized][ds], as well as the
8938   `std::time` module, which presently contains only `Duration`.
8939 * `Box<str>` and `Box<[T]>` both implement `Clone`.
8940 * The owned C string, [`CString`], implements [`Borrow`] and the
8941   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
8942   these allow C strings to be borrowed and cloned in generic code.
8943 * [`CStr`] implements [`Debug`].
8944 * [`AtomicPtr`] implements [`Debug`].
8945 * [`Error`] trait objects [can be downcast to their concrete types][e]
8946   in many common configurations, using the [`is`], [`downcast`],
8947   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
8948   [`Any`] trait.
8949 * Searching for substrings now [employs the two-way algorithm][search]
8950   instead of doing a naive search. This gives major speedups to a
8951   number of methods, including [`contains`][sc], [`find`][sf],
8952   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
8953   [`ends_with`][sew] are also faster.
8954 * The performance of `PartialEq` for slices is [much faster][ps].
8955 * The [`Hash`] trait offers the default method, [`hash_slice`], which
8956   is overridden and optimized by the implementations for scalars.
8957 * The [`Hasher`] trait now has a number of specialized `write_*`
8958   methods for primitive types, for efficiency.
8959 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
8960   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
8961   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
8962   of [`std::error::Error::cause`][iec] also delegates to the inner
8963   error.
8964 * [`process::Child`][pc] gained the [`id`] method, which returns a
8965   `u32` representing the platform-specific process identifier.
8966 * The [`connect`] method on slices is deprecated, replaced by the new
8967   [`join`] method (note that both of these are on the *unstable*
8968   [`SliceConcatExt`] trait, but through the magic of the prelude are
8969   available to stable code anyway).
8970 * The [`Div`] operator is implemented for [`Wrapping`] types.
8971 * [`DerefMut` is implemented for `String`][dms].
8972 * Performance of SipHash (the default hasher for `HashMap`) is
8973   [better for long data][sh].
8974 * [`AtomicPtr`] implements [`Send`].
8975 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
8976   are now [specialized to use uninitialized buffers for increased
8977   performance][rte].
8978 * Lifetime parameters of foreign functions [are now resolved
8979   properly][f].
8980
8981 Misc
8982 ----
8983
8984 * Rust can now, with some coercion, [produce programs that run on
8985   Windows XP][xp], though XP is not considered a supported platform.
8986 * Porting Rust on Windows from the GNU toolchain to MSVC continues
8987   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
8988   recommended for use in 1.3, though should be fully-functional
8989   in the [64-bit 1.4 beta][b14].
8990 * On Fedora-based systems installation will [properly configure the
8991   dynamic linker][fl].
8992 * The compiler gained many new extended error descriptions, which can
8993   be accessed with the `--explain` flag.
8994 * The `dropck` pass, which checks that destructors can't access
8995   destroyed values, [has been rewritten][dropck]. This fixes some
8996   soundness holes, and as such will cause some previously-compiling
8997   code to no longer build.
8998 * `rustc` now uses [LLVM to write archive files where possible][ar].
8999   Eventually this will eliminate the compiler's dependency on the ar
9000   utility.
9001 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
9002   supported FreeBSD on x86_64).
9003 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
9004   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
9005   more strict.
9006 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
9007   will kill the process instead of leaking][nlp].
9008
9009 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
9010 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
9011 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
9012 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
9013 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
9014 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
9015 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
9016 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
9017 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
9018 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
9019 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
9020 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
9021 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
9022 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
9023 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
9024 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
9025 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
9026 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
9027 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
9028 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
9029 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
9030 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
9031 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
9032 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
9033 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
9034 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
9035 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
9036 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
9037 [ar]: https://github.com/rust-lang/rust/pull/26926
9038 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
9039 [dms]: https://github.com/rust-lang/rust/pull/26241
9040 [dropck]: https://github.com/rust-lang/rust/pull/27261
9041 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
9042 [ds]: https://github.com/rust-lang/rust/pull/26818
9043 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
9044 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
9045 [dst3]: https://github.com/rust-lang/rust/pull/27351
9046 [e]: https://github.com/rust-lang/rust/pull/24793
9047 [f]: https://github.com/rust-lang/rust/pull/26588
9048 [fb]: https://github.com/rust-lang/rust/pull/26959
9049 [fl]: https://github.com/rust-lang/rust-installer/pull/41
9050 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
9051 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
9052 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
9053 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
9054 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
9055 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
9056 [lic]: https://github.com/rust-lang/rust/pull/26583
9057 [lnu]: https://github.com/rust-lang/rust/pull/27026
9058 [lr]: https://github.com/rust-lang/rust/issues/27248
9059 [lum]: https://github.com/rust-lang/rust/pull/26378
9060 [lur]: https://github.com/rust-lang/rust/pull/26783
9061 [nlp]: https://github.com/rust-lang/rust/pull/27176
9062 [nold2]: https://github.com/rust-lang/rust/pull/27045
9063 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
9064 [nom]: http://doc.rust-lang.org/nightly/nomicon/
9065 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
9066 [pi]: https://github.com/rust-lang/rust/pull/26699
9067 [ps]: https://github.com/rust-lang/rust/pull/26884
9068 [rte]: https://github.com/rust-lang/rust/pull/26950
9069 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
9070 [search]: https://github.com/rust-lang/rust/pull/26327
9071 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
9072 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
9073 [sh]: https://github.com/rust-lang/rust/pull/27280
9074 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
9075 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
9076 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
9077 [st]: https://github.com/rust-lang/rust/pull/26630
9078 [win1]: https://github.com/rust-lang/rust/pull/26569
9079 [win2]: https://github.com/rust-lang/rust/pull/26741
9080 [win3]: https://github.com/rust-lang/rust/pull/26741
9081 [win4]: https://github.com/rust-lang/rust/pull/27210
9082 [xp]: https://github.com/rust-lang/rust/pull/26569
9083
9084 Version 1.2.0 (2015-08-07)
9085 ==========================
9086
9087 * ~1200 changes, numerous bugfixes
9088
9089 Highlights
9090 ----------
9091
9092 * [Dynamically-sized-type coercions][dst] allow smart pointer types
9093   like `Rc` to contain types without a fixed size, arrays and trait
9094   objects, finally enabling use of `Rc<[T]>` and completing the
9095   implementation of DST.
9096 * [Parallel codegen][parcodegen] is now working again, which can
9097   substantially speed up large builds in debug mode; It also gets
9098   another ~33% speedup when bootstrapping on a 4 core machine (using 8
9099   jobs). It's not enabled by default, but will be "in the near
9100   future". It can be activated with the `-C codegen-units=N` flag to
9101   `rustc`.
9102 * This is the first release with [experimental support for linking
9103   with the MSVC linker and lib C on Windows (instead of using the GNU
9104   variants via MinGW)][win]. It is yet recommended only for the most
9105   intrepid Rustaceans.
9106 * Benchmark compilations are showing a 30% improvement in
9107   bootstrapping over 1.1.
9108
9109 Breaking Changes
9110 ----------------
9111
9112 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
9113   unicode case mapping, which is a previously-planned change in
9114   behavior and considered a bugfix.
9115 * [`mem::align_of`] now specifies [the *minimum alignment* for
9116   T][align], which is usually the alignment programs are interested
9117   in, and the same value reported by clang's
9118   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
9119   break real code.
9120 * [The `#[packed]` attribute is no longer silently accepted by the
9121   compiler][packed]. This attribute did nothing and code that
9122   mentioned it likely did not work as intended.
9123 * Associated type defaults are [now behind the
9124   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
9125   defaults *did not work*, but could be mentioned syntactically. As
9126   such this breakage has minimal impact.
9127
9128 Language
9129 --------
9130
9131 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
9132   matching against dereferenceable values.
9133
9134 Libraries
9135 ---------
9136
9137 * The [`Extend`] trait, which grows a collection from an iterator, is
9138   implemented over iterators of references, for `String`, `Vec`,
9139   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
9140   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
9141 * The [`iter::once`] function returns an iterator that yields a single
9142   element, and [`iter::empty`] returns an iterator that yields no
9143   elements.
9144 * The [`matches`] and [`rmatches`] methods on `str` return iterators
9145   over substring matches.
9146 * [`Cell`] and [`RefCell`] both implement `Eq`.
9147 * A number of methods for wrapping arithmetic are added to the
9148   integral types, [`wrapping_div`], [`wrapping_rem`],
9149   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
9150   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
9151   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
9152   type.. It is illegal for the default arithmetic operations in Rust
9153   to overflow; the desire to wrap must be explicit.
9154 * The `{:#?}` formatting specifier [displays the alternate,
9155   pretty-printed][debugfmt] form of the `Debug` formatter. This
9156   feature was actually introduced prior to 1.0 with little
9157   fanfare.
9158 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
9159   for writing data to formatted strings, similar to [`io::Write`].
9160 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
9161   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
9162   are used by code generators to emit implementations of [`Debug`].
9163 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
9164   methods that convert case, following Unicode case mapping.
9165 * It is now easier to handle poisoned locks. The [`PoisonError`]
9166   type, returned by failing lock operations, exposes `into_inner`,
9167   `get_ref`, and `get_mut`, which all give access to the inner lock
9168   guard, and allow the poisoned lock to continue to operate. The
9169   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
9170   poisoned lock without attempting to take the lock.
9171 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
9172   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
9173   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
9174   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
9175   `ChildStderr`.
9176 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
9177   malformed input.
9178
9179 Misc
9180 ----
9181
9182 * `rustc` employs smarter heuristics for guessing at [typos].
9183 * `rustc` emits more efficient code for [no-op conversions between
9184   unsafe pointers][nop].
9185 * Fat pointers are now [passed in pairs of immediate arguments][fat],
9186   resulting in faster compile times and smaller code.
9187
9188 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
9189 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
9190 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
9191 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
9192 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
9193 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
9194 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
9195 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
9196 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
9197 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
9198 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
9199 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
9200 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
9201 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
9202 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
9203 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
9204 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
9205 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
9206 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
9207 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
9208 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
9209 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
9210 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
9211 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
9212 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
9213 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
9214 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
9215 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
9216 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
9217 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
9218 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
9219 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
9220 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
9221 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9222 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9223 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
9224 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
9225 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
9226 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
9227 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
9228 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
9229 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
9230 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
9231 [align]: https://github.com/rust-lang/rust/pull/25646
9232 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
9233 [typos]: https://github.com/rust-lang/rust/pull/26087
9234 [nop]: https://github.com/rust-lang/rust/pull/26336
9235 [fat]: https://github.com/rust-lang/rust/pull/26411
9236 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
9237 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
9238 [packed]: https://github.com/rust-lang/rust/pull/25541
9239 [ad]: https://github.com/rust-lang/rust/pull/27382
9240 [win]: https://github.com/rust-lang/rust/pull/25350
9241
9242 Version 1.1.0 (2015-06-25)
9243 =========================
9244
9245 * ~850 changes, numerous bugfixes
9246
9247 Highlights
9248 ----------
9249
9250 * The [`std::fs` module has been expanded][fs] to expand the set of
9251   functionality exposed:
9252   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
9253     don't incur a syscall on some platforms.
9254   * A `symlink_metadata` function has been added.
9255   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
9256     access to all underlying information.
9257 * The compiler now contains extended explanations of many errors. When an error
9258   with an explanation occurs the compiler suggests using the `--explain` flag
9259   to read the explanation. Error explanations are also [available online][err-index].
9260 * Thanks to multiple [improvements][sk] to [type checking][pre], as
9261   well as other work, the time to bootstrap the compiler decreased by
9262   32%.
9263
9264 Libraries
9265 ---------
9266
9267 * The [`str::split_whitespace`] method splits a string on unicode
9268   whitespace boundaries.
9269 * On both Windows and Unix, new extension traits provide conversion of
9270   I/O types to and from the underlying system handles. On Unix, these
9271   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
9272   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
9273   `TcpListener`, and `UpdSocket`. Further implementations for
9274   `std::process` will be stabilized later.
9275 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
9276   Windows, symlinks can be created with
9277   `std::os::windows::symlink_dir` and
9278   `std::os::windows::symlink_file`.
9279 * The `mpsc::Receiver` type can now be converted into an iterator with
9280   `into_iter` on the [`IntoIterator`] trait.
9281 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
9282   implementation of the [`From`] trait.
9283 * The `Debug` implementation for `RangeFull` [creates output that is
9284   more consistent with other implementations][rf].
9285 * [`Debug` is implemented for `File`][file].
9286 * The `Default` implementation for `Arc` [no longer requires `Sync +
9287   Send`][arc].
9288 * [The `Iterator` methods `count`, `nth`, and `last` have been
9289   overridden for slices to have *O*(1) performance instead of *O*(*n*)][si].
9290 * Incorrect handling of paths on Windows has been improved in both the
9291   compiler and the standard library.
9292 * [`AtomicPtr` gained a `Default` implementation][ap].
9293 * In accordance with Rust's policy on arithmetic overflow `abs` now
9294   [panics on overflow when debug assertions are enabled][abs].
9295 * The [`Cloned`] iterator, which was accidentally left unstable for
9296   1.0 [has been stabilized][c].
9297 * The [`Incoming`] iterator, which iterates over incoming TCP
9298   connections, and which was accidentally unnamable in 1.0, [is now
9299   properly exported][inc].
9300 * [`BinaryHeap`] no longer corrupts itself [when functions called by
9301   `sift_up` or `sift_down` panic][bh].
9302 * The [`split_off`] method of `LinkedList` [no longer corrupts
9303   the list in certain scenarios][ll].
9304
9305 Misc
9306 ----
9307
9308 * Type checking performance [has improved notably][sk] with
9309   [multiple improvements][pre].
9310 * The compiler [suggests code changes][ch] for more errors.
9311 * rustc and it's build system have experimental support for [building
9312   toolchains against MUSL][m] instead of glibc on Linux.
9313 * The compiler defines the `target_env` cfg value, which is used for
9314   distinguishing toolchains that are otherwise for the same
9315   platform. Presently this is set to `gnu` for common GNU Linux
9316   targets and for MinGW targets, and `musl` for MUSL Linux targets.
9317 * The [`cargo rustc`][crc] command invokes a build with custom flags
9318   to rustc.
9319 * [Android executables are always position independent][pie].
9320 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
9321   with `Drop`][drop].
9322
9323 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
9324 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9325 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9326 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
9327 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
9328 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
9329 [rf]: https://github.com/rust-lang/rust/pull/24491
9330 [err-index]: https://doc.rust-lang.org/error-index.html
9331 [sk]: https://github.com/rust-lang/rust/pull/24615
9332 [pre]: https://github.com/rust-lang/rust/pull/25323
9333 [file]: https://github.com/rust-lang/rust/pull/24598
9334 [ch]: https://github.com/rust-lang/rust/pull/24683
9335 [arc]: https://github.com/rust-lang/rust/pull/24695
9336 [si]: https://github.com/rust-lang/rust/pull/24701
9337 [ap]: https://github.com/rust-lang/rust/pull/24834
9338 [m]: https://github.com/rust-lang/rust/pull/24777
9339 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
9340 [crc]: https://github.com/rust-lang/cargo/pull/1568
9341 [pie]: https://github.com/rust-lang/rust/pull/24953
9342 [abs]: https://github.com/rust-lang/rust/pull/25441
9343 [c]: https://github.com/rust-lang/rust/pull/25496
9344 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
9345 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
9346 [inc]: https://github.com/rust-lang/rust/pull/25522
9347 [bh]: https://github.com/rust-lang/rust/pull/25856
9348 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
9349 [ll]: https://github.com/rust-lang/rust/pull/26022
9350 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
9351 [drop]: https://github.com/rust-lang/rust/pull/24935
9352
9353 Version 1.0.0 (2015-05-15)
9354 ========================
9355
9356 * ~1500 changes, numerous bugfixes
9357
9358 Highlights
9359 ----------
9360
9361 * The vast majority of the standard library is now `#[stable]`. It is
9362   no longer possible to use unstable features with a stable build of
9363   the compiler.
9364 * Many popular crates on [crates.io] now work on the stable release
9365   channel.
9366 * Arithmetic on basic integer types now [checks for overflow in debug
9367   builds][overflow].
9368
9369 Language
9370 --------
9371
9372 * Several [restrictions have been added to trait coherence][coh] in
9373   order to make it easier for upstream authors to change traits
9374   without breaking downstream code.
9375 * Digits of binary and octal literals are [lexed more eagerly][lex] to
9376   improve error messages and macro behavior. For example, `0b1234` is
9377   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
9378 * Trait bounds [are always invariant][inv], eliminating the need for
9379   the `PhantomFn` and `MarkerTrait` lang items, which have been
9380   removed.
9381 * ["-" is no longer a valid character in crate names][cr], the `extern crate
9382   "foo" as bar` syntax has been replaced with `extern crate foo as
9383   bar`, and Cargo now automatically translates "-" in *package* names
9384   to underscore for the crate name.
9385 * [Lifetime shadowing is an error][lt].
9386 * [`Send` no longer implies `'static`][send-rfc].
9387 * [UFCS now supports trait-less associated paths][moar-ufcs] like
9388   `MyType::default()`.
9389 * Primitive types [now have inherent methods][prim-inherent],
9390   obviating the need for extension traits like `SliceExt`.
9391 * Methods with `Self: Sized` in their `where` clause are [considered
9392   object-safe][self-sized], allowing many extension traits like
9393   `IteratorExt` to be merged into the traits they extended.
9394 * You can now [refer to associated types][assoc-where] whose
9395   corresponding trait bounds appear only in a `where` clause.
9396 * The final bits of [OIBIT landed][oibit-final], meaning that traits
9397   like `Send` and `Sync` are now library-defined.
9398 * A [Reflect trait][reflect] was introduced, which means that
9399   downcasting via the `Any` trait is effectively limited to concrete
9400   types. This helps retain the potentially-important "parametricity"
9401   property: generic code cannot behave differently for different type
9402   arguments except in minor ways.
9403 * The `unsafe_destructor` feature is now deprecated in favor of the
9404   [new `dropck`][dropck]. This change is a major reduction in unsafe
9405   code.
9406
9407 Libraries
9408 ---------
9409
9410 * The `thread_local` module [has been renamed to `std::thread`][th].
9411 * The methods of `IteratorExt` [have been moved to the `Iterator`
9412   trait itself][ie].
9413 * Several traits that implement Rust's conventions for type
9414   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
9415   [centralized in the `std::convert` module][con].
9416 * The `FromError` trait [was removed in favor of `From`][fe].
9417 * The basic sleep function [has moved to
9418   `std::thread::sleep_ms`][slp].
9419 * The `splitn` function now takes an `n` parameter that represents the
9420   number of items yielded by the returned iterator [instead of the
9421   number of 'splits'][spl].
9422 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
9423 * [Derived implementations of `PartialOrd` now order enums according
9424   to their explicitly-assigned discriminants][po].
9425 * [Methods for searching strings are generic over `Pattern`s][pat],
9426   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
9427   some others.
9428 * [In method resolution, object methods are resolved before inherent
9429   methods][meth].
9430 * [`String::from_str` has been deprecated in favor of the `From` impl,
9431   `String::from`][sf].
9432 * [`io::Error` implements `Sync`][ios].
9433 * [The `words` method on `&str` has been replaced with
9434   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
9435   a word?'
9436 * The new path and IO modules are complete and `#[stable]`. This
9437   was the major library focus for this cycle.
9438 * The path API was [revised][path-normalize] to normalize `.`,
9439   adjusting the tradeoffs in favor of the most common usage.
9440 * A large number of remaining APIs in `std` were also stabilized
9441   during this cycle; about 75% of the non-deprecated API surface
9442   is now stable.
9443 * The new [string pattern API][string-pattern] landed, which makes
9444   the string slice API much more internally consistent and flexible.
9445 * A new set of [generic conversion traits][conversion] replaced
9446   many existing ad hoc traits.
9447 * Generic numeric traits were [completely removed][num-traits]. This
9448   was made possible thanks to inherent methods for primitive types,
9449   and the removal gives maximal flexibility for designing a numeric
9450   hierarchy in the future.
9451 * The `Fn` traits are now related via [inheritance][fn-inherit]
9452   and provide ergonomic [blanket implementations][fn-blanket].
9453 * The `Index` and `IndexMut` traits were changed to
9454   [take the index by value][index-value], enabling code like
9455   `hash_map["string"]` to work.
9456 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
9457   `Copy` data is known to be `Clone` as well.
9458
9459 Misc
9460 ----
9461
9462 * Many errors now have extended explanations that can be accessed with
9463   the `--explain` flag to `rustc`.
9464 * Many new examples have been added to the standard library
9465   documentation.
9466 * rustdoc has received a number of improvements focused on completion
9467   and polish.
9468 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
9469 * Much headway was made on ecosystem-wide CI, making it possible
9470   to [compare builds for breakage][ci-compare].
9471
9472
9473 [crates.io]: http://crates.io
9474 [clo]: https://github.com/rust-lang/rust/pull/24034
9475 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
9476 [con]: https://github.com/rust-lang/rust/pull/23875
9477 [cr]: https://github.com/rust-lang/rust/pull/23419
9478 [fe]: https://github.com/rust-lang/rust/pull/23879
9479 [ie]: https://github.com/rust-lang/rust/pull/23300
9480 [inv]: https://github.com/rust-lang/rust/pull/23938
9481 [ios]: https://github.com/rust-lang/rust/pull/24133
9482 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
9483 [lt]: https://github.com/rust-lang/rust/pull/24057
9484 [meth]: https://github.com/rust-lang/rust/pull/24056
9485 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
9486 [po]: https://github.com/rust-lang/rust/pull/24270
9487 [sf]: https://github.com/rust-lang/rust/pull/24517
9488 [slp]: https://github.com/rust-lang/rust/pull/23949
9489 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
9490 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
9491 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
9492 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
9493 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
9494 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
9495 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
9496 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
9497 [self-sized]: https://github.com/rust-lang/rust/pull/22301
9498 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
9499 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
9500 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
9501 [reflect]: https://github.com/rust-lang/rust/pull/23712
9502 [conversion]: https://github.com/rust-lang/rfcs/pull/529
9503 [num-traits]: https://github.com/rust-lang/rust/pull/23549
9504 [index-value]: https://github.com/rust-lang/rust/pull/23601
9505 [dropck]: https://github.com/rust-lang/rfcs/pull/769
9506 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
9507 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
9508 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
9509 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
9510 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
9511
9512
9513 Version 1.0.0-alpha.2 (2015-02-20)
9514 =====================================
9515
9516 * ~1300 changes, numerous bugfixes
9517
9518 * Highlights
9519
9520     * The various I/O modules were [overhauled][io-rfc] to reduce
9521       unnecessary abstractions and provide better interoperation with
9522       the underlying platform. The old `io` module remains temporarily
9523       at `std::old_io`.
9524     * The standard library now [participates in feature gating][feat],
9525       so use of unstable libraries now requires a `#![feature(...)]`
9526       attribute. The impact of this change is [described on the
9527       forum][feat-forum]. [RFC][feat-rfc].
9528
9529 * Language
9530
9531     * `for` loops [now operate on the `IntoIterator` trait][into],
9532       which eliminates the need to call `.iter()`, etc. to iterate
9533       over collections. There are some new subtleties to remember
9534       though regarding what sort of iterators various types yield, in
9535       particular that `for foo in bar { }` yields values from a move
9536       iterator, destroying the original collection. [RFC][into-rfc].
9537     * Objects now have [default lifetime bounds][obj], so you don't
9538       have to write `Box<Trait+'static>` when you don't care about
9539       storing references. [RFC][obj-rfc].
9540     * In types that implement `Drop`, [lifetimes must outlive the
9541       value][drop]. This will soon make it possible to safely
9542       implement `Drop` for types where `#[unsafe_destructor]` is now
9543       required. Read the [gorgeous RFC][drop-rfc] for details.
9544     * The fully qualified <T as Trait>::X syntax lets you set the Self
9545       type for a trait method or associated type. [RFC][ufcs-rfc].
9546     * References to types that implement `Deref<U>` now [automatically
9547       coerce to references][deref] to the dereferenced type `U`,
9548       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
9549       should eliminate many unsightly uses of `&*`, as when converting
9550       from references to vectors into references to
9551       slices. [RFC][deref-rfc].
9552     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
9553       `|:|`) is obsolete and closure kind is inferred from context.
9554     * [`Self` is a keyword][Self].
9555
9556 * Libraries
9557
9558     * The `Show` and `String` formatting traits [have been
9559       renamed][fmt] to `Debug` and `Display` to more clearly reflect
9560       their related purposes. Automatically getting a string
9561       conversion to use with `format!("{:?}", something_to_debug)` is
9562       now written `#[derive(Debug)]`.
9563     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
9564       OsStr}`, provide strings in platform-specific encodings for easier
9565       interop with system APIs. [RFC][osstr-rfc].
9566     * The `boxed::into_raw` and `Box::from_raw` functions [convert
9567       between `Box<T>` and `*mut T`][boxraw], a common pattern for
9568       creating raw pointers.
9569
9570 * Tooling
9571
9572     * Certain long error messages of the form 'expected foo found bar'
9573       are now [split neatly across multiple
9574       lines][multiline]. Examples in the PR.
9575     * On Unix Rust can be [uninstalled][un] by running
9576       `/usr/local/lib/rustlib/uninstall.sh`.
9577     * The `#[rustc_on_unimplemented]` attribute, requiring the
9578       'on_unimplemented' feature, lets rustc [display custom error
9579       messages when a trait is expected to be implemented for a type
9580       but is not][onun].
9581
9582 * Misc
9583
9584     * Rust is tested against a [LALR grammar][lalr], which parses
9585       almost all the Rust files that rustc does.
9586
9587 [boxraw]: https://github.com/rust-lang/rust/pull/21318
9588 [close]: https://github.com/rust-lang/rust/pull/21843
9589 [deref]: https://github.com/rust-lang/rust/pull/21351
9590 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
9591 [drop]: https://github.com/rust-lang/rust/pull/21972
9592 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
9593 [feat]: https://github.com/rust-lang/rust/pull/21248
9594 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
9595 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
9596 [fmt]: https://github.com/rust-lang/rust/pull/21457
9597 [into]: https://github.com/rust-lang/rust/pull/20790
9598 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
9599 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9600 [lalr]: https://github.com/rust-lang/rust/pull/21452
9601 [multiline]: https://github.com/rust-lang/rust/pull/19870
9602 [obj]: https://github.com/rust-lang/rust/pull/22230
9603 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
9604 [onun]: https://github.com/rust-lang/rust/pull/20889
9605 [osstr]: https://github.com/rust-lang/rust/pull/21488
9606 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9607 [Self]: https://github.com/rust-lang/rust/pull/22158
9608 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
9609 [un]: https://github.com/rust-lang/rust/pull/22256
9610
9611
9612 Version 1.0.0-alpha (2015-01-09)
9613 ==================================
9614
9615   * ~2400 changes, numerous bugfixes
9616
9617   * Highlights
9618
9619     * The language itself is considered feature complete for 1.0,
9620       though there will be many usability improvements and bugfixes
9621       before the final release.
9622     * Nearly 50% of the public API surface of the standard library has
9623       been declared 'stable'. Those interfaces are unlikely to change
9624       before 1.0.
9625     * The long-running debate over integer types has been
9626       [settled][ints]: Rust will ship with types named `isize` and
9627       `usize`, rather than `int` and `uint`, for pointer-sized
9628       integers. Guidelines will be rolled out during the alpha cycle.
9629     * Most crates that are not `std` have been moved out of the Rust
9630       distribution into the Cargo ecosystem so they can evolve
9631       separately and don't need to be stabilized as quickly, including
9632       'time', 'getopts', 'num', 'regex', and 'term'.
9633     * Documentation continues to be expanded with more API coverage, more
9634       examples, and more in-depth explanations. The guides have been
9635       consolidated into [The Rust Programming Language][trpl].
9636     * "[Rust By Example][rbe]" is now maintained by the Rust team.
9637     * All official Rust binary installers now come with [Cargo], the
9638       Rust package manager.
9639
9640 * Language
9641
9642     * Closures have been [completely redesigned][unboxed] to be
9643       implemented in terms of traits, can now be used as generic type
9644       bounds and thus monomorphized and inlined, or via an opaque
9645       pointer (boxed) as in the old system. The new system is often
9646       referred to as 'unboxed' closures.
9647     * Traits now support [associated types][assoc], allowing families
9648       of related types to be defined together and used generically in
9649       powerful ways.
9650     * Enum variants are [namespaced by their type names][enum].
9651     * [`where` clauses][where] provide a more versatile and attractive
9652       syntax for specifying generic bounds, though the previous syntax
9653       remains valid.
9654     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
9655       numeric types.
9656     * Rust [no longer has a runtime][rt] of any description, and only
9657       supports OS threads, not green threads.
9658     * At long last, Rust has been overhauled for 'dynamically-sized
9659       types' ([DST]), which integrates 'fat pointers' (object types,
9660       arrays, and `str`) more deeply into the type system, making it
9661       more consistent.
9662     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
9663       `..j` that produce range types and which, when combined with the
9664       `Index` operator and multidispatch, leads to a convenient slice
9665       notation, `[i..j]`.
9666     * The new range syntax revealed an ambiguity in the fixed-length
9667       array syntax, so now fixed length arrays [are written `[T;
9668       N]`][arrays].
9669     * The `Copy` trait is no longer implemented automatically. Unsafe
9670       pointers no longer implement `Sync` and `Send` so types
9671       containing them don't automatically either. `Sync` and `Send`
9672       are now 'unsafe traits' so one can "forcibly" implement them via
9673       `unsafe impl` if a type confirms to the requirements for them
9674       even though the internals do not (e.g. structs containing unsafe
9675       pointers like `Arc`). These changes are intended to prevent some
9676       footguns and are collectively known as [opt-in built-in
9677       traits][oibit] (though `Sync` and `Send` will soon become pure
9678       library types unknown to the compiler).
9679     * Operator traits now take their operands [by value][ops], and
9680       comparison traits can use multidispatch to compare one type
9681       against multiple other types, allowing e.g. `String` to be
9682       compared with `&str`.
9683     * `if let` and `while let` are no longer feature-gated.
9684     * Rust has adopted a more [uniform syntax for escaping unicode
9685       characters][unicode].
9686     * `macro_rules!` [has been declared stable][mac]. Though it is a
9687       flawed system it is sufficiently popular that it must be usable
9688       for 1.0. Effort has gone into [future-proofing][mac-future] it
9689       in ways that will allow other macro systems to be developed in
9690       parallel, and won't otherwise impact the evolution of the
9691       language.
9692     * The prelude has been [pared back significantly][prelude] such
9693       that it is the minimum necessary to support the most pervasive
9694       code patterns, and through [generalized where clauses][where]
9695       many of the prelude extension traits have been consolidated.
9696     * Rust's rudimentary reflection [has been removed][refl], as it
9697       incurred too much code generation for little benefit.
9698     * [Struct variants][structvars] are no longer feature-gated.
9699     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
9700       known as 'higher-ranked trait bounds', this crucially allows
9701       unboxed closures to work.
9702     * Macros invocations surrounded by parens or square brackets and
9703       not terminated by a semicolon are [parsed as
9704       expressions][macros], which makes expressions like `vec![1i32,
9705       2, 3].len()` work as expected.
9706     * Trait objects now implement their traits automatically, and
9707       traits that can be coerced to objects now must be [object
9708       safe][objsafe].
9709     * Automatically deriving traits is now done with `#[derive(...)]`
9710       not `#[deriving(...)]` for [consistency with other naming
9711       conventions][derive].
9712     * Importing the containing module or enum at the same time as
9713       items or variants they contain is [now done with `self` instead
9714       of `mod`][self], as in use `foo::{self, bar}`
9715     * Glob imports are no longer feature-gated.
9716     * The `box` operator and `box` patterns have been feature-gated
9717       pending a redesign. For now unique boxes should be allocated
9718       like other containers, with `Box::new`.
9719
9720 * Libraries
9721
9722     * A [series][coll1] of [efforts][coll2] to establish
9723       [conventions][coll3] for collections types has resulted in API
9724       improvements throughout the standard library.
9725     * New [APIs for error handling][err] provide ergonomic interop
9726       between error types, and [new conventions][err-conv] describe
9727       more clearly the recommended error handling strategies in Rust.
9728     * The `fail!` macro has been renamed to [`panic!`][panic] so that
9729       it is easier to discuss failure in the context of error handling
9730       without making clarifications as to whether you are referring to
9731       the 'fail' macro or failure more generally.
9732     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
9733       syscall when available.
9734     * The 'serialize' crate has been renamed 'rustc-serialize' and
9735       moved out of the distribution to Cargo. Although it is widely
9736       used now, it is expected to be superseded in the near future.
9737     * The `Show` formatter, typically implemented with
9738       `#[derive(Show)]` is [now requested with the `{:?}`
9739       specifier][show] and is intended for use by all types, for uses
9740       such as `println!` debugging. The new `String` formatter must be
9741       implemented by hand, uses the `{}` specifier, and is intended
9742       for full-fidelity conversions of things that can logically be
9743       represented as strings.
9744
9745 * Tooling
9746
9747     * [Flexible target specification][flex] allows rustc's code
9748       generation to be configured to support otherwise-unsupported
9749       platforms.
9750     * Rust comes with rust-gdb and rust-lldb scripts that launch their
9751       respective debuggers with Rust-appropriate pretty-printing.
9752     * The Windows installation of Rust is distributed with the
9753       MinGW components currently required to link binaries on that
9754       platform.
9755
9756 * Misc
9757
9758     * Nullable enum optimizations have been extended to more types so
9759       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
9760       space than the inner types themselves.
9761     * Work has begun on supporting AArch64.
9762
9763 [Cargo]: https://crates.io
9764 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
9765 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
9766 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
9767 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
9768 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
9769 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
9770 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
9771 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
9772 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
9773 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
9774 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
9775 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
9776 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
9777 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
9778 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
9779 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
9780 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
9781 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
9782 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
9783 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
9784 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
9785 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
9786 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
9787 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
9788 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
9789 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
9790 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
9791 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
9792 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
9793 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
9794 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
9795 [trpl]: https://doc.rust-lang.org/book/index.html
9796 [rbe]: http://rustbyexample.com/
9797
9798
9799 Version 0.12.0 (2014-10-09)
9800 =============================
9801
9802   * ~1900 changes, numerous bugfixes
9803
9804   * Highlights
9805
9806     * The introductory documentation (now called The Rust Guide) has
9807       been completely rewritten, as have a number of supplementary
9808       guides.
9809     * Rust's package manager, Cargo, continues to improve and is
9810       sometimes considered to be quite awesome.
9811     * Many API's in `std` have been reviewed and updated for
9812       consistency with the in-development Rust coding
9813       guidelines. The standard library documentation tracks
9814       stabilization progress.
9815     * Minor libraries have been moved out-of-tree to the rust-lang org
9816       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
9817       be installed with Cargo.
9818     * Lifetime elision allows lifetime annotations to be left off of
9819       function declarations in many common scenarios.
9820     * Rust now works on 64-bit Windows.
9821
9822   * Language
9823     * Indexing can be overloaded with the `Index` and `IndexMut`
9824       traits.
9825     * The `if let` construct takes a branch only if the `let` pattern
9826       matches, currently behind the 'if_let' feature gate.
9827     * 'where clauses', a more flexible syntax for specifying trait
9828       bounds that is more aesthetic, have been added for traits and
9829       free functions. Where clauses will in the future make it
9830       possible to constrain associated types, which would be
9831       impossible with the existing syntax.
9832     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
9833       the 'slicing_syntax' feature gate, and can be overloaded with
9834       the `Slice` or `SliceMut` traits.
9835     * The syntax for matching of sub-slices has been changed to use a
9836       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
9837       consistency with other uses of `..` and to future-proof
9838       potential additional uses of the syntax.
9839     * The syntax for matching inclusive ranges in patterns has changed
9840       from `0..3` to `0...4` to be consistent with the exclusive range
9841       syntax for slicing.
9842     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
9843       c]`) has been put behind the 'advanced_slice_patterns' feature
9844       gate and may be removed in the future.
9845     * Components of tuples and tuple structs can be extracted using
9846       the `value.0` syntax, currently behind the `tuple_indexing`
9847       feature gate.
9848     * The `#[crate_id]` attribute is no longer supported; versioning
9849       is handled by the package manager.
9850     * Renaming crate imports are now written `extern crate foo as bar`
9851       instead of `extern crate bar = foo`.
9852     * Renaming use statements are now written `use foo as bar` instead
9853       of `use bar = foo`.
9854     * `let` and `match` bindings and argument names in macros are now
9855       hygienic.
9856     * The new, more efficient, closure types ('unboxed closures') have
9857       been added under a feature gate, 'unboxed_closures'. These will
9858       soon replace the existing closure types, once higher-ranked
9859       trait lifetimes are added to the language.
9860     * `move` has been added as a keyword, for indicating closures
9861       that capture by value.
9862     * Mutation and assignment is no longer allowed in pattern guards.
9863     * Generic structs and enums can now have trait bounds.
9864     * The `Share` trait is now called `Sync` to free up the term
9865       'shared' to refer to 'shared reference' (the default reference
9866       type.
9867     * Dynamically-sized types have been mostly implemented,
9868       unifying the behavior of fat-pointer types with the rest of the
9869       type system.
9870     * As part of dynamically-sized types, the `Sized` trait has been
9871       introduced, which qualifying types implement by default, and
9872       which type parameters expect by default. To specify that a type
9873       parameter does not need to be sized, write `<Sized? T>`. Most
9874       types are `Sized`, notable exceptions being unsized arrays
9875       (`[T]`) and trait types.
9876     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
9877     * Lifetime bounds can now be applied to type parameters and object
9878       types.
9879     * The old, reference counted GC type, `Gc<T>` which was once
9880       denoted by the `@` sigil, has finally been removed. GC will be
9881       revisited in the future.
9882
9883   * Libraries
9884     * Library documentation has been improved for a number of modules.
9885     * Bit-vectors, collections::bitv has been modernized.
9886     * The url crate is deprecated in favor of
9887       http://github.com/servo/rust-url, which can be installed with
9888       Cargo.
9889     * Most I/O stream types can be cloned and subsequently closed from
9890       a different thread.
9891     * A `std::time::Duration` type has been added for use in I/O
9892       methods that rely on timers, as well as in the 'time' crate's
9893       `Timespec` arithmetic.
9894     * The runtime I/O abstraction layer that enabled the green thread
9895       scheduler to do non-thread-blocking I/O has been removed, along
9896       with the libuv-based implementation employed by the green thread
9897       scheduler. This will greatly simplify the future I/O work.
9898     * `collections::btree` has been rewritten to have a more
9899       idiomatic and efficient design.
9900
9901   * Tooling
9902     * rustdoc output now indicates the stability levels of API's.
9903     * The `--crate-name` flag can specify the name of the crate
9904       being compiled, like `#[crate_name]`.
9905     * The `-C metadata` specifies additional metadata to hash into
9906       symbol names, and `-C extra-filename` specifies additional
9907       information to put into the output filename, for use by the
9908       package manager for versioning.
9909     * debug info generation has continued to improve and should be
9910       more reliable under both gdb and lldb.
9911     * rustc has experimental support for compiling in parallel
9912       using the `-C codegen-units` flag.
9913     * rustc no longer encodes rpath information into binaries by
9914       default.
9915
9916   * Misc
9917     * Stack usage has been optimized with LLVM lifetime annotations.
9918     * Official Rust binaries on Linux are more compatible with older
9919       kernels and distributions, built on CentOS 5.10.
9920
9921
9922 Version 0.11.0 (2014-07-02)
9923 ==========================
9924
9925   * ~1700 changes, numerous bugfixes
9926
9927   * Language
9928     * ~[T] has been removed from the language. This type is superseded by
9929       the Vec<T> type.
9930     * ~str has been removed from the language. This type is superseded by
9931       the String type.
9932     * ~T has been removed from the language. This type is superseded by the
9933       Box<T> type.
9934     * @T has been removed from the language. This type is superseded by the
9935       standard library's std::gc::Gc<T> type.
9936     * Struct fields are now all private by default.
9937     * Vector indices and shift amounts are both required to be a `uint`
9938       instead of any integral type.
9939     * Byte character, byte string, and raw byte string literals are now all
9940       supported by prefixing the normal literal with a `b`.
9941     * Multiple ABIs are no longer allowed in an ABI string
9942     * The syntax for lifetimes on closures/procedures has been tweaked
9943       slightly: `<'a>|A, B|: 'b + K -> T`
9944     * Floating point modulus has been removed from the language; however it
9945       is still provided by a library implementation.
9946     * Private enum variants are now disallowed.
9947     * The `priv` keyword has been removed from the language.
9948     * A closure can no longer be invoked through a &-pointer.
9949     * The `use foo, bar, baz;` syntax has been removed from the language.
9950     * The transmute intrinsic no longer works on type parameters.
9951     * Statics now allow blocks/items in their definition.
9952     * Trait bounds are separated from objects with + instead of : now.
9953     * Objects can no longer be read while they are mutably borrowed.
9954     * The address of a static is now marked as insignificant unless the
9955       #[inline(never)] attribute is placed it.
9956     * The #[unsafe_destructor] attribute is now behind a feature gate.
9957     * Struct literals are no longer allowed in ambiguous positions such as
9958       if, while, match, and for..in.
9959     * Declaration of lang items and intrinsics are now feature-gated by
9960       default.
9961     * Integral literals no longer default to `int`, and floating point
9962       literals no longer default to `f64`. Literals must be suffixed with an
9963       appropriate type if inference cannot determine the type of the
9964       literal.
9965     * The Box<T> type is no longer implicitly borrowed to &mut T.
9966     * Procedures are now required to not capture borrowed references.
9967
9968   * Libraries
9969     * The standard library is now a "facade" over a number of underlying
9970       libraries. This means that development on the standard library should
9971       be speedier due to smaller crates, as well as a clearer line between
9972       all dependencies.
9973     * A new library, libcore, lives under the standard library's facade
9974       which is Rust's "0-assumption" library, suitable for embedded and
9975       kernel development for example.
9976     * A regex crate has been added to the standard distribution. This crate
9977       includes statically compiled regular expressions.
9978     * The unwrap/unwrap_err methods on Result require a Show bound for
9979       better error messages.
9980     * The return types of the std::comm primitives have been centralized
9981       around the Result type.
9982     * A number of I/O primitives have gained the ability to time out their
9983       operations.
9984     * A number of I/O primitives have gained the ability to close their
9985       reading/writing halves to cancel pending operations.
9986     * Reverse iterator methods have been removed in favor of `rev()` on
9987       their forward-iteration counterparts.
9988     * A bitflags! macro has been added to enable easy interop with C and
9989       management of bit flags.
9990     * A debug_assert! macro is now provided which is disabled when
9991       `--cfg ndebug` is passed to the compiler.
9992     * A graphviz crate has been added for creating .dot files.
9993     * The std::cast module has been migrated into std::mem.
9994     * The std::local_data api has been migrated from freestanding functions
9995       to being based on methods.
9996     * The Pod trait has been renamed to Copy.
9997     * jemalloc has been added as the default allocator for types.
9998     * The API for allocating memory has been changed to use proper alignment
9999       and sized deallocation
10000     * Connecting a TcpStream or binding a TcpListener is now based on a
10001       string address and a u16 port. This allows connecting to a hostname as
10002       opposed to an IP.
10003     * The Reader trait now contains a core method, read_at_least(), which
10004       correctly handles many repeated 0-length reads.
10005     * The process-spawning API is now centered around a builder-style
10006       Command struct.
10007     * The :? printing qualifier has been moved from the standard library to
10008       an external libdebug crate.
10009     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
10010       have been renamed to Eq/Ord.
10011     * The select/plural methods have been removed from format!. The escapes
10012       for { and } have also changed from \{ and \} to {{ and }},
10013       respectively.
10014     * The TaskBuilder API has been re-worked to be a true builder, and
10015       extension traits for spawning native/green tasks have been added.
10016
10017   * Tooling
10018     * All breaking changes to the language or libraries now have their
10019       commit message annotated with `[breaking-change]` to allow for easy
10020       discovery of breaking changes.
10021     * The compiler will now try to suggest how to annotate lifetimes if a
10022       lifetime-related error occurs.
10023     * Debug info continues to be improved greatly with general bug fixes and
10024       better support for situations like link time optimization (LTO).
10025     * Usage of syntax extensions when cross-compiling has been fixed.
10026     * Functionality equivalent to GCC & Clang's -ffunction-sections,
10027       -fdata-sections and --gc-sections has been enabled by default
10028     * The compiler is now stricter about where it will load module files
10029       from when a module is declared via `mod foo;`.
10030     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
10031       Syntax extensions are now discovered via a "plugin registrar" type
10032       which will be extended in the future to other various plugins.
10033     * Lints have been restructured to allow for dynamically loadable lints.
10034     * A number of rustdoc improvements:
10035       * The HTML output has been visually redesigned.
10036       * Markdown is now powered by hoedown instead of sundown.
10037       * Searching heuristics have been greatly improved.
10038       * The search index has been reduced in size by a great amount.
10039       * Cross-crate documentation via `pub use` has been greatly improved.
10040       * Primitive types are now hyperlinked and documented.
10041     * Documentation has been moved from static.rust-lang.org/doc to
10042       doc.rust-lang.org
10043     * A new sandbox, play.rust-lang.org, is available for running and
10044       sharing rust code examples on-line.
10045     * Unused attributes are now more robustly warned about.
10046     * The dead_code lint now warns about unused struct fields.
10047     * Cross-compiling to iOS is now supported.
10048     * Cross-compiling to mipsel is now supported.
10049     * Stability attributes are now inherited by default and no longer apply
10050       to intra-crate usage, only inter-crate usage.
10051     * Error message related to non-exhaustive match expressions have been
10052       greatly improved.
10053
10054
10055 Version 0.10 (2014-04-03)
10056 =========================
10057
10058   * ~1500 changes, numerous bugfixes
10059
10060   * Language
10061     * A new RFC process is now in place for modifying the language.
10062     * Patterns with `@`-pointers have been removed from the language.
10063     * Patterns with unique vectors (`~[T]`) have been removed from the
10064       language.
10065     * Patterns with unique strings (`~str`) have been removed from the
10066       language.
10067     * `@str` has been removed from the language.
10068     * `@[T]` has been removed from the language.
10069     * `@self` has been removed from the language.
10070     * `@Trait` has been removed from the language.
10071     * Headers on `~` allocations which contain `@` boxes inside the type for
10072       reference counting have been removed.
10073     * The semantics around the lifetimes of temporary expressions have changed,
10074       see #3511 and #11585 for more information.
10075     * Cross-crate syntax extensions are now possible, but feature gated. See
10076       #11151 for more information. This includes both `macro_rules!` macros as
10077       well as syntax extensions such as `format!`.
10078     * New lint modes have been added, and older ones have been turned on to be
10079       warn-by-default.
10080       * Unnecessary parentheses
10081       * Uppercase statics
10082       * Camel Case types
10083       * Uppercase variables
10084       * Publicly visible private types
10085       * `#[deriving]` with raw pointers
10086     * Unsafe functions can no longer be coerced to closures.
10087     * Various obscure macros such as `log_syntax!` are now behind feature gates.
10088     * The `#[simd]` attribute is now behind a feature gate.
10089     * Visibility is no longer allowed on `extern crate` statements, and
10090       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
10091     * Trailing commas are now allowed in argument lists and tuple patterns.
10092     * The `do` keyword has been removed, it is now a reserved keyword.
10093     * Default type parameters have been implemented, but are feature gated.
10094     * Borrowed variables through captures in closures are now considered soundly.
10095     * `extern mod` is now `extern crate`
10096     * The `Freeze` trait has been removed.
10097     * The `Share` trait has been added for types that can be shared among
10098       threads.
10099     * Labels in macros are now hygienic.
10100     * Expression/statement macro invocations can be delimited with `{}` now.
10101     * Treatment of types allowed in `static mut` locations has been tweaked.
10102     * The `*` and `.` operators are now overloadable through the `Deref` and
10103       `DerefMut` traits.
10104     * `~Trait` and `proc` no longer have `Send` bounds by default.
10105     * Partial type hints are now supported with the `_` type marker.
10106     * An `Unsafe` type was introduced for interior mutability. It is now
10107       considered undefined to transmute from `&T` to `&mut T` without using the
10108       `Unsafe` type.
10109     * The #[linkage] attribute was implemented for extern statics/functions.
10110     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
10111     * `Pod` was renamed to `Copy`.
10112
10113   * Libraries
10114     * The `libextra` library has been removed. It has now been decomposed into
10115       component libraries with smaller and more focused nuggets of
10116       functionality. The full list of libraries can be found on the
10117       documentation index page.
10118     * std: `std::condition` has been removed. All I/O errors are now propagated
10119       through the `Result` type. In order to assist with error handling, a
10120       `try!` macro for unwrapping errors with an early return and a lint for
10121       unused results has been added. See #12039 for more information.
10122     * std: The `vec` module has been renamed to `slice`.
10123     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
10124       This will become the only growable vector in the future.
10125     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
10126       are now found at `std::io::BufferedReader` instead of
10127       `std::io::buffered::BufferedReader`.
10128     * std: `print` and `println` are no longer in the prelude, the `print!` and
10129       `println!` macros are intended to be used instead.
10130     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
10131       attempts to statically prevent cycles.
10132     * std: The standard distribution is adopting the policy of pushing failure
10133       to the user rather than failing in libraries. Many functions (such as
10134       `slice::last()`) now return `Option<T>` instead of `T` + failing.
10135     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
10136       deriving mode: `#[deriving(Show)]`.
10137     * std: `ToStr` is now implemented for all types implementing `Show`.
10138     * std: The formatting trait methods now take `&self` instead of `&T`
10139     * std: The `invert()` method on iterators has been renamed to `rev()`
10140     * std: `std::num` has seen a reduction in the genericity of its traits,
10141       consolidating functionality into a few core traits.
10142     * std: Backtraces are now printed on task failure if the environment
10143       variable `RUST_BACKTRACE` is present.
10144     * std: Naming conventions for iterators have been standardized. More details
10145       can be found on the wiki's style guide.
10146     * std: `eof()` has been removed from the `Reader` trait. Specific types may
10147       still implement the function.
10148     * std: Networking types are now cloneable to allow simultaneous reads/writes.
10149     * std: `assert_approx_eq!` has been removed
10150     * std: The `e` and `E` formatting specifiers for floats have been added to
10151       print them in exponential notation.
10152     * std: The `Times` trait has been removed
10153     * std: Indications of variance and opting out of builtin bounds is done
10154       through marker types in `std::kinds::marker` now
10155     * std: `hash` has been rewritten, `IterBytes` has been removed, and
10156       `#[deriving(Hash)]` is now possible.
10157     * std: `SharedChan` has been removed, `Sender` is now cloneable.
10158     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
10159     * std: `Chan::new` is now `channel()`.
10160     * std: A new synchronous channel type has been implemented.
10161     * std: A `select!` macro is now provided for selecting over `Receiver`s.
10162     * std: `hashmap` and `trie` have been moved to `libcollections`
10163     * std: `run` has been rolled into `io::process`
10164     * std: `assert_eq!` now uses `{}` instead of `{:?}`
10165     * std: The equality and comparison traits have seen some reorganization.
10166     * std: `rand` has moved to `librand`.
10167     * std: `to_{lower,upper}case` has been implemented for `char`.
10168     * std: Logging has been moved to `liblog`.
10169     * collections: `HashMap` has been rewritten for higher performance and less
10170       memory usage.
10171     * native: The default runtime is now `libnative`. If `libgreen` is desired,
10172       it can be booted manually. The runtime guide has more information and
10173       examples.
10174     * native: All I/O functionality except signals has been implemented.
10175     * green: Task spawning with `libgreen` has been optimized with stack caching
10176       and various trimming of code.
10177     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
10178     * sync: The `extra::sync` module has been updated to modern rust (and moved
10179       to the `sync` library), tweaking and improving various interfaces while
10180       dropping redundant functionality.
10181     * sync: A new `Barrier` type has been added to the `sync` library.
10182     * sync: An efficient mutex for native and green tasks has been implemented.
10183     * serialize: The `base64` module has seen some improvement. It treats
10184       newlines better, has non-string error values, and has seen general
10185       cleanup.
10186     * fourcc: A `fourcc!` macro was introduced
10187     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
10188       hexadecimal literal.
10189
10190   * Tooling
10191     * `rustpkg` has been deprecated and removed from the main repository. Its
10192       replacement, `cargo`, is under development.
10193     * Nightly builds of rust are now available
10194     * The memory usage of rustc has been improved many times throughout this
10195       release cycle.
10196     * The build process supports disabling rpath support for the rustc binary
10197       itself.
10198     * Code generation has improved in some cases, giving more information to the
10199       LLVM optimization passes to enable more extensive optimizations.
10200     * Debuginfo compatibility with lldb on OSX has been restored.
10201     * The master branch is now gated on an android bot, making building for
10202       android much more reliable.
10203     * Output flags have been centralized into one `--emit` flag.
10204     * Crate type flags have been centralized into one `--crate-type` flag.
10205     * Codegen flags have been consolidated behind a `-C` flag.
10206     * Linking against outdated crates now has improved error messages.
10207     * Error messages with lifetimes will often suggest how to annotate the
10208       function to fix the error.
10209     * Many more types are documented in the standard library, and new guides
10210       were written.
10211     * Many `rustdoc` improvements:
10212       * code blocks are syntax highlighted.
10213       * render standalone markdown files.
10214       * the --test flag tests all code blocks by default.
10215       * exported macros are displayed.
10216       * re-exported types have their documentation inlined at the location of the
10217         first re-export.
10218       * search works across crates that have been rendered to the same output
10219         directory.
10220
10221
10222 Version 0.9 (2014-01-09)
10223 ==========================
10224
10225    * ~1800 changes, numerous bugfixes
10226
10227    * Language
10228       * The `float` type has been removed. Use `f32` or `f64` instead.
10229       * A new facility for enabling experimental features (feature gating) has
10230         been added, using the crate-level `#[feature(foo)]` attribute.
10231       * Managed boxes (@) are now behind a feature gate
10232         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
10233         standard library's `Gc` or `Rc` types instead.
10234       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
10235       * Jumping back to the top of a loop is now done with `continue` instead of
10236         `loop`.
10237       * Strings can no longer be mutated through index assignment.
10238       * Raw strings can be created via the basic `r"foo"` syntax or with matched
10239         hash delimiters, as in `r###"foo"###`.
10240       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
10241         called once.
10242       * The `&fn` type is now written `|args| -> ret` to match the literal form.
10243       * `@fn`s have been removed.
10244       * `do` only works with procs in order to make it obvious what the cost
10245         of `do` is.
10246       * Single-element tuple-like structs can no longer be dereferenced to
10247         obtain the inner value. A more comprehensive solution for overloading
10248         the dereference operator will be provided in the future.
10249       * The `#[link(...)]` attribute has been replaced with
10250         `#[crate_id = "name#vers"]`.
10251       * Empty `impl`s must be terminated with empty braces and may not be
10252         terminated with a semicolon.
10253       * Keywords are no longer allowed as lifetime names; the `self` lifetime
10254         no longer has any special meaning.
10255       * The old `fmt!` string formatting macro has been removed.
10256       * `printf!` and `printfln!` (old-style formatting) removed in favor of
10257         `print!` and `println!`.
10258       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
10259       * The `extern mod foo (name = "bar")` syntax has been removed. Use
10260         `extern mod foo = "bar"` instead.
10261       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
10262       * Macros can have attributes.
10263       * Macros can expand to items with attributes.
10264       * Macros can expand to multiple items.
10265       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
10266       * Comments may be nested.
10267       * Values automatically coerce to trait objects they implement, without
10268         an explicit `as`.
10269       * Enum discriminants are no longer an entire word but as small as needed to
10270         contain all the variants. The `repr` attribute can be used to override
10271         the discriminant size, as in `#[repr(int)]` for integer-sized, and
10272         `#[repr(C)]` to match C enums.
10273       * Non-string literals are not allowed in attributes (they never worked).
10274       * The FFI now supports variadic functions.
10275       * Octal numeric literals, as in `0o7777`.
10276       * The `concat!` syntax extension performs compile-time string concatenation.
10277       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
10278         removed as Rust no longer uses segmented stacks.
10279       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
10280       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
10281         not `*`; ignoring remaining fields of a struct is also done with `..`,
10282         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
10283       * `rustc` supports the "win64" calling convention via `extern "win64"`.
10284       * `rustc` supports the "system" calling convention, which defaults to the
10285         preferred convention for the target platform, "stdcall" on 32-bit Windows,
10286         "C" elsewhere.
10287       * The `type_overflow` lint (default: warn) checks literals for overflow.
10288       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
10289       * The `attribute_usage` lint (default: warn) warns about unknown
10290         attributes.
10291       * The `unknown_features` lint (default: warn) warns about unknown
10292         feature gates.
10293       * The `dead_code` lint (default: warn) checks for dead code.
10294       * Rust libraries can be linked statically to one another
10295       * `#[link_args]` is behind the `link_args` feature gate.
10296       * Native libraries are now linked with `#[link(name = "foo")]`
10297       * Native libraries can be statically linked to a rust crate
10298         (`#[link(name = "foo", kind = "static")]`).
10299       * Native OS X frameworks are now officially supported
10300         (`#[link(name = "foo", kind = "framework")]`).
10301       * The `#[thread_local]` attribute creates thread-local (not task-local)
10302         variables. Currently behind the `thread_local` feature gate.
10303       * The `return` keyword may be used in closures.
10304       * Types that can be copied via a memcpy implement the `Pod` kind.
10305       * The `cfg` attribute can now be used on struct fields and enum variants.
10306
10307    * Libraries
10308       * std: The `option` and `result` API's have been overhauled to make them
10309         simpler, more consistent, and more composable.
10310       * std: The entire `std::io` module has been replaced with one that is
10311         more comprehensive and that properly interfaces with the underlying
10312         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
10313         implemented.
10314       * std: `io::util` contains a number of useful implementations of
10315         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
10316         `ZeroReader`, `TeeReader`.
10317       * std: The reference counted pointer type `extra::rc` moved into std.
10318       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
10319         just a wrapper around it).
10320       * std: The `Either` type has been removed.
10321       * std: `fmt::Default` can be implemented for any type to provide default
10322         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
10323       * std: The `rand` API continues to be tweaked.
10324       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
10325         on failure in gdb, is now named `rust_fail`.
10326       * std: The `each_key` and `each_value` methods on `HashMap` have been
10327         replaced by the `keys` and `values` iterators.
10328       * std: Functions dealing with type size and alignment have moved from the
10329         `sys` module to the `mem` module.
10330       * std: The `path` module was written and API changed.
10331       * std: `str::from_utf8` has been changed to cast instead of allocate.
10332       * std: `starts_with` and `ends_with` methods added to vectors via the
10333         `ImmutableEqVector` trait, which is in the prelude.
10334       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
10335         if the index is out of bounds.
10336       * std: Task failure no longer propagates between tasks, as the model was
10337         complex, expensive, and incompatible with thread-based tasks.
10338       * std: The `Any` type can be used for dynamic typing.
10339       * std: `~Any` can be passed to the `fail!` macro and retrieved via
10340         `task::try`.
10341       * std: Methods that produce iterators generally do not have an `_iter`
10342         suffix now.
10343       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
10344         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
10345       * std: `util::ignore` renamed to `prelude::drop`.
10346       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
10347         trait.
10348       * std: `vec::raw` has seen a lot of cleanup and API changes.
10349       * std: The standard library no longer includes any C++ code, and very
10350         minimal C, eliminating the dependency on libstdc++.
10351       * std: Runtime scheduling and I/O functionality has been factored out into
10352         extensible interfaces and is now implemented by two different crates:
10353         libnative, for native threading and I/O; and libgreen, for green threading
10354         and I/O. This paves the way for using the standard library in more limited
10355         embedded environments.
10356       * std: The `comm` module has been rewritten to be much faster, have a
10357         simpler, more consistent API, and to work for both native and green
10358         threading.
10359       * std: All libuv dependencies have been moved into the rustuv crate.
10360       * native: New implementations of runtime scheduling on top of OS threads.
10361       * native: New native implementations of TCP, UDP, file I/O, process spawning,
10362         and other I/O.
10363       * green: The green thread scheduler and message passing types are almost
10364         entirely lock-free.
10365       * extra: The `flatpipes` module had bitrotted and was removed.
10366       * extra: All crypto functions have been removed and Rust now has a policy of
10367         not reimplementing crypto in the standard library. In the future crypto
10368         will be provided by external crates with bindings to established libraries.
10369       * extra: `c_vec` has been modernized.
10370       * extra: The `sort` module has been removed. Use the `sort` method on
10371         mutable slices.
10372
10373    * Tooling
10374       * The `rust` and `rusti` commands have been removed, due to lack of
10375         maintenance.
10376       * `rustdoc` was completely rewritten.
10377       * `rustdoc` can test code examples in documentation.
10378       * `rustpkg` can test packages with the argument, 'test'.
10379       * `rustpkg` supports arbitrary dependencies, including C libraries.
10380       * `rustc`'s support for generating debug info is improved again.
10381       * `rustc` has better error reporting for unbalanced delimiters.
10382       * `rustc`'s JIT support was removed due to bitrot.
10383       * Executables and static libraries can be built with LTO (-Z lto)
10384       * `rustc` adds a `--dep-info` flag for communicating dependencies to
10385         build tools.
10386
10387
10388 Version 0.8 (2013-09-26)
10389 ============================
10390
10391    * ~2200 changes, numerous bugfixes
10392
10393    * Language
10394       * The `for` loop syntax has changed to work with the `Iterator` trait.
10395       * At long last, unwinding works on Windows.
10396       * Default methods are ready for use.
10397       * Many trait inheritance bugs fixed.
10398       * Owned and borrowed trait objects work more reliably.
10399       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
10400       * rustc can omit emission of code for the `debug!` macro if it is passed
10401         `--cfg ndebug`
10402       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
10403         for foo.rs, then foo/mod.rs, and will generate an error when both are
10404         present.
10405       * Strings no longer contain trailing nulls. The new `std::c_str` module
10406         provides new mechanisms for converting to C strings.
10407       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
10408       * The FFI has been overhauled such that foreign functions are called directly,
10409         instead of through a stack-switching wrapper.
10410       * Calling a foreign function must be done through a Rust function with the
10411         `#[fixed_stack_segment]` attribute.
10412       * The `externfn!` macro can be used to declare both a foreign function and
10413         a `#[fixed_stack_segment]` wrapper at once.
10414       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
10415       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
10416       * `priv` is disallowed everywhere except for struct fields and enum variants.
10417       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
10418       * `ref` bindings in irrefutable patterns work correctly now.
10419       * `char` is now prevented from containing invalid code points.
10420       * Casting to `bool` is no longer allowed.
10421       * `\0` is now accepted as an escape in chars and strings.
10422       * `yield` is a reserved keyword.
10423       * `typeof` is a reserved keyword.
10424       * Crates may be imported by URL with `extern mod foo = "url";`.
10425       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
10426       * Static vectors can be initialized with repeating elements,
10427         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
10428       * Static structs can be initialized with functional record update,
10429         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
10430       * `cfg!` can be used to conditionally execute code based on the crate
10431         configuration, similarly to `#[cfg(...)]`.
10432       * The `unnecessary_qualification` lint detects unneeded module
10433         prefixes (default: allow).
10434       * Arithmetic operations have been implemented on the SIMD types in
10435         `std::unstable::simd`.
10436       * Exchange allocation headers were removed, reducing memory usage.
10437       * `format!` implements a completely new, extensible, and higher-performance
10438         string formatting system. It will replace `fmt!`.
10439       * `print!` and `println!` write formatted strings (using the `format!`
10440         extension) to stdout.
10441       * `write!` and `writeln!` write formatted strings (using the `format!`
10442         extension) to the new Writers in `std::rt::io`.
10443       * The library section in which a function or static is placed may
10444         be specified with `#[link_section = "..."]`.
10445       * The `proto!` syntax extension for defining bounded message protocols
10446         was removed.
10447       * `macro_rules!` is hygienic for `let` declarations.
10448       * The `#[export_name]` attribute specifies the name of a symbol.
10449       * `unreachable!` can be used to indicate unreachable code, and fails
10450         if executed.
10451
10452    * Libraries
10453       * std: Transitioned to the new runtime, written in Rust.
10454       * std: Added an experimental I/O library, `rt::io`, based on the new
10455         runtime.
10456       * std: A new generic `range` function was added to the prelude, replacing
10457         `uint::range` and friends.
10458       * std: `range_rev` no longer exists. Since range is an iterator it can be
10459         reversed with `range(lo, hi).invert()`.
10460       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
10461         renamed to `unwrap_or`.
10462       * std: The `iterator` module was renamed to `iter`.
10463       * std: Integral types now support the `checked_add`, `checked_sub`, and
10464         `checked_mul` operations for detecting overflow.
10465       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
10466         consistency.
10467       * std: Methods are standardizing on conventions for casting methods:
10468         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
10469         and cheap casts.
10470       * std: The `CString` type in `c_str` provides new ways to convert to and
10471         from C strings.
10472       * std: `DoubleEndedIterator` can yield elements in two directions.
10473       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
10474         two splices.
10475       * std: `str::from_bytes` renamed to `str::from_utf8`.
10476       * std: `pop_opt` and `shift_opt` methods added to vectors.
10477       * std: The task-local data interface no longer uses @, and keys are
10478         no longer function pointers.
10479       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
10480       * std: Added `SharedPort` to `comm`.
10481       * std: `Eq` has a default method for `ne`; only `eq` is required
10482         in implementations.
10483       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
10484         is required in implementations.
10485       * std: `is_utf8` performance is improved, impacting many string functions.
10486       * std: `os::MemoryMap` provides cross-platform mmap.
10487       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
10488         are not 'in-bounds' are considered undefined.
10489       * std: Many freestanding functions in `vec` removed in favor of methods.
10490       * std: Many freestanding functions on scalar types removed in favor of
10491         methods.
10492       * std: Many options to task builders were removed since they don't make
10493         sense in the new scheduler design.
10494       * std: More containers implement `FromIterator` so can be created by the
10495         `collect` method.
10496       * std: More complete atomic types in `unstable::atomics`.
10497       * std: `comm::PortSet` removed.
10498       * std: Mutating methods in the `Set` and `Map` traits have been moved into
10499         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
10500         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
10501         default implementations.
10502       * std: Various `from_str` functions were removed in favor of a generic
10503         `from_str` which is available in the prelude.
10504       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
10505       * extra: `dlist`, the doubly-linked list was modernized.
10506       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
10507       * extra: Added `glob` module, replacing `std::os::glob`.
10508       * extra: `rope` was removed.
10509       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
10510       * extra: `net`, and `timer` were removed. The experimental replacements
10511         are `std::rt::io::net` and `std::rt::io::timer`.
10512       * extra: Iterators implemented for `SmallIntMap`.
10513       * extra: Iterators implemented for `Bitv` and `BitvSet`.
10514       * extra: `SmallIntSet` removed. Use `BitvSet`.
10515       * extra: Performance of JSON parsing greatly improved.
10516       * extra: `semver` updated to SemVer 2.0.0.
10517       * extra: `term` handles more terminals correctly.
10518       * extra: `dbg` module removed.
10519       * extra: `par` module removed.
10520       * extra: `future` was cleaned up, with some method renames.
10521       * extra: Most free functions in `getopts` were converted to methods.
10522
10523    * Other
10524       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
10525       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
10526         similarly to gcc's `--march` flag.
10527       * rustc's performance compiling small crates is much better.
10528       * rustpkg has received many improvements.
10529       * rustpkg supports git tags as package IDs.
10530       * rustpkg builds into target-specific directories so it can be used for
10531         cross-compiling.
10532       * The number of concurrent test tasks is controlled by the environment
10533         variable RUST_TEST_TASKS.
10534       * The test harness can now report metrics for benchmarks.
10535       * All tools have man pages.
10536       * Programs compiled with `--test` now support the `-h` and `--help` flags.
10537       * The runtime uses jemalloc for allocations.
10538       * Segmented stacks are temporarily disabled as part of the transition to
10539         the new runtime. Stack overflows are possible!
10540       * A new documentation backend, rustdoc_ng, is available for use. It is
10541         still invoked through the normal `rustdoc` command.
10542
10543
10544 Version 0.7 (2013-07-03)
10545 =======================
10546
10547    * ~2000 changes, numerous bugfixes
10548
10549    * Language
10550       * `impl`s no longer accept a visibility qualifier. Put them on methods
10551         instead.
10552       * The borrow checker has been rewritten with flow-sensitivity, fixing
10553         many bugs and inconveniences.
10554       * The `self` parameter no longer implicitly means `&'self self`,
10555         and can be explicitly marked with a lifetime.
10556       * Overloadable compound operators (`+=`, etc.) have been temporarily
10557         removed due to bugs.
10558       * The `for` loop protocol now requires `for`-iterators to return `bool`
10559         so they compose better.
10560       * The `Durable` trait is replaced with the `'static` bounds.
10561       * Trait default methods work more often.
10562       * Structs with the `#[packed]` attribute have byte alignment and
10563         no padding between fields.
10564       * Type parameters bound by `Copy` must now be copied explicitly with
10565         the `copy` keyword.
10566       * It is now illegal to move out of a dereferenced unsafe pointer.
10567       * `Option<~T>` is now represented as a nullable pointer.
10568       * `@mut` does dynamic borrow checks correctly.
10569       * The `main` function is only detected at the topmost level of the crate.
10570         The `#[main]` attribute is still valid anywhere.
10571       * Struct fields may no longer be mutable. Use inherited mutability.
10572       * The `#[no_send]` attribute makes a type that would otherwise be
10573         `Send`, not.
10574       * The `#[no_freeze]` attribute makes a type that would otherwise be
10575         `Freeze`, not.
10576       * Unbounded recursion will abort the process after reaching the limit
10577         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
10578       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
10579         are never implicitly copyable.
10580       * `#[static_assert]` makes compile-time assertions about static bools.
10581       * At long last, 'argument modes' no longer exist.
10582       * The rarely used `use mod` statement no longer exists.
10583
10584    * Syntax extensions
10585       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
10586         argument list.
10587       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
10588         `Rand`, `Zero` and `ToStr` can all be automatically derived with
10589         `#[deriving(...)]`.
10590       * The `bytes!` macro returns a vector of bytes for string, u8, char,
10591         and unsuffixed integer literals.
10592
10593    * Libraries
10594       * The `core` crate was renamed to `std`.
10595       * The `std` crate was renamed to `extra`.
10596       * More and improved documentation.
10597       * std: `iterator` module for external iterator objects.
10598       * Many old-style (internal, higher-order function) iterators replaced by
10599         implementations of `Iterator`.
10600       * std: Many old internal vector and string iterators,
10601         incl. `any`, `all`. removed.
10602       * std: The `finalize` method of `Drop` renamed to `drop`.
10603       * std: The `drop` method now takes `&mut self` instead of `&self`.
10604       * std: The prelude no longer re-exports any modules, only types and traits.
10605       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
10606         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
10607       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
10608         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
10609       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
10610         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
10611       * std: Many types implement `Clone`.
10612       * std: `path` type renamed to `Path`.
10613       * std: `mut` module and `Mut` type removed.
10614       * std: Many standalone functions removed in favor of methods and iterators
10615         in `vec`, `str`. In the future methods will also work as functions.
10616       * std: `reinterpret_cast` removed. Use `transmute`.
10617       * std: ascii string handling in `std::ascii`.
10618       * std: `Rand` is implemented for ~/@.
10619       * std: `run` module for spawning processes overhauled.
10620       * std: Various atomic types added to `unstable::atomic`.
10621       * std: Various types implement `Zero`.
10622       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
10623       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
10624       * std: Added `os::mkdir_recursive`.
10625       * std: Added `os::glob` function performs filesystems globs.
10626       * std: `FuzzyEq` renamed to `ApproxEq`.
10627       * std: `Map` now defines `pop` and `swap` methods.
10628       * std: `Cell` constructors converted to static methods.
10629       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
10630       * extra: `flate` module moved from `std` to `extra`.
10631       * extra: `fileinput` module for iterating over a series of files.
10632       * extra: `Complex` number type and `complex` module.
10633       * extra: `Rational` number type and `rational` module.
10634       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
10635       * extra: `term` uses terminfo now, is more correct.
10636       * extra: `arc` functions converted to methods.
10637       * extra: Implementation of fixed output size variations of SHA-2.
10638
10639    * Tooling
10640       * `unused_variables` lint mode for unused variables (default: warn).
10641       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
10642         (default: warn).
10643       * `unused_mut` lint mode for identifying unused `mut` qualifiers
10644         (default: warn).
10645       * `dead_assignment` lint mode for unread variables (default: warn).
10646       * `unnecessary_allocation` lint mode detects some heap allocations that are
10647         immediately borrowed so could be written without allocating (default: warn).
10648       * `missing_doc` lint mode (default: allow).
10649       * `unreachable_code` lint mode (default: warn).
10650       * The `rusti` command has been rewritten and a number of bugs addressed.
10651       * rustc outputs in color on more terminals.
10652       * rustc accepts a `--link-args` flag to pass arguments to the linker.
10653       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
10654       * Compiling with `-g` will make the binary record information about
10655         dynamic borrowcheck failures for debugging.
10656       * rustdoc has a nicer stylesheet.
10657       * Various improvements to rustdoc.
10658       * Improvements to rustpkg (see the detailed release notes).
10659
10660
10661 Version 0.6 (2013-04-03)
10662 ========================
10663
10664    * ~2100 changes, numerous bugfixes
10665
10666    * Syntax changes
10667       * The self type parameter in traits is now spelled `Self`
10668       * The `self` parameter in trait and impl methods must now be explicitly
10669         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
10670       * Static methods no longer require the `static` keyword and instead
10671         are distinguished by the lack of a `self` parameter
10672       * Replaced the `Durable` trait with the `'static` lifetime
10673       * The old closure type syntax with the trailing sigil has been
10674         removed in favor of the more consistent leading sigil
10675       * `super` is a keyword, and may be prefixed to paths
10676       * Trait bounds are separated with `+` instead of whitespace
10677       * Traits are implemented with `impl Trait for Type`
10678         instead of `impl Type: Trait`
10679       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
10680       * The `export` keyword has finally been removed
10681       * The `move` keyword has been removed (see "Semantic changes")
10682       * The interior mutability qualifier on vectors, `[mut T]`, has been
10683         removed. Use `&mut [T]`, etc.
10684       * `mut` is no longer valid in `~mut T`. Use inherited mutability
10685       * `fail` is no longer a keyword. Use `fail!()`
10686       * `assert` is no longer a keyword. Use `assert!()`
10687       * `log` is no longer a keyword. use `debug!`, etc.
10688       * 1-tuples may be represented as `(T,)`
10689       * Struct fields may no longer be `mut`. Use inherited mutability,
10690         `@mut T`, `core::mut` or `core::cell`
10691       * `extern mod { ... }` is no longer valid syntax for foreign
10692         function modules. Use extern blocks: `extern { ... }`
10693       * Newtype enums removed. Use tuple-structs.
10694       * Trait implementations no longer support visibility modifiers
10695       * Pattern matching over vectors improved and expanded
10696       * `const` renamed to `static` to correspond to lifetime name,
10697         and make room for future `static mut` unsafe mutable globals.
10698       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
10699       * `Clone` implementations can be automatically generated with
10700         `#[deriving(Clone)]`
10701       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
10702         instead of `foo as Bar`.
10703       * Fixed length vector types are now written as `[int, .. 3]`
10704         instead of `[int * 3]`.
10705       * Fixed length vector types can express the length as a constant
10706         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
10707
10708    * Semantic changes
10709       * Types with owned pointers or custom destructors move by default,
10710         eliminating the `move` keyword
10711       * All foreign functions are considered unsafe
10712       * &mut is now unaliasable
10713       * Writes to borrowed @mut pointers are prevented dynamically
10714       * () has size 0
10715       * The name of the main function can be customized using #[main]
10716       * The default type of an inferred closure is &fn instead of @fn
10717       * `use` statements may no longer be "chained" - they cannot import
10718         identifiers imported by previous `use` statements
10719       * `use` statements are crate relative, importing from the "top"
10720         of the crate by default. Paths may be prefixed with `super::`
10721         or `self::` to change the search behavior.
10722       * Method visibility is inherited from the implementation declaration
10723       * Structural records have been removed
10724       * Many more types can be used in static items, including enums
10725         'static-lifetime pointers and vectors
10726       * Pattern matching over vectors improved and expanded
10727       * Typechecking of closure types has been overhauled to
10728         improve inference and eliminate unsoundness
10729       * Macros leave scope at the end of modules, unless that module is
10730         tagged with #[macro_escape]
10731
10732    * Libraries
10733       * Added big integers to `std::bigint`
10734       * Removed `core::oldcomm` module
10735       * Added pipe-based `core::comm` module
10736       * Numeric traits have been reorganized under `core::num`
10737       * `vec::slice` finally returns a slice
10738       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
10739       * Containers reorganized around traits in `core::container`
10740       * `core::dvec` removed, `~[T]` is a drop-in replacement
10741       * `core::send_map` renamed to `core::hashmap`
10742       * `std::map` removed; replaced with `core::hashmap`
10743       * `std::treemap` reimplemented as an owned balanced tree
10744       * `std::deque` and `std::smallintmap` reimplemented as owned containers
10745       * `core::trie` added as a fast ordered map for integer keys
10746       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
10747       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
10748         overload the comparison operators, whereas `TotalOrd` is used
10749         by certain container types
10750
10751    * Other
10752       * Replaced the 'cargo' package manager with 'rustpkg'
10753       * Added all-purpose 'rust' tool
10754       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
10755       * rustc now *attempts* to offer spelling suggestions
10756       * Improved support for ARM and Android
10757       * Preliminary MIPS backend
10758       * Improved foreign function ABI implementation for x86, x86_64
10759       * Various memory usage improvements
10760       * Rust code may be embedded in foreign code under limited circumstances
10761       * Inline assembler supported by new asm!() syntax extension.
10762
10763
10764 Version 0.5 (2012-12-21)
10765 ===========================
10766
10767    * ~900 changes, numerous bugfixes
10768
10769    * Syntax changes
10770       * Removed `<-` move operator
10771       * Completed the transition from the `#fmt` extension syntax to `fmt!`
10772       * Removed old fixed length vector syntax - `[T]/N`
10773       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
10774       * Macros may now expand to items and statements
10775       * `a.b()` is always parsed as a method call, never as a field projection
10776       * `Eq` and `IterBytes` implementations can be automatically generated
10777         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
10778       * Removed the special crate language for `.rc` files
10779       * Function arguments may consist of any irrefutable pattern
10780
10781    * Semantic changes
10782       * `&` and `~` pointers may point to objects
10783       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
10784       * Enum variants may be structs
10785       * Destructors can be added to all nominal types with the Drop trait
10786       * Structs and nullary enum variants may be constants
10787       * Values that cannot be implicitly copied are now automatically moved
10788         without writing `move` explicitly
10789       * `&T` may now be coerced to `*T`
10790       * Coercions happen in `let` statements as well as function calls
10791       * `use` statements now take crate-relative paths
10792       * The module and type namespaces have been merged so that static
10793         method names can be resolved under the trait in which they are
10794         declared
10795
10796    * Improved support for language features
10797       * Trait inheritance works in many scenarios
10798       * More support for explicit self arguments in methods - `self`, `&self`
10799         `@self`, and `~self` all generally work as expected
10800       * Static methods work in more situations
10801       * Experimental: Traits may declare default methods for the implementations
10802         to use
10803
10804    * Libraries
10805       * New condition handling system in `core::condition`
10806       * Timsort added to `std::sort`
10807       * New priority queue, `std::priority_queue`
10808       * Pipes for serializable types, `std::flatpipes'
10809       * Serialization overhauled to be trait-based
10810       * Expanded `getopts` definitions
10811       * Moved futures to `std`
10812       * More functions are pure now
10813       * `core::comm` renamed to `oldcomm`. Still deprecated
10814       * `rustdoc` and `cargo` are libraries now
10815
10816    * Misc
10817       * Added a preliminary REPL, `rusti`
10818       * License changed from MIT to dual MIT/APL2
10819
10820
10821 Version 0.4 (2012-10-15)
10822 ==========================
10823
10824    * ~2000 changes, numerous bugfixes
10825
10826    * Syntax
10827       * All keywords are now strict and may not be used as identifiers anywhere
10828       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
10829         'of', 'with', 'to', 'class'.
10830       * Classes are replaced with simpler structs
10831       * Explicit method self types
10832       * `ret` became `return` and `alt` became `match`
10833       * `import` is now `use`; `use is now `extern mod`
10834       * `extern mod { ... }` is now `extern { ... }`
10835       * `use mod` is the recommended way to import modules
10836       * `pub` and `priv` replace deprecated export lists
10837       * The syntax of `match` pattern arms now uses fat arrow (=>)
10838       * `main` no longer accepts an args vector; use `os::args` instead
10839
10840    * Semantics
10841       * Trait implementations are now coherent, ala Haskell typeclasses
10842       * Trait methods may be static
10843       * Argument modes are deprecated
10844       * Borrowed pointers are much more mature and recommended for use
10845       * Strings and vectors in the static region are stored in constant memory
10846       * Typestate was removed
10847       * Resolution rewritten to be more reliable
10848       * Support for 'dual-mode' data structures (freezing and thawing)
10849
10850    * Libraries
10851       * Most binary operators can now be overloaded via the traits in
10852         `core::ops'
10853       * `std::net::url` for representing URLs
10854       * Sendable hash maps in `core::send_map`
10855       * `core::task' gained a (currently unsafe) task-local storage API
10856
10857    * Concurrency
10858       * An efficient new intertask communication primitive called the pipe,
10859         along with a number of higher-level channel types, in `core::pipes`
10860       * `std::arc`, an atomically reference counted, immutable, shared memory
10861         type
10862       * `std::sync`, various exotic synchronization tools based on arcs and pipes
10863       * Futures are now based on pipes and sendable
10864       * More robust linked task failure
10865       * Improved task builder API
10866
10867    * Other
10868       * Improved error reporting
10869       * Preliminary JIT support
10870       * Preliminary work on precise GC
10871       * Extensive architectural improvements to rustc
10872       * Begun a transition away from buggy C++-based reflection (shape) code to
10873         Rust-based (visitor) code
10874       * All hash functions and tables converted to secure, randomized SipHash
10875
10876
10877 Version 0.3  (2012-07-12)
10878 ========================
10879
10880    * ~1900 changes, numerous bugfixes
10881
10882    * New coding conveniences
10883       * Integer-literal suffix inference
10884       * Per-item control over warnings, errors
10885       * #[cfg(windows)] and #[cfg(unix)] attributes
10886       * Documentation comments
10887       * More compact closure syntax
10888       * 'do' expressions for treating higher-order functions as
10889         control structures
10890       * *-patterns (wildcard extended to all constructor fields)
10891
10892    * Semantic cleanup
10893       * Name resolution pass and exhaustiveness checker rewritten
10894       * Region pointers and borrow checking supersede alias
10895         analysis
10896       * Init-ness checking is now provided by a region-based liveness
10897         pass instead of the typestate pass; same for last-use analysis
10898       * Extensive work on region pointers
10899
10900    * Experimental new language features
10901       * Slices and fixed-size, interior-allocated vectors
10902       * #!-comments for lang versioning, shell execution
10903       * Destructors and iface implementation for classes;
10904         type-parameterized classes and class methods
10905       * 'const' type kind for types that can be used to implement
10906         shared-memory concurrency patterns
10907
10908    * Type reflection
10909
10910    * Removal of various obsolete features
10911       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
10912                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
10913
10914       * Constructs: do-while loops ('do' repurposed), fn binding,
10915                     resources (replaced by destructors)
10916
10917    * Compiler reorganization
10918       * Syntax-layer of compiler split into separate crate
10919       * Clang (from LLVM project) integrated into build
10920       * Typechecker split into sub-modules
10921
10922    * New library code
10923       * New time functions
10924       * Extension methods for many built-in types
10925       * Arc: atomic-refcount read-only / exclusive-use shared cells
10926       * Par: parallel map and search routines
10927       * Extensive work on libuv interface
10928       * Much vector code moved to libraries
10929       * Syntax extensions: #line, #col, #file, #mod, #stringify,
10930         #include, #include_str, #include_bin
10931
10932    * Tool improvements
10933       * Cargo automatically resolves dependencies
10934
10935
10936 Version 0.2  (2012-03-29)
10937 =========================
10938
10939    * >1500 changes, numerous bugfixes
10940
10941    * New docs and doc tooling
10942
10943    * New port: FreeBSD x86_64
10944
10945    * Compilation model enhancements
10946       * Generics now specialized, multiply instantiated
10947       * Functions now inlined across separate crates
10948
10949    * Scheduling, stack and threading fixes
10950       * Noticeably improved message-passing performance
10951       * Explicit schedulers
10952       * Callbacks from C
10953       * Helgrind clean
10954
10955    * Experimental new language features
10956       * Operator overloading
10957       * Region pointers
10958       * Classes
10959
10960    * Various language extensions
10961       * C-callback function types: 'crust fn ...'
10962       * Infinite-loop construct: 'loop { ... }'
10963       * Shorten 'mutable' to 'mut'
10964       * Required mutable-local qualifier: 'let mut ...'
10965       * Basic glob-exporting: 'export foo::*;'
10966       * Alt now exhaustive, 'alt check' for runtime-checked
10967       * Block-function form of 'for' loop, with 'break' and 'ret'.
10968
10969    * New library code
10970       * AST quasi-quote syntax extension
10971       * Revived libuv interface
10972       * New modules: core::{future, iter}, std::arena
10973       * Merged per-platform std::{os*, fs*} to core::{libc, os}
10974       * Extensive cleanup, regularization in libstd, libcore
10975
10976
10977 Version 0.1  (2012-01-20)
10978 ===============================
10979
10980    * Most language features work, including:
10981       * Unique pointers, unique closures, move semantics
10982       * Interface-constrained generics
10983       * Static interface dispatch
10984       * Stack growth
10985       * Multithread task scheduling
10986       * Typestate predicates
10987       * Failure unwinding, destructors
10988       * Pattern matching and destructuring assignment
10989       * Lightweight block-lambda syntax
10990       * Preliminary macro-by-example
10991
10992    * Compiler works with the following configurations:
10993       * Linux: x86 and x86_64 hosts and targets
10994       * macOS: x86 and x86_64 hosts and targets
10995       * Windows: x86 hosts and targets
10996
10997    * Cross compilation / multi-target configuration supported.
10998
10999    * Preliminary API-documentation and package-management tools included.
11000
11001 Known issues:
11002
11003    * Documentation is incomplete.
11004
11005    * Performance is below intended target.
11006
11007    * Standard library APIs are subject to extensive change, reorganization.
11008
11009    * Language-level versioning is not yet operational - future code will
11010      break unexpectedly.