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 - [`NonZero{unsigned}::is_power_of_two`]
  45
  46 These APIs are now usable in const contexts:
  47
  48 - [`Duration::new`]
  49 - [`Duration::checked_add`]
  50 - [`Duration::saturating_add`]
  51 - [`Duration::checked_sub`]
  52 - [`Duration::saturating_sub`]
  53 - [`Duration::checked_mul`]
  54 - [`Duration::saturating_mul`]
  55 - [`Duration::checked_div`]
  56 - [`MaybeUninit::as_ptr`]
  57 - [`MaybeUninit::as_mut_ptr`]
  58 - [`MaybeUninit::assume_init`]
  59 - [`MaybeUninit::assume_init_ref`]
  60
  61 Cargo
  62 -----
  63
  64 - [Add --message-format for install command][cargo/10107]
  65 - [Warn when alias shadows external subcommand][cargo/10082]
  66
  67 Rustdoc
  68 -------
  69
  70 - [Show all Deref implementations recursively in rustdoc][90183]
  71 - [Use computed visibility in rustdoc][88447]
  72
  73 Compatibility Notes
  74 -------------------
  75
  76 - [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.
  77 - Windows: [`std::process::Command` will no longer search the current directory for executables.][87704]
  78 - [All proc-macro backward-compatibility lints are now deny-by-default.][88041]
  79 - [proc_macro: Append .0 to unsuffixed float if it would otherwise become int token][90297]
  80 - [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.
  81 - [rustdoc now rejects some unexpected semicolons in doctests][91026]
  82
  83 Internal Changes
  84 ----------------
  85
  86 These changes provide no direct user facing benefits, but represent significant
  87 improvements to the internals and overall performance of rustc
  88 and related tools.
  89
  90 - [Implement coherence checks for negative trait impls][90104]
  91 - [Add rustc lint, warning when iterating over hashmaps][89558]
  92 - [Optimize live point computation][90491]
  93 - [Enable verification for 1/32nd of queries loaded from disk][90361]
  94 - [Implement version of normalize_erasing_regions that allows for normalization failure][91255]
  95
  96 [87337]: https://github.com/rust-lang/rust/pull/87337/
  97 [87467]: https://github.com/rust-lang/rust/pull/87467/
  98 [87704]: https://github.com/rust-lang/rust/pull/87704/
  99 [88041]: https://github.com/rust-lang/rust/pull/88041/
 100 [88300]: https://github.com/rust-lang/rust/pull/88300/
 101 [88447]: https://github.com/rust-lang/rust/pull/88447/
 102 [88601]: https://github.com/rust-lang/rust/pull/88601/
 103 [88624]: https://github.com/rust-lang/rust/pull/88624/
 104 [89062]: https://github.com/rust-lang/rust/pull/89062/
 105 [89174]: https://github.com/rust-lang/rust/pull/89174/
 106 [89542]: https://github.com/rust-lang/rust/pull/89542/
 107 [89551]: https://github.com/rust-lang/rust/pull/89551/
 108 [89558]: https://github.com/rust-lang/rust/pull/89558/
 109 [89580]: https://github.com/rust-lang/rust/pull/89580/
 110 [89652]: https://github.com/rust-lang/rust/pull/89652/
 111 [89677]: https://github.com/rust-lang/rust/pull/89677/
 112 [89951]: https://github.com/rust-lang/rust/pull/89951/
 113 [90041]: https://github.com/rust-lang/rust/pull/90041/
 114 [90058]: https://github.com/rust-lang/rust/pull/90058/
 115 [90104]: https://github.com/rust-lang/rust/pull/90104/
 116 [90117]: https://github.com/rust-lang/rust/pull/90117/
 117 [90175]: https://github.com/rust-lang/rust/pull/90175/
 118 [90183]: https://github.com/rust-lang/rust/pull/90183/
 119 [90297]: https://github.com/rust-lang/rust/pull/90297/
 120 [90329]: https://github.com/rust-lang/rust/pull/90329/
 121 [90361]: https://github.com/rust-lang/rust/pull/90361/
 122 [90417]: https://github.com/rust-lang/rust/pull/90417/
 123 [90473]: https://github.com/rust-lang/rust/pull/90473/
 124 [90491]: https://github.com/rust-lang/rust/pull/90491/
 125 [90733]: https://github.com/rust-lang/rust/pull/90733/
 126 [90833]: https://github.com/rust-lang/rust/pull/90833/
 127 [90846]: https://github.com/rust-lang/rust/pull/90846/
 128 [90896]: https://github.com/rust-lang/rust/pull/90896/
 129 [91026]: https://github.com/rust-lang/rust/pull/91026/
 130 [91207]: https://github.com/rust-lang/rust/pull/91207/
 131 [91255]: https://github.com/rust-lang/rust/pull/91255/
 132 [91301]: https://github.com/rust-lang/rust/pull/91301/
 133 [cargo/10082]: https://github.com/rust-lang/cargo/pull/10082/
 134 [cargo/10107]: https://github.com/rust-lang/cargo/pull/10107/
 135 [`Metadata::is_symlink`]: https://doc.rust-lang.org/stable/std/fs/struct.Metadata.html#method.is_symlink
 136 [`Path::is_symlink`]: https://doc.rust-lang.org/stable/std/path/struct.Path.html#method.is_symlink
 137 [`{integer}::saturating_div`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.saturating_div
 138 [`Option::unwrap_unchecked`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.unwrap_unchecked
 139 [`NonZero{unsigned}::is_power_of_two`]: https://doc.rust-lang.org/stable/std/num/struct.NonZeroU8.html#method.is_power_of_two
 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 [`MaybeUninit::as_ptr`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.as_ptr
 163 [`MaybeUninit::as_mut_ptr`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.as_mut_ptr
 164 [`MaybeUninit::assume_init`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init
 165 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
 166
 167 Version 1.57.0 (2021-12-02)
 168 ==========================
 169
 170 Language
 171 --------
 172
 173 - [Macro attributes may follow `#[derive]` and will see the original (pre-`cfg`) input.][87220]
 174 - [Accept curly-brace macros in expressions, like `m!{ .. }.method()` and `m!{ .. }?`.][88690]
 175 - [Allow panicking in constant evaluation.][89508]
 176
 177 Compiler
 178 --------
 179
 180 - [Create more accurate debuginfo for vtables.][89597]
 181 - [Add `armv6k-nintendo-3ds` at Tier 3\*.][88529]
 182 - [Add `armv7-unknown-linux-uclibceabihf` at Tier 3\*.][88952]
 183 - [Add `m68k-unknown-linux-gnu` at Tier 3\*.][88321]
 184 - [Add SOLID targets at Tier 3\*:][86191] `aarch64-kmc-solid_asp3`, `armv7a-kmc-solid_asp3-eabi`, `armv7a-kmc-solid_asp3-eabihf`
 185
 186 \* Refer to Rust's [platform support page][platform-support-doc] for more
 187    information on Rust's tiered platform support.
 188
 189 Libraries
 190 ---------
 191
 192 - [Avoid allocations and copying in `Vec::leak`][89337]
 193 - [Add `#[repr(i8)]` to `Ordering`][89507]
 194 - [Optimize `File::read_to_end` and `read_to_string`][89582]
 195 - [Update to Unicode 14.0][89614]
 196 - [Many more functions are marked `#[must_use]`][89692], producing a warning
 197   when ignoring their return value. This helps catch mistakes such as expecting
 198   a function to mutate a value in place rather than return a new value.
 199
 200 Stabilised APIs
 201 ---------------
 202
 203 - [`[T; N]::as_mut_slice`][`array::as_mut_slice`]
 204 - [`[T; N]::as_slice`][`array::as_slice`]
 205 - [`collections::TryReserveError`]
 206 - [`HashMap::try_reserve`]
 207 - [`HashSet::try_reserve`]
 208 - [`String::try_reserve`]
 209 - [`String::try_reserve_exact`]
 210 - [`Vec::try_reserve`]
 211 - [`Vec::try_reserve_exact`]
 212 - [`VecDeque::try_reserve`]
 213 - [`VecDeque::try_reserve_exact`]
 214 - [`Iterator::map_while`]
 215 - [`iter::MapWhile`]
 216 - [`proc_macro::is_available`]
 217 - [`Command::get_program`]
 218 - [`Command::get_args`]
 219 - [`Command::get_envs`]
 220 - [`Command::get_current_dir`]
 221 - [`CommandArgs`]
 222 - [`CommandEnvs`]
 223
 224 These APIs are now usable in const contexts:
 225
 226 - [`hint::unreachable_unchecked`]
 227
 228 Cargo
 229 -----
 230
 231 - [Stabilize custom profiles][cargo/9943]
 232
 233 Compatibility notes
 234 -------------------
 235
 236 Internal changes
 237 ----------------
 238 These changes provide no direct user facing benefits, but represent significant
 239 improvements to the internals and overall performance of rustc
 240 and related tools.
 241
 242 - [Added an experimental backend for codegen with `libgccjit`.][87260]
 243
 244 [86191]: https://github.com/rust-lang/rust/pull/86191/
 245 [87220]: https://github.com/rust-lang/rust/pull/87220/
 246 [87260]: https://github.com/rust-lang/rust/pull/87260/
 247 [88243]: https://github.com/rust-lang/rust/pull/88243/
 248 [88321]: https://github.com/rust-lang/rust/pull/88321/
 249 [88529]: https://github.com/rust-lang/rust/pull/88529/
 250 [88690]: https://github.com/rust-lang/rust/pull/88690/
 251 [88952]: https://github.com/rust-lang/rust/pull/88952/
 252 [89337]: https://github.com/rust-lang/rust/pull/89337/
 253 [89507]: https://github.com/rust-lang/rust/pull/89507/
 254 [89508]: https://github.com/rust-lang/rust/pull/89508/
 255 [89582]: https://github.com/rust-lang/rust/pull/89582/
 256 [89597]: https://github.com/rust-lang/rust/pull/89597/
 257 [89614]: https://github.com/rust-lang/rust/pull/89614/
 258 [89692]: https://github.com/rust-lang/rust/issues/89692/
 259 [cargo/9943]: https://github.com/rust-lang/cargo/pull/9943/
 260 [`array::as_mut_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_mut_slice
 261 [`array::as_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_slice
 262 [`collections::TryReserveError`]: https://doc.rust-lang.org/std/collections/struct.TryReserveError.html
 263 [`HashMap::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_map/struct.HashMap.html#method.try_reserve
 264 [`HashSet::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_set/struct.HashSet.html#method.try_reserve
 265 [`String::try_reserve`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve
 266 [`String::try_reserve_exact`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve_exact
 267 [`Vec::try_reserve`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve
 268 [`Vec::try_reserve_exact`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve_exact
 269 [`VecDeque::try_reserve`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve
 270 [`VecDeque::try_reserve_exact`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve_exact
 271 [`Iterator::map_while`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.map_while
 272 [`iter::MapWhile`]: https://doc.rust-lang.org/std/iter/struct.MapWhile.html
 273 [`proc_macro::is_available`]: https://doc.rust-lang.org/proc_macro/fn.is_available.html
 274 [`Command::get_program`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_program
 275 [`Command::get_args`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_args
 276 [`Command::get_envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_envs
 277 [`Command::get_current_dir`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_current_dir
 278 [`CommandArgs`]: https://doc.rust-lang.org/std/process/struct.CommandArgs.html
 279 [`CommandEnvs`]: https://doc.rust-lang.org/std/process/struct.CommandEnvs.html
 280
 281 Version 1.56.1 (2021-11-01)
 282 ===========================
 283
 284 - New lints to detect the presence of bidirectional-override Unicode
 285   codepoints in the compiled source code ([CVE-2021-42574])
 286
 287 [CVE-2021-42574]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-42574
 288
 289 Version 1.56.0 (2021-10-21)
 290 ========================
 291
 292 Language
 293 --------
 294
 295 - [The 2021 Edition is now stable.][rust#88100]
 296   See [the edition guide][rust-2021-edition-guide] for more details.
 297 - [The pattern in `binding @ pattern` can now also introduce new bindings.][rust#85305]
 298 - [Union field access is permitted in `const fn`.][rust#85769]
 299
 300 [rust-2021-edition-guide]: https://doc.rust-lang.org/nightly/edition-guide/rust-2021/index.html
 301
 302 Compiler
 303 --------
 304
 305 - [Upgrade to LLVM 13.][rust#87570]
 306 - [Support memory, address, and thread sanitizers on aarch64-unknown-freebsd.][rust#88023]
 307 - [Allow specifying a deployment target version for all iOS targets][rust#87699]
 308 - [Warnings can be forced on with `--force-warn`.][rust#87472]
 309   This feature is primarily intended for usage by `cargo fix`, rather than end users.
 310 - [Promote `aarch64-apple-ios-sim` to Tier 2\*.][rust#87760]
 311 - [Add `powerpc-unknown-freebsd` at Tier 3\*.][rust#87370]
 312 - [Add `riscv32imc-esp-espidf` at Tier 3\*.][rust#87666]
 313
 314 \* Refer to Rust's [platform support page][platform-support-doc] for more
 315 information on Rust's tiered platform support.
 316
 317 Libraries
 318 ---------
 319
 320 - [Allow writing of incomplete UTF-8 sequences via stdout/stderr on Windows.][rust#83342]
 321   The Windows console still requires valid Unicode, but this change allows
 322   splitting a UTF-8 character across multiple write calls. This allows, for
 323   instance, programs that just read and write data buffers (e.g. copying a file
 324   to stdout) without regard for Unicode or character boundaries.
 325 - [Prefer `AtomicU{64,128}` over Mutex for Instant backsliding protection.][rust#83093]
 326   For this use case, atomics scale much better under contention.
 327 - [Implement `Extend<(A, B)>` for `(Extend<A>, Extend<B>)`][rust#85835]
 328 - [impl Default, Copy, Clone for std::io::Sink and std::io::Empty][rust#86744]
 329 - [`impl From<[(K, V); N]>` for all collections.][rust#84111]
 330 - [Remove `P: Unpin` bound on impl Future for Pin.][rust#81363]
 331 - [Treat invalid environment variable names as non-existent.][rust#86183]
 332   Previously, the environment functions would panic if given a variable name
 333   with an internal null character or equal sign (`=`). Now, these functions will
 334   just treat such names as non-existent variables, since the OS cannot represent
 335   the existence of a variable with such a name.
 336
 337 Stabilised APIs
 338 ---------------
 339
 340 - [`std::os::unix::fs::chroot`]
 341 - [`UnsafeCell::raw_get`]
 342 - [`BufWriter::into_parts`]
 343 - [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]
 344   These APIs were previously stable in `std`, but are now also available in `core`.
 345 - [`Vec::shrink_to`]
 346 - [`String::shrink_to`]
 347 - [`OsString::shrink_to`]
 348 - [`PathBuf::shrink_to`]
 349 - [`BinaryHeap::shrink_to`]
 350 - [`VecDeque::shrink_to`]
 351 - [`HashMap::shrink_to`]
 352 - [`HashSet::shrink_to`]
 353
 354 These APIs are now usable in const contexts:
 355
 356 - [`std::mem::transmute`]
 357 - [`[T]::first`][`slice::first`]
 358 - [`[T]::split_first`][`slice::split_first`]
 359 - [`[T]::last`][`slice::last`]
 360 - [`[T]::split_last`][`slice::split_last`]
 361
 362 Cargo
 363 -----
 364
 365 - [Cargo supports specifying a minimum supported Rust version in Cargo.toml.][`rust-version`]
 366   This has no effect at present on dependency version selection.
 367   We encourage crates to specify their minimum supported Rust version, and we encourage CI systems
 368   that support Rust code to include a crate's specified minimum version in the test matrix for that
 369   crate by default.
 370
 371 Compatibility notes
 372 -------------------
 373
 374 - [Update to new argument parsing rules on Windows.][rust#87580]
 375   This adjusts Rust's standard library to match the behavior of the standard
 376   libraries for C/C++. The rules have changed slightly over time, and this PR
 377   brings us to the latest set of rules (changed in 2008).
 378 - [Disallow the aapcs calling convention on aarch64][rust#88399]
 379   This was already not supported by LLVM; this change surfaces this lack of
 380   support with a better error message.
 381 - [Make `SEMICOLON_IN_EXPRESSIONS_FROM_MACROS` warn by default][rust#87385]
 382 - [Warn when an escaped newline skips multiple lines.][rust#87671]
 383 - [Calls to `libc::getpid` / `std::process::id` from `Command::pre_exec`
 384    may return different values on glibc <= 2.24.][rust#81825]
 385    Rust now invokes the `clone3` system call directly, when available, to use new functionality
 386    available via that system call. Older versions of glibc cache the result of `getpid`, and only
 387    update that cache when calling glibc's clone/fork functions, so a direct system call bypasses
 388    that cache update. glibc 2.25 and newer no longer cache `getpid` for exactly this reason.
 389
 390 Internal changes
 391 ----------------
 392 These changes provide no direct user facing benefits, but represent significant
 393 improvements to the internals and overall performance of rustc
 394 and related tools.
 395
 396 - [LLVM is compiled with PGO in published x86_64-unknown-linux-gnu artifacts.][rust#88069]
 397   This improves the performance of most Rust builds.
 398 - [Unify representation of macros in internal data structures.][rust#88019]
 399   This change fixes a host of bugs with the handling of macros by the compiler,
 400   as well as rustdoc.
 401
 402 [`std::os::unix::fs::chroot`]: https://doc.rust-lang.org/stable/std/os/unix/fs/fn.chroot.html
 403 [`Iterator::intersperse`]: https://doc.rust-lang.org/stable/std/iter/trait.Iterator.html#method.intersperse
 404 [`Iterator::intersperse_with`]: https://doc.rust-lang.org/stable/std/iter/trait.Iterator.html#method.intersperse
 405 [`UnsafeCell::raw_get`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.raw_get
 406 [`BufWriter::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.BufWriter.html#method.into_parts
 407 [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]: https://github.com/rust-lang/rust/pull/84662
 408 [`Vec::shrink_to`]: https://doc.rust-lang.org/stable/std/vec/struct.Vec.html#method.shrink_to
 409 [`String::shrink_to`]: https://doc.rust-lang.org/stable/std/string/struct.String.html#method.shrink_to
 410 [`OsString::shrink_to`]: https://doc.rust-lang.org/stable/std/ffi/struct.OsString.html#method.shrink_to
 411 [`PathBuf::shrink_to`]: https://doc.rust-lang.org/stable/std/path/struct.PathBuf.html#method.shrink_to
 412 [`BinaryHeap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.BinaryHeap.html#method.shrink_to
 413 [`VecDeque::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.VecDeque.html#method.shrink_to
 414 [`HashMap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_map/struct.HashMap.html#method.shrink_to
 415 [`HashSet::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_set/struct.HashSet.html#method.shrink_to
 416 [`std::mem::transmute`]: https://doc.rust-lang.org/stable/std/mem/fn.transmute.html
 417 [`slice::first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.first
 418 [`slice::split_first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_first
 419 [`slice::last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.last
 420 [`slice::split_last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_last
 421 [`rust-version`]: https://doc.rust-lang.org/nightly/cargo/reference/manifest.html#the-rust-version-field
 422 [rust#87671]: https://github.com/rust-lang/rust/pull/87671
 423 [rust#86183]: https://github.com/rust-lang/rust/pull/86183
 424 [rust#87385]: https://github.com/rust-lang/rust/pull/87385
 425 [rust#88100]: https://github.com/rust-lang/rust/pull/88100
 426 [rust#86860]: https://github.com/rust-lang/rust/pull/86860
 427 [rust#84039]: https://github.com/rust-lang/rust/pull/84039
 428 [rust#86492]: https://github.com/rust-lang/rust/pull/86492
 429 [rust#88363]: https://github.com/rust-lang/rust/pull/88363
 430 [rust#85305]: https://github.com/rust-lang/rust/pull/85305
 431 [rust#87832]: https://github.com/rust-lang/rust/pull/87832
 432 [rust#88069]: https://github.com/rust-lang/rust/pull/88069
 433 [rust#87472]: https://github.com/rust-lang/rust/pull/87472
 434 [rust#87699]: https://github.com/rust-lang/rust/pull/87699
 435 [rust#87570]: https://github.com/rust-lang/rust/pull/87570
 436 [rust#88023]: https://github.com/rust-lang/rust/pull/88023
 437 [rust#87760]: https://github.com/rust-lang/rust/pull/87760
 438 [rust#87370]: https://github.com/rust-lang/rust/pull/87370
 439 [rust#87580]: https://github.com/rust-lang/rust/pull/87580
 440 [rust#83342]: https://github.com/rust-lang/rust/pull/83342
 441 [rust#83093]: https://github.com/rust-lang/rust/pull/83093
 442 [rust#88177]: https://github.com/rust-lang/rust/pull/88177
 443 [rust#88548]: https://github.com/rust-lang/rust/pull/88548
 444 [rust#88551]: https://github.com/rust-lang/rust/pull/88551
 445 [rust#88299]: https://github.com/rust-lang/rust/pull/88299
 446 [rust#88220]: https://github.com/rust-lang/rust/pull/88220
 447 [rust#85835]: https://github.com/rust-lang/rust/pull/85835
 448 [rust#86879]: https://github.com/rust-lang/rust/pull/86879
 449 [rust#86744]: https://github.com/rust-lang/rust/pull/86744
 450 [rust#84662]: https://github.com/rust-lang/rust/pull/84662
 451 [rust#86593]: https://github.com/rust-lang/rust/pull/86593
 452 [rust#81050]: https://github.com/rust-lang/rust/pull/81050
 453 [rust#81363]: https://github.com/rust-lang/rust/pull/81363
 454 [rust#84111]: https://github.com/rust-lang/rust/pull/84111
 455 [rust#85769]: https://github.com/rust-lang/rust/pull/85769#issuecomment-854363720
 456 [rust#88490]: https://github.com/rust-lang/rust/pull/88490
 457 [rust#88269]: https://github.com/rust-lang/rust/pull/88269
 458 [rust#84176]: https://github.com/rust-lang/rust/pull/84176
 459 [rust#88399]: https://github.com/rust-lang/rust/pull/88399
 460 [rust#88227]: https://github.com/rust-lang/rust/pull/88227
 461 [rust#88200]: https://github.com/rust-lang/rust/pull/88200
 462 [rust#82776]: https://github.com/rust-lang/rust/pull/82776
 463 [rust#88077]: https://github.com/rust-lang/rust/pull/88077
 464 [rust#87728]: https://github.com/rust-lang/rust/pull/87728
 465 [rust#87050]: https://github.com/rust-lang/rust/pull/87050
 466 [rust#87619]: https://github.com/rust-lang/rust/pull/87619
 467 [rust#81825]: https://github.com/rust-lang/rust/pull/81825#issuecomment-808406918
 468 [rust#88019]: https://github.com/rust-lang/rust/pull/88019
 469 [rust#87666]: https://github.com/rust-lang/rust/pull/87666
 470
 471 Version 1.55.0 (2021-09-09)
 472 ============================
 473
 474 Language
 475 --------
 476 - [You can now write open "from" range patterns (`X..`), which will start at `X` and
 477   will end at the maximum value of the integer.][83918]
 478 - [You can now explicitly import the prelude of different editions
 479   through `std::prelude` (e.g. `use std::prelude::rust_2021::*;`).][86294]
 480
 481 Compiler
 482 --------
 483 - [Added tier 3\* support for `powerpc64le-unknown-freebsd`.][83572]
 484
 485 \* Refer to Rust's [platform support page][platform-support-doc] for more
 486    information on Rust's tiered platform support.
 487
 488 Libraries
 489 ---------
 490
 491 - [Updated std's float parsing to use the Eisel-Lemire algorithm.][86761]
 492   These improvements should in general provide faster string parsing of floats,
 493   no longer reject certain valid floating point values, and reduce
 494   the produced code size for non-stripped artifacts.
 495 - [`string::Drain` now implements `AsRef<str>` and `AsRef<[u8]>`.][86858]
 496
 497 Stabilised APIs
 498 ---------------
 499
 500 - [`Bound::cloned`]
 501 - [`Drain::as_str`]
 502 - [`IntoInnerError::into_error`]
 503 - [`IntoInnerError::into_parts`]
 504 - [`MaybeUninit::assume_init_mut`]
 505 - [`MaybeUninit::assume_init_ref`]
 506 - [`MaybeUninit::write`]
 507 - [`array::map`]
 508 - [`ops::ControlFlow`]
 509 - [`x86::_bittest`]
 510 - [`x86::_bittestandcomplement`]
 511 - [`x86::_bittestandreset`]
 512 - [`x86::_bittestandset`]
 513 - [`x86_64::_bittest64`]
 514 - [`x86_64::_bittestandcomplement64`]
 515 - [`x86_64::_bittestandreset64`]
 516 - [`x86_64::_bittestandset64`]
 517
 518 The following previously stable functions are now `const`.
 519
 520 - [`str::from_utf8_unchecked`]
 521
 522
 523 Cargo
 524 -----
 525 - [Cargo will now deduplicate compiler diagnostics to the terminal when invoking
 526   rustc in parallel such as when using `cargo test`.][cargo/9675]
 527 - [The package definition in `cargo metadata` now includes the `"default_run"`
 528   field from the manifest.][cargo/9550]
 529 - [Added `cargo d` as an alias for `cargo doc`.][cargo/9680]
 530 - [Added `{lib}` as formatting option for `cargo tree` to print the `"lib_name"`
 531   of packages.][cargo/9663]
 532
 533 Rustdoc
 534 -------
 535 - [Added "Go to item on exact match" search option.][85876]
 536 - [The "Implementors" section on traits no longer shows redundant
 537   method definitions.][85970]
 538 - [Trait implementations are toggled open by default.][86260] This should make the
 539   implementations more searchable by tools like `CTRL+F` in your browser.
 540 - [Intra-doc links should now correctly resolve associated items (e.g. methods)
 541   through type aliases.][86334]
 542 - [Traits which are marked with `#[doc(hidden)]` will no longer appear in the
 543   "Trait Implementations" section.][86513]
 544
 545
 546 Compatibility Notes
 547 -------------------
 548 - [std functions that return an `io::Error` will no longer use the
 549   `ErrorKind::Other` variant.][85746] This is to better reflect that these
 550   kinds of errors could be categorised [into newer more specific `ErrorKind`
 551   variants][79965], and that they do not represent a user error.
 552 - [Using environment variable names with `process::Command` on Windows now
 553   behaves as expected.][85270] Previously using envionment variables with
 554   `Command` would cause them to be ASCII-uppercased.
 555 - [Rustdoc will now warn on using rustdoc lints that aren't prefixed
 556   with `rustdoc::`][86849]
 557 - `RUSTFLAGS` is no longer set for build scripts. Build scripts
 558   should use `CARGO_ENCODED_RUSTFLAGS` instead. See the
 559   [documentation](https://doc.rust-lang.org/nightly/cargo/reference/environment-variables.html#environment-variables-cargo-sets-for-build-scripts)
 560   for more details.
 561
 562 [86849]: https://github.com/rust-lang/rust/pull/86849
 563 [86513]: https://github.com/rust-lang/rust/pull/86513
 564 [86334]: https://github.com/rust-lang/rust/pull/86334
 565 [86260]: https://github.com/rust-lang/rust/pull/86260
 566 [85970]: https://github.com/rust-lang/rust/pull/85970
 567 [85876]: https://github.com/rust-lang/rust/pull/85876
 568 [83572]: https://github.com/rust-lang/rust/pull/83572
 569 [86294]: https://github.com/rust-lang/rust/pull/86294
 570 [86858]: https://github.com/rust-lang/rust/pull/86858
 571 [86761]: https://github.com/rust-lang/rust/pull/86761
 572 [85769]: https://github.com/rust-lang/rust/pull/85769
 573 [85746]: https://github.com/rust-lang/rust/pull/85746
 574 [85305]: https://github.com/rust-lang/rust/pull/85305
 575 [85270]: https://github.com/rust-lang/rust/pull/85270
 576 [84111]: https://github.com/rust-lang/rust/pull/84111
 577 [83918]: https://github.com/rust-lang/rust/pull/83918
 578 [79965]: https://github.com/rust-lang/rust/pull/79965
 579 [87370]: https://github.com/rust-lang/rust/pull/87370
 580 [87298]: https://github.com/rust-lang/rust/pull/87298
 581 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
 582 [cargo/9675]: https://github.com/rust-lang/cargo/pull/9675
 583 [cargo/9550]: https://github.com/rust-lang/cargo/pull/9550
 584 [cargo/9680]: https://github.com/rust-lang/cargo/pull/9680
 585 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
 586 [`array::map`]: https://doc.rust-lang.org/stable/std/primitive.array.html#method.map
 587 [`Bound::cloned`]: https://doc.rust-lang.org/stable/std/ops/enum.Bound.html#method.cloned
 588 [`Drain::as_str`]: https://doc.rust-lang.org/stable/std/string/struct.Drain.html#method.as_str
 589 [`IntoInnerError::into_error`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_error
 590 [`IntoInnerError::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_parts
 591 [`MaybeUninit::assume_init_mut`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_mut
 592 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
 593 [`MaybeUninit::write`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.write
 594 [`Seek::rewind`]: https://doc.rust-lang.org/stable/std/io/trait.Seek.html#method.rewind
 595 [`ops::ControlFlow`]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html
 596 [`str::from_utf8_unchecked`]: https://doc.rust-lang.org/stable/std/str/fn.from_utf8_unchecked.html
 597 [`x86::_bittest`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittest.html
 598 [`x86::_bittestandcomplement`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandcomplement.html
 599 [`x86::_bittestandreset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandreset.html
 600 [`x86::_bittestandset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandset.html
 601 [`x86_64::_bittest64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittest64.html
 602 [`x86_64::_bittestandcomplement64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandcomplement64.html
 603 [`x86_64::_bittestandreset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandreset64.html
 604 [`x86_64::_bittestandset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandset64.html
 605
 606
 607 Version 1.54.0 (2021-07-29)
 608 ============================
 609
 610 Language
 611 -----------------------
 612
 613 - [You can now use macros for values in some built-in attributes.][83366]
 614   This primarily allows you to call macros within the `#[doc]` attribute. For
 615   example, to include external documentation in your crate, you can now write
 616   the following:
 617   ```rust
 618   #![doc = include_str!("README.md")]
 619   ```
 620
 621 - [You can now cast between unsized slice types (and types which contain
 622   unsized slices) in `const fn`.][85078]
 623 - [You can now use multiple generic lifetimes with `impl Trait` where the
 624    lifetimes don't explicitly outlive another.][84701] In code this means
 625    that you can now have `impl Trait<'a, 'b>` where as before you could
 626    only have `impl Trait<'a, 'b> where 'b: 'a`.
 627
 628 Compiler
 629 -----------------------
 630
 631 - [Rustc will now search for custom JSON targets in
 632   `/lib/rustlib/<target-triple>/target.json` where `/` is the "sysroot"
 633   directory.][83800] You can find your sysroot directory by running
 634   `rustc --print sysroot`.
 635 - [Added `wasm` as a `target_family` for WebAssembly platforms.][84072]
 636 - [You can now use `#[target_feature]` on safe functions when targeting
 637   WebAssembly platforms.][84988]
 638 - [Improved debugger output for enums on Windows MSVC platforms.][85292]
 639 - [Added tier 3\* support for `bpfel-unknown-none`
 640    and `bpfeb-unknown-none`.][79608]
 641 - [`-Zmutable-noalias=yes`][82834] is enabled by default when using LLVM 12 or above.
 642
 643 \* Refer to Rust's [platform support page][platform-support-doc] for more
 644    information on Rust's tiered platform support.
 645
 646 Libraries
 647 -----------------------
 648
 649 - [`panic::panic_any` will now `#[track_caller]`.][85745]
 650 - [Added `OutOfMemory` as a variant of `io::ErrorKind`.][84744]
 651 - [ `proc_macro::Literal` now implements `FromStr`.][84717]
 652 - [The implementations of vendor intrinsics in core::arch have been
 653    significantly refactored.][83278] The main user-visible changes are
 654    a 50% reduction in the size of libcore.rlib and stricter validation
 655    of constant operands passed to intrinsics. The latter is technically
 656    a breaking change, but allows Rust to more closely match the C vendor
 657    intrinsics API.
 658
 659 Stabilized APIs
 660 ---------------
 661
 662 - [`BTreeMap::into_keys`]
 663 - [`BTreeMap::into_values`]
 664 - [`HashMap::into_keys`]
 665 - [`HashMap::into_values`]
 666 - [`arch::wasm32`]
 667 - [`VecDeque::binary_search`]
 668 - [`VecDeque::binary_search_by`]
 669 - [`VecDeque::binary_search_by_key`]
 670 - [`VecDeque::partition_point`]
 671
 672 Cargo
 673 -----
 674
 675 - [Added the `--prune <spec>` option to `cargo-tree` to remove a package from
 676   the dependency graph.][cargo/9520]
 677 - [Added the `--depth` option to `cargo-tree` to print only to a certain depth
 678   in the tree ][cargo/9499]
 679 - [Added the `no-proc-macro` value to `cargo-tree --edges` to hide procedural
 680   macro dependencies.][cargo/9488]
 681 - [A new environment variable named `CARGO_TARGET_TMPDIR` is available.][cargo/9375]
 682   This variable points to a directory that integration tests and benches
 683   can use as a "scratchpad" for testing filesystem operations.
 684
 685 Compatibility Notes
 686 -------------------
 687 - [Mixing Option and Result via `?` is no longer permitted in closures for inferred types.][86831]
 688 - [Previously unsound code is no longer permitted where different constructors in branches
 689   could require different lifetimes.][85574]
 690 - As previously mentioned the [`std::arch` instrinsics now uses stricter const checking][83278]
 691   than before and may reject some previously accepted code.
 692 - [`i128` multiplication on Cortex M0+ platforms currently unconditionally causes overflow
 693    when compiled with `codegen-units = 1`.][86063]
 694
 695 [85574]: https://github.com/rust-lang/rust/issues/85574
 696 [86831]: https://github.com/rust-lang/rust/issues/86831
 697 [86063]: https://github.com/rust-lang/rust/issues/86063
 698 [86831]: https://github.com/rust-lang/rust/issues/86831
 699 [79608]: https://github.com/rust-lang/rust/pull/79608
 700 [84988]: https://github.com/rust-lang/rust/pull/84988
 701 [84701]: https://github.com/rust-lang/rust/pull/84701
 702 [84072]: https://github.com/rust-lang/rust/pull/84072
 703 [85745]: https://github.com/rust-lang/rust/pull/85745
 704 [84744]: https://github.com/rust-lang/rust/pull/84744
 705 [85078]: https://github.com/rust-lang/rust/pull/85078
 706 [84717]: https://github.com/rust-lang/rust/pull/84717
 707 [83800]: https://github.com/rust-lang/rust/pull/83800
 708 [83366]: https://github.com/rust-lang/rust/pull/83366
 709 [83278]: https://github.com/rust-lang/rust/pull/83278
 710 [85292]: https://github.com/rust-lang/rust/pull/85292
 711 [82834]: https://github.com/rust-lang/rust/pull/82834
 712 [cargo/9520]: https://github.com/rust-lang/cargo/pull/9520
 713 [cargo/9499]: https://github.com/rust-lang/cargo/pull/9499
 714 [cargo/9488]: https://github.com/rust-lang/cargo/pull/9488
 715 [cargo/9375]: https://github.com/rust-lang/cargo/pull/9375
 716 [`BTreeMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_keys
 717 [`BTreeMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_values
 718 [`HashMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_keys
 719 [`HashMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_values
 720 [`arch::wasm32`]: https://doc.rust-lang.org/core/arch/wasm32/index.html
 721 [`VecDeque::binary_search`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search
 722 [`VecDeque::binary_search_by`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by
 723
 724 [`VecDeque::binary_search_by_key`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by_key
 725
 726 [`VecDeque::partition_point`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.partition_point
 727
 728 Version 1.53.0 (2021-06-17)
 729 ============================
 730
 731 Language
 732 -----------------------
 733 - [You can now use unicode for identifiers.][83799] This allows multilingual
 734   identifiers but still doesn't allow glyphs that are not considered characters
 735   such as `◆` or `🦀`. More specifically you can now use any identifier that
 736   matches the UAX #31 "Unicode Identifier and Pattern Syntax" standard. This
 737   is the same standard as languages like Python, however Rust uses NFC
 738   normalization which may be different from other languages.
 739 - [You can now specify "or patterns" inside pattern matches.][79278]
 740   Previously you could only use `|` (OR) on complete patterns. E.g.
 741   ```rust
 742   let x = Some(2u8);
 743   // Before
 744   matches!(x, Some(1) | Some(2));
 745   // Now
 746   matches!(x, Some(1 | 2));
 747   ```
 748 - [Added the `:pat_param` `macro_rules!` matcher.][83386] This matcher
 749   has the same semantics as the `:pat` matcher. This is to allow `:pat`
 750   to change semantics to being a pattern fragment in a future edition.
 751
 752 Compiler
 753 -----------------------
 754 - [Updated the minimum external LLVM version to LLVM 10.][83387]
 755 - [Added Tier 3\* support for the `wasm64-unknown-unknown` target.][80525]
 756 - [Improved debuginfo for closures and async functions on Windows MSVC.][83941]
 757
 758 \* Refer to Rust's [platform support page][platform-support-doc] for more
 759 information on Rust's tiered platform support.
 760
 761 Libraries
 762 -----------------------
 763 - [Abort messages will now forward to `android_set_abort_message` on
 764   Android platforms when available.][81469]
 765 - [`slice::IterMut<'_, T>` now implements `AsRef<[T]>`][82771]
 766 - [Arrays of any length now implement `IntoIterator`.][84147]
 767   Currently calling `.into_iter()` as a method on an array will
 768   return `impl Iterator<Item=&T>`, but this may change in a
 769   future edition to change `Item` to `T`. Calling `IntoIterator::into_iter`
 770   directly on arrays will provide `impl Iterator<Item=T>` as expected.
 771 - [`leading_zeros`, and `trailing_zeros` are now available on all
 772   `NonZero` integer types.][84082]
 773 - [`{f32, f64}::from_str` now parse and print special values
 774   (`NaN`, `-0`) according to IEEE 754.][78618]
 775 - [You can now index into slices using `(Bound<usize>, Bound<usize>)`.][77704]
 776 - [Add the `BITS` associated constant to all numeric types.][82565]
 777
 778 Stabilised APIs
 779 ---------------
 780 - [`AtomicBool::fetch_update`]
 781 - [`AtomicPtr::fetch_update`]
 782 - [`BTreeMap::retain`]
 783 - [`BTreeSet::retain`]
 784 - [`BufReader::seek_relative`]
 785 - [`DebugStruct::non_exhaustive`]
 786 - [`Duration::MAX`]
 787 - [`Duration::ZERO`]
 788 - [`Duration::is_zero`]
 789 - [`Duration::saturating_add`]
 790 - [`Duration::saturating_mul`]
 791 - [`Duration::saturating_sub`]
 792 - [`ErrorKind::Unsupported`]
 793 - [`Option::insert`]
 794 - [`Ordering::is_eq`]
 795 - [`Ordering::is_ge`]
 796 - [`Ordering::is_gt`]
 797 - [`Ordering::is_le`]
 798 - [`Ordering::is_lt`]
 799 - [`Ordering::is_ne`]
 800 - [`OsStr::is_ascii`]
 801 - [`OsStr::make_ascii_lowercase`]
 802 - [`OsStr::make_ascii_uppercase`]
 803 - [`OsStr::to_ascii_lowercase`]
 804 - [`OsStr::to_ascii_uppercase`]
 805 - [`Peekable::peek_mut`]
 806 - [`Rc::decrement_strong_count`]
 807 - [`Rc::increment_strong_count`]
 808 - [`Vec::extend_from_within`]
 809 - [`array::from_mut`]
 810 - [`array::from_ref`]
 811 - [`cmp::max_by_key`]
 812 - [`cmp::max_by`]
 813 - [`cmp::min_by_key`]
 814 - [`cmp::min_by`]
 815 - [`f32::is_subnormal`]
 816 - [`f64::is_subnormal`]
 817
 818 Cargo
 819 -----------------------
 820 - [Cargo now supports git repositories where the default `HEAD` branch is not
 821   "master".][cargo/9392] This also includes a switch to the version 3 `Cargo.lock` format
 822   which can handle default branches correctly.
 823 - [macOS targets now default to `unpacked` split-debuginfo.][cargo/9298]
 824 - [The `authors` field is no longer included in `Cargo.toml` for new
 825   projects.][cargo/9282]
 826
 827 Rustdoc
 828 -----------------------
 829 - [Added the `rustdoc::bare_urls` lint that warns when you have URLs
 830   without hyperlinks.][81764]
 831
 832 Compatibility Notes
 833 -------------------
 834 - [Implement token-based handling of attributes during expansion][82608]
 835 - [`Ipv4::from_str` will now reject octal format IP addresses in addition
 836   to rejecting hexadecimal IP addresses.][83652] The octal format can lead
 837   to confusion and potential security vulnerabilities and [is no
 838   longer recommended][ietf6943].
 839 - [The added `BITS` constant may conflict with external definitions.][85667]
 840   In particular, this was known to be a problem in the `lexical-core` crate,
 841   but they have published fixes for semantic versions 0.4 through 0.7. To
 842   update this dependency alone, use `cargo update -p lexical-core`.
 843 - Incremental compilation remains off by default, unless one uses the `RUSTC_FORCE_INCREMENTAL=1` environment variable added in 1.52.1.
 844
 845 Internal Only
 846 -------------
 847 These changes provide no direct user facing benefits, but represent significant
 848 improvements to the internals and overall performance of rustc and
 849 related tools.
 850
 851 - [Rework the `std::sys::windows::alloc` implementation.][83065]
 852 - [rustdoc: Don't enter an infer_ctxt in get_blanket_impls for impls that aren't blanket impls.][82864]
 853 - [rustdoc: Only look at blanket impls in `get_blanket_impls`][83681]
 854 - [Rework rustdoc const type][82873]
 855
 856 [85667]: https://github.com/rust-lang/rust/pull/85667
 857 [83386]: https://github.com/rust-lang/rust/pull/83386
 858 [82771]: https://github.com/rust-lang/rust/pull/82771
 859 [84147]: https://github.com/rust-lang/rust/pull/84147
 860 [84082]: https://github.com/rust-lang/rust/pull/84082
 861 [83799]: https://github.com/rust-lang/rust/pull/83799
 862 [83681]: https://github.com/rust-lang/rust/pull/83681
 863 [83652]: https://github.com/rust-lang/rust/pull/83652
 864 [83387]: https://github.com/rust-lang/rust/pull/83387
 865 [82873]: https://github.com/rust-lang/rust/pull/82873
 866 [82864]: https://github.com/rust-lang/rust/pull/82864
 867 [82608]: https://github.com/rust-lang/rust/pull/82608
 868 [82565]: https://github.com/rust-lang/rust/pull/82565
 869 [80525]: https://github.com/rust-lang/rust/pull/80525
 870 [79278]: https://github.com/rust-lang/rust/pull/79278
 871 [78618]: https://github.com/rust-lang/rust/pull/78618
 872 [77704]: https://github.com/rust-lang/rust/pull/77704
 873 [83941]: https://github.com/rust-lang/rust/pull/83941
 874 [83065]: https://github.com/rust-lang/rust/pull/83065
 875 [81764]: https://github.com/rust-lang/rust/pull/81764
 876 [81469]: https://github.com/rust-lang/rust/pull/81469
 877 [cargo/9298]: https://github.com/rust-lang/cargo/pull/9298
 878 [cargo/9282]: https://github.com/rust-lang/cargo/pull/9282
 879 [cargo/9392]: https://github.com/rust-lang/cargo/pull/9392
 880 [`AtomicBool::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicBool.html#method.fetch_update
 881 [`AtomicPtr::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicPtr.html#method.fetch_update
 882 [`BTreeMap::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.retain
 883 [`BTreeSet::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeSet.html#method.retain
 884 [`BufReader::seek_relative`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.seek_relative
 885 [`DebugStruct::non_exhaustive`]: https://doc.rust-lang.org/std/fmt/struct.DebugStruct.html#method.finish_non_exhaustive
 886 [`Duration::MAX`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
 887 [`Duration::ZERO`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.ZERO
 888 [`Duration::is_zero`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.is_zero
 889 [`Duration::saturating_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_add
 890 [`Duration::saturating_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_mul
 891 [`Duration::saturating_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_sub
 892 [`ErrorKind::Unsupported`]: https://doc.rust-lang.org/std/io/enum.ErrorKind.html#variant.Unsupported
 893 [`Option::insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.insert
 894 [`Ordering::is_eq`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_eq
 895 [`Ordering::is_ge`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ge
 896 [`Ordering::is_gt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_gt
 897 [`Ordering::is_le`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_le
 898 [`Ordering::is_lt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_lt
 899 [`Ordering::is_ne`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ne
 900 [`OsStr::eq_ignore_ascii_case`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.eq_ignore_ascii_case
 901 [`OsStr::is_ascii`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.is_ascii
 902 [`OsStr::make_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_lowercase
 903 [`OsStr::make_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_uppercase
 904 [`OsStr::to_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_lowercase
 905 [`OsStr::to_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_uppercase
 906 [`Peekable::peek_mut`]: https://doc.rust-lang.org/std/iter/struct.Peekable.html#method.peek_mut
 907 [`Rc::decrement_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
 908 [`Rc::increment_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
 909 [`Vec::extend_from_within`]: https://doc.rust-lang.org/beta/std/vec/struct.Vec.html#method.extend_from_within
 910 [`array::from_mut`]: https://doc.rust-lang.org/beta/std/array/fn.from_mut.html
 911 [`array::from_ref`]: https://doc.rust-lang.org/beta/std/array/fn.from_ref.html
 912 [`cmp::max_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by_key.html
 913 [`cmp::max_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by.html
 914 [`cmp::min_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by_key.html
 915 [`cmp::min_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by.html
 916 [`f32::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
 917 [`f64::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
 918 [ietf6943]: https://datatracker.ietf.org/doc/html/rfc6943#section-3.1.1
 919
 920
 921 Version 1.52.1 (2021-05-10)
 922 ============================
 923
 924 This release disables incremental compilation, unless the user has explicitly
 925 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
 926
 927 This is due to the widespread, and frequently occuring, breakage encountered by
 928 Rust users due to newly enabled incremental verification in 1.52.0. Notably,
 929 Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
 930 newly added incremental verification are still present in past stable versions,
 931 and are not yet fixed on any channel. These bugs can lead to miscompilation of
 932 Rust binaries.
 933
 934 These problems only affect incremental builds, so release builds with Cargo
 935 should not be affected unless the user has explicitly opted into incremental.
 936 Debug and check builds are affected.
 937
 938 See [84970] for more details.
 939
 940 [84970]: https://github.com/rust-lang/rust/issues/84970
 941
 942 Version 1.52.0 (2021-05-06)
 943 ============================
 944
 945 Language
 946 --------
 947 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
 948   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
 949   is allowed by default, and may become a warning or hard error in a
 950   future edition.
 951 - [You can now cast mutable references to arrays to a pointer of the same type as
 952   the element.][81479]
 953
 954 Compiler
 955 --------
 956 - [Upgraded the default LLVM to LLVM 12.][81451]
 957
 958 Added tier 3\* support for the following targets.
 959
 960 - [`s390x-unknown-linux-musl`][82166]
 961 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
 962 - [`powerpc-unknown-openbsd`][82733]
 963
 964 \* Refer to Rust's [platform support page][platform-support-doc] for more
 965 information on Rust's tiered platform support.
 966
 967 Libraries
 968 ---------
 969 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
 970 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
 971 - [`Arc<impl Error>` now implements `error::Error`.][80553]
 972 - [All integer division and remainder operations are now `const`.][80962]
 973
 974 Stabilised APIs
 975 -------------
 976 - [`Arguments::as_str`]
 977 - [`char::MAX`]
 978 - [`char::REPLACEMENT_CHARACTER`]
 979 - [`char::UNICODE_VERSION`]
 980 - [`char::decode_utf16`]
 981 - [`char::from_digit`]
 982 - [`char::from_u32_unchecked`]
 983 - [`char::from_u32`]
 984 - [`slice::partition_point`]
 985 - [`str::rsplit_once`]
 986 - [`str::split_once`]
 987
 988 The following previously stable APIs are now `const`.
 989
 990 - [`char::len_utf8`]
 991 - [`char::len_utf16`]
 992 - [`char::to_ascii_uppercase`]
 993 - [`char::to_ascii_lowercase`]
 994 - [`char::eq_ignore_ascii_case`]
 995 - [`u8::to_ascii_uppercase`]
 996 - [`u8::to_ascii_lowercase`]
 997 - [`u8::eq_ignore_ascii_case`]
 998
 999 Rustdoc
1000 -------
1001 - [Rustdoc lints are now treated as a tool lint, meaning that
1002   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
1003   Using the old style is still allowed, and will become a warning in
1004   a future release.
1005 - [Rustdoc now supports argument files.][82261]
1006 - [Rustdoc now generates smart punctuation for documentation.][79423]
1007 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
1008   ```markdown
1009   - [x] Complete
1010   - [ ] Todo
1011   ```
1012
1013 Misc
1014 ----
1015 - [You can now pass multiple filters to tests.][81356] E.g.
1016   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
1017 - [Rustup now distributes PDB symbols for the `std` library on Windows,
1018   allowing you to see `std` symbols when debugging.][82218]
1019
1020 Internal Only
1021 -------------
1022 These changes provide no direct user facing benefits, but represent significant
1023 improvements to the internals and overall performance of rustc and
1024 related tools.
1025
1026 - [Check the result cache before the DepGraph when ensuring queries][81855]
1027 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
1028 - [Only store a LocalDefId in some HIR nodes][81611]
1029 - [Store HIR attributes in a side table][79519]
1030
1031 Compatibility Notes
1032 -------------------
1033 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
1034 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
1035 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
1036 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
1037   languages in code blocks.][78429]
1038 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
1039 - [Changes in how proc macros handle whitespace may lead to panics when used
1040   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
1041 - [Turn `#[derive]` into a regular macro attribute][79078]
1042
1043 [84136]: https://github.com/rust-lang/rust/issues/84136
1044 [80763]: https://github.com/rust-lang/rust/pull/80763
1045 [82166]: https://github.com/rust-lang/rust/pull/82166
1046 [82121]: https://github.com/rust-lang/rust/pull/82121
1047 [81879]: https://github.com/rust-lang/rust/pull/81879
1048 [82261]: https://github.com/rust-lang/rust/pull/82261
1049 [82218]: https://github.com/rust-lang/rust/pull/82218
1050 [82216]: https://github.com/rust-lang/rust/pull/82216
1051 [82202]: https://github.com/rust-lang/rust/pull/82202
1052 [81855]: https://github.com/rust-lang/rust/pull/81855
1053 [81766]: https://github.com/rust-lang/rust/pull/81766
1054 [81744]: https://github.com/rust-lang/rust/pull/81744
1055 [81611]: https://github.com/rust-lang/rust/pull/81611
1056 [81479]: https://github.com/rust-lang/rust/pull/81479
1057 [81451]: https://github.com/rust-lang/rust/pull/81451
1058 [81356]: https://github.com/rust-lang/rust/pull/81356
1059 [80962]: https://github.com/rust-lang/rust/pull/80962
1060 [80553]: https://github.com/rust-lang/rust/pull/80553
1061 [80527]: https://github.com/rust-lang/rust/pull/80527
1062 [79519]: https://github.com/rust-lang/rust/pull/79519
1063 [79423]: https://github.com/rust-lang/rust/pull/79423
1064 [79208]: https://github.com/rust-lang/rust/pull/79208
1065 [78429]: https://github.com/rust-lang/rust/pull/78429
1066 [82733]: https://github.com/rust-lang/rust/pull/82733
1067 [82594]: https://github.com/rust-lang/rust/pull/82594
1068 [79078]: https://github.com/rust-lang/rust/pull/79078
1069 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
1070 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
1071 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
1072 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
1073 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
1074 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
1075 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
1076 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
1077 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
1078 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
1079 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
1080 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
1081 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
1082 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
1083 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
1084 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
1085 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
1086 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
1087 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
1088 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
1089 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
1090 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
1091
1092 Version 1.51.0 (2021-03-25)
1093 ============================
1094
1095 Language
1096 --------
1097 - [You can now parameterize items such as functions, traits, and `struct`s by constant
1098   values in addition to by types and lifetimes.][79135] Also known as "const generics"
1099   E.g. you can now write the following. Note: Only values of primitive integers,
1100   `bool`, or `char` types are currently permitted.
1101   ```rust
1102   struct GenericArray<T, const LENGTH: usize> {
1103       inner: [T; LENGTH]
1104   }
1105
1106   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
1107       const fn last(&self) -> Option<&T> {
1108           if LENGTH == 0 {
1109               None
1110           } else {
1111               Some(&self.inner[LENGTH - 1])
1112           }
1113       }
1114   }
1115   ```
1116
1117
1118 Compiler
1119 --------
1120
1121 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
1122   This option controls whether debug information is split across multiple files
1123   or packed into a single file. **Note** This option is unstable on other platforms.
1124 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
1125   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
1126 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
1127 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
1128
1129 \* Refer to Rust's [platform support page][platform-support-doc] for more
1130 information on Rust's tiered platform support.
1131
1132 Libraries
1133 ---------
1134
1135 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
1136 - [`str` now implements `AsMut<str>`.][80279]
1137 - [`u64` and `u128` now implement `From<char>`.][79502]
1138 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
1139 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
1140 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
1141 - [`io::Empty` now implements `io::Seek`.][78044]
1142 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
1143   `T: ?Sized` types.][80764]
1144 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
1145
1146
1147 Stabilized APIs
1148 ---------------
1149
1150 - [`Arc::decrement_strong_count`]
1151 - [`Arc::increment_strong_count`]
1152 - [`Once::call_once_force`]
1153 - [`Peekable::next_if_eq`]
1154 - [`Peekable::next_if`]
1155 - [`Seek::stream_position`]
1156 - [`array::IntoIter`]
1157 - [`panic::panic_any`]
1158 - [`ptr::addr_of!`]
1159 - [`ptr::addr_of_mut!`]
1160 - [`slice::fill_with`]
1161 - [`slice::split_inclusive_mut`]
1162 - [`slice::split_inclusive`]
1163 - [`slice::strip_prefix`]
1164 - [`slice::strip_suffix`]
1165 - [`str::split_inclusive`]
1166 - [`sync::OnceState`]
1167 - [`task::Wake`]
1168 - [`VecDeque::range`]
1169 - [`VecDeque::range_mut`]
1170
1171 Cargo
1172 -----
1173 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
1174   codegen option.][cargo/9112]
1175 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
1176   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
1177   to avoid unifying features of dependencies where that unification could be unwanted.
1178   Such as using the same dependency with a `std` feature in a build scripts and
1179   proc-macros, while using the `no-std` feature in the final binary. See the
1180   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
1181
1182 Rustdoc
1183 -------
1184
1185 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
1186 - [You can now provide a `--default-theme` flag which sets the default theme to use for
1187   documentation.][79642]
1188
1189 Various improvements to intra-doc links:
1190
1191 - [You can link to non-path primitives such as `slice`.][80181]
1192 - [You can link to associated items.][74489]
1193 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
1194
1195 Misc
1196 ----
1197 - [You can now pass `--include-ignored` to tests (e.g. with
1198   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
1199
1200 Compatibility Notes
1201 -------------------
1202
1203 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
1204 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
1205   could fail.][80579]
1206 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
1207   for the distributed artifacts.][81521]
1208     - `armv5te-unknown-linux-gnueabi`
1209     - `sparc64-unknown-linux-gnu`
1210     - `thumbv7neon-unknown-linux-gnueabihf`
1211     - `armv7-unknown-linux-gnueabi`
1212     - `x86_64-unknown-linux-gnux32`
1213 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
1214
1215 Internal Only
1216 -------------
1217
1218 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
1219
1220 [79135]: https://github.com/rust-lang/rust/pull/79135
1221 [74489]: https://github.com/rust-lang/rust/pull/74489
1222 [76934]: https://github.com/rust-lang/rust/pull/76934
1223 [79570]: https://github.com/rust-lang/rust/pull/79570
1224 [80181]: https://github.com/rust-lang/rust/pull/80181
1225 [79642]: https://github.com/rust-lang/rust/pull/79642
1226 [80945]: https://github.com/rust-lang/rust/pull/80945
1227 [80279]: https://github.com/rust-lang/rust/pull/80279
1228 [80053]: https://github.com/rust-lang/rust/pull/80053
1229 [79502]: https://github.com/rust-lang/rust/pull/79502
1230 [75180]: https://github.com/rust-lang/rust/pull/75180
1231 [79135]: https://github.com/rust-lang/rust/pull/79135
1232 [81521]: https://github.com/rust-lang/rust/pull/81521
1233 [80968]: https://github.com/rust-lang/rust/pull/80968
1234 [80959]: https://github.com/rust-lang/rust/pull/80959
1235 [80718]: https://github.com/rust-lang/rust/pull/80718
1236 [80653]: https://github.com/rust-lang/rust/pull/80653
1237 [80579]: https://github.com/rust-lang/rust/pull/80579
1238 [79998]: https://github.com/rust-lang/rust/pull/79998
1239 [78044]: https://github.com/rust-lang/rust/pull/78044
1240 [81455]: https://github.com/rust-lang/rust/pull/81455
1241 [80764]: https://github.com/rust-lang/rust/pull/80764
1242 [80749]: https://github.com/rust-lang/rust/pull/80749
1243 [80662]: https://github.com/rust-lang/rust/pull/80662
1244 [79134]: https://github.com/rust-lang/rust/pull/79134
1245 [80966]: https://github.com/rust-lang/rust/pull/80966
1246 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
1247 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
1248 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
1249 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
1250 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
1251 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
1252 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
1253 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
1254 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
1255 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
1256 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
1257 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
1258 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
1259 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
1260 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
1261 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
1262 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
1263 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
1264 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
1265 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
1266 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
1267 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
1268 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
1269
1270 Version 1.50.0 (2021-02-11)
1271 ============================
1272
1273 Language
1274 -----------------------
1275 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
1276   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
1277 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
1278
1279 Compiler
1280 -----------------------
1281 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
1282 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
1283 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
1284 - [Dropped support for all cloudabi targets.][78439]
1285
1286 \* Refer to Rust's [platform support page][platform-support-doc] for more
1287 information on Rust's tiered platform support.
1288
1289 Libraries
1290 -----------------------
1291
1292 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
1293 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
1294 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
1295   This value cannot be a valid file descriptor, and now means `Option<File>` takes
1296   up the same amount of space as `File`.
1297
1298 Stabilized APIs
1299 ---------------
1300
1301 - [`bool::then`]
1302 - [`btree_map::Entry::or_insert_with_key`]
1303 - [`f32::clamp`]
1304 - [`f64::clamp`]
1305 - [`hash_map::Entry::or_insert_with_key`]
1306 - [`Ord::clamp`]
1307 - [`RefCell::take`]
1308 - [`slice::fill`]
1309 - [`UnsafeCell::get_mut`]
1310
1311 The following previously stable methods are now `const`.
1312
1313 - [`IpAddr::is_ipv4`]
1314 - [`IpAddr::is_ipv6`]
1315 - [`IpAddr::is_unspecified`]
1316 - [`IpAddr::is_loopback`]
1317 - [`IpAddr::is_multicast`]
1318 - [`Ipv4Addr::octets`]
1319 - [`Ipv4Addr::is_loopback`]
1320 - [`Ipv4Addr::is_private`]
1321 - [`Ipv4Addr::is_link_local`]
1322 - [`Ipv4Addr::is_multicast`]
1323 - [`Ipv4Addr::is_broadcast`]
1324 - [`Ipv4Addr::is_documentation`]
1325 - [`Ipv4Addr::to_ipv6_compatible`]
1326 - [`Ipv4Addr::to_ipv6_mapped`]
1327 - [`Ipv6Addr::segments`]
1328 - [`Ipv6Addr::is_unspecified`]
1329 - [`Ipv6Addr::is_loopback`]
1330 - [`Ipv6Addr::is_multicast`]
1331 - [`Ipv6Addr::to_ipv4`]
1332 - [`Layout::size`]
1333 - [`Layout::align`]
1334 - [`Layout::from_size_align`]
1335 - `pow` for all integer types.
1336 - `checked_pow` for all integer types.
1337 - `saturating_pow` for all integer types.
1338 - `wrapping_pow` for all integer types.
1339 - `next_power_of_two` for all unsigned integer types.
1340 - `checked_next_power_of_two` for all unsigned integer types.
1341
1342 Cargo
1343 -----------------------
1344
1345 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
1346   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
1347 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
1348   contents of that directory for changes.][cargo/8973]
1349 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
1350
1351 Misc
1352 ----
1353
1354 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
1355 - [Running tests will now print the total time taken to execute.][75752]
1356
1357 Compatibility Notes
1358 -------------------
1359
1360 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
1361   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
1362 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
1363   unhygenic `macro_rules!` macros.][79472]
1364 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
1365   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
1366 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
1367 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
1368   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
1369 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
1370
1371 [74989]: https://github.com/rust-lang/rust/pull/74989
1372 [79261]: https://github.com/rust-lang/rust/pull/79261
1373 [79896]: https://github.com/rust-lang/rust/pull/79896
1374 [79484]: https://github.com/rust-lang/rust/pull/79484
1375 [79472]: https://github.com/rust-lang/rust/pull/79472
1376 [79270]: https://github.com/rust-lang/rust/pull/79270
1377 [79003]: https://github.com/rust-lang/rust/pull/79003
1378 [78864]: https://github.com/rust-lang/rust/pull/78864
1379 [78636]: https://github.com/rust-lang/rust/pull/78636
1380 [78439]: https://github.com/rust-lang/rust/pull/78439
1381 [78343]: https://github.com/rust-lang/rust/pull/78343
1382 [78296]: https://github.com/rust-lang/rust/pull/78296
1383 [78068]: https://github.com/rust-lang/rust/pull/78068
1384 [75752]: https://github.com/rust-lang/rust/pull/75752
1385 [74699]: https://github.com/rust-lang/rust/pull/74699
1386 [78142]: https://github.com/rust-lang/rust/pull/78142
1387 [77484]: https://github.com/rust-lang/rust/pull/77484
1388 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
1389 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
1390 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
1391 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
1392 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
1393 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
1394 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
1395 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
1396 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
1397 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
1398 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
1399 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
1400 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
1401 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
1402 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
1403 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
1404 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
1405 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
1406 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
1407 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
1408 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
1409 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
1410 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
1411 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
1412 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
1413 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
1414 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
1415 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
1416 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
1417 [`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
1418 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
1419 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
1420 [`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
1421 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
1422
1423
1424 Version 1.49.0 (2020-12-31)
1425 ============================
1426
1427 Language
1428 -----------------------
1429
1430 - [Unions can now implement `Drop`, and you can now have a field in a union
1431   with `ManuallyDrop<T>`.][77547]
1432 - [You can now cast uninhabited enums to integers.][76199]
1433 - [You can now bind by reference and by move in patterns.][76119] This
1434   allows you to selectively borrow individual components of a type. E.g.
1435   ```rust
1436   #[derive(Debug)]
1437   struct Person {
1438       name: String,
1439       age: u8,
1440   }
1441
1442   let person = Person {
1443       name: String::from("Alice"),
1444       age: 20,
1445   };
1446
1447   // `name` is moved out of person, but `age` is referenced.
1448   let Person { name, ref age } = person;
1449   println!("{} {}", name, age);
1450   ```
1451
1452 Compiler
1453 -----------------------
1454
1455 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
1456 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
1457 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
1458 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
1459 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
1460 - [Output from threads spawned in tests is now captured.][78227]
1461 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
1462
1463 \* Refer to Rust's [platform support page][platform-support-doc] for more
1464 information on Rust's tiered platform support.
1465
1466 Libraries
1467 -----------------------
1468
1469 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
1470 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
1471
1472 Stabilized APIs
1473 ---------------
1474
1475 - [`slice::select_nth_unstable`]
1476 - [`slice::select_nth_unstable_by`]
1477 - [`slice::select_nth_unstable_by_key`]
1478
1479 The following previously stable methods are now `const`.
1480
1481 - [`Poll::is_ready`]
1482 - [`Poll::is_pending`]
1483
1484 Cargo
1485 -----------------------
1486 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
1487 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
1488 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
1489   variable will be set if the crate being built is one the user selected to build, either
1490   with `-p` or through defaults.
1491 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
1492
1493
1494 Compatibility Notes
1495 -------------------
1496
1497 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
1498 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
1499 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
1500   Previously such invalid or unused attributes could be ignored.
1501 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
1502   read [this post about the changes][rustdoc-ws-post] for more details.
1503 - [Trait bounds are no longer inferred for associated types.][79904]
1504
1505 Internal Only
1506 -------------
1507 These changes provide no direct user facing benefits, but represent significant
1508 improvements to the internals and overall performance of rustc and
1509 related tools.
1510
1511 - [rustc's internal crates are now compiled using the `initial-exec` Thread
1512   Local Storage model.][78201]
1513 - [Calculate visibilities once in resolve.][78077]
1514 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
1515 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
1516
1517
1518 [75991]: https://github.com/rust-lang/rust/pull/75991
1519 [78951]: https://github.com/rust-lang/rust/pull/78951
1520 [78848]: https://github.com/rust-lang/rust/pull/78848
1521 [78746]: https://github.com/rust-lang/rust/pull/78746
1522 [78376]: https://github.com/rust-lang/rust/pull/78376
1523 [78228]: https://github.com/rust-lang/rust/pull/78228
1524 [78227]: https://github.com/rust-lang/rust/pull/78227
1525 [78201]: https://github.com/rust-lang/rust/pull/78201
1526 [78109]: https://github.com/rust-lang/rust/pull/78109
1527 [78077]: https://github.com/rust-lang/rust/pull/78077
1528 [77997]: https://github.com/rust-lang/rust/pull/77997
1529 [77703]: https://github.com/rust-lang/rust/pull/77703
1530 [77547]: https://github.com/rust-lang/rust/pull/77547
1531 [77015]: https://github.com/rust-lang/rust/pull/77015
1532 [76199]: https://github.com/rust-lang/rust/pull/76199
1533 [76119]: https://github.com/rust-lang/rust/pull/76119
1534 [75914]: https://github.com/rust-lang/rust/pull/75914
1535 [79004]: https://github.com/rust-lang/rust/pull/79004
1536 [78676]: https://github.com/rust-lang/rust/pull/78676
1537 [79904]: https://github.com/rust-lang/rust/issues/79904
1538 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
1539 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
1540 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
1541 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
1542 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
1543 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
1544 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
1545 [`hint::spin_loop`]: https://doc.rust-lang.org/stable/std/hint/fn.spin_loop.html
1546 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
1547 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
1548 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
1549
1550 Version 1.48.0 (2020-11-19)
1551 ==========================
1552
1553 Language
1554 --------
1555
1556 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
1557   is still rejected *semantically*, but can now be parsed by procedural macros.
1558
1559 Compiler
1560 --------
1561 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
1562   `rustc` whether to link its own C runtime and libraries or to rely on a external
1563   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
1564 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
1565   Note: If you're using cargo you must explicitly pass the `--target` flag.
1566 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
1567
1568 \* Refer to Rust's [platform support page][platform-support-doc] for more
1569 information on Rust's tiered platform support.
1570
1571 Libraries
1572 ---------
1573 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
1574   and `&Stderr`.][76275]
1575 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
1576 - [The `matches!` macro now supports having a trailing comma.][74880]
1577 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
1578 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
1579
1580 Stabilized APIs
1581 ---------------
1582 - [`slice::as_ptr_range`]
1583 - [`slice::as_mut_ptr_range`]
1584 - [`VecDeque::make_contiguous`]
1585 - [`future::pending`]
1586 - [`future::ready`]
1587
1588 The following previously stable methods are now `const fn`'s:
1589
1590 - [`Option::is_some`]
1591 - [`Option::is_none`]
1592 - [`Option::as_ref`]
1593 - [`Result::is_ok`]
1594 - [`Result::is_err`]
1595 - [`Result::as_ref`]
1596 - [`Ordering::reverse`]
1597 - [`Ordering::then`]
1598
1599 Cargo
1600 -----
1601
1602 Rustdoc
1603 -------
1604 - [You can now link to items in `rustdoc` using the intra-doc link
1605   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
1606   a link to `std::future`'s documentation. See ["Linking to items by
1607   name"][intradoc-links] for more information.
1608 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
1609   when searching through `rustdoc`'s UI.][75740]
1610
1611 Compatibility Notes
1612 -------------------
1613 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
1614   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
1615   promoted to `'static` lifetime any more inside `const fn`s.
1616 - [Associated type bindings on trait objects are now verified to meet the bounds
1617   declared on the trait when checking that they implement the trait.][27675]
1618 - [When trait bounds on associated types or opaque types are ambiguous, the
1619   compiler no longer makes an arbitrary choice on which bound to use.][54121]
1620 - [Fixed recursive nonterminals not being expanded in macros during
1621   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
1622   correctly handling recursive nonterminal tokens.
1623 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
1624 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
1625   in places where they have no effect.][73461]
1626 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
1627   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
1628 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
1629   disallow zero-initialization.][71274]
1630 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
1631 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
1632   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
1633   see the [`catch_unwind`] documentation for further information.
1634
1635
1636
1637 Internal Only
1638 -------------
1639 These changes provide no direct user facing benefits, but represent significant
1640 improvements to the internals and overall performance of rustc and
1641 related tools.
1642
1643 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
1644   You can continue building with `make` by setting `ninja=false` in
1645   your `config.toml`.
1646 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
1647 - [Made `ensure_sufficient_stack()` non-generic][76680]
1648
1649 [78143]: https://github.com/rust-lang/rust/issues/78143
1650 [76680]: https://github.com/rust-lang/rust/pull/76680/
1651 [76030]: https://github.com/rust-lang/rust/pull/76030/
1652 [70212]: https://github.com/rust-lang/rust/pull/70212/
1653 [27675]: https://github.com/rust-lang/rust/issues/27675/
1654 [54121]: https://github.com/rust-lang/rust/issues/54121/
1655 [71274]: https://github.com/rust-lang/rust/pull/71274/
1656 [77386]: https://github.com/rust-lang/rust/pull/77386/
1657 [77153]: https://github.com/rust-lang/rust/pull/77153/
1658 [77055]: https://github.com/rust-lang/rust/pull/77055/
1659 [76275]: https://github.com/rust-lang/rust/pull/76275/
1660 [76310]: https://github.com/rust-lang/rust/pull/76310/
1661 [76420]: https://github.com/rust-lang/rust/pull/76420/
1662 [76158]: https://github.com/rust-lang/rust/pull/76158/
1663 [75857]: https://github.com/rust-lang/rust/pull/75857/
1664 [75585]: https://github.com/rust-lang/rust/pull/75585/
1665 [75740]: https://github.com/rust-lang/rust/pull/75740/
1666 [75502]: https://github.com/rust-lang/rust/pull/75502/
1667 [74880]: https://github.com/rust-lang/rust/pull/74880/
1668 [74922]: https://github.com/rust-lang/rust/pull/74922/
1669 [74430]: https://github.com/rust-lang/rust/pull/74430/
1670 [74194]: https://github.com/rust-lang/rust/pull/74194/
1671 [73461]: https://github.com/rust-lang/rust/pull/73461/
1672 [73166]: https://github.com/rust-lang/rust/pull/73166/
1673 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
1674 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
1675 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
1676 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
1677 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
1678 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
1679 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
1680 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
1681 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
1682 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
1683 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
1684 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
1685 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
1686 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
1687 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
1688
1689
1690 Version 1.47.0 (2020-10-08)
1691 ==========================
1692
1693 Language
1694 --------
1695 - [Closures will now warn when not used.][74869]
1696
1697 Compiler
1698 --------
1699 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
1700   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
1701   platforms.
1702 - [Upgraded to LLVM 11.][73526]
1703 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
1704 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
1705 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
1706
1707 \* Refer to Rust's [platform support page][platform-support-doc] for more
1708 information on Rust's tiered platform support.
1709
1710 Libraries
1711 ---------
1712 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
1713 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
1714   those of length less than 33.][74060]
1715 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
1716 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
1717   `PartialEq`, and `PartialOrd`.][73583]
1718
1719 Stabilized APIs
1720 ---------------
1721 - [`Ident::new_raw`]
1722 - [`Range::is_empty`]
1723 - [`RangeInclusive::is_empty`]
1724 - [`Result::as_deref`]
1725 - [`Result::as_deref_mut`]
1726 - [`Vec::leak`]
1727 - [`pointer::offset_from`]
1728 - [`f32::TAU`]
1729 - [`f64::TAU`]
1730
1731 The following previously stable APIs have now been made const.
1732
1733 - [The `new` method for all `NonZero` integers.][73858]
1734 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
1735   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
1736   methods for all integers.][73858]
1737 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
1738   signed integers.][73858]
1739 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
1740   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
1741   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
1742   `is_ascii_control` methods for `char` and `u8`.][73858]
1743
1744 Cargo
1745 -----
1746 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
1747   You can override this by setting the following in your `Cargo.toml`.
1748   ```toml
1749   [profile.release.build-override]
1750   opt-level = 3
1751   ```
1752 - [`cargo-help` will now display man pages for commands rather just the
1753   `--help` text.][cargo/8456]
1754 - [`cargo-metadata` now emits a `test` field indicating if a target has
1755   tests enabled.][cargo/8478]
1756 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
1757 - [`cargo-publish` will now use an alternative registry by default if it's the
1758   only registry specified in `package.publish`.][cargo/8571]
1759
1760 Misc
1761 ----
1762 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
1763   type based search.][75366]
1764 - [Added the Ayu theme to rustdoc.][71237]
1765
1766 Compatibility Notes
1767 -------------------
1768 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
1769 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
1770 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
1771   help to preserve more span information.][73084] These changes may cause
1772   compiliation errors if your macro was unhygenic or didn't correctly handle
1773   `Delimiter::None`.
1774 - [Moved support for the CloudABI target to tier 3.][75568]
1775 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
1776 - [Added the `rustc-docs` component.][75560] This allows you to install
1777   and read the documentation for the compiler internal APIs. (Currently only
1778   available for `x86_64-unknown-linux-gnu`.)
1779
1780 Internal Only
1781 --------
1782
1783 - [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.
1784
1785 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
1786 [75048]: https://github.com/rust-lang/rust/pull/75048/
1787 [74163]: https://github.com/rust-lang/rust/pull/74163/
1788 [71237]: https://github.com/rust-lang/rust/pull/71237/
1789 [74869]: https://github.com/rust-lang/rust/pull/74869/
1790 [73858]: https://github.com/rust-lang/rust/pull/73858/
1791 [75716]: https://github.com/rust-lang/rust/pull/75716/
1792 [75908]: https://github.com/rust-lang/rust/pull/75908/
1793 [75516]: https://github.com/rust-lang/rust/pull/75516/
1794 [75560]: https://github.com/rust-lang/rust/pull/75560/
1795 [75568]: https://github.com/rust-lang/rust/pull/75568/
1796 [75366]: https://github.com/rust-lang/rust/pull/75366/
1797 [75204]: https://github.com/rust-lang/rust/pull/75204/
1798 [74650]: https://github.com/rust-lang/rust/pull/74650/
1799 [74419]: https://github.com/rust-lang/rust/pull/74419/
1800 [73964]: https://github.com/rust-lang/rust/pull/73964/
1801 [74021]: https://github.com/rust-lang/rust/pull/74021/
1802 [74060]: https://github.com/rust-lang/rust/pull/74060/
1803 [73893]: https://github.com/rust-lang/rust/pull/73893/
1804 [73526]: https://github.com/rust-lang/rust/pull/73526/
1805 [73583]: https://github.com/rust-lang/rust/pull/73583/
1806 [73084]: https://github.com/rust-lang/rust/pull/73084/
1807 [73197]: https://github.com/rust-lang/rust/pull/73197/
1808 [72488]: https://github.com/rust-lang/rust/pull/72488/
1809 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
1810 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
1811 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
1812 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
1813 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
1814 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
1815 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
1816 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
1817 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
1818 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
1819 [`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
1820 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
1821 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
1822 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
1823 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
1824
1825
1826 Version 1.46.0 (2020-08-27)
1827 ==========================
1828
1829 Language
1830 --------
1831 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
1832 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
1833   const functions.][73862]
1834 - [The `#[track_caller]` attribute can now be added to functions to use the
1835   function's caller's location information for panic messages.][72445]
1836 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
1837   `x.0.0` over `(x.0).0`.
1838 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
1839   You currently can't use `mem::transmute` in constant functions.
1840
1841 Compiler
1842 --------
1843 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
1844 - [Enabled static "Position Independent Executables" by default
1845   for `x86_64-unknown-linux-musl`.][70740]
1846
1847 Libraries
1848 ---------
1849 - [`mem::forget` is now a `const fn`.][73887]
1850 - [`String` now implements `From<char>`.][73466]
1851 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
1852   integer types.][73032]
1853 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
1854 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
1855   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
1856 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
1857 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
1858 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
1859
1860 Stabilized APIs
1861 ---------------
1862 - [`Option::zip`]
1863 - [`vec::Drain::as_slice`]
1864
1865 Cargo
1866 -----
1867 Added a number of new environment variables that are now available when
1868 compiling your crate.
1869
1870 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
1871   the specific binary being compiled and the name of the crate.
1872 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
1873 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
1874
1875 Compatibility Notes
1876 -------------------
1877 - [The target configuration option `abi_blacklist` has been renamed
1878   to `unsupported_abis`.][74150] The old name will still continue to work.
1879 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
1880   This was previously accepted but will become a hard error in a future release.
1881 - [Rustc will fail to compile if you have a struct with
1882   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
1883   allowed on `enum`s.
1884 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
1885   ensure that spans have the correct information, and may cause breakage if you
1886   were relying on receiving spans with dummy information.
1887 - [The InnoSetup installer for Windows is no longer available.][72569] This was
1888   a legacy installer that was replaced by a MSI installer a few years ago but
1889   was still being built.
1890 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
1891 - [Rustc will no longer accept overlapping trait implementations that only
1892   differ in how the lifetime was bound.][72493]
1893 - [Rustc now correctly relates the lifetime of an existential associated
1894   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
1895   you to pass a shorter lifetime than expected.
1896 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
1897   The library will need to be installed for `rustc` to work, even though we
1898   expect it to be already available on most systems.
1899 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
1900   under QEMU.][74820]
1901 - [Pretty printing of some tokens in procedural macros changed.][75453] The
1902   exact output returned by rustc's pretty printing is an unstable
1903   implementation detail: we recommend any macro relying on it to switch to a
1904   more robust parsing system.
1905
1906 [75453]: https://github.com/rust-lang/rust/issues/75453/
1907 [74820]: https://github.com/rust-lang/rust/issues/74820/
1908 [74420]: https://github.com/rust-lang/rust/issues/74420/
1909 [74109]: https://github.com/rust-lang/rust/pull/74109/
1910 [74150]: https://github.com/rust-lang/rust/pull/74150/
1911 [73862]: https://github.com/rust-lang/rust/pull/73862/
1912 [73887]: https://github.com/rust-lang/rust/pull/73887/
1913 [73466]: https://github.com/rust-lang/rust/pull/73466/
1914 [73516]: https://github.com/rust-lang/rust/pull/73516/
1915 [73293]: https://github.com/rust-lang/rust/pull/73293/
1916 [73007]: https://github.com/rust-lang/rust/pull/73007/
1917 [73032]: https://github.com/rust-lang/rust/pull/73032/
1918 [72920]: https://github.com/rust-lang/rust/pull/72920/
1919 [72569]: https://github.com/rust-lang/rust/pull/72569/
1920 [72583]: https://github.com/rust-lang/rust/pull/72583/
1921 [72584]: https://github.com/rust-lang/rust/pull/72584/
1922 [72717]: https://github.com/rust-lang/rust/pull/72717/
1923 [72437]: https://github.com/rust-lang/rust/pull/72437/
1924 [72445]: https://github.com/rust-lang/rust/pull/72445/
1925 [72486]: https://github.com/rust-lang/rust/pull/72486/
1926 [72493]: https://github.com/rust-lang/rust/pull/72493/
1927 [72331]: https://github.com/rust-lang/rust/pull/72331/
1928 [71896]: https://github.com/rust-lang/rust/pull/71896/
1929 [71660]: https://github.com/rust-lang/rust/pull/71660/
1930 [71322]: https://github.com/rust-lang/rust/pull/71322/
1931 [70740]: https://github.com/rust-lang/rust/pull/70740/
1932 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
1933 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
1934 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
1935 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
1936 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
1937
1938
1939 Version 1.45.2 (2020-08-03)
1940 ==========================
1941
1942 * [Fix bindings in tuple struct patterns][74954]
1943 * [Fix track_caller integration with trait objects][74784]
1944
1945 [74954]: https://github.com/rust-lang/rust/issues/74954
1946 [74784]: https://github.com/rust-lang/rust/issues/74784
1947
1948
1949 Version 1.45.1 (2020-07-30)
1950 ==========================
1951
1952 * [Fix const propagation with references.][73613]
1953 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1954 * [Avoid spurious implicit region bound.][74509]
1955 * [Install clippy on x.py install][74457]
1956
1957 [73613]: https://github.com/rust-lang/rust/pull/73613
1958 [73078]: https://github.com/rust-lang/rust/issues/73078
1959 [74509]: https://github.com/rust-lang/rust/pull/74509
1960 [74457]: https://github.com/rust-lang/rust/pull/74457
1961
1962
1963 Version 1.45.0 (2020-07-16)
1964 ==========================
1965
1966 Language
1967 --------
1968 - [Out of range float to int conversions using `as` has been defined as a saturating
1969   conversion.][71269] This was previously undefined behaviour, but you can use the
1970    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
1971    may be desirable in rare performance sensitive situations.
1972 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
1973   using `u64`.][70705]
1974 - [Function like procedural macros can now be used in expression, pattern, and  statement
1975   positions.][68717] This means you can now use a function-like procedural macro
1976   anywhere you can use a declarative (`macro_rules!`) macro.
1977
1978 Compiler
1979 --------
1980 - [You can now override individual target features through the `target-feature`
1981   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
1982   equivalent to `-C target-feature=+avx2,+fma`.
1983 - [Added the `force-unwind-tables` flag.][69984] This option allows
1984   rustc to always generate unwind tables regardless of panic strategy.
1985 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
1986   to include LLVM bitcode into generated `rlib`s (this is on by default).
1987 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
1988 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
1989 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
1990 - [Upgraded to LLVM 10.][67759]
1991
1992 \* Refer to Rust's [platform support page][platform-support-doc] for more
1993 information on Rust's tiered platform support.
1994
1995
1996 Libraries
1997 ---------
1998 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
1999   and `Ord`.][72239]
2000 - [`proc_macro::TokenStream` now implements `Default`.][72234]
2001 - [You can now use `char` with
2002   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
2003   a range of codepoints.][72413] E.g.
2004   you can now write the following;
2005   ```rust
2006   for ch in 'a'..='z' {
2007       print!("{}", ch);
2008   }
2009   println!();
2010   // Prints "abcdefghijklmnopqrstuvwxyz"
2011   ```
2012 - [`OsString` now implements `FromStr`.][71662]
2013 - [The `saturating_neg` method has been added to all signed integer primitive
2014   types, and the `saturating_abs` method has been added for all integer
2015   primitive types.][71886]
2016 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
2017   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
2018   or `Path`.][71447]
2019 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
2020 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
2021   integer types.][69813]
2022 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
2023   integer types.][72324]
2024 - [The `fetch_update` method has been added to all atomic integer types.][71843]
2025
2026 Stabilized APIs
2027 ---------------
2028 - [`Arc::as_ptr`]
2029 - [`BTreeMap::remove_entry`]
2030 - [`Rc::as_ptr`]
2031 - [`rc::Weak::as_ptr`]
2032 - [`rc::Weak::from_raw`]
2033 - [`rc::Weak::into_raw`]
2034 - [`str::strip_prefix`]
2035 - [`str::strip_suffix`]
2036 - [`sync::Weak::as_ptr`]
2037 - [`sync::Weak::from_raw`]
2038 - [`sync::Weak::into_raw`]
2039 - [`char::UNICODE_VERSION`]
2040 - [`Span::resolved_at`]
2041 - [`Span::located_at`]
2042 - [`Span::mixed_site`]
2043 - [`unix::process::CommandExt::arg0`]
2044
2045 Cargo
2046 -----
2047
2048 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
2049   time.][cargo/8066]
2050
2051 Misc
2052 ----
2053 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
2054   `~~outdated information~~` becomes "~~outdated information~~".
2055 - [Added an emoji to Rustdoc's deprecated API message.][72014]
2056
2057 Compatibility Notes
2058 -------------------
2059 - [Trying to self initialize a static value (that is creating a value using
2060   itself) is unsound and now causes a compile error.][71140]
2061 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
2062   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
2063 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
2064   previously undocumented and not intended for public use. Rustdoc still provides
2065   a non-zero exit code on errors.
2066 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
2067   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
2068   flags while cargo is adding `embed-bitcode` itself. The recommended way to
2069   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
2070   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
2071
2072 Internals Only
2073 --------------
2074 - [Make clippy a git subtree instead of a git submodule][70655]
2075 - [Unify the undo log of all snapshot types][69464]
2076
2077 [71848]: https://github.com/rust-lang/rust/issues/71848/
2078 [73420]: https://github.com/rust-lang/rust/issues/73420/
2079 [72324]: https://github.com/rust-lang/rust/pull/72324/
2080 [71843]: https://github.com/rust-lang/rust/pull/71843/
2081 [71886]: https://github.com/rust-lang/rust/pull/71886/
2082 [72234]: https://github.com/rust-lang/rust/pull/72234/
2083 [72239]: https://github.com/rust-lang/rust/pull/72239/
2084 [72397]: https://github.com/rust-lang/rust/pull/72397/
2085 [72413]: https://github.com/rust-lang/rust/pull/72413/
2086 [72014]: https://github.com/rust-lang/rust/pull/72014/
2087 [72062]: https://github.com/rust-lang/rust/pull/72062/
2088 [72094]: https://github.com/rust-lang/rust/pull/72094/
2089 [72133]: https://github.com/rust-lang/rust/pull/72133/
2090 [67759]: https://github.com/rust-lang/rust/pull/67759/
2091 [71900]: https://github.com/rust-lang/rust/pull/71900/
2092 [71928]: https://github.com/rust-lang/rust/pull/71928/
2093 [71662]: https://github.com/rust-lang/rust/pull/71662/
2094 [71716]: https://github.com/rust-lang/rust/pull/71716/
2095 [71447]: https://github.com/rust-lang/rust/pull/71447/
2096 [71269]: https://github.com/rust-lang/rust/pull/71269/
2097 [71095]: https://github.com/rust-lang/rust/pull/71095/
2098 [71140]: https://github.com/rust-lang/rust/pull/71140/
2099 [70655]: https://github.com/rust-lang/rust/pull/70655/
2100 [70705]: https://github.com/rust-lang/rust/pull/70705/
2101 [69984]: https://github.com/rust-lang/rust/pull/69984/
2102 [69813]: https://github.com/rust-lang/rust/pull/69813/
2103 [69464]: https://github.com/rust-lang/rust/pull/69464/
2104 [68717]: https://github.com/rust-lang/rust/pull/68717/
2105 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
2106 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
2107 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
2108 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
2109 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
2110 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
2111 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
2112 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
2113 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
2114 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
2115 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
2116 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
2117 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
2118 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
2119 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
2120 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
2121 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
2122
2123
2124 Version 1.44.1 (2020-06-18)
2125 ===========================
2126
2127 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
2128 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
2129 * [Fix crashes when finding backtrace on macOS.][71397]
2130 * [Clippy applies lint levels into different files.][clippy/5356]
2131
2132 [71397]: https://github.com/rust-lang/rust/issues/71397
2133 [73078]: https://github.com/rust-lang/rust/issues/73078
2134 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
2135 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
2136
2137
2138 Version 1.44.0 (2020-06-04)
2139 ==========================
2140
2141 Language
2142 --------
2143 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
2144 - [Added the `unused_braces` lint.][70081]
2145
2146 **Syntax-only changes**
2147
2148 - [Expansion-driven outline module parsing][69838]
2149 ```rust
2150 #[cfg(FALSE)]
2151 mod foo {
2152     mod bar {
2153         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
2154     }
2155 }
2156 ```
2157
2158 These are still rejected semantically, so you will likely receive an error but
2159 these changes can be seen and parsed by macros and conditional compilation.
2160
2161 Compiler
2162 --------
2163 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
2164   Additionally when in incremental mode rustc defaults to 256 codegen units.
2165 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
2166   a panic is thrown.][67502]
2167 - [Added tier 3\* support for the `aarch64-unknown-none` and
2168   `aarch64-unknown-none-softfloat` targets.][68334]
2169 - [Added tier 3 support for `arm64-apple-tvos` and
2170   `x86_64-apple-tvos` targets.][68191]
2171
2172
2173 Libraries
2174 ---------
2175 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
2176   `vec![]` to be able to be used in `const` contexts.
2177 - [`convert::Infallible` now implements `Hash`.][70281]
2178 - [`OsString` now implements `DerefMut` and `IndexMut` returning
2179   a `&mut OsStr`.][70048]
2180 - [Unicode 13 is now supported.][69929]
2181 - [`String` now implements `From<&mut str>`.][69661]
2182 - [`IoSlice` now implements `Copy`.][69403]
2183 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
2184 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
2185 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
2186   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
2187   integer types.][69373]
2188
2189 Stabilized APIs
2190 ---------------
2191 - [`PathBuf::with_capacity`]
2192 - [`PathBuf::capacity`]
2193 - [`PathBuf::clear`]
2194 - [`PathBuf::reserve`]
2195 - [`PathBuf::reserve_exact`]
2196 - [`PathBuf::shrink_to_fit`]
2197 - [`f32::to_int_unchecked`]
2198 - [`f64::to_int_unchecked`]
2199 - [`Layout::align_to`]
2200 - [`Layout::pad_to_align`]
2201 - [`Layout::array`]
2202 - [`Layout::extend`]
2203
2204 Cargo
2205 -----
2206 - [Added the `cargo tree` command which will print a tree graph of
2207   your dependencies.][cargo/8062] E.g.
2208   ```
2209     mdbook v0.3.2 (/Users/src/rust/mdbook)
2210   ├── ammonia v3.0.0
2211   │   ├── html5ever v0.24.0
2212   │   │   ├── log v0.4.8
2213   │   │   │   └── cfg-if v0.1.9
2214   │   │   ├── mac v0.1.1
2215   │   │   └── markup5ever v0.9.0
2216   │   │       ├── log v0.4.8 (*)
2217   │   │       ├── phf v0.7.24
2218   │   │       │   └── phf_shared v0.7.24
2219   │   │       │       ├── siphasher v0.2.3
2220   │   │       │       └── unicase v1.4.2
2221   │   │       │           [build-dependencies]
2222   │   │       │           └── version_check v0.1.5
2223   ...
2224   ```
2225   You can also display dependencies on multiple versions of the same crate with
2226   `cargo tree -d` (short for `cargo tree --duplicates`).
2227
2228 Misc
2229 ----
2230 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
2231   the version in the sidebar.][69494]
2232
2233 Compatibility Notes
2234 -------------------
2235 - [Rustc now correctly generates static libraries on Windows GNU targets with
2236   the `.a` extension, rather than the previous `.lib`.][70937]
2237 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
2238 - [The `file_name` property in JSON output of macro errors now points the actual
2239   source file rather than the previous format of `<NAME macros>`.][70969]
2240   **Note:** this may not point to a file that actually exists on the user's system.
2241 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
2242 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
2243   not allow zero initialization such as `NonZeroU8`.][66059] This was
2244   previously a warning.
2245 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
2246   operator has been defined as a saturating operation.][71269] This was previously
2247   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
2248   continue using the current behaviour, which may be desirable in rare performance
2249   sensitive situations.
2250
2251 Internal Only
2252 -------------
2253 These changes provide no direct user facing benefits, but represent significant
2254 improvements to the internals and overall performance of rustc and
2255 related tools.
2256
2257 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
2258 - [Replace big JS dict with JSON parsing.][71250]
2259
2260 [69373]: https://github.com/rust-lang/rust/pull/69373/
2261 [66059]: https://github.com/rust-lang/rust/pull/66059/
2262 [68191]: https://github.com/rust-lang/rust/pull/68191/
2263 [68899]: https://github.com/rust-lang/rust/pull/68899/
2264 [71147]: https://github.com/rust-lang/rust/pull/71147/
2265 [71250]: https://github.com/rust-lang/rust/pull/71250/
2266 [70937]: https://github.com/rust-lang/rust/pull/70937/
2267 [70969]: https://github.com/rust-lang/rust/pull/70969/
2268 [70632]: https://github.com/rust-lang/rust/pull/70632/
2269 [70281]: https://github.com/rust-lang/rust/pull/70281/
2270 [70345]: https://github.com/rust-lang/rust/pull/70345/
2271 [70048]: https://github.com/rust-lang/rust/pull/70048/
2272 [70081]: https://github.com/rust-lang/rust/pull/70081/
2273 [70156]: https://github.com/rust-lang/rust/pull/70156/
2274 [71269]: https://github.com/rust-lang/rust/pull/71269/
2275 [69838]: https://github.com/rust-lang/rust/pull/69838/
2276 [69929]: https://github.com/rust-lang/rust/pull/69929/
2277 [69661]: https://github.com/rust-lang/rust/pull/69661/
2278 [69778]: https://github.com/rust-lang/rust/pull/69778/
2279 [69494]: https://github.com/rust-lang/rust/pull/69494/
2280 [69403]: https://github.com/rust-lang/rust/pull/69403/
2281 [69033]: https://github.com/rust-lang/rust/pull/69033/
2282 [68692]: https://github.com/rust-lang/rust/pull/68692/
2283 [68334]: https://github.com/rust-lang/rust/pull/68334/
2284 [67502]: https://github.com/rust-lang/rust/pull/67502/
2285 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
2286 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
2287 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
2288 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
2289 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
2290 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
2291 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
2292 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
2293 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
2294 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
2295 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
2296 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
2297 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
2298
2299
2300 Version 1.43.1 (2020-05-07)
2301 ===========================
2302
2303 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
2304 * [Fixed the stabilization of AVX-512 features.][71473]
2305 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
2306
2307 [71430]: https://github.com/rust-lang/rust/pull/71430
2308 [71473]: https://github.com/rust-lang/rust/issues/71473
2309 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
2310
2311
2312 Version 1.43.0 (2020-04-23)
2313 ==========================
2314
2315 Language
2316 --------
2317 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
2318   the type inferred correctly.][68129]
2319 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
2320
2321 **Syntax only changes**
2322 - [Allow `type Foo: Ord` syntactically.][69361]
2323 - [Fuse associated and extern items up to defaultness.][69194]
2324 - [Syntactically allow `self` in all `fn` contexts.][68764]
2325 - [Merge `fn` syntax + cleanup item parsing.][68728]
2326 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
2327   For example, you may now write:
2328   ```rust
2329   macro_rules! mac_trait {
2330       ($i:item) => {
2331           trait T { $i }
2332       }
2333   }
2334   mac_trait! {
2335       fn foo() {}
2336   }
2337   ```
2338
2339 These are still rejected *semantically*, so you will likely receive an error but
2340 these changes can be seen and parsed by macros and
2341 conditional compilation.
2342
2343
2344 Compiler
2345 --------
2346 - [You can now pass multiple lint flags to rustc to override the previous
2347   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
2348   everything in the `unused` lint group except `unused-variables` which
2349   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
2350   everything in the `unused` lint group **including** `unused-variables` since
2351   the allow flag is specified before the deny flag (and therefore overridden).
2352 - [rustc will now prefer your system MinGW libraries over its bundled libraries
2353   if they are available on `windows-gnu`.][67429]
2354 - [rustc now buffers errors/warnings printed in JSON.][69227]
2355
2356 Libraries
2357 ---------
2358 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
2359   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
2360   respectively.][69538] **Note** These conversions are only available when `N`
2361   is `0..=32`.
2362 - [You can now use associated constants on floats and integers directly, rather
2363   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
2364   `f32::NAN` with no imports.
2365 - [`u8::is_ascii` is now `const`.][68984]
2366 - [`String` now implements `AsMut<str>`.][68742]
2367 - [Added the `primitive` module to `std` and `core`.][67637] This module
2368   reexports Rust's primitive types. This is mainly useful in macros
2369   where you want avoid these types being shadowed.
2370 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
2371 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
2372
2373 Stabilized APIs
2374 ---------------
2375 - [`Once::is_completed`]
2376 - [`f32::LOG10_2`]
2377 - [`f32::LOG2_10`]
2378 - [`f64::LOG10_2`]
2379 - [`f64::LOG2_10`]
2380 - [`iter::once_with`]
2381
2382 Cargo
2383 -----
2384 - [You can now set config `[profile]`s in your `.cargo/config`, or through
2385   your environment.][cargo/7823]
2386 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
2387   executable path when running integration tests or benchmarks.][cargo/7697]
2388   `<name>` is the name of your binary as-is e.g. If you wanted the executable
2389   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
2390
2391 Misc
2392 ----
2393 - [Certain checks in the `const_err` lint were deemed unrelated to const
2394   evaluation][69185], and have been moved to the `unconditional_panic` and
2395   `arithmetic_overflow` lints.
2396
2397 Compatibility Notes
2398 -------------------
2399
2400 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
2401   has been a warning since 1.36.0.
2402 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
2403   led to some instances being accepted, and now correctly emits a hard error.
2404
2405 [69340]: https://github.com/rust-lang/rust/pull/69340
2406
2407 Internal Only
2408 -------------
2409 These changes provide no direct user facing benefits, but represent significant
2410 improvements to the internals and overall performance of `rustc` and
2411 related tools.
2412
2413 - [All components are now built with `opt-level=3` instead of `2`.][67878]
2414 - [Improved how rustc generates drop code.][67332]
2415 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
2416 - [traits: preallocate 2 Vecs of known initial size][69022]
2417 - [Avoid exponential behaviour when relating types][68772]
2418 - [Skip `Drop` terminators for enum variants without drop glue][68943]
2419 - [Improve performance of coherence checks][68966]
2420 - [Deduplicate types in the generator witness][68672]
2421 - [Invert control in struct_lint_level.][68725]
2422
2423 [67332]: https://github.com/rust-lang/rust/pull/67332/
2424 [67429]: https://github.com/rust-lang/rust/pull/67429/
2425 [67637]: https://github.com/rust-lang/rust/pull/67637/
2426 [67642]: https://github.com/rust-lang/rust/pull/67642/
2427 [67878]: https://github.com/rust-lang/rust/pull/67878/
2428 [67885]: https://github.com/rust-lang/rust/pull/67885/
2429 [68129]: https://github.com/rust-lang/rust/pull/68129/
2430 [68672]: https://github.com/rust-lang/rust/pull/68672/
2431 [68725]: https://github.com/rust-lang/rust/pull/68725/
2432 [68728]: https://github.com/rust-lang/rust/pull/68728/
2433 [68738]: https://github.com/rust-lang/rust/pull/68738/
2434 [68742]: https://github.com/rust-lang/rust/pull/68742/
2435 [68764]: https://github.com/rust-lang/rust/pull/68764/
2436 [68772]: https://github.com/rust-lang/rust/pull/68772/
2437 [68943]: https://github.com/rust-lang/rust/pull/68943/
2438 [68952]: https://github.com/rust-lang/rust/pull/68952/
2439 [68966]: https://github.com/rust-lang/rust/pull/68966/
2440 [68984]: https://github.com/rust-lang/rust/pull/68984/
2441 [69022]: https://github.com/rust-lang/rust/pull/69022/
2442 [69185]: https://github.com/rust-lang/rust/pull/69185/
2443 [69194]: https://github.com/rust-lang/rust/pull/69194/
2444 [69201]: https://github.com/rust-lang/rust/pull/69201/
2445 [69227]: https://github.com/rust-lang/rust/pull/69227/
2446 [69548]: https://github.com/rust-lang/rust/pull/69548/
2447 [69256]: https://github.com/rust-lang/rust/pull/69256/
2448 [69361]: https://github.com/rust-lang/rust/pull/69361/
2449 [69366]: https://github.com/rust-lang/rust/pull/69366/
2450 [69538]: https://github.com/rust-lang/rust/pull/69538/
2451 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
2452 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
2453 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
2454 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
2455 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
2456 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
2457 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
2458 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
2459
2460
2461 Version 1.42.0 (2020-03-12)
2462 ==========================
2463
2464 Language
2465 --------
2466 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
2467   ```rust
2468   fn foo(words: &[&str]) {
2469       match words {
2470           ["Hello", "World", "!", ..] => println!("Hello World!"),
2471           ["Foo", "Bar", ..] => println!("Baz"),
2472           rest => println!("{:?}", rest),
2473       }
2474   }
2475   ```
2476 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
2477   that you can create an enum that has the exact layout and ABI of the type
2478   it contains.
2479 - [You can now use outer attribute procedural macros on inline modules.][64273]
2480 - [There are some *syntax-only* changes:][67131]
2481    - `default` is syntactically allowed before items in `trait` definitions.
2482    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
2483      leave out their bodies in favor of `;`.
2484    - Bounds on associated types in `impl`s are now syntactically allowed
2485      (e.g. `type Foo: Ord;`).
2486    - `...` (the C-variadic type) may occur syntactically directly as the type of
2487       any function parameter.
2488
2489   These are still rejected *semantically*, so you will likely receive an error
2490   but these changes can be seen and parsed by procedural macros and
2491   conditional compilation.
2492
2493 Compiler
2494 --------
2495 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
2496 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
2497 - [`Option::{expect,unwrap}` and
2498    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
2499    pointing to the location where they were called, rather than
2500    `core`'s internals. ][67887]
2501
2502 \* Refer to Rust's [platform support page][platform-support-doc] for more
2503 information on Rust's tiered platform support.
2504
2505 Libraries
2506 ---------
2507 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
2508 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
2509    to implement `Sized`.][67935]
2510 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
2511 - [`Layout::new` is now `const`.][66254]
2512 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
2513
2514
2515 Stabilized APIs
2516 ---------------
2517 - [`CondVar::wait_while`]
2518 - [`CondVar::wait_timeout_while`]
2519 - [`DebugMap::key`]
2520 - [`DebugMap::value`]
2521 - [`ManuallyDrop::take`]
2522 - [`matches!`]
2523 - [`ptr::slice_from_raw_parts_mut`]
2524 - [`ptr::slice_from_raw_parts`]
2525
2526 Cargo
2527 -----
2528 - [You no longer need to include `extern crate proc_macro;` to be able to
2529   `use proc_macro;` in the `2018` edition.][cargo/7700]
2530
2531 Compatibility Notes
2532 -------------------
2533 - [`Error::description` has been deprecated, and its use will now produce a
2534   warning.][66919] It's recommended to use `Display`/`to_string` instead.
2535
2536 [68253]: https://github.com/rust-lang/rust/pull/68253/
2537 [68348]: https://github.com/rust-lang/rust/pull/68348/
2538 [67935]: https://github.com/rust-lang/rust/pull/67935/
2539 [68339]: https://github.com/rust-lang/rust/pull/68339/
2540 [68122]: https://github.com/rust-lang/rust/pull/68122/
2541 [64273]: https://github.com/rust-lang/rust/pull/64273/
2542 [67712]: https://github.com/rust-lang/rust/pull/67712/
2543 [67887]: https://github.com/rust-lang/rust/pull/67887/
2544 [67131]: https://github.com/rust-lang/rust/pull/67131/
2545 [67233]: https://github.com/rust-lang/rust/pull/67233/
2546 [66899]: https://github.com/rust-lang/rust/pull/66899/
2547 [66919]: https://github.com/rust-lang/rust/pull/66919/
2548 [66254]: https://github.com/rust-lang/rust/pull/66254/
2549 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
2550 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
2551 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
2552 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
2553 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
2554 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
2555 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
2556 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
2557 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
2558
2559
2560 Version 1.41.1 (2020-02-27)
2561 ===========================
2562
2563 * [Always check types of static items][69145]
2564 * [Always check lifetime bounds of `Copy` impls][69145]
2565 * [Fix miscompilation in callers of `Layout::repeat`][69225]
2566
2567 [69225]: https://github.com/rust-lang/rust/issues/69225
2568 [69145]: https://github.com/rust-lang/rust/pull/69145
2569
2570
2571 Version 1.41.0 (2020-01-30)
2572 ===========================
2573
2574 Language
2575 --------
2576
2577 - [You can now pass type parameters to foreign items when implementing
2578   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
2579 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
2580   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
2581   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
2582 - [You can now use any valid identifier in a `format_args` macro.][66847]
2583   Previously identifiers starting with an underscore were not allowed.
2584 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
2585   enum variants.][66183] These are still rejected semantically, but
2586   can be seen and parsed by procedural macros and conditional compilation.
2587
2588 Compiler
2589 --------
2590
2591 - [Rustc will now warn if you have unused loop `'label`s.][66325]
2592 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
2593 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
2594 - [You can now pass an arguments file passing the `@path` syntax
2595   to rustc.][66172] Note that the format differs somewhat from what is
2596   found in other tooling; please see [the documentation][argfile-docs] for
2597   more information.
2598 - [You can now provide `--extern` flag without a path, indicating that it is
2599   available from the search path or specified with an `-L` flag.][64882]
2600
2601 \* Refer to Rust's [platform support page][platform-support-doc] for more
2602 information on Rust's tiered platform support.
2603
2604 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
2605
2606 Libraries
2607 ---------
2608
2609 - [The `core::panic` module is now stable.][66771] It was already stable
2610   through `std`.
2611 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
2612   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
2613 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
2614
2615 Stabilized APIs
2616 ---------------
2617
2618 - [`Result::map_or`]
2619 - [`Result::map_or_else`]
2620 - [`std::rc::Weak::weak_count`]
2621 - [`std::rc::Weak::strong_count`]
2622 - [`std::sync::Weak::weak_count`]
2623 - [`std::sync::Weak::strong_count`]
2624
2625 Cargo
2626 -----
2627
2628 - [Cargo will now document all the private items for binary crates
2629   by default.][cargo/7593]
2630 - [`cargo-install` will now reinstall the package if it detects that it is out
2631   of date.][cargo/7560]
2632 - [Cargo.lock now uses a more git friendly format that should help to reduce
2633   merge conflicts.][cargo/7579]
2634 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
2635   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
2636   optimisation level to `2` for debug builds. You can also use
2637   `[profile.<profile>.build-override]` to override build scripts and
2638   their dependencies.
2639
2640 Misc
2641 ----
2642
2643 - [You can now specify `edition` in documentation code blocks to compile the block
2644   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
2645   should be compiled the 2018 edition of Rust.
2646 - [You can now provide custom themes to rustdoc with `--theme`, and check the
2647   current theme with `--check-theme`.][54733]
2648 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
2649
2650 Compatibility Notes
2651 -------------------
2652
2653 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
2654   Apple targets.][apple-32bit-drop] This means that the source code is still
2655   available to build, but the targets are no longer being tested and release
2656   binaries for those platforms will no longer be distributed by the Rust project.
2657   Please refer to the linked blog post for more information.
2658
2659 [54733]: https://github.com/rust-lang/rust/pull/54733/
2660 [61351]: https://github.com/rust-lang/rust/pull/61351/
2661 [67255]: https://github.com/rust-lang/rust/pull/67255/
2662 [66661]: https://github.com/rust-lang/rust/pull/66661/
2663 [66771]: https://github.com/rust-lang/rust/pull/66771/
2664 [66847]: https://github.com/rust-lang/rust/pull/66847/
2665 [66238]: https://github.com/rust-lang/rust/pull/66238/
2666 [66277]: https://github.com/rust-lang/rust/pull/66277/
2667 [66325]: https://github.com/rust-lang/rust/pull/66325/
2668 [66172]: https://github.com/rust-lang/rust/pull/66172/
2669 [66183]: https://github.com/rust-lang/rust/pull/66183/
2670 [65879]: https://github.com/rust-lang/rust/pull/65879/
2671 [65013]: https://github.com/rust-lang/rust/pull/65013/
2672 [64882]: https://github.com/rust-lang/rust/pull/64882/
2673 [64325]: https://github.com/rust-lang/rust/pull/64325/
2674 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
2675 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
2676 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
2677 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
2678 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
2679 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
2680 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
2681 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
2682 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
2683 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
2684 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
2685
2686 Version 1.40.0 (2019-12-19)
2687 ===========================
2688
2689 Language
2690 --------
2691 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
2692   `const` contexts.][65188] e.g.
2693
2694   ```rust
2695   pub struct Point(i32, i32);
2696
2697   const ORIGIN: Point = {
2698       let constructor = Point;
2699
2700       constructor(0, 0)
2701   };
2702   ```
2703
2704 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
2705   indicate that there may be variants or fields added in the future.][64639]
2706   For example this requires adding a wild-card branch (`_ => {}`) to any match
2707   statements on a non-exhaustive `enum`. [(RFC 2008)]
2708 - [You can now use function-like procedural macros in `extern` blocks and in
2709   type positions.][63931] e.g. `type Generated = macro!();`
2710 - [Function-like and attribute procedural macros can now emit
2711   `macro_rules!` items, so you can now have your macros generate macros.][64035]
2712 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
2713   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
2714   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
2715
2716 Compiler
2717 --------
2718 - [Added tier 3 support\* for the
2719   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
2720 - [Added tier 3 support for the
2721   `aarch64-unknown-none-softfloat` target.][64589]
2722 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
2723   `mips64el-unknown-linux-muslabi64` targets.][65843]
2724
2725 \* Refer to Rust's [platform support page][platform-support-doc] for more
2726   information on Rust's tiered platform support.
2727
2728 Libraries
2729 ---------
2730 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
2731
2732 Stabilized APIs
2733 ---------------
2734 - [`BTreeMap::get_key_value`]
2735 - [`HashMap::get_key_value`]
2736 - [`Option::as_deref_mut`]
2737 - [`Option::as_deref`]
2738 - [`Option::flatten`]
2739 - [`UdpSocket::peer_addr`]
2740 - [`f32::to_be_bytes`]
2741 - [`f32::to_le_bytes`]
2742 - [`f32::to_ne_bytes`]
2743 - [`f64::to_be_bytes`]
2744 - [`f64::to_le_bytes`]
2745 - [`f64::to_ne_bytes`]
2746 - [`f32::from_be_bytes`]
2747 - [`f32::from_le_bytes`]
2748 - [`f32::from_ne_bytes`]
2749 - [`f64::from_be_bytes`]
2750 - [`f64::from_le_bytes`]
2751 - [`f64::from_ne_bytes`]
2752 - [`mem::take`]
2753 - [`slice::repeat`]
2754 - [`todo!`]
2755
2756 Cargo
2757 -----
2758 - [Cargo will now always display warnings, rather than only on
2759   fresh builds.][cargo/7450]
2760 - [Feature flags (except `--all-features`) passed to a virtual workspace will
2761   now produce an error.][cargo/7507] Previously these flags were ignored.
2762 - [You can now publish `dev-dependencies` without including
2763   a `version`.][cargo/7333]
2764
2765 Misc
2766 ----
2767 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
2768   when running documentation tests with `rustdoc`.][63803]
2769
2770 Compatibility Notes
2771 -------------------
2772 - [As previously announced, any previous NLL warnings in the 2015 edition are
2773   now hard errors.][64221]
2774 - [The `include!` macro will now warn if it failed to include the
2775   entire file.][64284] The `include!` macro unintentionally only includes the
2776   first _expression_ in a file, and this can be unintuitive. This will become
2777   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
2778 - [Using `#[inline]` on function prototypes and consts now emits a warning under
2779   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
2780   or `extern` blocks now correctly emits a hard error.
2781
2782 [65294]: https://github.com/rust-lang/rust/pull/65294/
2783 [66103]: https://github.com/rust-lang/rust/pull/66103/
2784 [65843]: https://github.com/rust-lang/rust/pull/65843/
2785 [65188]: https://github.com/rust-lang/rust/pull/65188/
2786 [65092]: https://github.com/rust-lang/rust/pull/65092/
2787 [64589]: https://github.com/rust-lang/rust/pull/64589/
2788 [64639]: https://github.com/rust-lang/rust/pull/64639/
2789 [64221]: https://github.com/rust-lang/rust/pull/64221/
2790 [64284]: https://github.com/rust-lang/rust/pull/64284/
2791 [63931]: https://github.com/rust-lang/rust/pull/63931/
2792 [64035]: https://github.com/rust-lang/rust/pull/64035/
2793 [63674]: https://github.com/rust-lang/rust/pull/63674/
2794 [63803]: https://github.com/rust-lang/rust/pull/63803/
2795 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
2796 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
2797 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
2798 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
2799 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
2800 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
2801 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
2802 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
2803 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
2804 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
2805 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
2806 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
2807 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
2808 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
2809 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
2810 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
2811 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
2812 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
2813 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
2814 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
2815 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
2816 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
2817 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
2818 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
2819 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
2820 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
2821
2822
2823 Version 1.39.0 (2019-11-07)
2824 ===========================
2825
2826 Language
2827 --------
2828 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
2829   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
2830 - [You can now use certain attributes on function, closure, and function pointer
2831   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
2832   `deny`, `forbid` as well as inert helper attributes used by procedural macro
2833   attributes applied to items. e.g.
2834   ```rust
2835   fn len(
2836       #[cfg(windows)] slice: &[u16],
2837       #[cfg(not(windows))] slice: &[u8],
2838   ) -> usize {
2839       slice.len()
2840   }
2841   ```
2842 - [You can now take shared references to bind-by-move patterns in the `if` guards
2843   of `match` arms.][63118] e.g.
2844   ```rust
2845   fn main() {
2846       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
2847
2848       match array {
2849           nums
2850   //      ---- `nums` is bound by move.
2851               if nums.iter().sum::<u8>() == 10
2852   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
2853           => {
2854               drop(nums);
2855   //          ----------- Legal as `nums` was bound by move and so we have ownership.
2856           }
2857           _ => unreachable!(),
2858       }
2859   }
2860   ```
2861
2862
2863
2864 Compiler
2865 --------
2866 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
2867 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
2868 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
2869   **Note** Cargo currently doesn't use this feature. Refer to
2870   [cargo#7315][cargo/7315] to track this feature's progress.
2871 - [You can now pass `--show-output` argument to test binaries to print the
2872   output of successful tests.][62600]
2873
2874
2875 \* Refer to Rust's [platform support page][platform-support-doc] for more
2876 information on Rust's tiered platform support.
2877
2878 Libraries
2879 ---------
2880 - [`Vec::new` and `String::new` are now `const` functions.][64028]
2881 - [`LinkedList::new` is now a `const` function.][63684]
2882 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
2883 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
2884   now `const`.][63786]
2885
2886 Stabilized APIs
2887 ---------------
2888 - [`Pin::into_inner`]
2889 - [`Instant::checked_duration_since`]
2890 - [`Instant::saturating_duration_since`]
2891
2892 Cargo
2893 -----
2894 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
2895 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
2896   `--all` is now deprecated.
2897
2898 Misc
2899 ----
2900 - [You can now pass `-Clinker` to rustdoc to control the linker used
2901   for compiling doctests.][63834]
2902
2903 Compatibility Notes
2904 -------------------
2905 - [Code that was previously accepted by the old borrow checker, but rejected by
2906   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
2907   previously a warning, and will also become a hard error in the Rust 2015
2908   edition in the 1.40.0 release.
2909 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
2910   run tests.][63827] This should improve performance when running a large
2911   amount of doctests.
2912 - [The `try!` macro will now issue a deprecation warning.][62672] It is
2913   recommended to use the `?` operator instead.
2914 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
2915   returned `0.0`.
2916
2917 [62600]: https://github.com/rust-lang/rust/pull/62600/
2918 [62672]: https://github.com/rust-lang/rust/pull/62672/
2919 [63118]: https://github.com/rust-lang/rust/pull/63118/
2920 [63209]: https://github.com/rust-lang/rust/pull/63209/
2921 [63402]: https://github.com/rust-lang/rust/pull/63402/
2922 [63565]: https://github.com/rust-lang/rust/pull/63565/
2923 [63595]: https://github.com/rust-lang/rust/pull/63595/
2924 [63684]: https://github.com/rust-lang/rust/pull/63684/
2925 [63698]: https://github.com/rust-lang/rust/pull/63698/
2926 [63770]: https://github.com/rust-lang/rust/pull/63770/
2927 [63786]: https://github.com/rust-lang/rust/pull/63786/
2928 [63827]: https://github.com/rust-lang/rust/pull/63827/
2929 [63834]: https://github.com/rust-lang/rust/pull/63834/
2930 [63927]: https://github.com/rust-lang/rust/pull/63927/
2931 [63933]: https://github.com/rust-lang/rust/pull/63933/
2932 [63934]: https://github.com/rust-lang/rust/pull/63934/
2933 [63938]: https://github.com/rust-lang/rust/pull/63938/
2934 [63940]: https://github.com/rust-lang/rust/pull/63940/
2935 [63941]: https://github.com/rust-lang/rust/pull/63941/
2936 [63945]: https://github.com/rust-lang/rust/pull/63945/
2937 [64010]: https://github.com/rust-lang/rust/pull/64010/
2938 [64028]: https://github.com/rust-lang/rust/pull/64028/
2939 [64334]: https://github.com/rust-lang/rust/pull/64334/
2940 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
2941 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
2942 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
2943 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
2944 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
2945 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
2946
2947 Version 1.38.0 (2019-09-26)
2948 ==========================
2949
2950 Language
2951 --------
2952 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
2953 - [The `#[deprecated]` attribute can now be used on macros.][62042]
2954
2955 Compiler
2956 --------
2957 - [Added pipelined compilation support to `rustc`.][62766] This will
2958   improve compilation times in some cases. For further information please refer
2959   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
2960 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
2961   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
2962   `x86_64-uwp-windows-msvc` targets.][60260]
2963 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
2964   `armv7-unknown-linux-musleabi` targets.][63107]
2965 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
2966 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
2967 - [Upgraded to LLVM 9.][62592]
2968
2969 \* Refer to Rust's [platform support page][platform-support-doc] for more
2970 information on Rust's tiered platform support.
2971
2972 Libraries
2973 ---------
2974 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
2975 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
2976   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
2977   is available at `std::clone::Clone`). This also makes all built-in macros
2978   available in `std`/`core` root. e.g. `std::include_bytes!`.
2979 - [`str::Chars` now implements `Debug`.][63000]
2980 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
2981 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
2982 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
2983 - [Added euclidean remainder and division operations (`div_euclid`,
2984   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
2985   `overflowing`, and `wrapping` versions are available for all
2986   integer primitives.
2987 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
2988   `PartialEq`.][61491]
2989 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
2990
2991 Stabilized APIs
2992 ---------------
2993 - [`<*const T>::cast`]
2994 - [`<*mut T>::cast`]
2995 - [`Duration::as_secs_f32`]
2996 - [`Duration::as_secs_f64`]
2997 - [`Duration::div_f32`]
2998 - [`Duration::div_f64`]
2999 - [`Duration::from_secs_f32`]
3000 - [`Duration::from_secs_f64`]
3001 - [`Duration::mul_f32`]
3002 - [`Duration::mul_f64`]
3003 - [`any::type_name`]
3004
3005 Cargo
3006 -----
3007 - [Added pipelined compilation support to `cargo`.][cargo/7143]
3008 - [You can now pass the `--features` option multiple times to enable
3009   multiple features.][cargo/7084]
3010
3011 Rustdoc
3012 -------
3013
3014 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
3015
3016 Misc
3017 ----
3018 - [`rustc` will now warn about some incorrect uses of
3019   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
3020
3021 Compatibility Notes
3022 -------------------
3023 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
3024   1.38.0.
3025 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
3026   issues][62896] with certain crates such as libc.
3027
3028 [60260]: https://github.com/rust-lang/rust/pull/60260/
3029 [61457]: https://github.com/rust-lang/rust/pull/61457/
3030 [61491]: https://github.com/rust-lang/rust/pull/61491/
3031 [61884]: https://github.com/rust-lang/rust/pull/61884/
3032 [61953]: https://github.com/rust-lang/rust/pull/61953/
3033 [62042]: https://github.com/rust-lang/rust/pull/62042/
3034 [62528]: https://github.com/rust-lang/rust/pull/62528/
3035 [62583]: https://github.com/rust-lang/rust/pull/62583/
3036 [62735]: https://github.com/rust-lang/rust/pull/62735/
3037 [62766]: https://github.com/rust-lang/rust/pull/62766/
3038 [62784]: https://github.com/rust-lang/rust/pull/62784/
3039 [62592]: https://github.com/rust-lang/rust/pull/62592/
3040 [62785]: https://github.com/rust-lang/rust/issues/62785/
3041 [62814]: https://github.com/rust-lang/rust/pull/62814/
3042 [62896]: https://github.com/rust-lang/rust/issues/62896/
3043 [63000]: https://github.com/rust-lang/rust/pull/63000/
3044 [63056]: https://github.com/rust-lang/rust/pull/63056/
3045 [63107]: https://github.com/rust-lang/rust/pull/63107/
3046 [63346]: https://github.com/rust-lang/rust/pull/63346/
3047 [63421]: https://github.com/rust-lang/rust/pull/63421/
3048 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
3049 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
3050 [63048]: https://github.com/rust-lang/rust/pull/63048
3051 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
3052 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
3053 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
3054 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
3055 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
3056 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
3057 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
3058 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
3059 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
3060 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
3061 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
3062 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
3063 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
3064
3065 Version 1.37.0 (2019-08-15)
3066 ==========================
3067
3068 Language
3069 --------
3070 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
3071   [`Box`][62228], or an [array][62235] and unused.
3072 - [You can now use the `cfg` and `cfg_attr` attributes on
3073   generic parameters.][61547]
3074 - [You can now use enum variants through type alias.][61682] e.g. You can
3075   write the following:
3076   ```rust
3077   type MyOption = Option<u8>;
3078
3079   fn increment_or_zero(x: MyOption) -> u8 {
3080       match x {
3081           MyOption::Some(y) => y + 1,
3082           MyOption::None => 0,
3083       }
3084   }
3085   ```
3086 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
3087   `const _: u32 = 5;`.
3088 - [You can now use `#[repr(align(X)]` on enums.][61229]
3089 - [The  `?` Kleene macro operator is now available in the
3090   2015 edition.][60932]
3091
3092 Compiler
3093 --------
3094 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
3095   and `-C profile-use` flags.][61268] For more information on how to use profile
3096   guided optimization, please refer to the [rustc book][rustc-book-pgo].
3097 - [The `rust-lldb` wrapper script should now work again.][61827]
3098
3099 Libraries
3100 ---------
3101 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
3102
3103 Stabilized APIs
3104 ---------------
3105 - [`BufReader::buffer`]
3106 - [`BufWriter::buffer`]
3107 - [`Cell::from_mut`]
3108 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
3109 - [`DoubleEndedIterator::nth_back`]
3110 - [`Option::xor`]
3111 - [`Wrapping::reverse_bits`]
3112 - [`i128::reverse_bits`]
3113 - [`i16::reverse_bits`]
3114 - [`i32::reverse_bits`]
3115 - [`i64::reverse_bits`]
3116 - [`i8::reverse_bits`]
3117 - [`isize::reverse_bits`]
3118 - [`slice::copy_within`]
3119 - [`u128::reverse_bits`]
3120 - [`u16::reverse_bits`]
3121 - [`u32::reverse_bits`]
3122 - [`u64::reverse_bits`]
3123 - [`u8::reverse_bits`]
3124 - [`usize::reverse_bits`]
3125
3126 Cargo
3127 -----
3128 - [`Cargo.lock` files are now included by default when publishing executable crates
3129   with executables.][cargo/7026]
3130 - [You can now specify `default-run="foo"` in `[package]` to specify the
3131   default executable to use for `cargo run`.][cargo/7056]
3132
3133 Misc
3134 ----
3135
3136 Compatibility Notes
3137 -------------------
3138 - [Using `...` for inclusive range patterns will now warn by default.][61342]
3139   Please transition your code to using the `..=` syntax for inclusive
3140   ranges instead.
3141 - [Using a trait object without the `dyn` will now warn by default.][61203]
3142   Please transition your code to use `dyn Trait` for trait objects instead.
3143
3144 [62228]: https://github.com/rust-lang/rust/pull/62228/
3145 [62235]: https://github.com/rust-lang/rust/pull/62235/
3146 [61802]: https://github.com/rust-lang/rust/pull/61802/
3147 [61827]: https://github.com/rust-lang/rust/pull/61827/
3148 [61547]: https://github.com/rust-lang/rust/pull/61547/
3149 [61682]: https://github.com/rust-lang/rust/pull/61682/
3150 [61268]: https://github.com/rust-lang/rust/pull/61268/
3151 [61342]: https://github.com/rust-lang/rust/pull/61342/
3152 [61347]: https://github.com/rust-lang/rust/pull/61347/
3153 [61100]: https://github.com/rust-lang/rust/pull/61100/
3154 [61203]: https://github.com/rust-lang/rust/pull/61203/
3155 [61229]: https://github.com/rust-lang/rust/pull/61229/
3156 [60932]: https://github.com/rust-lang/rust/pull/60932/
3157 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
3158 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
3159 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
3160 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
3161 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
3162 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
3163 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
3164 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
3165 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
3166 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
3167 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
3168 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
3169 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
3170 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
3171 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
3172 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
3173 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
3174 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
3175 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
3176 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
3177 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
3178 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
3179 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
3180 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
3181
3182
3183 Version 1.36.0 (2019-07-04)
3184 ==========================
3185
3186 Language
3187 --------
3188 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
3189 - [The order of traits in trait objects no longer affects the semantics of that
3190   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
3191   `dyn fmt::Debug + Send`, where this was previously not the case.
3192
3193 Libraries
3194 ---------
3195 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
3196 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
3197 - [`mem::needs_drop` is now available as a const fn.][60364]
3198 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
3199 - [`String` now implements `BorrowMut<str>`.][60404]
3200 - [`io::Cursor` now implements `Default`.][60234]
3201 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
3202 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
3203   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
3204   environment has access to heap memory allocation.
3205 - [`String` now implements `From<&String>`.][59825]
3206 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
3207   return a tuple of each argument when there is multiple arguments.
3208 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
3209   not used.][59648]
3210
3211 Stabilized APIs
3212 ---------------
3213 - [`VecDeque::rotate_left`]
3214 - [`VecDeque::rotate_right`]
3215 - [`Iterator::copied`]
3216 - [`io::IoSlice`]
3217 - [`io::IoSliceMut`]
3218 - [`Read::read_vectored`]
3219 - [`Write::write_vectored`]
3220 - [`str::as_mut_ptr`]
3221 - [`mem::MaybeUninit`]
3222 - [`pointer::align_offset`]
3223 - [`future::Future`]
3224 - [`task::Context`]
3225 - [`task::RawWaker`]
3226 - [`task::RawWakerVTable`]
3227 - [`task::Waker`]
3228 - [`task::Poll`]
3229
3230 Cargo
3231 -----
3232 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
3233 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
3234
3235 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
3236
3237 Clippy
3238 ------
3239 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
3240
3241 Misc
3242 ----
3243
3244 Compatibility Notes
3245 -------------------
3246 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
3247   longer recommended, and will be deprecated in 1.39.0.
3248
3249 [60318]: https://github.com/rust-lang/rust/pull/60318/
3250 [60364]: https://github.com/rust-lang/rust/pull/60364/
3251 [60370]: https://github.com/rust-lang/rust/pull/60370/
3252 [60404]: https://github.com/rust-lang/rust/pull/60404/
3253 [60234]: https://github.com/rust-lang/rust/pull/60234/
3254 [60244]: https://github.com/rust-lang/rust/pull/60244/
3255 [58623]: https://github.com/rust-lang/rust/pull/58623/
3256 [59648]: https://github.com/rust-lang/rust/pull/59648/
3257 [59675]: https://github.com/rust-lang/rust/pull/59675/
3258 [59825]: https://github.com/rust-lang/rust/pull/59825/
3259 [59826]: https://github.com/rust-lang/rust/pull/59826/
3260 [59445]: https://github.com/rust-lang/rust/pull/59445/
3261 [59114]: https://github.com/rust-lang/rust/pull/59114/
3262 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
3263 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
3264 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
3265 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
3266 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
3267 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
3268 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
3269 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
3270 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
3271 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
3272 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
3273 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
3274 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
3275 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
3276 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
3277 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
3278 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
3279 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
3280 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
3281 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
3282
3283
3284 Version 1.35.0 (2019-05-23)
3285 ==========================
3286
3287 Language
3288 --------
3289 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
3290   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
3291 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
3292   ```rust
3293   unsafe fn call_unsafe(func: unsafe fn()) {
3294       func()
3295   }
3296
3297   pub fn main() {
3298       unsafe { call_unsafe(|| {}); }
3299   }
3300   ```
3301
3302
3303 Compiler
3304 --------
3305 - [Added the `armv6-unknown-freebsd-gnueabihf` and
3306   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
3307 - [Added the `wasm32-unknown-wasi` target.][59464]
3308
3309
3310 Libraries
3311 ---------
3312 - [`Thread` will now show its ID in `Debug` output.][59460]
3313 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
3314 - [`alloc::System` now implements `Default`.][59451]
3315 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
3316   last field.][59076]
3317 - [`char::{ToLowercase, ToUppercase}` now
3318   implement `ExactSizeIterator`.][58778]
3319 - [All `NonZero` numeric types now implement `FromStr`.][58717]
3320 - [Removed the `Read` trait bounds
3321   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
3322 - [You can now call the `dbg!` macro without any parameters to print the file
3323   and line where it is called.][57847]
3324 - [In place ASCII case conversions are now up to 4× faster.][59283]
3325   e.g. `str::make_ascii_lowercase`
3326 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
3327   and `Send`.][58369]
3328
3329 Stabilized APIs
3330 ---------------
3331 - [`f32::copysign`]
3332 - [`f64::copysign`]
3333 - [`RefCell::replace_with`]
3334 - [`RefCell::map_split`]
3335 - [`ptr::hash`]
3336 - [`Range::contains`]
3337 - [`RangeFrom::contains`]
3338 - [`RangeTo::contains`]
3339 - [`RangeInclusive::contains`]
3340 - [`RangeToInclusive::contains`]
3341 - [`Option::copied`]
3342
3343 Cargo
3344 -----
3345 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
3346   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
3347   platform specific.
3348
3349 Misc
3350 ----
3351 - [The Rust toolchain is now available natively for musl based distros.][58575]
3352
3353 [59460]: https://github.com/rust-lang/rust/pull/59460/
3354 [59464]: https://github.com/rust-lang/rust/pull/59464/
3355 [59500]: https://github.com/rust-lang/rust/pull/59500/
3356 [59512]: https://github.com/rust-lang/rust/pull/59512/
3357 [59580]: https://github.com/rust-lang/rust/pull/59580/
3358 [59283]: https://github.com/rust-lang/rust/pull/59283/
3359 [59451]: https://github.com/rust-lang/rust/pull/59451/
3360 [59076]: https://github.com/rust-lang/rust/pull/59076/
3361 [58778]: https://github.com/rust-lang/rust/pull/58778/
3362 [58717]: https://github.com/rust-lang/rust/pull/58717/
3363 [58369]: https://github.com/rust-lang/rust/pull/58369/
3364 [58423]: https://github.com/rust-lang/rust/pull/58423/
3365 [58080]: https://github.com/rust-lang/rust/pull/58080/
3366 [57847]: https://github.com/rust-lang/rust/pull/57847/
3367 [58575]: https://github.com/rust-lang/rust/pull/58575
3368 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
3369 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
3370 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
3371 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
3372 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
3373 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
3374 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
3375 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
3376 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
3377 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
3378 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
3379 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
3380
3381 Version 1.34.2 (2019-05-14)
3382 ===========================
3383
3384 * [Destabilize the `Error::type_id` function due to a security
3385    vulnerability][60785] ([CVE-2019-12083])
3386
3387 [60785]: https://github.com/rust-lang/rust/pull/60785
3388 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
3389
3390 Version 1.34.1 (2019-04-25)
3391 ===========================
3392
3393 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
3394 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
3395 * [Fix Clippy panic when checking some macros][clippy/3805]
3396
3397 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
3398 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
3399 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
3400
3401 Version 1.34.0 (2019-04-11)
3402 ==========================
3403
3404 Language
3405 --------
3406 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
3407   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
3408   but had no effect.
3409 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
3410   `#[attr{}]` procedural macros.][57367]
3411 - [You can now write `extern crate self as foo;`][57407] to import your
3412   crate's root into the extern prelude.
3413
3414
3415 Compiler
3416 --------
3417 - [You can now target `riscv64imac-unknown-none-elf` and
3418   `riscv64gc-unknown-none-elf`.][58406]
3419 - [You can now enable linker plugin LTO optimisations with
3420   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
3421   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
3422   boundaries.
3423 - [You can now target `powerpc64-unknown-freebsd`.][57809]
3424
3425
3426 Libraries
3427 ---------
3428 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
3429   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
3430   the `Hash` trait to create an iterator.
3431 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
3432   methods.][58421] Most notably you no longer require the `Ord` trait to create
3433   an iterator.
3434 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
3435   for all numeric types.][58044]
3436 - [Indexing a `str` is now generic over all types that
3437   implement `SliceIndex<str>`.][57604]
3438 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
3439   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
3440   produce a warning if their returning type is unused.
3441 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
3442   `overflowing_pow` are now available for all numeric types.][57873] These are
3443   equivalent to methods such as `wrapping_add` for the `pow` operation.
3444
3445
3446 Stabilized APIs
3447 ---------------
3448
3449 #### std & core
3450 * [`Any::type_id`]
3451 * [`Error::type_id`]
3452 * [`atomic::AtomicI16`]
3453 * [`atomic::AtomicI32`]
3454 * [`atomic::AtomicI64`]
3455 * [`atomic::AtomicI8`]
3456 * [`atomic::AtomicU16`]
3457 * [`atomic::AtomicU32`]
3458 * [`atomic::AtomicU64`]
3459 * [`atomic::AtomicU8`]
3460 * [`convert::Infallible`]
3461 * [`convert::TryFrom`]
3462 * [`convert::TryInto`]
3463 * [`iter::from_fn`]
3464 * [`iter::successors`]
3465 * [`num::NonZeroI128`]
3466 * [`num::NonZeroI16`]
3467 * [`num::NonZeroI32`]
3468 * [`num::NonZeroI64`]
3469 * [`num::NonZeroI8`]
3470 * [`num::NonZeroIsize`]
3471 * [`slice::sort_by_cached_key`]
3472 * [`str::escape_debug`]
3473 * [`str::escape_default`]
3474 * [`str::escape_unicode`]
3475 * [`str::split_ascii_whitespace`]
3476
3477 #### std
3478 * [`Instant::checked_add`]
3479 * [`Instant::checked_sub`]
3480 * [`SystemTime::checked_add`]
3481 * [`SystemTime::checked_sub`]
3482
3483 Cargo
3484 -----
3485 - [You can now use alternative registries to crates.io.][cargo/6654]
3486
3487 Misc
3488 ----
3489 - [You can now use the `?` operator in your documentation tests without manually
3490   adding `fn main() -> Result<(), _> {}`.][56470]
3491
3492 Compatibility Notes
3493 -------------------
3494 - [`Command::before_exec` is being replaced by the unsafe method
3495   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
3496 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
3497   can now use `const` functions in `static` variables.
3498
3499 [58370]: https://github.com/rust-lang/rust/pull/58370/
3500 [58406]: https://github.com/rust-lang/rust/pull/58406/
3501 [58421]: https://github.com/rust-lang/rust/pull/58421/
3502 [58166]: https://github.com/rust-lang/rust/pull/58166/
3503 [58044]: https://github.com/rust-lang/rust/pull/58044/
3504 [58057]: https://github.com/rust-lang/rust/pull/58057/
3505 [58059]: https://github.com/rust-lang/rust/pull/58059/
3506 [57809]: https://github.com/rust-lang/rust/pull/57809/
3507 [57873]: https://github.com/rust-lang/rust/pull/57873/
3508 [57604]: https://github.com/rust-lang/rust/pull/57604/
3509 [57367]: https://github.com/rust-lang/rust/pull/57367/
3510 [57407]: https://github.com/rust-lang/rust/pull/57407/
3511 [57425]: https://github.com/rust-lang/rust/pull/57425/
3512 [57106]: https://github.com/rust-lang/rust/pull/57106/
3513 [56470]: https://github.com/rust-lang/rust/pull/56470/
3514 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
3515 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
3516 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
3517 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
3518 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
3519 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
3520 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
3521 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
3522 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
3523 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
3524 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
3525 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
3526 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
3527 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
3528 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
3529 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
3530 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
3531 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
3532 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
3533 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
3534 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
3535 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
3536 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
3537 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
3538 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
3539 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
3540 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
3541 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
3542 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
3543 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
3544 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
3545
3546
3547 Version 1.33.0 (2019-02-28)
3548 ==========================
3549
3550 Language
3551 --------
3552 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
3553   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
3554 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
3555   E.g. You can have match statement on a `u8` that covers `0..=255` and
3556   you would no longer be required to have a `_ => unreachable!()` case.
3557 - [You can now have multiple patterns in `if let` and `while let`
3558   expressions.][57532] You can do this with the same syntax as a `match`
3559   expression. E.g.
3560   ```rust
3561   enum Creature {
3562       Crab(String),
3563       Lobster(String),
3564       Person(String),
3565   }
3566
3567   fn main() {
3568       let state = Creature::Crab("Ferris");
3569
3570       if let Creature::Crab(name) | Creature::Person(name) = state {
3571           println!("This creature's name is: {}", name);
3572       }
3573   }
3574   ```
3575 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
3576   this feature will by default produce a warning as this behaviour can be
3577   unintuitive. E.g. `if let _ = 5 {}`
3578 - [You can now use `let` bindings, assignments, expression statements,
3579   and irrefutable pattern destructuring in const functions.][57175]
3580 - [You can now call unsafe const functions.][57067] E.g.
3581   ```rust
3582   const unsafe fn foo() -> i32 { 5 }
3583   const fn bar() -> i32 {
3584       unsafe { foo() }
3585   }
3586   ```
3587 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
3588   E.g. `#[cfg_attr(all(), must_use, optimize)]`
3589 - [You can now specify a specific alignment with the `#[repr(packed)]`
3590   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
3591   with an alignment of 2 bytes and a size of 6 bytes.
3592 - [You can now import an item from a module as an `_`.][56303] This allows you to
3593   import a trait's impls, and not have the name in the namespace. E.g.
3594   ```rust
3595   use std::io::Read as _;
3596
3597   // Allowed as there is only one `Read` in the module.
3598   pub trait Read {}
3599   ```
3600 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
3601
3602 Compiler
3603 --------
3604 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
3605   command line argument.][56351]
3606 - [The minimum required LLVM version has been bumped to 6.0.][56642]
3607 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
3608 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
3609   tier 2 support.][57130] Visit the [platform support][platform-support] page for
3610   information on Rust's platform support.
3611 - [Added support for the `thumbv7neon-linux-androideabi` and
3612   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
3613 - [Added support for the `x86_64-unknown-uefi` target.][56769]
3614
3615 Libraries
3616 ---------
3617 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
3618   functions for all numeric types.][57566]
3619 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
3620   are now `const` functions for all numeric types.][57105]
3621 - [The methods `is_positive` and `is_negative` are now `const` functions for
3622   all signed numeric types.][57105]
3623 - [The `get` method for all `NonZero` types is now `const`.][57167]
3624 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
3625   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
3626   numeric types.][57234]
3627 - [`Ipv4Addr::new` is now a `const` function][57234]
3628
3629 Stabilized APIs
3630 ---------------
3631 - [`unix::FileExt::read_exact_at`]
3632 - [`unix::FileExt::write_all_at`]
3633 - [`Option::transpose`]
3634 - [`Result::transpose`]
3635 - [`convert::identity`]
3636 - [`pin::Pin`]
3637 - [`marker::Unpin`]
3638 - [`marker::PhantomPinned`]
3639 - [`Vec::resize_with`]
3640 - [`VecDeque::resize_with`]
3641 - [`Duration::as_millis`]
3642 - [`Duration::as_micros`]
3643 - [`Duration::as_nanos`]
3644
3645
3646 Cargo
3647 -----
3648 - [You can now publish crates that require a feature flag to compile with
3649   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
3650 - [Cargo should now rebuild a crate if a file was modified during the initial
3651   build.][cargo/6484]
3652
3653 Compatibility Notes
3654 -------------------
3655 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
3656   are now deprecated in the standard library, and their usage will now produce a warning.
3657   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
3658   methods instead.
3659 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
3660   downcasting.
3661 - [Libtest no longer creates a new thread for each test when
3662   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
3663
3664 [55982]: https://github.com/rust-lang/rust/pull/55982/
3665 [56243]: https://github.com/rust-lang/rust/pull/56243
3666 [56303]: https://github.com/rust-lang/rust/pull/56303/
3667 [56351]: https://github.com/rust-lang/rust/pull/56351/
3668 [56362]: https://github.com/rust-lang/rust/pull/56362
3669 [56642]: https://github.com/rust-lang/rust/pull/56642/
3670 [56769]: https://github.com/rust-lang/rust/pull/56769/
3671 [56805]: https://github.com/rust-lang/rust/pull/56805
3672 [56947]: https://github.com/rust-lang/rust/pull/56947/
3673 [57049]: https://github.com/rust-lang/rust/pull/57049/
3674 [57067]: https://github.com/rust-lang/rust/pull/57067/
3675 [57105]: https://github.com/rust-lang/rust/pull/57105
3676 [57130]: https://github.com/rust-lang/rust/pull/57130/
3677 [57167]: https://github.com/rust-lang/rust/pull/57167/
3678 [57175]: https://github.com/rust-lang/rust/pull/57175/
3679 [57234]: https://github.com/rust-lang/rust/pull/57234/
3680 [57332]: https://github.com/rust-lang/rust/pull/57332/
3681 [57465]: https://github.com/rust-lang/rust/pull/57465/
3682 [57532]: https://github.com/rust-lang/rust/pull/57532/
3683 [57535]: https://github.com/rust-lang/rust/pull/57535/
3684 [57566]: https://github.com/rust-lang/rust/pull/57566/
3685 [57615]: https://github.com/rust-lang/rust/pull/57615/
3686 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
3687 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
3688 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
3689 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
3690 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
3691 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
3692 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
3693 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
3694 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
3695 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
3696 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
3697 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
3698 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
3699 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
3700 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
3701 [platform-support]: https://forge.rust-lang.org/platform-support.html
3702
3703 Version 1.32.0 (2019-01-17)
3704 ==========================
3705
3706 Language
3707 --------
3708 #### 2018 edition
3709 - [You can now use the `?` operator in macro definitions.][56245] The `?`
3710   operator allows you to specify zero or one repetitions similar to the `*` and
3711   `+` operators.
3712 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
3713   now always resolve to the item (`enum`, `struct`, etc.) available in the
3714   module if present, before resolving to a external crate or an item the prelude.][56759]
3715   E.g.
3716   ```rust
3717   enum Color { Red, Green, Blue }
3718
3719   use Color::*;
3720   ```
3721
3722 #### All editions
3723 - [You can now match against `PhantomData<T>` types.][55837]
3724 - [You can now match against literals in macros with the `literal`
3725   specifier.][56072] This will match against a literal of any type.
3726   E.g. `1`, `'A'`, `"Hello World"`
3727 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
3728   ```rust
3729   struct Point(i32, i32);
3730
3731   impl Point {
3732       pub fn new(x: i32, y: i32) -> Self {
3733           Self(x, y)
3734       }
3735
3736       pub fn is_origin(&self) -> bool {
3737           match self {
3738               Self(0, 0) => true,
3739               _ => false,
3740           }
3741       }
3742   }
3743   ```
3744 - [Self can also now be used in type definitions.][56366] E.g.
3745   ```rust
3746   enum List<T>
3747   where
3748       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
3749   {
3750       Nil,
3751       Cons(T, Box<Self>) // likewise here
3752   }
3753   ```
3754 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
3755   a `impl Trait` or `dyn Trait` is returned and unused in the program.
3756
3757 Compiler
3758 --------
3759 - [The default allocator has changed from jemalloc to the default allocator on
3760   your system.][55238] The compiler itself on Linux & macOS will still use
3761   jemalloc, but programs compiled with it will use the system allocator.
3762 - [Added the `aarch64-pc-windows-msvc` target.][55702]
3763
3764 Libraries
3765 ---------
3766 - [`PathBuf` now implements `FromStr`.][55148]
3767 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
3768 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
3769   easily debug expressions in your rust program. E.g.
3770   ```rust
3771   let a = 2;
3772   let b = dbg!(a * 2) + 1;
3773   //      ^-- prints: [src/main.rs:4] a * 2 = 4
3774   assert_eq!(b, 5);
3775   ```
3776
3777 The following APIs are now `const` functions and can be used in a
3778 `const` context.
3779
3780 - [`Cell::as_ptr`]
3781 - [`UnsafeCell::get`]
3782 - [`char::is_ascii`]
3783 - [`iter::empty`]
3784 - [`ManuallyDrop::new`]
3785 - [`ManuallyDrop::into_inner`]
3786 - [`RangeInclusive::start`]
3787 - [`RangeInclusive::end`]
3788 - [`NonNull::as_ptr`]
3789 - [`slice::as_ptr`]
3790 - [`str::as_ptr`]
3791 - [`Duration::as_secs`]
3792 - [`Duration::subsec_millis`]
3793 - [`Duration::subsec_micros`]
3794 - [`Duration::subsec_nanos`]
3795 - [`CStr::as_ptr`]
3796 - [`Ipv4Addr::is_unspecified`]
3797 - [`Ipv6Addr::new`]
3798 - [`Ipv6Addr::octets`]
3799
3800 Stabilized APIs
3801 ---------------
3802 - [`i8::to_be_bytes`]
3803 - [`i8::to_le_bytes`]
3804 - [`i8::to_ne_bytes`]
3805 - [`i8::from_be_bytes`]
3806 - [`i8::from_le_bytes`]
3807 - [`i8::from_ne_bytes`]
3808 - [`i16::to_be_bytes`]
3809 - [`i16::to_le_bytes`]
3810 - [`i16::to_ne_bytes`]
3811 - [`i16::from_be_bytes`]
3812 - [`i16::from_le_bytes`]
3813 - [`i16::from_ne_bytes`]
3814 - [`i32::to_be_bytes`]
3815 - [`i32::to_le_bytes`]
3816 - [`i32::to_ne_bytes`]
3817 - [`i32::from_be_bytes`]
3818 - [`i32::from_le_bytes`]
3819 - [`i32::from_ne_bytes`]
3820 - [`i64::to_be_bytes`]
3821 - [`i64::to_le_bytes`]
3822 - [`i64::to_ne_bytes`]
3823 - [`i64::from_be_bytes`]
3824 - [`i64::from_le_bytes`]
3825 - [`i64::from_ne_bytes`]
3826 - [`i128::to_be_bytes`]
3827 - [`i128::to_le_bytes`]
3828 - [`i128::to_ne_bytes`]
3829 - [`i128::from_be_bytes`]
3830 - [`i128::from_le_bytes`]
3831 - [`i128::from_ne_bytes`]
3832 - [`isize::to_be_bytes`]
3833 - [`isize::to_le_bytes`]
3834 - [`isize::to_ne_bytes`]
3835 - [`isize::from_be_bytes`]
3836 - [`isize::from_le_bytes`]
3837 - [`isize::from_ne_bytes`]
3838 - [`u8::to_be_bytes`]
3839 - [`u8::to_le_bytes`]
3840 - [`u8::to_ne_bytes`]
3841 - [`u8::from_be_bytes`]
3842 - [`u8::from_le_bytes`]
3843 - [`u8::from_ne_bytes`]
3844 - [`u16::to_be_bytes`]
3845 - [`u16::to_le_bytes`]
3846 - [`u16::to_ne_bytes`]
3847 - [`u16::from_be_bytes`]
3848 - [`u16::from_le_bytes`]
3849 - [`u16::from_ne_bytes`]
3850 - [`u32::to_be_bytes`]
3851 - [`u32::to_le_bytes`]
3852 - [`u32::to_ne_bytes`]
3853 - [`u32::from_be_bytes`]
3854 - [`u32::from_le_bytes`]
3855 - [`u32::from_ne_bytes`]
3856 - [`u64::to_be_bytes`]
3857 - [`u64::to_le_bytes`]
3858 - [`u64::to_ne_bytes`]
3859 - [`u64::from_be_bytes`]
3860 - [`u64::from_le_bytes`]
3861 - [`u64::from_ne_bytes`]
3862 - [`u128::to_be_bytes`]
3863 - [`u128::to_le_bytes`]
3864 - [`u128::to_ne_bytes`]
3865 - [`u128::from_be_bytes`]
3866 - [`u128::from_le_bytes`]
3867 - [`u128::from_ne_bytes`]
3868 - [`usize::to_be_bytes`]
3869 - [`usize::to_le_bytes`]
3870 - [`usize::to_ne_bytes`]
3871 - [`usize::from_be_bytes`]
3872 - [`usize::from_le_bytes`]
3873 - [`usize::from_ne_bytes`]
3874
3875 Cargo
3876 -----
3877 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
3878 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
3879
3880 Misc
3881 ----
3882 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
3883
3884 Compatibility Notes
3885 -------------------
3886 - [The argument types for AVX's
3887   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
3888   been changed from `*const` to `*mut` as the previous implementation
3889   was unsound.
3890
3891
3892 [55148]: https://github.com/rust-lang/rust/pull/55148/
3893 [55238]: https://github.com/rust-lang/rust/pull/55238/
3894 [55280]: https://github.com/rust-lang/rust/pull/55280/
3895 [55610]: https://github.com/rust-lang/rust/pull/55610/
3896 [55663]: https://github.com/rust-lang/rust/pull/55663/
3897 [55702]: https://github.com/rust-lang/rust/pull/55702/
3898 [55837]: https://github.com/rust-lang/rust/pull/55837/
3899 [55843]: https://github.com/rust-lang/rust/pull/55843/
3900 [56072]: https://github.com/rust-lang/rust/pull/56072/
3901 [56245]: https://github.com/rust-lang/rust/pull/56245/
3902 [56365]: https://github.com/rust-lang/rust/pull/56365/
3903 [56366]: https://github.com/rust-lang/rust/pull/56366/
3904 [56395]: https://github.com/rust-lang/rust/pull/56395/
3905 [56759]: https://github.com/rust-lang/rust/pull/56759/
3906 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
3907 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
3908 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
3909 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
3910 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
3911 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3912 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3913 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
3914 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
3915 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
3916 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
3917 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
3918 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
3919 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
3920 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
3921 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
3922 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
3923 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
3924 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
3925 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
3926 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
3927 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
3928 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
3929 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
3930 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
3931 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
3932 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
3933 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
3934 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
3935 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
3936 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
3937 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
3938 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
3939 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
3940 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
3941 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
3942 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
3943 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
3944 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
3945 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
3946 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
3947 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
3948 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
3949 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
3950 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
3951 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
3952 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
3953 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
3954 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
3955 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
3956 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
3957 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
3958 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
3959 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
3960 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
3961 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
3962 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
3963 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
3964 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
3965 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
3966 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
3967 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
3968 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
3969 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
3970 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
3971 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
3972 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
3973 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
3974 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
3975 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
3976 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
3977 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
3978 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
3979 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
3980 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
3981 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
3982 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
3983 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
3984 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
3985 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
3986 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
3987 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
3988 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
3989 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
3990 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
3991 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
3992 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
3993 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
3994 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
3995 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
3996 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
3997 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
3998 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
3999
4000
4001 Version 1.31.1 (2018-12-20)
4002 ===========================
4003
4004 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
4005 - [Fix broken go-to-definition in RLS][rls/1171]
4006 - [Fix infinite loop on hover in RLS][rls/1170]
4007
4008 [56562]: https://github.com/rust-lang/rust/pull/56562
4009 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
4010 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
4011
4012 Version 1.31.0 (2018-12-06)
4013 ==========================
4014
4015 Language
4016 --------
4017 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
4018 - [New lifetime elision rules now allow for eliding lifetimes in functions and
4019   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
4020   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
4021   in structs.
4022 - [You can now define and use `const` functions.][54835] These are currently
4023   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
4024   [language reference][const-reference] for what exactly is available.
4025 - [You can now use tool lints, which allow you to scope lints from external
4026   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
4027 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
4028   a crate, not just in exported functions.][54451]
4029 - [You can now use parentheses in pattern matches.][54497]
4030
4031 Compiler
4032 --------
4033 - [Updated musl to 1.1.20][54430]
4034
4035 Libraries
4036 ---------
4037 - [You can now convert `num::NonZero*` types to their raw equivalents using the
4038   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
4039 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
4040   into `Option<&mut T>` using the `From` trait.][53218]
4041 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
4042
4043
4044 Stabilized APIs
4045 ---------------
4046 - [`slice::align_to`]
4047 - [`slice::align_to_mut`]
4048 - [`slice::chunks_exact`]
4049 - [`slice::chunks_exact_mut`]
4050 - [`slice::rchunks`]
4051 - [`slice::rchunks_mut`]
4052 - [`slice::rchunks_exact`]
4053 - [`slice::rchunks_exact_mut`]
4054 - [`Option::replace`]
4055
4056 Cargo
4057 -----
4058 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
4059 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
4060   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
4061
4062 [52813]: https://github.com/rust-lang/rust/pull/52813/
4063 [53218]: https://github.com/rust-lang/rust/pull/53218/
4064 [53555]: https://github.com/rust-lang/rust/issues/53555/
4065 [54057]: https://github.com/rust-lang/rust/pull/54057/
4066 [54240]: https://github.com/rust-lang/rust/pull/54240/
4067 [54430]: https://github.com/rust-lang/rust/pull/54430/
4068 [54451]: https://github.com/rust-lang/rust/pull/54451/
4069 [54497]: https://github.com/rust-lang/rust/pull/54497/
4070 [54778]: https://github.com/rust-lang/rust/pull/54778/
4071 [54835]: https://github.com/rust-lang/rust/pull/54835/
4072 [54870]: https://github.com/rust-lang/rust/pull/54870/
4073 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
4074 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
4075 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
4076 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
4077 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
4078 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
4079 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
4080 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
4081 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
4082 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
4083 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
4084 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
4085 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
4086 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
4087
4088 Version 1.30.1 (2018-11-08)
4089 ===========================
4090
4091 - [Fixed overflow ICE in rustdoc][54199]
4092 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
4093
4094 [54199]: https://github.com/rust-lang/rust/pull/54199
4095 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
4096
4097 Version 1.30.0 (2018-10-25)
4098 ==========================
4099
4100 Language
4101 --------
4102 - [Procedural macros are now available.][52081] These kinds of macros allow for
4103   more powerful code generation. There is a [new chapter available][proc-macros]
4104   in the Rust Programming Language book that goes further in depth.
4105 - [You can now use keywords as identifiers using the raw identifiers
4106   syntax (`r#`),][53236] e.g. `let r#for = true;`
4107 - [Using anonymous parameters in traits is now deprecated with a warning and
4108   will be a hard error in the 2018 edition.][53272]
4109 - [You can now use `crate` in paths.][54404] This allows you to refer to the
4110   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
4111 - [Using a external crate no longer requires being prefixed with `::`.][54404]
4112   Previously, using a external crate in a module without a use statement
4113   required `let json = ::serde_json::from_str(foo);` but can now be written
4114   as `let json = serde_json::from_str(foo);`.
4115 - [You can now apply the `#[used]` attribute to static items to prevent the
4116   compiler from optimising them away, even if they appear to be unused,][51363]
4117   e.g. `#[used] static FOO: u32 = 1;`
4118 - [You can now import and reexport macros from other crates with the `use`
4119   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
4120   the root module of the crate. If your macro relies on calling other local
4121   macros, it is recommended to export with the
4122   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
4123   those macros.
4124 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
4125   using the `vis` specifier.][53370]
4126 - [Non-macro attributes now allow all forms of literals, not just
4127   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
4128   write `#[attr(true)]`.
4129 - [You can now specify a function to handle a panic in the Rust runtime with the
4130   `#[panic_handler]` attribute.][51366]
4131
4132 Compiler
4133 --------
4134 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
4135 - [Added the `aarch64-unknown-netbsd` target][53165]
4136 - [Upgraded to LLVM 8.][53611]
4137
4138 Libraries
4139 ---------
4140 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
4141
4142 Stabilized APIs
4143 ---------------
4144 - [`Ipv4Addr::BROADCAST`]
4145 - [`Ipv4Addr::LOCALHOST`]
4146 - [`Ipv4Addr::UNSPECIFIED`]
4147 - [`Ipv6Addr::LOCALHOST`]
4148 - [`Ipv6Addr::UNSPECIFIED`]
4149 - [`Iterator::find_map`]
4150
4151   The following methods are replacement methods for `trim_left`, `trim_right`,
4152   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
4153   in 1.33.0:
4154 - [`str::trim_end_matches`]
4155 - [`str::trim_end`]
4156 - [`str::trim_start_matches`]
4157 - [`str::trim_start`]
4158
4159 Cargo
4160 ----
4161 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
4162 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
4163   equivalent to calling `rustdoc --error-format=json`.
4164 - [Cargo will now provide a progress bar for builds.][cargo/5995]
4165
4166 Misc
4167 ----
4168 - [`rustdoc` allows you to specify what edition to treat your code as with the
4169   `--edition` option.][54057]
4170 - [`rustdoc` now has the `--color` (specify whether to output color) and
4171   `--error-format` (specify error format, e.g. `json`) options.][53003]
4172 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
4173   debug symbols.][53774]
4174 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
4175   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
4176
4177 [50911]: https://github.com/rust-lang/rust/pull/50911/
4178 [51363]: https://github.com/rust-lang/rust/pull/51363/
4179 [51366]: https://github.com/rust-lang/rust/pull/51366/
4180 [52081]: https://github.com/rust-lang/rust/pull/52081/
4181 [53003]: https://github.com/rust-lang/rust/pull/53003/
4182 [53033]: https://github.com/rust-lang/rust/pull/53033/
4183 [53044]: https://github.com/rust-lang/rust/pull/53044/
4184 [53165]: https://github.com/rust-lang/rust/pull/53165/
4185 [53611]: https://github.com/rust-lang/rust/pull/53611/
4186 [53213]: https://github.com/rust-lang/rust/pull/53213/
4187 [53236]: https://github.com/rust-lang/rust/pull/53236/
4188 [53272]: https://github.com/rust-lang/rust/pull/53272/
4189 [53370]: https://github.com/rust-lang/rust/pull/53370/
4190 [53459]: https://github.com/rust-lang/rust/pull/53459/
4191 [53774]: https://github.com/rust-lang/rust/pull/53774/
4192 [53822]: https://github.com/rust-lang/rust/pull/53822/
4193 [54057]: https://github.com/rust-lang/rust/pull/54057/
4194 [54146]: https://github.com/rust-lang/rust/pull/54146/
4195 [54404]: https://github.com/rust-lang/rust/pull/54404/
4196 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
4197 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
4198 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
4199 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
4200
4201 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
4202 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
4203 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
4204 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
4205 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
4206 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
4207 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
4208 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
4209 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
4210 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
4211
4212
4213 Version 1.29.2 (2018-10-11)
4214 ===========================
4215
4216 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
4217 - The `rls-preview` component on the windows-gnu targets has been restored.
4218
4219 [54639]: https://github.com/rust-lang/rust/pull/54639
4220
4221
4222 Version 1.29.1 (2018-09-25)
4223 ===========================
4224
4225 Security Notes
4226 --------------
4227
4228 - The standard library's `str::repeat` function contained an out of bounds write
4229   caused by an integer overflow. This has been fixed by deterministically
4230   panicking when an overflow happens.
4231
4232   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
4233   us.
4234
4235
4236 Version 1.29.0 (2018-09-13)
4237 ==========================
4238
4239 Compiler
4240 --------
4241 - [Bumped minimum LLVM version to 5.0.][51899]
4242 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
4243 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
4244 - [Upgraded to LLVM 7.][51966]
4245
4246 Libraries
4247 ---------
4248 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
4249 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
4250 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
4251 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
4252   for `&str`.][51178]
4253 - [`Cell<T>` now allows `T` to be unsized.][50494]
4254 - [`SocketAddr` is now stable on Redox.][52656]
4255
4256 Stabilized APIs
4257 ---------------
4258 - [`Arc::downcast`]
4259 - [`Iterator::flatten`]
4260 - [`Rc::downcast`]
4261
4262 Cargo
4263 -----
4264 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
4265   `--locked` to disable this behavior.
4266 - [`cargo-install` will now allow you to cross compile an install
4267   using `--target`.][cargo/5614]
4268 - [Added the `cargo-fix` subcommand to automatically move project code from
4269   2015 edition to 2018.][cargo/5723]
4270 - [`cargo doc` can now optionally document private types using the
4271   `--document-private-items` flag.][cargo/5543]
4272
4273 Misc
4274 ----
4275 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
4276   the specified level to that level.][52354] For example `--cap-lints warn`
4277   will demote `deny` and `forbid` lints to `warn`.
4278 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
4279   fails and `101` if there is a panic.][52197]
4280 - [A preview of clippy has been made available through rustup.][51122]
4281   You can install the preview with `rustup component add clippy-preview`.
4282
4283 Compatibility Notes
4284 -------------------
4285 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
4286   Use `str::get_unchecked(begin..end)` instead.
4287 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
4288   Consider using the `home_dir` function from
4289   https://crates.io/crates/dirs instead.
4290 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
4291 - [`cfg` attributes and `--cfg` command line flags are now more
4292   strictly validated.][53893]
4293
4294 [53893]: https://github.com/rust-lang/rust/pull/53893/
4295 [52861]: https://github.com/rust-lang/rust/pull/52861/
4296 [51966]: https://github.com/rust-lang/rust/pull/51966/
4297 [52656]: https://github.com/rust-lang/rust/pull/52656/
4298 [52239]: https://github.com/rust-lang/rust/pull/52239/
4299 [52330]: https://github.com/rust-lang/rust/pull/52330/
4300 [52354]: https://github.com/rust-lang/rust/pull/52354/
4301 [52402]: https://github.com/rust-lang/rust/pull/52402/
4302 [52103]: https://github.com/rust-lang/rust/pull/52103/
4303 [52197]: https://github.com/rust-lang/rust/pull/52197/
4304 [51807]: https://github.com/rust-lang/rust/pull/51807/
4305 [51899]: https://github.com/rust-lang/rust/pull/51899/
4306 [51912]: https://github.com/rust-lang/rust/pull/51912/
4307 [51511]: https://github.com/rust-lang/rust/pull/51511/
4308 [51619]: https://github.com/rust-lang/rust/pull/51619/
4309 [51656]: https://github.com/rust-lang/rust/pull/51656/
4310 [51178]: https://github.com/rust-lang/rust/pull/51178/
4311 [51122]: https://github.com/rust-lang/rust/pull/51122
4312 [50494]: https://github.com/rust-lang/rust/pull/50494/
4313 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
4314 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
4315 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
4316 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
4317 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
4318 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
4319 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
4320
4321
4322 Version 1.28.0 (2018-08-02)
4323 ===========================
4324
4325 Language
4326 --------
4327 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
4328   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
4329   the inner type across Foreign Function Interface (FFI) boundaries.
4330 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
4331   and can now be used as identifiers.][51196]
4332 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
4333   stable.][51241] This will allow users to specify a global allocator for
4334   their program.
4335 - [Unit test functions marked with the `#[test]` attribute can now return
4336   `Result<(), E: Debug>` in addition to `()`.][51298]
4337 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
4338   allows macros to easily target lifetimes.
4339
4340 Compiler
4341 --------
4342 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
4343   prioritise making smaller binary sizes. `z` is the same as `s` with the
4344   exception that it does not vectorise loops, which typically results in an even
4345   smaller binary.
4346 - [The short error format is now stable.][49546] Specified with
4347   `--error-format=short` this option will provide a more compressed output of
4348   rust error messages.
4349 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
4350 - [Reduced the number of allocations in the macro parser.][50855] This can
4351   improve compile times of macro heavy crates on average by 5%.
4352
4353 Libraries
4354 ---------
4355 - [Implemented `Default` for `&mut str`.][51306]
4356 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
4357 - [Implemented `Extend` for `()`.][50234]
4358 - [The `Debug` implementation of `time::Duration` should now be more easily
4359   human readable.][50364] Previously a `Duration` of one second would printed as
4360   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
4361 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
4362   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
4363   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
4364   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
4365   for `PathBuf`.][50170]
4366 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
4367   and `Wrapping<i128>`.][50465]
4368 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
4369   possible.][51050] This can provide up to a 40% speed increase.
4370 - [Improved error messages when using `format!`.][50610]
4371
4372 Stabilized APIs
4373 ---------------
4374 - [`Iterator::step_by`]
4375 - [`Path::ancestors`]
4376 - [`SystemTime::UNIX_EPOCH`]
4377 - [`alloc::GlobalAlloc`]
4378 - [`alloc::Layout`]
4379 - [`alloc::LayoutErr`]
4380 - [`alloc::System`]
4381 - [`alloc::alloc`]
4382 - [`alloc::alloc_zeroed`]
4383 - [`alloc::dealloc`]
4384 - [`alloc::realloc`]
4385 - [`alloc::handle_alloc_error`]
4386 - [`btree_map::Entry::or_default`]
4387 - [`fmt::Alignment`]
4388 - [`hash_map::Entry::or_default`]
4389 - [`iter::repeat_with`]
4390 - [`num::NonZeroUsize`]
4391 - [`num::NonZeroU128`]
4392 - [`num::NonZeroU16`]
4393 - [`num::NonZeroU32`]
4394 - [`num::NonZeroU64`]
4395 - [`num::NonZeroU8`]
4396 - [`ops::RangeBounds`]
4397 - [`slice::SliceIndex`]
4398 - [`slice::from_mut`]
4399 - [`slice::from_ref`]
4400 - [`{Any + Send + Sync}::downcast_mut`]
4401 - [`{Any + Send + Sync}::downcast_ref`]
4402 - [`{Any + Send + Sync}::is`]
4403
4404 Cargo
4405 -----
4406 - [Cargo will now no longer allow you to publish crates with build scripts that
4407   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
4408   considered to be immutable.
4409
4410 Misc
4411 ----
4412 - [The `suggestion_applicability` field in `rustc`'s json output is now
4413   stable.][50486] This will allow dev tools to check whether a code suggestion
4414   would apply to them.
4415
4416 Compatibility Notes
4417 -------------------
4418 - [Rust will consider trait objects with duplicated constraints to be the same
4419   type as without the duplicated constraint.][51276] For example the below code will
4420   now fail to compile.
4421   ```rust
4422   trait Trait {}
4423
4424   impl Trait + Send {
4425       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
4426   }
4427
4428   impl Trait + Send + Send {
4429       fn test(&self) { println!("two"); }
4430   }
4431   ```
4432
4433 [49546]: https://github.com/rust-lang/rust/pull/49546/
4434 [50143]: https://github.com/rust-lang/rust/pull/50143/
4435 [50170]: https://github.com/rust-lang/rust/pull/50170/
4436 [50234]: https://github.com/rust-lang/rust/pull/50234/
4437 [50265]: https://github.com/rust-lang/rust/pull/50265/
4438 [50364]: https://github.com/rust-lang/rust/pull/50364/
4439 [50385]: https://github.com/rust-lang/rust/pull/50385/
4440 [50465]: https://github.com/rust-lang/rust/pull/50465/
4441 [50486]: https://github.com/rust-lang/rust/pull/50486/
4442 [50554]: https://github.com/rust-lang/rust/pull/50554/
4443 [50610]: https://github.com/rust-lang/rust/pull/50610/
4444 [50855]: https://github.com/rust-lang/rust/pull/50855/
4445 [51050]: https://github.com/rust-lang/rust/pull/51050/
4446 [51196]: https://github.com/rust-lang/rust/pull/51196/
4447 [51200]: https://github.com/rust-lang/rust/pull/51200/
4448 [51241]: https://github.com/rust-lang/rust/pull/51241/
4449 [51276]: https://github.com/rust-lang/rust/pull/51276/
4450 [51298]: https://github.com/rust-lang/rust/pull/51298/
4451 [51306]: https://github.com/rust-lang/rust/pull/51306/
4452 [51562]: https://github.com/rust-lang/rust/pull/51562/
4453 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
4454 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
4455 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
4456 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
4457 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
4458 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
4459 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
4460 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
4461 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
4462 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
4463 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
4464 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
4465 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
4466 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
4467 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
4468 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
4469 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
4470 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
4471 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
4472 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
4473 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
4474 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
4475 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
4476 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
4477 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
4478 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
4479 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
4480 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
4481 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
4482 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
4483
4484 Version 1.27.2 (2018-07-20)
4485 ===========================
4486
4487 Compatibility Notes
4488 -------------------
4489
4490 - The borrow checker was fixed to avoid potential unsoundness when using
4491   match ergonomics: [#52213][52213].
4492
4493 [52213]: https://github.com/rust-lang/rust/issues/52213
4494
4495 Version 1.27.1 (2018-07-10)
4496 ===========================
4497
4498 Security Notes
4499 --------------
4500
4501 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
4502   when running, which enabled executing code as some other user on a
4503   given machine. This release fixes that vulnerability; you can read
4504   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
4505
4506   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
4507
4508 Compatibility Notes
4509 -------------------
4510
4511 - The borrow checker was fixed to avoid an additional potential unsoundness when using
4512   match ergonomics: [#51415][51415], [#49534][49534].
4513
4514 [51415]: https://github.com/rust-lang/rust/issues/51415
4515 [49534]: https://github.com/rust-lang/rust/issues/49534
4516 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
4517 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
4518
4519 Version 1.27.0 (2018-06-21)
4520 ==========================
4521
4522 Language
4523 --------
4524 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
4525   be used as an identifier.
4526 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
4527   bare `Trait` syntax, and should make it clearer when being used in tandem with
4528   `impl Trait` because it is equivalent to the following syntax:
4529   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
4530   `Box<Trait> == Box<dyn Trait>`.
4531 - [Attributes on generic parameters such as types and lifetimes are
4532   now stable.][48851] e.g.
4533   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
4534 - [The `#[must_use]` attribute can now also be used on functions as well as
4535   types.][48925] It provides a lint that by default warns users when the
4536   value returned by a function has not been used.
4537
4538 Compiler
4539 --------
4540 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
4541
4542 Libraries
4543 ---------
4544 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
4545   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
4546   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
4547   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
4548   the `cfg` attribute.
4549 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
4550   std are now available in core.][49896]
4551 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
4552   to `Self`.][49630]
4553 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
4554   that the operation isn't done in place.
4555 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
4556   the `#[must_use]` attribute][49533] to warn about unused potentially
4557   expensive allocations.
4558
4559 Stabilized APIs
4560 ---------------
4561 - [`DoubleEndedIterator::rfind`]
4562 - [`DoubleEndedIterator::rfold`]
4563 - [`DoubleEndedIterator::try_rfold`]
4564 - [`Duration::from_micros`]
4565 - [`Duration::from_nanos`]
4566 - [`Duration::subsec_micros`]
4567 - [`Duration::subsec_millis`]
4568 - [`HashMap::remove_entry`]
4569 - [`Iterator::try_fold`]
4570 - [`Iterator::try_for_each`]
4571 - [`NonNull::cast`]
4572 - [`Option::filter`]
4573 - [`String::replace_range`]
4574 - [`Take::set_limit`]
4575 - [`hint::unreachable_unchecked`]
4576 - [`os::unix::process::parent_id`]
4577 - [`ptr::swap_nonoverlapping`]
4578 - [`slice::rsplit_mut`]
4579 - [`slice::rsplit`]
4580 - [`slice::swap_with_slice`]
4581
4582 Cargo
4583 -----
4584 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
4585   `readme`, and `repository` fields.][cargo/5386]
4586 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
4587 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
4588   a different directory than `target` for placing compilation artifacts.
4589 - [Cargo will be adding automatic target inference for binaries, benchmarks,
4590   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
4591   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
4592   where cargo would infer a binary, Cargo will produce a warning. You can
4593   disable this feature ahead of time by setting any of the following to false:
4594   `autobins`, `autobenches`, `autoexamples`, `autotests`.
4595 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
4596   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
4597
4598 Misc
4599 ----
4600 - [Added “The Rustc book” into the official documentation.][49707]
4601   [“The Rustc book”] documents and teaches how to use the rustc compiler.
4602 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
4603
4604 Compatibility Notes
4605 -------------------
4606 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
4607   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
4608   compile, `"".is_empty()` will still compile.
4609 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
4610   will only print the inner type.][48553] E.g.
4611   `print!("{:?}", AtomicBool::new(true))` will print `true`,
4612   not `AtomicBool(true)`.
4613 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
4614   could enter higher numbers but they were not supported by LLVM. Up to 512MB
4615   alignment should cover all use cases.
4616 - The `.description()` method on the `std::error::Error` trait
4617   [has been soft-deprecated][50163]. It is no longer required to implement it.
4618
4619 [48553]: https://github.com/rust-lang/rust/pull/48553/
4620 [48851]: https://github.com/rust-lang/rust/pull/48851/
4621 [48925]: https://github.com/rust-lang/rust/pull/48925/
4622 [49533]: https://github.com/rust-lang/rust/pull/49533/
4623 [49623]: https://github.com/rust-lang/rust/pull/49623/
4624 [49630]: https://github.com/rust-lang/rust/pull/49630/
4625 [49664]: https://github.com/rust-lang/rust/pull/49664/
4626 [49699]: https://github.com/rust-lang/rust/pull/49699/
4627 [49707]: https://github.com/rust-lang/rust/pull/49707/
4628 [49719]: https://github.com/rust-lang/rust/pull/49719/
4629 [49896]: https://github.com/rust-lang/rust/pull/49896/
4630 [49968]: https://github.com/rust-lang/rust/pull/49968/
4631 [50163]: https://github.com/rust-lang/rust/pull/50163
4632 [50177]: https://github.com/rust-lang/rust/pull/50177/
4633 [50378]: https://github.com/rust-lang/rust/pull/50378/
4634 [50398]: https://github.com/rust-lang/rust/pull/50398/
4635 [50423]: https://github.com/rust-lang/rust/pull/50423/
4636 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
4637 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
4638 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
4639 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
4640 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
4641 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
4642 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
4643 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
4644 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
4645 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
4646 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
4647 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
4648 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
4649 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
4650 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
4651 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
4652 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
4653 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
4654 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
4655 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
4656 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
4657 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
4658 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4659 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
4660 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
4661 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
4662 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
4663 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
4664 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
4665 [“The Rustc book”]: https://doc.rust-lang.org/rustc
4666
4667
4668 Version 1.26.2 (2018-06-05)
4669 ==========================
4670
4671 Compatibility Notes
4672 -------------------
4673
4674 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
4675
4676 [51117]: https://github.com/rust-lang/rust/issues/51117
4677
4678
4679 Version 1.26.1 (2018-05-29)
4680 ==========================
4681
4682 Tools
4683 -----
4684
4685 - [RLS now works on Windows.][50646]
4686 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
4687
4688
4689 Compatibility Notes
4690 --------
4691
4692 - [`fn main() -> impl Trait` no longer works for non-Termination
4693   trait.][50656]
4694   This reverts an accidental stabilization.
4695 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
4696 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
4697
4698 [50646]: https://github.com/rust-lang/rust/issues/50646
4699 [50656]: https://github.com/rust-lang/rust/pull/50656
4700 [50812]: https://github.com/rust-lang/rust/pull/50812
4701 [50950]: https://github.com/rust-lang/rust/issues/50950
4702 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
4703
4704 Version 1.26.0 (2018-05-10)
4705 ==========================
4706
4707 Language
4708 --------
4709 - [Closures now implement `Copy` and/or `Clone` if all captured variables
4710   implement either or both traits.][49299]
4711 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
4712 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
4713   lifetime can be elided.][49458]
4714 - [`impl Trait` is now stable allowing you to have abstract types in returns
4715    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
4716   `fn open(path: impl AsRef<Path>)`.
4717 - [Pattern matching will now automatically apply dereferences.][49394]
4718 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
4719 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
4720 - [A lot of operations are now available in a const context.][46882] E.g. You
4721   can now index into constant arrays, reference and dereference into constants,
4722   and use tuple struct constructors.
4723 - [Fixed entry slice patterns are now stable.][48516] E.g.
4724   ```rust
4725   let points = [1, 2, 3, 4];
4726   match points {
4727       [1, 2, 3, 4] => println!("All points were sequential."),
4728       _ => println!("Not all points were sequential."),
4729   }
4730   ```
4731
4732
4733 Compiler
4734 --------
4735 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
4736 - [Fixed exponential projection complexity on nested types.][48296]
4737   This can provide up to a ~12% reduction in compile times for certain crates.
4738 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
4739   to remap path prefixes outputted by the compiler.
4740 - [Added `powerpc-unknown-netbsd` target.][48281]
4741
4742 Libraries
4743 ---------
4744 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
4745 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
4746   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
4747 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
4748 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
4749 - [`ascii::escape_default` is now available in libcore.][48735]
4750 - [Trailing commas are now supported in std and core macros.][48056]
4751 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
4752 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
4753
4754 Stabilized APIs
4755 ---------------
4756 - [`*const T::add`]
4757 - [`*const T::copy_to_nonoverlapping`]
4758 - [`*const T::copy_to`]
4759 - [`*const T::read_unaligned`]
4760 - [`*const T::read_volatile`]
4761 - [`*const T::read`]
4762 - [`*const T::sub`]
4763 - [`*const T::wrapping_add`]
4764 - [`*const T::wrapping_sub`]
4765 - [`*mut T::add`]
4766 - [`*mut T::copy_to_nonoverlapping`]
4767 - [`*mut T::copy_to`]
4768 - [`*mut T::read_unaligned`]
4769 - [`*mut T::read_volatile`]
4770 - [`*mut T::read`]
4771 - [`*mut T::replace`]
4772 - [`*mut T::sub`]
4773 - [`*mut T::swap`]
4774 - [`*mut T::wrapping_add`]
4775 - [`*mut T::wrapping_sub`]
4776 - [`*mut T::write_bytes`]
4777 - [`*mut T::write_unaligned`]
4778 - [`*mut T::write_volatile`]
4779 - [`*mut T::write`]
4780 - [`Box::leak`]
4781 - [`FromUtf8Error::as_bytes`]
4782 - [`LocalKey::try_with`]
4783 - [`Option::cloned`]
4784 - [`btree_map::Entry::and_modify`]
4785 - [`fs::read_to_string`]
4786 - [`fs::read`]
4787 - [`fs::write`]
4788 - [`hash_map::Entry::and_modify`]
4789 - [`iter::FusedIterator`]
4790 - [`ops::RangeInclusive`]
4791 - [`ops::RangeToInclusive`]
4792 - [`process::id`]
4793 - [`slice::rotate_left`]
4794 - [`slice::rotate_right`]
4795 - [`String::retain`]
4796
4797
4798 Cargo
4799 -----
4800 - [Cargo will now output path to custom commands when `-v` is
4801   passed with `--list`][cargo/5041]
4802 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
4803
4804 Misc
4805 ----
4806 - [The second edition of "The Rust Programming Language" book is now recommended
4807   over the first.][48404]
4808
4809 Compatibility Notes
4810 -------------------
4811
4812 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
4813   syntax is now invalid.
4814   ```
4815   use std::ops::Fn as dyn;
4816   fn g(_: Box<dyn(std::fmt::Debug)>) {}
4817   ```
4818 - [The result of dereferences are no longer promoted to `'static`.][47408]
4819   e.g.
4820   ```rust
4821   fn main() {
4822       const PAIR: &(i32, i32) = &(0, 1);
4823       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
4824   }
4825   ```
4826 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
4827 - [`".e0"` will now no longer parse as `0.0` and will instead cause
4828   an error.][48235]
4829 - [Removed hoedown from rustdoc.][48274]
4830 - [Bounds on higher-kinded lifetimes a hard error.][48326]
4831
4832 [46882]: https://github.com/rust-lang/rust/pull/46882
4833 [47379]: https://github.com/rust-lang/rust/pull/47379
4834 [47408]: https://github.com/rust-lang/rust/pull/47408
4835 [47813]: https://github.com/rust-lang/rust/pull/47813
4836 [48056]: https://github.com/rust-lang/rust/pull/48056
4837 [48125]: https://github.com/rust-lang/rust/pull/48125
4838 [48166]: https://github.com/rust-lang/rust/pull/48166
4839 [48235]: https://github.com/rust-lang/rust/pull/48235
4840 [48274]: https://github.com/rust-lang/rust/pull/48274
4841 [48281]: https://github.com/rust-lang/rust/pull/48281
4842 [48296]: https://github.com/rust-lang/rust/pull/48296
4843 [48326]: https://github.com/rust-lang/rust/pull/48326
4844 [48359]: https://github.com/rust-lang/rust/pull/48359
4845 [48404]: https://github.com/rust-lang/rust/pull/48404
4846 [48481]: https://github.com/rust-lang/rust/pull/48481
4847 [48516]: https://github.com/rust-lang/rust/pull/48516
4848 [48628]: https://github.com/rust-lang/rust/pull/48628
4849 [48629]: https://github.com/rust-lang/rust/pull/48629
4850 [48657]: https://github.com/rust-lang/rust/pull/48657
4851 [48735]: https://github.com/rust-lang/rust/pull/48735
4852 [48978]: https://github.com/rust-lang/rust/pull/48978
4853 [49101]: https://github.com/rust-lang/rust/pull/49101
4854 [49109]: https://github.com/rust-lang/rust/pull/49109
4855 [49121]: https://github.com/rust-lang/rust/pull/49121
4856 [49162]: https://github.com/rust-lang/rust/pull/49162
4857 [49184]: https://github.com/rust-lang/rust/pull/49184
4858 [49234]: https://github.com/rust-lang/rust/pull/49234
4859 [49255]: https://github.com/rust-lang/rust/pull/49255
4860 [49299]: https://github.com/rust-lang/rust/pull/49299
4861 [49305]: https://github.com/rust-lang/rust/pull/49305
4862 [49394]: https://github.com/rust-lang/rust/pull/49394
4863 [49458]: https://github.com/rust-lang/rust/pull/49458
4864 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
4865 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
4866 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
4867 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
4868 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
4869 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
4870 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
4871 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
4872 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
4873 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
4874 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
4875 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
4876 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
4877 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
4878 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
4879 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
4880 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
4881 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
4882 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
4883 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
4884 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
4885 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
4886 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
4887 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
4888 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
4889 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
4890 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
4891 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
4892 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
4893 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
4894 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
4895 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
4896 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
4897 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
4898 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
4899 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
4900 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4901 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
4902 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
4903 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
4904 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
4905 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
4906
4907
4908 Version 1.25.0 (2018-03-29)
4909 ==========================
4910
4911 Language
4912 --------
4913 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
4914 - [You can now use nested groups of imports.][47948]
4915   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
4916 - [You can now have `|` at the start of a match arm.][47947] e.g.
4917 ```rust
4918 enum Foo { A, B, C }
4919
4920 fn main() {
4921     let x = Foo::A;
4922     match x {
4923         | Foo::A
4924         | Foo::B => println!("AB"),
4925         | Foo::C => println!("C"),
4926     }
4927 }
4928 ```
4929
4930 Compiler
4931 --------
4932 - [Upgraded to LLVM 6.][47828]
4933 - [Added `-C lto=val` option.][47521]
4934 - [Added `i586-unknown-linux-musl` target][47282]
4935
4936 Libraries
4937 ---------
4938 - [Impl Send for `process::Command` on Unix.][47760]
4939 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
4940 - [`UnsafeCell::into_inner` is now safe.][47204]
4941 - [Implement libstd for CloudABI.][47268]
4942 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
4943 - [Implement `AsRef<Path>` for Component][46985]
4944 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
4945 - [Moved `Duration` to libcore.][46666]
4946
4947 Stabilized APIs
4948 ---------------
4949 - [`Location::column`]
4950 - [`ptr::NonNull`]
4951
4952 The following functions can now be used in a constant expression.
4953 eg. `static MINUTE: Duration = Duration::from_secs(60);`
4954 - [`Duration::new`][47300]
4955 - [`Duration::from_secs`][47300]
4956 - [`Duration::from_millis`][47300]
4957
4958 Cargo
4959 -----
4960 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
4961 - [`cargo new` now defaults to creating a binary crate, instead of a
4962   library crate.][cargo/5029]
4963
4964 Misc
4965 ----
4966 - [Rust by example is now shipped with new releases][46196]
4967
4968 Compatibility Notes
4969 -------------------
4970 - [Deprecated `net::lookup_host`.][47510]
4971 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
4972 - The borrow checker was sometimes incorrectly permitting overlapping borrows
4973   around indexing operations (see [#47349][47349]). This has been fixed (which also
4974   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
4975 - [Removed deprecated unstable attribute `#[simd]`.][47251]
4976
4977 [33903]: https://github.com/rust-lang/rust/pull/33903
4978 [47947]: https://github.com/rust-lang/rust/pull/47947
4979 [47948]: https://github.com/rust-lang/rust/pull/47948
4980 [47760]: https://github.com/rust-lang/rust/pull/47760
4981 [47790]: https://github.com/rust-lang/rust/pull/47790
4982 [47828]: https://github.com/rust-lang/rust/pull/47828
4983 [47398]: https://github.com/rust-lang/rust/pull/47398
4984 [47510]: https://github.com/rust-lang/rust/pull/47510
4985 [47521]: https://github.com/rust-lang/rust/pull/47521
4986 [47204]: https://github.com/rust-lang/rust/pull/47204
4987 [47251]: https://github.com/rust-lang/rust/pull/47251
4988 [47268]: https://github.com/rust-lang/rust/pull/47268
4989 [47282]: https://github.com/rust-lang/rust/pull/47282
4990 [47300]: https://github.com/rust-lang/rust/pull/47300
4991 [47349]: https://github.com/rust-lang/rust/pull/47349
4992 [46931]: https://github.com/rust-lang/rust/pull/46931
4993 [46985]: https://github.com/rust-lang/rust/pull/46985
4994 [47006]: https://github.com/rust-lang/rust/pull/47006
4995 [46830]: https://github.com/rust-lang/rust/pull/46830
4996 [46095]: https://github.com/rust-lang/rust/pull/46095
4997 [46666]: https://github.com/rust-lang/rust/pull/46666
4998 [46196]: https://github.com/rust-lang/rust/pull/46196
4999 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
5000 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
5001 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
5002 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
5003 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
5004
5005
5006 Version 1.24.1 (2018-03-01)
5007 ==========================
5008
5009  - [Do not abort when unwinding through FFI][48251]
5010  - [Emit UTF-16 files for linker arguments on Windows][48318]
5011  - [Make the error index generator work again][48308]
5012  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
5013
5014 [48251]: https://github.com/rust-lang/rust/issues/48251
5015 [48308]: https://github.com/rust-lang/rust/issues/48308
5016 [48318]: https://github.com/rust-lang/rust/issues/48318
5017 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
5018
5019
5020 Version 1.24.0 (2018-02-15)
5021 ==========================
5022
5023 Language
5024 --------
5025 - [External `sysv64` ffi is now available.][46528]
5026   eg. `extern "sysv64" fn foo () {}`
5027
5028 Compiler
5029 --------
5030 - [rustc now uses 16 codegen units by default for release builds.][46910]
5031   For the fastest builds, utilize `codegen-units=1`.
5032 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
5033 - [Add `aarch64-unknown-openbsd` support][46760]
5034
5035 Libraries
5036 ---------
5037 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
5038   improvement in performance in the majority of cases.
5039 - [`OsStr`'s `Debug` implementation is now lossless and consistent
5040   with Windows.][46798]
5041 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
5042 - [impl `From<bool>` for `AtomicBool`][46293]
5043 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
5044 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
5045 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
5046 - [float::from_bits now just uses transmute.][46012] This provides
5047   some optimisations from LLVM.
5048 - [Copied `AsciiExt` methods onto `char`][46077]
5049 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
5050 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
5051 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
5052 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
5053
5054 Stabilized APIs
5055 ---------------
5056 - [`RefCell::replace`]
5057 - [`RefCell::swap`]
5058 - [`atomic::spin_loop_hint`]
5059
5060 The following functions can now be used in a constant expression.
5061 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
5062
5063 - [`AtomicBool::new`][46287]
5064 - [`AtomicUsize::new`][46287]
5065 - [`AtomicIsize::new`][46287]
5066 - [`AtomicPtr::new`][46287]
5067 - [`Cell::new`][46287]
5068 - [`{integer}::min_value`][46287]
5069 - [`{integer}::max_value`][46287]
5070 - [`mem::size_of`][46287]
5071 - [`mem::align_of`][46287]
5072 - [`ptr::null`][46287]
5073 - [`ptr::null_mut`][46287]
5074 - [`RefCell::new`][46287]
5075 - [`UnsafeCell::new`][46287]
5076
5077 Cargo
5078 -----
5079 - [Added a `workspace.default-members` config that
5080   overrides implied `--all` in virtual workspaces.][cargo/4743]
5081 - [Enable incremental by default on development builds.][cargo/4817] Also added
5082   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
5083   per-project or global basis respectively.
5084
5085 Misc
5086 ----
5087
5088 Compatibility Notes
5089 -------------------
5090 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
5091 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
5092   in accordance with IETF RFC 4291 §2.2.
5093 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
5094 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
5095   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
5096 - [Leading zeros in tuple struct members is now an error][47084]
5097 - [`column!()` macro is one-based instead of zero-based][46977]
5098 - [`fmt::Arguments` can no longer be shared across threads][45198]
5099 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
5100 - [Cargo sets a different working directory for the compiler][cargo/4788]
5101
5102 [44884]: https://github.com/rust-lang/rust/pull/44884
5103 [45198]: https://github.com/rust-lang/rust/pull/45198
5104 [45506]: https://github.com/rust-lang/rust/pull/45506
5105 [45904]: https://github.com/rust-lang/rust/pull/45904
5106 [45990]: https://github.com/rust-lang/rust/pull/45990
5107 [46012]: https://github.com/rust-lang/rust/pull/46012
5108 [46077]: https://github.com/rust-lang/rust/pull/46077
5109 [46094]: https://github.com/rust-lang/rust/pull/46094
5110 [46284]: https://github.com/rust-lang/rust/pull/46284
5111 [46287]: https://github.com/rust-lang/rust/pull/46287
5112 [46293]: https://github.com/rust-lang/rust/pull/46293
5113 [46528]: https://github.com/rust-lang/rust/pull/46528
5114 [46671]: https://github.com/rust-lang/rust/pull/46671
5115 [46713]: https://github.com/rust-lang/rust/pull/46713
5116 [46735]: https://github.com/rust-lang/rust/pull/46735
5117 [46749]: https://github.com/rust-lang/rust/pull/46749
5118 [46760]: https://github.com/rust-lang/rust/pull/46760
5119 [46798]: https://github.com/rust-lang/rust/pull/46798
5120 [46828]: https://github.com/rust-lang/rust/pull/46828
5121 [46831]: https://github.com/rust-lang/rust/pull/46831
5122 [46833]: https://github.com/rust-lang/rust/pull/46833
5123 [46910]: https://github.com/rust-lang/rust/pull/46910
5124 [46977]: https://github.com/rust-lang/rust/pull/46977
5125 [47018]: https://github.com/rust-lang/rust/pull/47018
5126 [47080]: https://github.com/rust-lang/rust/pull/47080
5127 [47084]: https://github.com/rust-lang/rust/pull/47084
5128 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
5129 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
5130 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
5131 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
5132 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
5133 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
5134
5135
5136 Version 1.23.0 (2018-01-04)
5137 ==========================
5138
5139 Language
5140 --------
5141 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
5142 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
5143   Which should fix some confusing errors in some operations.
5144
5145 Compiler
5146 --------
5147 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
5148   undefined behavior.][45920]
5149 - [rustc now suggests renaming import if names clash.][45660]
5150 - [Display errors/warnings correctly when there are zero-width or
5151   wide characters.][45711]
5152 - [rustc now avoids unnecessary copies of arguments that are
5153   simple bindings][45380] This should improve memory usage on average by 5-10%.
5154 - [Updated musl used to build musl rustc to 1.1.17][45393]
5155
5156 Libraries
5157 ---------
5158 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
5159 - [Implement Hash for raw pointers to unsized types][45483]
5160 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
5161 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
5162 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
5163 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
5164   and `<*mut T>::as_mut`][44932]
5165 - [Optimized `Thread::{park, unpark}` implementation][45524]
5166 - [Improved `SliceExt::binary_search` performance.][45333]
5167 - [impl `FromIterator<()>` for `()`][45379]
5168 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
5169   is now deprecated.
5170
5171 Stabilized APIs
5172 ---------------
5173
5174 Cargo
5175 -----
5176 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
5177   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
5178 - [Added unit test checking to `cargo check`][cargo/4592]
5179 - [Cargo now lets you install a specific version
5180   using `cargo install --version`][cargo/4637]
5181
5182 Misc
5183 ----
5184 - [Releases now ship with the Cargo book documentation.][45692]
5185 - [rustdoc now prints rendering warnings on every run.][45324]
5186
5187 Compatibility Notes
5188 -------------------
5189 - [Changes have been made to type equality to make it more correct,
5190   in rare cases this could break some code.][45853] [Tracking issue for
5191   further information][45852]
5192 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
5193 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
5194   Android 9, the minimum supported version is Android 14.
5195 - [Bumped the minimum LLVM to 3.9][45326]
5196
5197 [44042]: https://github.com/rust-lang/rust/pull/44042
5198 [44932]: https://github.com/rust-lang/rust/pull/44932
5199 [45267]: https://github.com/rust-lang/rust/pull/45267
5200 [45324]: https://github.com/rust-lang/rust/pull/45324
5201 [45326]: https://github.com/rust-lang/rust/pull/45326
5202 [45333]: https://github.com/rust-lang/rust/pull/45333
5203 [45379]: https://github.com/rust-lang/rust/pull/45379
5204 [45380]: https://github.com/rust-lang/rust/pull/45380
5205 [45393]: https://github.com/rust-lang/rust/pull/45393
5206 [45435]: https://github.com/rust-lang/rust/pull/45435
5207 [45483]: https://github.com/rust-lang/rust/pull/45483
5208 [45524]: https://github.com/rust-lang/rust/pull/45524
5209 [45571]: https://github.com/rust-lang/rust/pull/45571
5210 [45580]: https://github.com/rust-lang/rust/pull/45580
5211 [45610]: https://github.com/rust-lang/rust/pull/45610
5212 [45660]: https://github.com/rust-lang/rust/pull/45660
5213 [45692]: https://github.com/rust-lang/rust/pull/45692
5214 [45711]: https://github.com/rust-lang/rust/pull/45711
5215 [45772]: https://github.com/rust-lang/rust/pull/45772
5216 [45852]: https://github.com/rust-lang/rust/issues/45852
5217 [45853]: https://github.com/rust-lang/rust/pull/45853
5218 [45887]: https://github.com/rust-lang/rust/pull/45887
5219 [45920]: https://github.com/rust-lang/rust/pull/45920
5220 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
5221 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
5222 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
5223
5224
5225 Version 1.22.1 (2017-11-22)
5226 ==========================
5227
5228 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
5229
5230 [46183]: https://github.com/rust-lang/rust/pull/46183
5231
5232 Version 1.22.0 (2017-11-22)
5233 ==========================
5234
5235 Language
5236 --------
5237 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
5238 - [Now accepts underscores in unicode escapes][43716]
5239 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
5240 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
5241
5242 Compiler
5243 --------
5244 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
5245 - [rustc will no longer inline in codegen units when compiling for debug][45075]
5246   This should decrease compile times for debug builds.
5247 - [strict memory alignment now enabled on ARMv6][45094]
5248 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
5249
5250 Libraries
5251 ---------
5252 - [Allow atomic operations up to 32 bits
5253   on `armv5te_unknown_linux_gnueabi`][44978]
5254 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
5255 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
5256 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
5257 - [Properly detect overflow in `Instant += Duration`.][44220]
5258 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
5259 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
5260 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
5261
5262 Stabilized APIs
5263 ---------------
5264
5265 Cargo
5266 -----
5267 - [Cargo will now build multi file examples in subdirectories of the `examples`
5268   folder that have a `main.rs` file.][cargo/4496]
5269 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
5270   the old format will continue to work and can be updated with `cargo update`.
5271 - [Now supports vendoring git repositories][cargo/3992]
5272
5273 Misc
5274 ----
5275 - [`libbacktrace` is now available on Apple platforms.][44251]
5276 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
5277   This now lets you specify that a given code example will fail to compile.
5278
5279 Compatibility Notes
5280 -------------------
5281 - [The minimum Android version that rustc can build for has been bumped
5282   to `4.0` from `2.3`][45656]
5283 - [Allowing `T op= &T` for numeric types has broken some type
5284   inference cases][45480]
5285
5286
5287 [42526]: https://github.com/rust-lang/rust/pull/42526
5288 [43017]: https://github.com/rust-lang/rust/pull/43017
5289 [43716]: https://github.com/rust-lang/rust/pull/43716
5290 [43949]: https://github.com/rust-lang/rust/pull/43949
5291 [44015]: https://github.com/rust-lang/rust/pull/44015
5292 [44220]: https://github.com/rust-lang/rust/pull/44220
5293 [44251]: https://github.com/rust-lang/rust/pull/44251
5294 [44287]: https://github.com/rust-lang/rust/pull/44287
5295 [44303]: https://github.com/rust-lang/rust/pull/44303
5296 [44456]: https://github.com/rust-lang/rust/pull/44456
5297 [44466]: https://github.com/rust-lang/rust/pull/44466
5298 [44895]: https://github.com/rust-lang/rust/pull/44895
5299 [44966]: https://github.com/rust-lang/rust/pull/44966
5300 [44978]: https://github.com/rust-lang/rust/pull/44978
5301 [45041]: https://github.com/rust-lang/rust/pull/45041
5302 [45064]: https://github.com/rust-lang/rust/pull/45064
5303 [45075]: https://github.com/rust-lang/rust/pull/45075
5304 [45094]: https://github.com/rust-lang/rust/pull/45094
5305 [45095]: https://github.com/rust-lang/rust/pull/45095
5306 [45480]: https://github.com/rust-lang/rust/issues/45480
5307 [45656]: https://github.com/rust-lang/rust/pull/45656
5308 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
5309 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
5310 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
5311
5312
5313
5314
5315
5316
5317 Version 1.21.0 (2017-10-12)
5318 ==========================
5319
5320 Language
5321 --------
5322 - [You can now use static references for literals.][43838]
5323   Example:
5324   ```rust
5325   fn main() {
5326       let x: &'static u32 = &0;
5327   }
5328   ```
5329 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
5330   Example:
5331   ```rust
5332   my_macro!(Vec<i32>::new); // Always worked
5333   my_macro!(Vec::<i32>::new); // Now works
5334   ```
5335
5336 Compiler
5337 --------
5338 - [Upgraded jemalloc to 4.5.0][43911]
5339 - [Enabled unwinding panics on Redox][43917]
5340 - [Now runs LLVM in parallel during translation phase.][43506]
5341   This should reduce peak memory usage.
5342
5343 Libraries
5344 ---------
5345 - [Generate builtin impls for `Clone` for all arrays and tuples that
5346   are `T: Clone`][43690]
5347 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
5348 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
5349   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
5350
5351 Stabilized APIs
5352 ---------------
5353
5354 [`std::mem::discriminant`]
5355
5356 Cargo
5357 -----
5358 - [You can now call `cargo install` with multiple package names][cargo/4216]
5359 - [Cargo commands inside a virtual workspace will now implicitly
5360   pass `--all`][cargo/4335]
5361 - [Added a `[patch]` section to `Cargo.toml` to handle
5362   prepublication dependencies][cargo/4123] [RFC 1969]
5363 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
5364   like patterns][cargo/4270]
5365 - [Added the `--all-targets` option][cargo/4400]
5366 - [Using required dependencies as a feature is now deprecated and emits
5367   a warning][cargo/4364]
5368
5369
5370 Misc
5371 ----
5372 - [Cargo docs are moving][43916]
5373   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
5374 - [The rustdoc book is now available][43863]
5375   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
5376 - [Added a preview of RLS has been made available through rustup][44204]
5377   Install with `rustup component add rls-preview`
5378 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
5379   Previously only showed `std::os::unix`.
5380
5381 Compatibility Notes
5382 -------------------
5383 - [Changes in method matching against higher-ranked types][43880] This may cause
5384   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
5385 - [rustc's JSON error output's byte position start at top of file.][42973]
5386   Was previously relative to the rustc's internal `CodeMap` struct which
5387   required the unstable library `libsyntax` to correctly use.
5388 - [`unused_results` lint no longer ignores booleans][43728]
5389
5390 [42565]: https://github.com/rust-lang/rust/pull/42565
5391 [42973]: https://github.com/rust-lang/rust/pull/42973
5392 [43348]: https://github.com/rust-lang/rust/pull/43348
5393 [43459]: https://github.com/rust-lang/rust/pull/43459
5394 [43506]: https://github.com/rust-lang/rust/pull/43506
5395 [43540]: https://github.com/rust-lang/rust/pull/43540
5396 [43690]: https://github.com/rust-lang/rust/pull/43690
5397 [43728]: https://github.com/rust-lang/rust/pull/43728
5398 [43838]: https://github.com/rust-lang/rust/pull/43838
5399 [43863]: https://github.com/rust-lang/rust/pull/43863
5400 [43880]: https://github.com/rust-lang/rust/pull/43880
5401 [43911]: https://github.com/rust-lang/rust/pull/43911
5402 [43916]: https://github.com/rust-lang/rust/pull/43916
5403 [43917]: https://github.com/rust-lang/rust/pull/43917
5404 [44204]: https://github.com/rust-lang/rust/pull/44204
5405 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
5406 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
5407 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5408 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
5409 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
5410 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
5411 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
5412 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
5413 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
5414
5415 Version 1.20.0 (2017-08-31)
5416 ===========================
5417
5418 Language
5419 --------
5420 - [Associated constants are now stabilised.][42809]
5421 - [A lot of macro bugs are now fixed.][42913]
5422
5423 Compiler
5424 --------
5425
5426 - [Struct fields are now properly coerced to the expected field type.][42807]
5427 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
5428   `wasm32-experimental-emscripten` target.
5429 - [Changed some of the error messages to be more helpful.][42033]
5430 - [Add support for RELRO(RELocation Read-Only) for platforms that support
5431   it.][43170]
5432 - [rustc now reports the total number of errors on compilation failure][43015]
5433   previously this was only the number of errors in the pass that failed.
5434 - [Expansion in rustc has been sped up 29x.][42533]
5435 - [added `msp430-none-elf` target.][43099]
5436 - [rustc will now suggest one-argument enum variant to fix type mismatch when
5437   applicable][43178]
5438 - [Fixes backtraces on Redox][43228]
5439 - [rustc now identifies different versions of same crate when absolute paths of
5440   different types match in an error message.][42826]
5441
5442 Libraries
5443 ---------
5444
5445
5446 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
5447 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
5448   tuples.][43011]
5449 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
5450   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
5451 - [Impl `Clone` for `DefaultHasher`.][42799]
5452 - [Impl `Sync` for `SyncSender`.][42397]
5453 - [Impl `FromStr` for `char`][42271]
5454 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
5455   NaN.][42431]
5456 - [allow messages in the `unimplemented!()` macro.][42155]
5457   ie. `unimplemented!("Waiting for 1.21 to be stable")`
5458 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
5459 - [Upgrade to Unicode 10.0.0][42999]
5460 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
5461 - [Skip the main thread's manual stack guard on Linux][43072]
5462 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in *O*(1) time][43077]
5463 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
5464   previously 2^15.
5465 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
5466
5467 Stabilized APIs
5468 ---------------
5469
5470 - [`CStr::into_c_string`]
5471 - [`CString::as_c_str`]
5472 - [`CString::into_boxed_c_str`]
5473 - [`Chain::get_mut`]
5474 - [`Chain::get_ref`]
5475 - [`Chain::into_inner`]
5476 - [`Option::get_or_insert_with`]
5477 - [`Option::get_or_insert`]
5478 - [`OsStr::into_os_string`]
5479 - [`OsString::into_boxed_os_str`]
5480 - [`Take::get_mut`]
5481 - [`Take::get_ref`]
5482 - [`Utf8Error::error_len`]
5483 - [`char::EscapeDebug`]
5484 - [`char::escape_debug`]
5485 - [`compile_error!`]
5486 - [`f32::from_bits`]
5487 - [`f32::to_bits`]
5488 - [`f64::from_bits`]
5489 - [`f64::to_bits`]
5490 - [`mem::ManuallyDrop`]
5491 - [`slice::sort_unstable_by_key`]
5492 - [`slice::sort_unstable_by`]
5493 - [`slice::sort_unstable`]
5494 - [`str::from_boxed_utf8_unchecked`]
5495 - [`str::as_bytes_mut`]
5496 - [`str::as_bytes_mut`]
5497 - [`str::from_utf8_mut`]
5498 - [`str::from_utf8_unchecked_mut`]
5499 - [`str::get_mut`]
5500 - [`str::get_unchecked_mut`]
5501 - [`str::get_unchecked`]
5502 - [`str::get`]
5503 - [`str::into_boxed_bytes`]
5504
5505
5506 Cargo
5507 -----
5508 - [Cargo API token location moved from `~/.cargo/config` to
5509   `~/.cargo/credentials`.][cargo/3978]
5510 - [Cargo will now build `main.rs` binaries that are in sub-directories of
5511   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
5512   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
5513 - [You can now specify version of a binary when installed through
5514   `cargo install` using `--vers`.][cargo/4229]
5515 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
5516   failure.][cargo/4248]
5517 - [Changed the convention around which file is the crate root.][cargo/4259]
5518 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
5519   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
5520
5521 Compatibility Notes
5522 -------------------
5523
5524 - [Functions with `'static` in their return types will now not be as usable as
5525   if they were using lifetime parameters instead.][42417]
5526 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
5527   takes the sign of NaN into account where previously didn't.][42430]
5528
5529 [42033]: https://github.com/rust-lang/rust/pull/42033
5530 [42155]: https://github.com/rust-lang/rust/pull/42155
5531 [42271]: https://github.com/rust-lang/rust/pull/42271
5532 [42397]: https://github.com/rust-lang/rust/pull/42397
5533 [42417]: https://github.com/rust-lang/rust/pull/42417
5534 [42430]: https://github.com/rust-lang/rust/pull/42430
5535 [42431]: https://github.com/rust-lang/rust/pull/42431
5536 [42533]: https://github.com/rust-lang/rust/pull/42533
5537 [42571]: https://github.com/rust-lang/rust/pull/42571
5538 [42613]: https://github.com/rust-lang/rust/pull/42613
5539 [42799]: https://github.com/rust-lang/rust/pull/42799
5540 [42807]: https://github.com/rust-lang/rust/pull/42807
5541 [42809]: https://github.com/rust-lang/rust/pull/42809
5542 [42822]: https://github.com/rust-lang/rust/pull/42822
5543 [42826]: https://github.com/rust-lang/rust/pull/42826
5544 [42854]: https://github.com/rust-lang/rust/pull/42854
5545 [42913]: https://github.com/rust-lang/rust/pull/42913
5546 [42999]: https://github.com/rust-lang/rust/pull/42999
5547 [43011]: https://github.com/rust-lang/rust/pull/43011
5548 [43015]: https://github.com/rust-lang/rust/pull/43015
5549 [43072]: https://github.com/rust-lang/rust/pull/43072
5550 [43077]: https://github.com/rust-lang/rust/pull/43077
5551 [43097]: https://github.com/rust-lang/rust/pull/43097
5552 [43099]: https://github.com/rust-lang/rust/pull/43099
5553 [43170]: https://github.com/rust-lang/rust/pull/43170
5554 [43178]: https://github.com/rust-lang/rust/pull/43178
5555 [43185]: https://github.com/rust-lang/rust/pull/43185
5556 [43228]: https://github.com/rust-lang/rust/pull/43228
5557 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
5558 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
5559 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
5560 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
5561 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
5562 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5563 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
5564 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
5565 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
5566 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
5567 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
5568 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
5569 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
5570 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
5571 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
5572 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
5573 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
5574 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
5575 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
5576 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
5577 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
5578 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
5579 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
5580 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
5581 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
5582 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
5583 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
5584 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
5585 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
5586 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
5587 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
5588 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
5589 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
5590 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
5591 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
5592 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
5593 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
5594 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
5595 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
5596
5597
5598 Version 1.19.0 (2017-07-20)
5599 ===========================
5600
5601 Language
5602 --------
5603
5604 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
5605   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
5606 - [Macro recursion limit increased to 1024 from 64.][41676]
5607 - [Added lint for detecting unused macros.][41907]
5608 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
5609   For example: `let x = loop { break 7; };`
5610 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
5611   contain `Copy` types and cannot have a `Drop` implementation.
5612   Example: `union Foo { bar: u8, baz: usize }`
5613 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
5614   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
5615
5616 Compiler
5617 --------
5618
5619 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
5620 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
5621   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
5622   you should use `--target armv7-linux-androideabi`.
5623 - [Fixed ICE when removing a source file between compilation sessions.][41873]
5624 - [Minor optimisation of string operations.][42037]
5625 - [Compiler error message is now `aborting due to previous error(s)` instead of
5626   `aborting due to N previous errors`][42150] This was previously inaccurate and
5627   would only count certain kinds of errors.
5628 - [The compiler now supports Visual Studio 2017][42225]
5629 - [The compiler is now built against LLVM 4.0.1 by default][42948]
5630 - [Added a lot][42264] of [new error codes][42302]
5631 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
5632   libraries with C Run-time Libraries(CRT) to be statically linked.
5633 - [Fixed various ARM codegen bugs][42740]
5634
5635 Libraries
5636 ---------
5637
5638 - [`String` now implements `FromIterator<Cow<'a, str>>` and
5639   `Extend<Cow<'a, str>>`][41449]
5640 - [`Vec` now implements `From<&mut [T]>`][41530]
5641 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
5642 - [`SplitWhitespace` now implements `Clone`][41659]
5643 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
5644   1.5x faster][41764]
5645 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
5646   macros, but for printing to stderr.
5647
5648 Stabilized APIs
5649 ---------------
5650
5651 - [`OsString::shrink_to_fit`]
5652 - [`cmp::Reverse`]
5653 - [`Command::envs`]
5654 - [`thread::ThreadId`]
5655
5656 Cargo
5657 -----
5658
5659 - [Build scripts can now add environment variables to the environment
5660   the crate is being compiled in.
5661   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
5662 - [Subcommands now replace the current process rather than spawning a new
5663   child process][cargo/3970]
5664 - [Workspace members can now accept glob file patterns][cargo/3979]
5665 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
5666   the members in a given workspace.][cargo/3988]
5667 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
5668 - [Target directory path is now in the cargo metadata][cargo/4022]
5669 - [Cargo no longer checks out a local working directory for the
5670   crates.io index][cargo/4026] This should provide smaller file size for the
5671   registry, and improve cloning times, especially on Windows machines.
5672 - [Added an `--exclude` option for excluding certain packages when using the
5673   `--all` option][cargo/4031]
5674 - [Cargo will now automatically retry when receiving a 5xx error
5675   from crates.io][cargo/4032]
5676 - [The `--features` option now accepts multiple comma or space
5677   delimited values.][cargo/4084]
5678 - [Added support for custom target specific runners][cargo/3954]
5679
5680 Misc
5681 ----
5682
5683 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
5684   Windows Debugger.
5685 - [Rust will now release XZ compressed packages][rust-installer/57]
5686 - [rustup will now prefer to download rust packages with
5687   XZ compression][rustup/1100] over GZip packages.
5688 - [Added the ability to escape `#` in rust documentation][41785] By adding
5689   additional `#`'s ie. `##` is now `#`
5690
5691 Compatibility Notes
5692 -------------------
5693
5694 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
5695 - [`-Z` flags are now no longer allowed to be used on the stable
5696   compiler.][41751] This has been a warning for a year previous to this.
5697 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
5698   longer works][42844]. Users should migrate to the built-in `check`
5699   command, which has been available since 1.16.
5700 - [Ending a float literal with `._` is now a hard error.
5701   Example: `42._` .][41946]
5702 - [Any use of a private `extern crate` outside of its module is now a
5703   hard error.][36886] This was previously a warning.
5704 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
5705   relative while the `::` prefix makes a path absolute, but was ignored and the
5706   path was relative regardless.
5707 - [Floating point constants in match patterns is now a hard error][36890]
5708   This was previously a warning.
5709 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
5710   match patterns is now a hard error][36891] This was previously a warning.
5711 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
5712   a warning.
5713 - [From the pound escape, lines consisting of multiple `#`s are
5714   now visible][41785]
5715 - [It is an error to re-export private enum variants][42460]. This is
5716   known to break a number of crates that depend on an older version of
5717   mustache.
5718 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
5719   to use it to find the linker, and the build will fail where it did
5720   not previously][42607]
5721
5722 [36886]: https://github.com/rust-lang/rust/issues/36886
5723 [36888]: https://github.com/rust-lang/rust/issues/36888
5724 [36890]: https://github.com/rust-lang/rust/issues/36890
5725 [36891]: https://github.com/rust-lang/rust/issues/36891
5726 [36892]: https://github.com/rust-lang/rust/issues/36892
5727 [37406]: https://github.com/rust-lang/rust/issues/37406
5728 [39983]: https://github.com/rust-lang/rust/pull/39983
5729 [41145]: https://github.com/rust-lang/rust/pull/41145
5730 [41192]: https://github.com/rust-lang/rust/pull/41192
5731 [41258]: https://github.com/rust-lang/rust/pull/41258
5732 [41370]: https://github.com/rust-lang/rust/pull/41370
5733 [41449]: https://github.com/rust-lang/rust/pull/41449
5734 [41530]: https://github.com/rust-lang/rust/pull/41530
5735 [41624]: https://github.com/rust-lang/rust/pull/41624
5736 [41656]: https://github.com/rust-lang/rust/pull/41656
5737 [41659]: https://github.com/rust-lang/rust/pull/41659
5738 [41676]: https://github.com/rust-lang/rust/pull/41676
5739 [41751]: https://github.com/rust-lang/rust/pull/41751
5740 [41764]: https://github.com/rust-lang/rust/pull/41764
5741 [41785]: https://github.com/rust-lang/rust/pull/41785
5742 [41873]: https://github.com/rust-lang/rust/pull/41873
5743 [41907]: https://github.com/rust-lang/rust/pull/41907
5744 [41946]: https://github.com/rust-lang/rust/pull/41946
5745 [42016]: https://github.com/rust-lang/rust/pull/42016
5746 [42037]: https://github.com/rust-lang/rust/pull/42037
5747 [42068]: https://github.com/rust-lang/rust/pull/42068
5748 [42150]: https://github.com/rust-lang/rust/pull/42150
5749 [42162]: https://github.com/rust-lang/rust/pull/42162
5750 [42225]: https://github.com/rust-lang/rust/pull/42225
5751 [42264]: https://github.com/rust-lang/rust/pull/42264
5752 [42302]: https://github.com/rust-lang/rust/pull/42302
5753 [42460]: https://github.com/rust-lang/rust/issues/42460
5754 [42607]: https://github.com/rust-lang/rust/issues/42607
5755 [42740]: https://github.com/rust-lang/rust/pull/42740
5756 [42844]: https://github.com/rust-lang/rust/issues/42844
5757 [42948]: https://github.com/rust-lang/rust/pull/42948
5758 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
5759 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
5760 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
5761 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
5762 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
5763 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
5764 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
5765 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
5766 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
5767 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
5768 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
5769 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
5770 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
5771 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
5772 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
5773 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
5774 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
5775 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
5776 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
5777 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
5778 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
5779 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
5780
5781
5782 Version 1.18.0 (2017-06-08)
5783 ===========================
5784
5785 Language
5786 --------
5787
5788 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
5789   make the item visible to just that module tree. Also accepts the keyword
5790   `crate` to make something public to the whole crate but not users of the
5791   library. Example: `pub(crate) mod utils;`. [RFC 1422].
5792 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
5793   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
5794 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
5795   types like `Write + Send`, trailing `+` are now supported in trait objects,
5796   and better error reporting for trait objects starting with `?Sized`.
5797 - [0e+10 is now a valid floating point literal][40589]
5798 - [Now warns if you bind a lifetime parameter to 'static][40734]
5799 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
5800   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
5801   representation in some cases.][40377]
5802
5803 Compiler
5804 --------
5805
5806 - [rustc can now emit mir with `--emit mir`][39891]
5807 - [Improved LLVM IR for trivial functions][40367]
5808 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
5809 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
5810   opportunities found through profiling
5811 - [Improved backtrace formatting when panicking][38165]
5812
5813 Libraries
5814 ---------
5815
5816 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
5817   iterator hasn't been advanced the original `Vec` is reassembled with no actual
5818   iteration or reallocation.
5819 - [Simplified HashMap Bucket interface][40561] provides performance
5820   improvements for iterating and cloning.
5821 - [Specialize Vec::from_elem to use calloc][40409]
5822 - [Fixed Race condition in fs::create_dir_all][39799]
5823 - [No longer caching stdio on Windows][40516]
5824 - [Optimized insertion sort in slice][40807] insertion sort in some cases
5825   2.50%~ faster and in one case now 12.50% faster.
5826 - [Optimized `AtomicBool::fetch_nand`][41143]
5827
5828 Stabilized APIs
5829 ---------------
5830
5831 - [`Child::try_wait`]
5832 - [`HashMap::retain`]
5833 - [`HashSet::retain`]
5834 - [`PeekMut::pop`]
5835 - [`TcpStream::peek`]
5836 - [`UdpSocket::peek`]
5837 - [`UdpSocket::peek_from`]
5838
5839 Cargo
5840 -----
5841
5842 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
5843   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
5844 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
5845 - [Added Android build support][cargo/3885]
5846 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
5847   of a certain type, for example `cargo build --bins` will build all
5848   binaries.
5849 - [Added support for haiku][cargo/3952]
5850
5851 Misc
5852 ----
5853
5854 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
5855 - [Added rust-windbg script for better debugging on Windows][39983]
5856 - [Rust now uses the official cross compiler for NetBSD][40612]
5857 - [rustdoc now accepts `#` at the start of files][40828]
5858 - [Fixed jemalloc support for musl][41168]
5859
5860 Compatibility Notes
5861 -------------------
5862
5863 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
5864   always placed after the sign if it exists and before the digits. With the `#`
5865   flag the zeroes are placed after the prefix and before the digits.
5866 - [Due to the struct field optimisation][40377], using `transmute` on structs
5867   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
5868   always been undefined behavior, but is now more likely to break in practice.
5869 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
5870   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
5871   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
5872 - [Overlapping inherent `impl`s are now a hard error][40728]
5873 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
5874 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
5875   `out.asm` and `out.ll` instead of only one of the filetypes.
5876 - [ calling a function that returns `Self` will no longer work][41805] when
5877   the size of `Self` cannot be statically determined.
5878 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
5879   this has caused a few regressions namely:
5880
5881   - Changed the link order of local static/dynamic libraries (respecting the
5882     order on given rather than having the compiler reorder).
5883   - Changed how MinGW is linked, native code linked to dynamic libraries
5884     may require manually linking to the gcc support library (for the native
5885     code itself)
5886
5887 [38165]: https://github.com/rust-lang/rust/pull/38165
5888 [39799]: https://github.com/rust-lang/rust/pull/39799
5889 [39891]: https://github.com/rust-lang/rust/pull/39891
5890 [39983]: https://github.com/rust-lang/rust/pull/39983
5891 [40043]: https://github.com/rust-lang/rust/pull/40043
5892 [40241]: https://github.com/rust-lang/rust/pull/40241
5893 [40338]: https://github.com/rust-lang/rust/pull/40338
5894 [40367]: https://github.com/rust-lang/rust/pull/40367
5895 [40377]: https://github.com/rust-lang/rust/pull/40377
5896 [40409]: https://github.com/rust-lang/rust/pull/40409
5897 [40516]: https://github.com/rust-lang/rust/pull/40516
5898 [40556]: https://github.com/rust-lang/rust/pull/40556
5899 [40561]: https://github.com/rust-lang/rust/pull/40561
5900 [40589]: https://github.com/rust-lang/rust/pull/40589
5901 [40612]: https://github.com/rust-lang/rust/pull/40612
5902 [40723]: https://github.com/rust-lang/rust/pull/40723
5903 [40728]: https://github.com/rust-lang/rust/pull/40728
5904 [40731]: https://github.com/rust-lang/rust/pull/40731
5905 [40734]: https://github.com/rust-lang/rust/pull/40734
5906 [40805]: https://github.com/rust-lang/rust/pull/40805
5907 [40807]: https://github.com/rust-lang/rust/pull/40807
5908 [40828]: https://github.com/rust-lang/rust/pull/40828
5909 [40870]: https://github.com/rust-lang/rust/pull/40870
5910 [41085]: https://github.com/rust-lang/rust/pull/41085
5911 [41143]: https://github.com/rust-lang/rust/pull/41143
5912 [41168]: https://github.com/rust-lang/rust/pull/41168
5913 [41270]: https://github.com/rust-lang/rust/issues/41270
5914 [41469]: https://github.com/rust-lang/rust/pull/41469
5915 [41805]: https://github.com/rust-lang/rust/issues/41805
5916 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
5917 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
5918 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
5919 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
5920 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
5921 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
5922 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
5923 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
5924 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
5925 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
5926 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
5927 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
5928 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
5929 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
5930
5931
5932 Version 1.17.0 (2017-04-27)
5933 ===========================
5934
5935 Language
5936 --------
5937
5938 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
5939 * [Fields of structs may be initialized without duplicating the field/variable
5940   names][39761]. [RFC 1682]
5941 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
5942 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5943   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
5944   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
5945   `'b`. Soundness fix.
5946 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
5947 * [Static variables may contain references to other statics][40027]
5948
5949 Compiler
5950 --------
5951
5952 * [Exit quickly on only `--emit dep-info`][40336]
5953 * [Make `-C relocation-model` more correctly determine whether the linker
5954   creates a position-independent executable][40245]
5955 * [Add `-C overflow-checks` to directly control whether integer overflow
5956   panics][40037]
5957 * [The rustc type checker now checks items on demand instead of in a single
5958   in-order pass][40008]. This is mostly an internal refactoring in support of
5959   future work, including incremental type checking, but also resolves [RFC
5960   1647], allowing `Self` to appear in `impl` `where` clauses.
5961 * [Optimize vtable loads][39995]
5962 * [Turn off vectorization for Emscripten targets][39990]
5963 * [Provide suggestions for unknown macros imported with `use`][39953]
5964 * [Fix ICEs in path resolution][39939]
5965 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
5966 * [Add clearer error message using `&str + &str`][39116]
5967
5968 Stabilized APIs
5969 ---------------
5970
5971 * [`Arc::into_raw`]
5972 * [`Arc::from_raw`]
5973 * [`Arc::ptr_eq`]
5974 * [`Rc::into_raw`]
5975 * [`Rc::from_raw`]
5976 * [`Rc::ptr_eq`]
5977 * [`Ordering::then`]
5978 * [`Ordering::then_with`]
5979 * [`BTreeMap::range`]
5980 * [`BTreeMap::range_mut`]
5981 * [`collections::Bound`]
5982 * [`process::abort`]
5983 * [`ptr::read_unaligned`]
5984 * [`ptr::write_unaligned`]
5985 * [`Result::expect_err`]
5986 * [`Cell::swap`]
5987 * [`Cell::replace`]
5988 * [`Cell::into_inner`]
5989 * [`Cell::take`]
5990
5991 Libraries
5992 ---------
5993
5994 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
5995 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
5996 * [`String` implements `FromIterator<&char>`][40028]
5997 * `Box` [implements][40009] a number of new conversions:
5998   `From<Box<str>> for String`,
5999   `From<Box<[T]>> for Vec<T>`,
6000   `From<Box<CStr>> for CString`,
6001   `From<Box<OsStr>> for OsString`,
6002   `From<Box<Path>> for PathBuf`,
6003   `Into<Box<str>> for String`,
6004   `Into<Box<[T]>> for Vec<T>`,
6005   `Into<Box<CStr>> for CString`,
6006   `Into<Box<OsStr>> for OsString`,
6007   `Into<Box<Path>> for PathBuf`,
6008   `Default for Box<str>`,
6009   `Default for Box<CStr>`,
6010   `Default for Box<OsStr>`,
6011   `From<&CStr> for Box<CStr>`,
6012   `From<&OsStr> for Box<OsStr>`,
6013   `From<&Path> for Box<Path>`
6014 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
6015 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
6016 * [Slightly optimize `slice::sort`][39538]
6017 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
6018 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
6019   `Box<str>` implements `From<&str>`][39438]
6020 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
6021   `From<(I, u16)> where I: Into<IpAddr>`][39372]
6022 * [`format!` estimates the needed capacity before writing a string][39356]
6023 * [Support unprivileged symlink creation in Windows][38921]
6024 * [`PathBuf` implements `Default`][38764]
6025 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
6026 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
6027   and poor hash functions.
6028
6029 Cargo
6030 -----
6031
6032 * [Add `cargo check --all`][cargo/3731]
6033 * [Add an option to ignore SSL revocation checking][cargo/3699]
6034 * [Add `cargo run --package`][cargo/3691]
6035 * [Add `required_features`][cargo/3667]
6036 * [Assume `build.rs` is a build script][cargo/3664]
6037 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
6038
6039 Misc
6040 ----
6041
6042 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
6043   `rustbook`][39633]
6044 * [The "Unstable Book" documents nightly-only features][ubook]
6045 * [Improve the style of the sidebar in rustdoc output][40265]
6046 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
6047 * [Fix MSP430 breakage due to `i128`][40257]
6048 * [Preliminary Solaris/SPARCv9 support][39903]
6049 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
6050   run without installing the MSVC runtime.
6051 * [`rustdoc --test` includes file names in test names][39788]
6052 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
6053   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
6054 * [Initial support for `aarch64-unknown-freebsd`][39491]
6055 * [Initial support for `i686-unknown-netbsd`][39426]
6056 * [This release no longer includes the old makefile build system][39431]. Rust
6057   is built with a custom build system, written in Rust, and with Cargo.
6058 * [Add Debug implementations for libcollection structs][39002]
6059 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
6060 * [`--test-threads=0` produces an error][38945]
6061 * [`rustup` installs documentation by default][40526]
6062 * [The Rust source includes NatVis visualizations][39843]. These can be used by
6063   WinDbg and Visual Studio to improve the debugging experience.
6064
6065 Compatibility Notes
6066 -------------------
6067
6068 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
6069   workaround, either use MSVC 2015 or run vcvars.bat.
6070 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
6071   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
6072   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
6073   fix.
6074 * [`format!` and `Display::to_string` panic if an underlying formatting
6075   implementation returns an error][40117]. Previously the error was silently
6076   ignored. It is incorrect for `write_fmt` to return an error when writing
6077   to a string.
6078 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
6079   crates were marked stable and could be accessed from the stable toolchain.
6080 * [Rust git source no longer includes vendored crates][39728]. Those that need
6081   to build with vendored crates should build from release tarballs.
6082 * [Fix inert attributes from `proc_macro_derives`][39572]
6083 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
6084   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
6085   build system.
6086 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
6087   existing code generally ignores the type of dead-code unless a type-hint is
6088   provided; this can cause surprising inference interactions particularly around
6089   defaulting. The new code uniformly ignores the result type of dead-code.
6090 * [Tuple-struct constructors with private fields are no longer visible][38932]
6091 * [Lifetime parameters that do not appear in the arguments are now considered
6092   early-bound][38897], resolving a soundness bug (#[32330]). The
6093   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
6094   April of 2016.
6095 * [rustdoc: fix doctests with non-feature crate attributes][38161]
6096 * [Make transmuting from fn item types to pointer-sized types a hard
6097   error][34198]
6098
6099 [27787]: https://github.com/rust-lang/rust/issues/27787
6100 [32330]: https://github.com/rust-lang/rust/issues/32330
6101 [34198]: https://github.com/rust-lang/rust/pull/34198
6102 [38161]: https://github.com/rust-lang/rust/pull/38161
6103 [38368]: https://github.com/rust-lang/rust/pull/38368
6104 [38584]: https://github.com/rust-lang/rust/issues/38584
6105 [38661]: https://github.com/rust-lang/rust/pull/38661
6106 [38764]: https://github.com/rust-lang/rust/pull/38764
6107 [38864]: https://github.com/rust-lang/rust/issues/38864
6108 [38897]: https://github.com/rust-lang/rust/pull/38897
6109 [38921]: https://github.com/rust-lang/rust/pull/38921
6110 [38932]: https://github.com/rust-lang/rust/pull/38932
6111 [38945]: https://github.com/rust-lang/rust/pull/38945
6112 [38981]: https://github.com/rust-lang/rust/pull/38981
6113 [39002]: https://github.com/rust-lang/rust/pull/39002
6114 [39116]: https://github.com/rust-lang/rust/pull/39116
6115 [39193]: https://github.com/rust-lang/rust/pull/39193
6116 [39265]: https://github.com/rust-lang/rust/pull/39265
6117 [39356]: https://github.com/rust-lang/rust/pull/39356
6118 [39372]: https://github.com/rust-lang/rust/pull/39372
6119 [39426]: https://github.com/rust-lang/rust/pull/39426
6120 [39431]: https://github.com/rust-lang/rust/pull/39431
6121 [39438]: https://github.com/rust-lang/rust/pull/39438
6122 [39440]: https://github.com/rust-lang/rust/pull/39440
6123 [39485]: https://github.com/rust-lang/rust/pull/39485
6124 [39491]: https://github.com/rust-lang/rust/pull/39491
6125 [39518]: https://github.com/rust-lang/rust/pull/39518
6126 [39538]: https://github.com/rust-lang/rust/pull/39538
6127 [39572]: https://github.com/rust-lang/rust/pull/39572
6128 [39633]: https://github.com/rust-lang/rust/pull/39633
6129 [39642]: https://github.com/rust-lang/rust/pull/39642
6130 [39728]: https://github.com/rust-lang/rust/pull/39728
6131 [39761]: https://github.com/rust-lang/rust/pull/39761
6132 [39788]: https://github.com/rust-lang/rust/pull/39788
6133 [39793]: https://github.com/rust-lang/rust/pull/39793
6134 [39837]: https://github.com/rust-lang/rust/pull/39837
6135 [39843]: https://github.com/rust-lang/rust/pull/39843
6136 [39851]: https://github.com/rust-lang/rust/pull/39851
6137 [39903]: https://github.com/rust-lang/rust/pull/39903
6138 [39939]: https://github.com/rust-lang/rust/pull/39939
6139 [39953]: https://github.com/rust-lang/rust/pull/39953
6140 [39960]: https://github.com/rust-lang/rust/pull/39960
6141 [39990]: https://github.com/rust-lang/rust/pull/39990
6142 [39995]: https://github.com/rust-lang/rust/pull/39995
6143 [40008]: https://github.com/rust-lang/rust/pull/40008
6144 [40009]: https://github.com/rust-lang/rust/pull/40009
6145 [40027]: https://github.com/rust-lang/rust/pull/40027
6146 [40028]: https://github.com/rust-lang/rust/pull/40028
6147 [40037]: https://github.com/rust-lang/rust/pull/40037
6148 [40117]: https://github.com/rust-lang/rust/pull/40117
6149 [40166]: https://github.com/rust-lang/rust/pull/40166
6150 [40245]: https://github.com/rust-lang/rust/pull/40245
6151 [40257]: https://github.com/rust-lang/rust/pull/40257
6152 [40261]: https://github.com/rust-lang/rust/pull/40261
6153 [40265]: https://github.com/rust-lang/rust/pull/40265
6154 [40319]: https://github.com/rust-lang/rust/pull/40319
6155 [40336]: https://github.com/rust-lang/rust/pull/40336
6156 [40526]: https://github.com/rust-lang/rust/pull/40526
6157 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
6158 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
6159 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
6160 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
6161 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
6162 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
6163 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
6164 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
6165 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
6166 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
6167 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
6168 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
6169 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
6170 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
6171 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
6172 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
6173 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
6174 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
6175 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
6176 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
6177 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
6178 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
6179 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
6180 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
6181 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
6182 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
6183 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
6184 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
6185 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
6186 [mdbook]: https://crates.io/crates/mdbook
6187 [ubook]: https://doc.rust-lang.org/unstable-book/
6188
6189
6190 Version 1.16.0 (2017-03-16)
6191 ===========================
6192
6193 Language
6194 --------
6195
6196 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6197 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6198   match patterns][38069]
6199 * [Clean up semantics of `self` in an import list][38313]
6200 * [`Self` may appear in `impl` headers][38920]
6201 * [`Self` may appear in struct expressions][39282]
6202
6203 Compiler
6204 --------
6205
6206 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
6207   a `.rmeta` file containing only crate metadata][38571]. This can be
6208   used by tools like the Rust Language Service to perform
6209   metadata-only builds.
6210 * [Levenshtein based typo suggestions now work in most places, while
6211   previously they worked only for fields and sometimes for local
6212   variables][38927]. Together with the overhaul of "no
6213   resolution"/"unexpected resolution" errors (#[38154]) they result in
6214   large and systematic improvement in resolution diagnostics.
6215 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
6216   `U`][38670]
6217 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
6218 * [`rustc` no longer attempts to provide "consider using an explicit
6219   lifetime" suggestions][37057]. They were inaccurate.
6220
6221 Stabilized APIs
6222 ---------------
6223
6224 * [`VecDeque::truncate`]
6225 * [`VecDeque::resize`]
6226 * [`String::insert_str`]
6227 * [`Duration::checked_add`]
6228 * [`Duration::checked_sub`]
6229 * [`Duration::checked_div`]
6230 * [`Duration::checked_mul`]
6231 * [`str::replacen`]
6232 * [`str::repeat`]
6233 * [`SocketAddr::is_ipv4`]
6234 * [`SocketAddr::is_ipv6`]
6235 * [`IpAddr::is_ipv4`]
6236 * [`IpAddr::is_ipv6`]
6237 * [`Vec::dedup_by`]
6238 * [`Vec::dedup_by_key`]
6239 * [`Result::unwrap_or_default`]
6240 * [`<*const T>::wrapping_offset`]
6241 * [`<*mut T>::wrapping_offset`]
6242 * `CommandExt::creation_flags`
6243 * [`File::set_permissions`]
6244 * [`String::split_off`]
6245
6246 Libraries
6247 ---------
6248
6249 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
6250   their argument by `Borrow` parameter][37761]
6251 * [All public types in std implement `Debug`][38006]
6252 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
6253 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
6254 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6255   Windows][38274]
6256 * [std: Fix partial writes in `LineWriter`][38062]
6257 * [std: Clamp max read/write sizes on Unix][38062]
6258 * [Use more specific panic message for `&str` slicing errors][38066]
6259 * [`TcpListener::set_only_v6` is deprecated][38304]. This
6260   functionality cannot be achieved in std currently.
6261 * [`writeln!`, like `println!`, now accepts a form with no string
6262   or formatting arguments, to just print a newline][38469]
6263 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
6264 * [Reduce the size of static data in `std_unicode::tables`][38781]
6265 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
6266   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
6267   `Display`][38909]
6268 * [`Duration` implements `Sum`][38712]
6269 * [`String` implements `ToSocketAddrs`][39048]
6270
6271 Cargo
6272 -----
6273
6274 * [The `cargo check` command does a type check of a project without
6275   building it][cargo/3296]
6276 * [crates.io will display CI badges from Travis and AppVeyor, if
6277   specified in Cargo.toml][cargo/3546]
6278 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
6279 * [Compilation profiles accept integer values for `debug`, in addition
6280   to `true` and `false`. These are passed to `rustc` as the value to
6281   `-C debuginfo`][cargo/3534]
6282 * [Implement `cargo --version --verbose`][cargo/3604]
6283 * [All builds now output 'dep-info' build dependencies compatible with
6284   make and ninja][cargo/3557]
6285 * [Build all workspace members with `build --all`][cargo/3511]
6286 * [Document all workspace members with `doc --all`][cargo/3515]
6287 * [Path deps outside workspace are not members][cargo/3443]
6288
6289 Misc
6290 ----
6291
6292 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
6293   the path to the Rust implementation][38589]
6294 * [The `armv7-linux-androideabi` target no longer enables NEON
6295   extensions, per Google's ABI guide][38413]
6296 * [The stock standard library can be compiled for Redox OS][38401]
6297 * [Rust has initial SPARC support][38726]. Tier 3. No builds
6298   available.
6299 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
6300   builds available.
6301 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
6302
6303 Compatibility Notes
6304 -------------------
6305
6306 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6307   match patterns][38069]
6308 * In this release, references to uninhabited types can not be
6309   pattern-matched. This was accidentally allowed in 1.15.
6310 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6311 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6312   Windows][38274]
6313 * [Clean up semantics of `self` in an import list][38313]
6314 * Reimplemented lifetime elision. This change was almost entirely compatible
6315   with existing code, but it did close a number of small bugs and loopholes,
6316   as well as being more accepting in some other [cases][41105].
6317
6318 [37057]: https://github.com/rust-lang/rust/pull/37057
6319 [37761]: https://github.com/rust-lang/rust/pull/37761
6320 [38006]: https://github.com/rust-lang/rust/pull/38006
6321 [38051]: https://github.com/rust-lang/rust/pull/38051
6322 [38062]: https://github.com/rust-lang/rust/pull/38062
6323 [38062]: https://github.com/rust-lang/rust/pull/38622
6324 [38066]: https://github.com/rust-lang/rust/pull/38066
6325 [38069]: https://github.com/rust-lang/rust/pull/38069
6326 [38131]: https://github.com/rust-lang/rust/pull/38131
6327 [38154]: https://github.com/rust-lang/rust/pull/38154
6328 [38274]: https://github.com/rust-lang/rust/pull/38274
6329 [38304]: https://github.com/rust-lang/rust/pull/38304
6330 [38313]: https://github.com/rust-lang/rust/pull/38313
6331 [38314]: https://github.com/rust-lang/rust/pull/38314
6332 [38327]: https://github.com/rust-lang/rust/pull/38327
6333 [38401]: https://github.com/rust-lang/rust/pull/38401
6334 [38413]: https://github.com/rust-lang/rust/pull/38413
6335 [38469]: https://github.com/rust-lang/rust/pull/38469
6336 [38559]: https://github.com/rust-lang/rust/pull/38559
6337 [38571]: https://github.com/rust-lang/rust/pull/38571
6338 [38580]: https://github.com/rust-lang/rust/pull/38580
6339 [38589]: https://github.com/rust-lang/rust/pull/38589
6340 [38670]: https://github.com/rust-lang/rust/pull/38670
6341 [38712]: https://github.com/rust-lang/rust/pull/38712
6342 [38726]: https://github.com/rust-lang/rust/pull/38726
6343 [38781]: https://github.com/rust-lang/rust/pull/38781
6344 [38798]: https://github.com/rust-lang/rust/pull/38798
6345 [38909]: https://github.com/rust-lang/rust/pull/38909
6346 [38920]: https://github.com/rust-lang/rust/pull/38920
6347 [38927]: https://github.com/rust-lang/rust/pull/38927
6348 [39048]: https://github.com/rust-lang/rust/pull/39048
6349 [39282]: https://github.com/rust-lang/rust/pull/39282
6350 [39379]: https://github.com/rust-lang/rust/pull/39379
6351 [41105]: https://github.com/rust-lang/rust/issues/41105
6352 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6353 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6354 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
6355 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
6356 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
6357 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
6358 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
6359 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
6360 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
6361 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
6362 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
6363 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
6364 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
6365 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
6366 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
6367 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
6368 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
6369 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
6370 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
6371 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
6372 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
6373 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
6374 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
6375 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
6376 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
6377 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
6378 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
6379 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
6380 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
6381 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
6382
6383
6384 Version 1.15.1 (2017-02-09)
6385 ===========================
6386
6387 * [Fix IntoIter::as_mut_slice's signature][39466]
6388 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
6389
6390 [39466]: https://github.com/rust-lang/rust/pull/39466
6391 [39523]: https://github.com/rust-lang/rust/pull/39523
6392
6393
6394 Version 1.15.0 (2017-02-02)
6395 ===========================
6396
6397 Language
6398 --------
6399
6400 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
6401   stable. This allows popular code-generating crates like Serde and Diesel to
6402   work ergonomically. [RFC 1681].
6403 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
6404   with curly braces][36868]. Part of [RFC 1506].
6405 * [A number of minor changes to name resolution have been activated][37127].
6406   They add up to more consistent semantics, allowing for future evolution of
6407   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6408   details of what is different. The breaking changes here have been transitioned
6409   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6410 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
6411   bounds][38279]
6412 * [`?Sized` can be used in `where` clauses][37791]
6413 * [There is now a limit on the size of monomorphized types and it can be
6414   modified with the `#![type_size_limit]` crate attribute, similarly to
6415   the `#![recursion_limit]` attribute][37789]
6416
6417 Compiler
6418 --------
6419
6420 * [On Windows, the compiler will apply dllimport attributes when linking to
6421   extern functions][37973]. Additional attributes and flags can control which
6422   library kind is linked and its name. [RFC 1717].
6423 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6424 * [The `--test` flag works with procedural macro crates][38107]
6425 * [Fix `extern "aapcs" fn` ABI][37814]
6426 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
6427 * [The `format!` expander recognizes incorrect `printf` and shell-style
6428   formatting directives and suggests the correct format][37613].
6429 * [Only report one error for all unused imports in an import list][37456]
6430
6431 Compiler Performance
6432 --------------------
6433
6434 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
6435 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
6436 * [Don't clone in `UnificationTable::probe`][37848]
6437 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
6438 * [Use small vectors in type walker][37760]
6439 * [Macro expansion performance was improved][37701]
6440 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
6441 * [Replace FNV with a faster hash function][37229]
6442
6443 Stabilized APIs
6444 ---------------
6445
6446 * [`std::iter::Iterator::min_by`]
6447 * [`std::iter::Iterator::max_by`]
6448 * [`std::os::*::fs::FileExt`]
6449 * [`std::sync::atomic::Atomic*::get_mut`]
6450 * [`std::sync::atomic::Atomic*::into_inner`]
6451 * [`std::vec::IntoIter::as_slice`]
6452 * [`std::vec::IntoIter::as_mut_slice`]
6453 * [`std::sync::mpsc::Receiver::try_iter`]
6454 * [`std::os::unix::process::CommandExt::before_exec`]
6455 * [`std::rc::Rc::strong_count`]
6456 * [`std::rc::Rc::weak_count`]
6457 * [`std::sync::Arc::strong_count`]
6458 * [`std::sync::Arc::weak_count`]
6459 * [`std::char::encode_utf8`]
6460 * [`std::char::encode_utf16`]
6461 * [`std::cell::Ref::clone`]
6462 * [`std::io::Take::into_inner`]
6463
6464 Libraries
6465 ---------
6466
6467 * [The standard sorting algorithm has been rewritten for dramatic performance
6468   improvements][38192]. It is a hybrid merge sort, drawing influences from
6469   Timsort. Previously it was a naive merge sort.
6470 * [`Iterator::nth` no longer has a `Sized` bound][38134]
6471 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
6472   performance.
6473 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
6474   and `char_indices().last()`][37882]
6475 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
6476 * [Chinese characters display correctly in `fmt::Debug`][37855]
6477 * [Derive `Default` for `Duration`][37699]
6478 * [Support creation of anonymous pipes on WinXP/2k][37677]
6479 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
6480 * [Don't pass overlapped handles to processes][38835]
6481
6482 Cargo
6483 -----
6484
6485 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6486   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6487   should instead check the variable at runtime with `std::env`. That the value
6488   was set at build time was a bug, and incorrect when cross-compiling. This
6489   change is known to cause breakage.
6490 * [Add `--all` flag to `cargo test`][cargo/3221]
6491 * [Compile statically against the MSVC CRT][cargo/3363]
6492 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
6493 * [Link OpenSSL statically on OSX][cargo/3311]
6494 * [Apply new fingerprinting to build dir outputs][cargo/3310]
6495 * [Test for bad path overrides with summaries][cargo/3336]
6496 * [Require `cargo install --vers` to take a semver version][cargo/3338]
6497 * [Fix retrying crate downloads for network errors][cargo/3348]
6498 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
6499 * [Emit more info on --message-format=json][cargo/3319]
6500 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
6501 * [Don't ignore errors in workspace manifest][cargo/3409]
6502 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
6503
6504 Tooling
6505 -------
6506
6507 * [Test runners (binaries built with `--test`) now support a `--list` argument
6508   that lists the tests it contains][38185]
6509 * [Test runners now support a `--exact` argument that makes the test filter
6510   match exactly, instead of matching only a substring of the test name][38181]
6511 * [rustdoc supports a `--playground-url` flag][37763]
6512 * [rustdoc provides more details about `#[should_panic]` errors][37749]
6513
6514 Misc
6515 ----
6516
6517 * [The Rust build system is now written in Rust][37817]. The Makefiles may
6518   continue to be used in this release by passing `--disable-rustbuild` to the
6519   configure script, but they will be deleted soon. Note that the new build
6520   system uses a different on-disk layout that will likely affect any scripts
6521   building Rust.
6522 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
6523   releases.
6524 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
6525 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
6526   releases.
6527
6528 Compatibility Notes
6529 -------------------
6530
6531 * [A number of minor changes to name resolution have been activated][37127].
6532   They add up to more consistent semantics, allowing for future evolution of
6533   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6534   details of what is different. The breaking changes here have been transitioned
6535   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6536 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6537   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6538   should instead check the variable at runtime with `std::env`. That the value
6539   was set at build time was a bug, and incorrect when cross-compiling. This
6540   change is known to cause breakage.
6541 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
6542   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
6543   1.10 and is now an error by default. It will become a hard error in the near
6544   future.
6545 * [The semantics relating modules to file system directories are changing in
6546   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
6547   lint, which is a warning in this release, and will become a hard error in the
6548   future.
6549 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6550 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
6551   the underlying iterator][37834]
6552
6553 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
6554 [33685]: https://github.com/rust-lang/rust/issues/33685
6555 [36868]: https://github.com/rust-lang/rust/pull/36868
6556 [37127]: https://github.com/rust-lang/rust/pull/37127
6557 [37229]: https://github.com/rust-lang/rust/pull/37229
6558 [37456]: https://github.com/rust-lang/rust/pull/37456
6559 [37527]: https://github.com/rust-lang/rust/pull/37527
6560 [37602]: https://github.com/rust-lang/rust/pull/37602
6561 [37613]: https://github.com/rust-lang/rust/pull/37613
6562 [37615]: https://github.com/rust-lang/rust/pull/37615
6563 [37636]: https://github.com/rust-lang/rust/pull/37636
6564 [37627]: https://github.com/rust-lang/rust/pull/37627
6565 [37642]: https://github.com/rust-lang/rust/pull/37642
6566 [37677]: https://github.com/rust-lang/rust/pull/37677
6567 [37699]: https://github.com/rust-lang/rust/pull/37699
6568 [37701]: https://github.com/rust-lang/rust/pull/37701
6569 [37705]: https://github.com/rust-lang/rust/pull/37705
6570 [37749]: https://github.com/rust-lang/rust/pull/37749
6571 [37760]: https://github.com/rust-lang/rust/pull/37760
6572 [37763]: https://github.com/rust-lang/rust/pull/37763
6573 [37764]: https://github.com/rust-lang/rust/pull/37764
6574 [37789]: https://github.com/rust-lang/rust/pull/37789
6575 [37791]: https://github.com/rust-lang/rust/pull/37791
6576 [37814]: https://github.com/rust-lang/rust/pull/37814
6577 [37817]: https://github.com/rust-lang/rust/pull/37817
6578 [37834]: https://github.com/rust-lang/rust/pull/37834
6579 [37848]: https://github.com/rust-lang/rust/pull/37848
6580 [37855]: https://github.com/rust-lang/rust/pull/37855
6581 [37882]: https://github.com/rust-lang/rust/pull/37882
6582 [37888]: https://github.com/rust-lang/rust/pull/37888
6583 [37973]: https://github.com/rust-lang/rust/pull/37973
6584 [37979]: https://github.com/rust-lang/rust/pull/37979
6585 [38086]: https://github.com/rust-lang/rust/pull/38086
6586 [38107]: https://github.com/rust-lang/rust/pull/38107
6587 [38117]: https://github.com/rust-lang/rust/pull/38117
6588 [38134]: https://github.com/rust-lang/rust/pull/38134
6589 [38146]: https://github.com/rust-lang/rust/pull/38146
6590 [38181]: https://github.com/rust-lang/rust/pull/38181
6591 [38182]: https://github.com/rust-lang/rust/pull/38182
6592 [38185]: https://github.com/rust-lang/rust/pull/38185
6593 [38192]: https://github.com/rust-lang/rust/pull/38192
6594 [38279]: https://github.com/rust-lang/rust/pull/38279
6595 [38835]: https://github.com/rust-lang/rust/pull/38835
6596 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6597 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6598 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
6599 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
6600 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
6601 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
6602 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
6603 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
6604 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
6605 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
6606 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
6607 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
6608 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
6609 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
6610 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
6611 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
6612 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
6613 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
6614 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
6615 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
6616 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
6617 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
6618 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
6619 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
6620 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
6621 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
6622 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
6623 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
6624 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
6625 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
6626 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
6627 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
6628 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
6629 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
6630 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
6631 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
6632 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
6633 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
6634
6635
6636 Version 1.14.0 (2016-12-22)
6637 ===========================
6638
6639 Language
6640 --------
6641
6642 * [`..` matches multiple tuple fields in enum variants, structs
6643   and tuples][36843]. [RFC 1492].
6644 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
6645 * [`use *` and `use ::*` both glob-import from the crate root][37367]
6646 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
6647   dereferencing][36822]
6648
6649 Compiler
6650 --------
6651
6652 * [Mark enums with non-zero discriminant as non-zero][37224]
6653 * [Lower-case `static mut` names are linted like other
6654   statics and consts][37162]
6655 * [Fix ICE on some macros in const integer positions
6656    (e.g. `[u8; m!()]`)][36819]
6657 * [Improve error message and snippet for "did you mean `x`"][36798]
6658 * [Add a panic-strategy field to the target specification][36794]
6659 * [Include LLVM version in `--version --verbose`][37200]
6660
6661 Compile-time Optimizations
6662 --------------------------
6663
6664 * [Improve macro expansion performance][37569]
6665 * [Shrink `Expr_::ExprInlineAsm`][37445]
6666 * [Replace all uses of SHA-256 with BLAKE2b][37439]
6667 * [Reduce the number of bytes hashed by `IchHasher`][37427]
6668 * [Avoid more allocations when compiling html5ever][37373]
6669 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
6670 * [Avoid some allocations in the macro parser][37318]
6671 * [Use a faster deflate setting][37298]
6672 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
6673   during interning of slices][37270]
6674 * [Optimize `write_metadata`][37267]
6675 * [Don't process obligation forest cycles when stalled][37231]
6676 * [Avoid many `CrateConfig` clones][37161]
6677 * [Optimize `Substs::super_fold_with`][37108]
6678 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
6679 * [Speed up `plug_leaks`][36917]
6680
6681 Libraries
6682 ---------
6683
6684 * [`println!()`, with no arguments, prints newline][36825].
6685   Previously, an empty string was required to achieve the same.
6686 * [`Wrapping` impls standard binary and unary operators, as well as
6687    the `Sum` and `Product` iterators][37356]
6688 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
6689   Vec<T>`][37326]
6690 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
6691   `VecDeque` iterators][37315]
6692 * [Improve `SipHasher` performance on small values][37312]
6693 * [Add Iterator trait TrustedLen to enable better FromIterator /
6694   Extend][37306]
6695 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
6696 * [`ReadDir` implements `Debug`][37221]
6697 * [Implement `RefUnwindSafe` for atomic types][37178]
6698 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
6699 * [Avoid allocations in `Decoder::read_str`][37064]
6700 * [`io::Error` implements `From<io::ErrorKind>`][37037]
6701 * [Impl `Debug` for raw pointers to unsized data][36880]
6702 * [Don't reuse `HashMap` random seeds][37470]
6703 * [The internal memory layout of `HashMap` is more cache-friendly, for
6704   significant improvements in some operations][36692]
6705 * [`HashMap` uses less memory on 32-bit architectures][36595]
6706 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
6707
6708 Cargo
6709 -----
6710
6711 * [Expose rustc cfg values to build scripts][cargo/3243]
6712 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
6713 * [Fix passing --features when testing multiple packages][cargo/3280]
6714 * [Use a single profile set per workspace][cargo/3249]
6715 * [Load `replace` sections from lock files][cargo/3220]
6716 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
6717
6718 Tooling
6719 -------
6720
6721 * [rustup is the recommended Rust installation method][1.14rustup]
6722 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
6723   S390x. These are [tier 2] platforms and may have major defects. Follow the
6724   instructions on the website to install, or add the targets to an existing
6725   installation with `rustup target add`. The new target triples are:
6726   - `mips-unknown-linux-gnu`
6727   - `mipsel-unknown-linux-gnu`
6728   - `mips64-unknown-linux-gnuabi64`
6729   - `mips64el-unknown-linux-gnuabi64 `
6730   - `powerpc-unknown-linux-gnu`
6731   - `powerpc64-unknown-linux-gnu`
6732   - `powerpc64le-unknown-linux-gnu`
6733   - `s390x-unknown-linux-gnu `
6734 * This release includes target (std) builds for ARM Linux running MUSL
6735   libc. These are [tier 2] platforms and may have major defects. Add the
6736   following triples to an existing rustup installation with `rustup target add`:
6737   - `arm-unknown-linux-musleabi`
6738   - `arm-unknown-linux-musleabihf`
6739   - `armv7-unknown-linux-musleabihf`
6740 * This release includes [experimental support for WebAssembly][1.14wasm], via
6741   the `wasm32-unknown-emscripten` target. This target is known to have major
6742   defects. Please test, report, and fix.
6743 * rustup no longer installs documentation by default. Run `rustup
6744   component add rust-docs` to install.
6745 * [Fix line stepping in debugger][37310]
6746 * [Enable line number debuginfo in releases][37280]
6747
6748 Misc
6749 ----
6750
6751 * [Disable jemalloc on aarch64/powerpc/mips][37392]
6752 * [Add support for Fuchsia OS][37313]
6753 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
6754
6755 Compatibility Notes
6756 -------------------
6757
6758 * [A number of forward-compatibility lints used by the compiler
6759   to gradually introduce language changes have been converted
6760   to deny by default][36894]:
6761   - ["use of inaccessible extern crate erroneously allowed"][36886]
6762   - ["type parameter default erroneously allowed in invalid location"][36887]
6763   - ["detects super or self keywords at the beginning of global path"][36888]
6764   - ["two overlapping inherent impls define an item with the same name
6765     were erroneously allowed"][36889]
6766   - ["floating-point constants cannot be used in patterns"][36890]
6767   - ["constants of struct or enum type can only be used in a pattern if
6768      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
6769   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
6770 * [Prohibit patterns in trait methods without bodies][37378]
6771 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
6772 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
6773 * [The `$crate` macro variable is accepted in fewer locations][37213]
6774 * [Impls specifying extra region requirements beyond the trait
6775   they implement are rejected][37167]
6776 * [Enums may not be unsized][37111]. Unsized enums are intended to
6777   work but never have. For now they are forbidden.
6778 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
6779
6780 [tier 2]: https://forge.rust-lang.org/platform-support.html
6781 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
6782 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
6783 [36430]: https://github.com/rust-lang/rust/pull/36430
6784 [36595]: https://github.com/rust-lang/rust/pull/36595
6785 [36595]: https://github.com/rust-lang/rust/pull/36595
6786 [36692]: https://github.com/rust-lang/rust/pull/36692
6787 [36767]: https://github.com/rust-lang/rust/pull/36767
6788 [36794]: https://github.com/rust-lang/rust/pull/36794
6789 [36798]: https://github.com/rust-lang/rust/pull/36798
6790 [36819]: https://github.com/rust-lang/rust/pull/36819
6791 [36822]: https://github.com/rust-lang/rust/pull/36822
6792 [36825]: https://github.com/rust-lang/rust/pull/36825
6793 [36843]: https://github.com/rust-lang/rust/pull/36843
6794 [36880]: https://github.com/rust-lang/rust/pull/36880
6795 [36886]: https://github.com/rust-lang/rust/issues/36886
6796 [36887]: https://github.com/rust-lang/rust/issues/36887
6797 [36888]: https://github.com/rust-lang/rust/issues/36888
6798 [36889]: https://github.com/rust-lang/rust/issues/36889
6799 [36890]: https://github.com/rust-lang/rust/issues/36890
6800 [36891]: https://github.com/rust-lang/rust/issues/36891
6801 [36892]: https://github.com/rust-lang/rust/issues/36892
6802 [36894]: https://github.com/rust-lang/rust/pull/36894
6803 [36917]: https://github.com/rust-lang/rust/pull/36917
6804 [36993]: https://github.com/rust-lang/rust/pull/36993
6805 [37037]: https://github.com/rust-lang/rust/pull/37037
6806 [37064]: https://github.com/rust-lang/rust/pull/37064
6807 [37094]: https://github.com/rust-lang/rust/pull/37094
6808 [37108]: https://github.com/rust-lang/rust/pull/37108
6809 [37111]: https://github.com/rust-lang/rust/pull/37111
6810 [37161]: https://github.com/rust-lang/rust/pull/37161
6811 [37162]: https://github.com/rust-lang/rust/pull/37162
6812 [37167]: https://github.com/rust-lang/rust/pull/37167
6813 [37178]: https://github.com/rust-lang/rust/pull/37178
6814 [37200]: https://github.com/rust-lang/rust/pull/37200
6815 [37213]: https://github.com/rust-lang/rust/pull/37213
6816 [37221]: https://github.com/rust-lang/rust/pull/37221
6817 [37224]: https://github.com/rust-lang/rust/pull/37224
6818 [37230]: https://github.com/rust-lang/rust/pull/37230
6819 [37231]: https://github.com/rust-lang/rust/pull/37231
6820 [37247]: https://github.com/rust-lang/rust/pull/37247
6821 [37267]: https://github.com/rust-lang/rust/pull/37267
6822 [37270]: https://github.com/rust-lang/rust/pull/37270
6823 [37273]: https://github.com/rust-lang/rust/pull/37273
6824 [37280]: https://github.com/rust-lang/rust/pull/37280
6825 [37298]: https://github.com/rust-lang/rust/pull/37298
6826 [37306]: https://github.com/rust-lang/rust/pull/37306
6827 [37310]: https://github.com/rust-lang/rust/pull/37310
6828 [37312]: https://github.com/rust-lang/rust/pull/37312
6829 [37313]: https://github.com/rust-lang/rust/pull/37313
6830 [37315]: https://github.com/rust-lang/rust/pull/37315
6831 [37318]: https://github.com/rust-lang/rust/pull/37318
6832 [37322]: https://github.com/rust-lang/rust/pull/37322
6833 [37326]: https://github.com/rust-lang/rust/pull/37326
6834 [37351]: https://github.com/rust-lang/rust/pull/37351
6835 [37356]: https://github.com/rust-lang/rust/pull/37356
6836 [37367]: https://github.com/rust-lang/rust/pull/37367
6837 [37373]: https://github.com/rust-lang/rust/pull/37373
6838 [37378]: https://github.com/rust-lang/rust/pull/37378
6839 [37389]: https://github.com/rust-lang/rust/pull/37389
6840 [37392]: https://github.com/rust-lang/rust/pull/37392
6841 [37427]: https://github.com/rust-lang/rust/pull/37427
6842 [37439]: https://github.com/rust-lang/rust/pull/37439
6843 [37445]: https://github.com/rust-lang/rust/pull/37445
6844 [37470]: https://github.com/rust-lang/rust/pull/37470
6845 [37569]: https://github.com/rust-lang/rust/pull/37569
6846 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6847 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
6848 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
6849 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
6850 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
6851 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
6852 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
6853
6854
6855 Version 1.13.0 (2016-11-10)
6856 ===========================
6857
6858 Language
6859 --------
6860
6861 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
6862   errors, like the `try!` macro, described in [RFC 0243].
6863 * [Stabilize macros in type position][36014]. Described in [RFC 873].
6864 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
6865 * [Fix `#[derive]` for empty tuple structs/variants][35728]
6866 * [Fix lifetime rules for 'if' conditions][36029]
6867 * [Avoid loading and parsing unconfigured non-inline modules][36482]
6868
6869 Compiler
6870 --------
6871
6872 * [Add the `-C link-arg` argument][36574]
6873 * [Remove the old AST-based backend from rustc_trans][35764]
6874 * [Don't enable NEON by default on armv7 Linux][35814]
6875 * [Fix debug line number info for macro expansions][35238]
6876 * [Do not emit "class method" debuginfo for types that are not
6877   DICompositeType][36008]
6878 * [Warn about multiple conflicting #[repr] hints][34623]
6879 * [When sizing DST, don't double-count nested struct prefixes][36351]
6880 * [Default RUST_MIN_STACK to 16MiB for now][36505]
6881 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
6882 * [Reject macros with empty repetitions to avoid infinite loop][36721]
6883 * [Expand macros without recursing to avoid stack overflows][36214]
6884
6885 Diagnostics
6886 -----------
6887
6888 * [Replace macro backtraces with labeled local uses][35702]
6889 * [Improve error message for misplaced doc comments][33922]
6890 * [Buffer unix and lock windows to prevent message interleaving][35975]
6891 * [Update lifetime errors to specifically note temporaries][36171]
6892 * [Special case a few colors for Windows][36178]
6893 * [Suggest `use self` when such an import resolves][36289]
6894 * [Be more specific when type parameter shadows primitive type][36338]
6895 * Many minor improvements
6896
6897 Compile-time Optimizations
6898 --------------------------
6899
6900 * [Compute and cache HIR hashes at beginning][35854]
6901 * [Don't hash types in loan paths][36004]
6902 * [Cache projections in trans][35761]
6903 * [Optimize the parser's last token handling][36527]
6904 * [Only instantiate #[inline] functions in codegen units referencing
6905   them][36524]. This leads to big improvements in cases where crates export
6906   define many inline functions without using them directly.
6907 * [Lazily allocate TypedArena's first chunk][36592]
6908 * [Don't allocate during default HashSet creation][36734]
6909
6910 Stabilized APIs
6911 ---------------
6912
6913 * [`checked_abs`]
6914 * [`wrapping_abs`]
6915 * [`overflowing_abs`]
6916 * [`RefCell::try_borrow`]
6917 * [`RefCell::try_borrow_mut`]
6918
6919 Libraries
6920 ---------
6921
6922 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
6923 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
6924   covariant][35354]
6925 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
6926 * [Implement `Debug` for `std::vec::IntoIter`][35707]
6927 * [`CString`: avoid excessive growth just to 0-terminate][35871]
6928 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
6929 * [Use arc4rand on FreeBSD][35884]
6930 * [memrchr: Correct aligned offset computation][35969]
6931 * [Improve Demangling of Rust Symbols][36059]
6932 * [Use monotonic time in condition variables][35048]
6933 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
6934 * [Implement conversion traits for `char`][35755]
6935 * [Fix illegal instruction caused by overflow in channel cloning][36104]
6936 * [Zero first byte of CString on drop][36264]
6937 * [Inherit overflow checks for sum and product][36372]
6938 * [Add missing Eq implementations][36423]
6939 * [Implement `Debug` for `DirEntry`][36631]
6940 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
6941   `errno`][36754]
6942 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6943 * [Implement more traits for `std::io::ErrorKind`][35911]
6944 * [Optimize BinaryHeap bounds checking][36072]
6945 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
6946   `extend_with_element`][36355]
6947 * [Fix overflow checking in unsigned pow()][34942]
6948
6949 Cargo
6950 -----
6951
6952 * This release includes security fixes to both curl and OpenSSL.
6953 * [Fix transitive doctests when panic=abort][cargo/3021]
6954 * [Add --all-features flag to cargo][cargo/3038]
6955 * [Reject path-based dependencies in `cargo package`][cargo/3060]
6956 * [Don't parse the home directory more than once][cargo/3078]
6957 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
6958 * [Update OpenSSL to 1.0.2j][cargo/3121]
6959 * [Add license and license_file to cargo metadata output][cargo/3110]
6960 * [Make crates-io registry URL optional in config; ignore all changes to
6961   source.crates-io][cargo/3089]
6962 * [Don't download dependencies from other platforms][cargo/3123]
6963 * [Build transitive dev-dependencies when needed][cargo/3125]
6964 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
6965 * [Avoid updating registry when adding existing deps][cargo/3144]
6966 * [Warn about path overrides that won't work][cargo/3136]
6967 * [Use workspaces during `cargo install`][cargo/3146]
6968 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
6969 * [Add --message-format flag][cargo/3000]
6970 * [Pass target environment for rustdoc][cargo/3205]
6971 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
6972 * [Update curl and curl-sys][cargo/3241]
6973 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
6974
6975 Tooling
6976 -------
6977
6978 * [rustdoc: Add the `--sysroot` argument][36586]
6979 * [rustdoc: Fix a couple of issues with the search results][35655]
6980 * [rustdoc: remove the `!` from macro URLs and titles][35234]
6981 * [gdb: Fix pretty-printing special-cased Rust types][35585]
6982 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
6983
6984 Misc
6985 ----
6986
6987 * [Remove unmaintained style guide][35124]
6988 * [Add s390x support][36369]
6989 * [Initial work at Haiku OS support][36727]
6990 * [Add mips-uclibc targets][35734]
6991 * [Crate-ify compiler-rt into compiler-builtins][35021]
6992 * [Add rustc version info (git hash + date) to dist tarball][36213]
6993 * Many documentation improvements
6994
6995 Compatibility Notes
6996 -------------------
6997
6998 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6999 * [Deny (by default) transmuting from fn item types to pointer-sized
7000   types][34923]. Continuing the long transition to zero-sized fn items,
7001   per [RFC 401].
7002 * [Fix `#[derive]` for empty tuple structs/variants][35728].
7003   Part of [RFC 1506].
7004 * [Issue deprecation warnings for safe accesses to extern statics][36173]
7005 * [Fix lifetime rules for 'if' conditions][36029].
7006 * [Inherit overflow checks for sum and product][36372].
7007 * [Forbid user-defined macros named "macro_rules"][36730].
7008
7009 [33922]: https://github.com/rust-lang/rust/pull/33922
7010 [34623]: https://github.com/rust-lang/rust/pull/34623
7011 [34923]: https://github.com/rust-lang/rust/pull/34923
7012 [34942]: https://github.com/rust-lang/rust/pull/34942
7013 [34982]: https://github.com/rust-lang/rust/pull/34982
7014 [35021]: https://github.com/rust-lang/rust/pull/35021
7015 [35048]: https://github.com/rust-lang/rust/pull/35048
7016 [35074]: https://github.com/rust-lang/rust/pull/35074
7017 [35124]: https://github.com/rust-lang/rust/pull/35124
7018 [35234]: https://github.com/rust-lang/rust/pull/35234
7019 [35238]: https://github.com/rust-lang/rust/pull/35238
7020 [35354]: https://github.com/rust-lang/rust/pull/35354
7021 [35559]: https://github.com/rust-lang/rust/pull/35559
7022 [35585]: https://github.com/rust-lang/rust/pull/35585
7023 [35627]: https://github.com/rust-lang/rust/pull/35627
7024 [35655]: https://github.com/rust-lang/rust/pull/35655
7025 [35702]: https://github.com/rust-lang/rust/pull/35702
7026 [35707]: https://github.com/rust-lang/rust/pull/35707
7027 [35728]: https://github.com/rust-lang/rust/pull/35728
7028 [35734]: https://github.com/rust-lang/rust/pull/35734
7029 [35755]: https://github.com/rust-lang/rust/pull/35755
7030 [35761]: https://github.com/rust-lang/rust/pull/35761
7031 [35764]: https://github.com/rust-lang/rust/pull/35764
7032 [35814]: https://github.com/rust-lang/rust/pull/35814
7033 [35854]: https://github.com/rust-lang/rust/pull/35854
7034 [35871]: https://github.com/rust-lang/rust/pull/35871
7035 [35884]: https://github.com/rust-lang/rust/pull/35884
7036 [35911]: https://github.com/rust-lang/rust/pull/35911
7037 [35969]: https://github.com/rust-lang/rust/pull/35969
7038 [35975]: https://github.com/rust-lang/rust/pull/35975
7039 [36004]: https://github.com/rust-lang/rust/pull/36004
7040 [36008]: https://github.com/rust-lang/rust/pull/36008
7041 [36014]: https://github.com/rust-lang/rust/pull/36014
7042 [36029]: https://github.com/rust-lang/rust/pull/36029
7043 [36059]: https://github.com/rust-lang/rust/pull/36059
7044 [36072]: https://github.com/rust-lang/rust/pull/36072
7045 [36101]: https://github.com/rust-lang/rust/pull/36101
7046 [36104]: https://github.com/rust-lang/rust/pull/36104
7047 [36171]: https://github.com/rust-lang/rust/pull/36171
7048 [36173]: https://github.com/rust-lang/rust/pull/36173
7049 [36178]: https://github.com/rust-lang/rust/pull/36178
7050 [36213]: https://github.com/rust-lang/rust/pull/36213
7051 [36214]: https://github.com/rust-lang/rust/pull/36214
7052 [36264]: https://github.com/rust-lang/rust/pull/36264
7053 [36266]: https://github.com/rust-lang/rust/pull/36266
7054 [36289]: https://github.com/rust-lang/rust/pull/36289
7055 [36338]: https://github.com/rust-lang/rust/pull/36338
7056 [36351]: https://github.com/rust-lang/rust/pull/36351
7057 [36355]: https://github.com/rust-lang/rust/pull/36355
7058 [36369]: https://github.com/rust-lang/rust/pull/36369
7059 [36372]: https://github.com/rust-lang/rust/pull/36372
7060 [36423]: https://github.com/rust-lang/rust/pull/36423
7061 [36482]: https://github.com/rust-lang/rust/pull/36482
7062 [36505]: https://github.com/rust-lang/rust/pull/36505
7063 [36524]: https://github.com/rust-lang/rust/pull/36524
7064 [36527]: https://github.com/rust-lang/rust/pull/36527
7065 [36551]: https://github.com/rust-lang/rust/pull/36551
7066 [36574]: https://github.com/rust-lang/rust/pull/36574
7067 [36586]: https://github.com/rust-lang/rust/pull/36586
7068 [36592]: https://github.com/rust-lang/rust/pull/36592
7069 [36631]: https://github.com/rust-lang/rust/pull/36631
7070 [36639]: https://github.com/rust-lang/rust/pull/36639
7071 [36721]: https://github.com/rust-lang/rust/pull/36721
7072 [36727]: https://github.com/rust-lang/rust/pull/36727
7073 [36730]: https://github.com/rust-lang/rust/pull/36730
7074 [36734]: https://github.com/rust-lang/rust/pull/36734
7075 [36754]: https://github.com/rust-lang/rust/pull/36754
7076 [36995]: https://github.com/rust-lang/rust/pull/36995
7077 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
7078 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
7079 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
7080 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
7081 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
7082 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
7083 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
7084 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
7085 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
7086 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
7087 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
7088 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
7089 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
7090 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
7091 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
7092 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
7093 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
7094 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
7095 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
7096 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
7097 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
7098 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
7099 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
7100 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
7101 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
7102 [rustup]: https://www.rustup.rs
7103 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
7104 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
7105 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
7106 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
7107 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
7108 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
7109 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
7110
7111
7112 Version 1.12.1 (2016-10-20)
7113 ===========================
7114
7115 Regression Fixes
7116 ----------------
7117
7118 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
7119 * [Confusion with double negation and booleans][36856]
7120 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
7121 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
7122 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
7123 * [Corrupted memory after updated to 1.12][36936]
7124 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
7125 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
7126 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
7127
7128 [36381]: https://github.com/rust-lang/rust/issues/36381
7129 [36856]: https://github.com/rust-lang/rust/issues/36856
7130 [36875]: https://github.com/rust-lang/rust/issues/36875
7131 [36924]: https://github.com/rust-lang/rust/issues/36924
7132 [36926]: https://github.com/rust-lang/rust/issues/36926
7133 [36936]: https://github.com/rust-lang/rust/issues/36936
7134 [37026]: https://github.com/rust-lang/rust/issues/37026
7135 [37112]: https://github.com/rust-lang/rust/issues/37112
7136 [37153]: https://github.com/rust-lang/rust/issues/37153
7137
7138
7139 Version 1.12.0 (2016-09-29)
7140 ===========================
7141
7142 Highlights
7143 ----------
7144
7145 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
7146   This translation pass is far simpler than the previous AST->LLVM pass, and
7147   creates opportunities to perform new optimizations directly on the MIR. It
7148   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
7149 * [`rustc` presents a new, more readable error format, along with
7150   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
7151   Most common editors supporting Rust have been updated to work with it. It was
7152   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
7153
7154 Compiler
7155 --------
7156
7157 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
7158   This translation pass is far simpler than the previous AST->LLVM pass, and
7159   creates opportunities to perform new optimizations directly on the MIR. It
7160   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
7161 * [Print the Rust target name, not the LLVM target name, with
7162   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
7163 * [The computation of `TypeId` is correct in some cases where it was previously
7164   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
7165 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
7166 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
7167   `--print relocation-models`, and `--print code-models` print the available
7168   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
7169   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
7170 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
7171   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
7172   These targets produce statically-linked binaries. There are no binary release
7173   builds yet though.
7174
7175 Diagnostics
7176 -----------
7177
7178 * [`rustc` presents a new, more readable error format, along with
7179   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
7180   Most common editors supporting Rust have been updated to work with it. It was
7181   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
7182 * [In error descriptions, references are now described in plain English,
7183   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
7184 * [In error type descriptions, unknown numeric types are named `{integer}` or
7185   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
7186 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
7187
7188 Language
7189 --------
7190
7191 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
7192 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
7193 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
7194   useful](https://github.com/rust-lang/rust/pull/34908)
7195 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
7196   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
7197 * [Semicolons are properly required as statement delimiters inside
7198   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
7199 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
7200
7201 Stabilized APIs
7202 ---------------
7203
7204 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
7205 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
7206 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
7207 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
7208 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
7209 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
7210 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
7211 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
7212 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
7213 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
7214   Both on Unix and Windows.
7215 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
7216 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
7217 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
7218 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
7219 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
7220 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
7221 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
7222 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
7223
7224 Libraries
7225 ---------
7226
7227 * [The `format!` macro and friends now allow a single argument to be formatted
7228   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
7229 * [The lifetime bounds on `[T]::binary_search_by` and
7230   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
7231 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
7232 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
7233 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
7234 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
7235 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
7236 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
7237 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
7238 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
7239   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
7240 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
7241   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
7242 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
7243 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
7244   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
7245 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
7246 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
7247 * [`mpsc::sync_channel` `Receiver`s return any available message before
7248   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
7249 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
7250 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
7251
7252 Cargo
7253 -----
7254
7255 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
7256 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
7257 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
7258 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
7259 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
7260 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
7261 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
7262 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
7263 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
7264 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
7265 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
7266 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
7267 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
7268 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
7269 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
7270 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
7271
7272 Performance
7273 -----------
7274
7275 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
7276 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
7277
7278 Tooling
7279 -------
7280
7281 * [Test binaries now support a `--test-threads` argument to specify the number
7282   of threads used to run tests, and which acts the same as the
7283   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
7284 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
7285 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
7286 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7287 * [Rust releases now come with source packages that can be installed by rustup
7288   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
7289   The resulting source code can be used by tools and IDES, located in the
7290   sysroot under `lib/rustlib/src`.
7291
7292 Misc
7293 ----
7294
7295 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
7296 * Many minor improvements to the documentation.
7297 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
7298
7299 Compatibility Notes
7300 -------------------
7301
7302 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
7303   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
7304 * [When formatting strings, if "precision" is specified, the "fill",
7305   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
7306 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
7307
7308
7309 Version 1.11.0 (2016-08-18)
7310 ===========================
7311
7312 Language
7313 --------
7314
7315 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
7316 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
7317 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
7318 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
7319
7320 Stabilized APIs
7321 ---------------
7322
7323 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
7324 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
7325 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
7326 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
7327 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
7328 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
7329   (in libcore - previously stabilized in libstd)
7330 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
7331   (in libcore - previously stabilized in libstd)
7332 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
7333   (in libcore - previously stabilized in libstd)
7334 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
7335   (in libcore - previously stabilized in libstd)
7336 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7337 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7338 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
7339 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
7340
7341 Libraries
7342 ---------
7343
7344 * [The `thread_local!` macro supports multiple definitions in a single
7345    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
7346 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
7347 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
7348   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
7349 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
7350 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
7351 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
7352 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
7353
7354 Cargo
7355 -----
7356
7357 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
7358 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
7359 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
7360 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
7361 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
7362   and `-vv` prints warnings for all crates.
7363 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
7364 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
7365   This provides room for expansion by arbitrary tools.
7366 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
7367 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
7368 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
7369 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
7370 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
7371 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
7372 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
7373
7374 Performance
7375 -----------
7376
7377 * [Caching projections speeds up type check dramatically for some
7378   workloads](https://github.com/rust-lang/rust/pull/33816)
7379 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
7380   This hasher is faster, but is believed to provide sufficient
7381   protection from collision attacks.
7382 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
7383
7384 Rustdoc
7385 -------
7386
7387 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
7388 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
7389 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
7390 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
7391 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
7392
7393 Tooling
7394 -------
7395
7396 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
7397 * [When emitting debug info, rustc emits frame pointers for closures,
7398   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
7399 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7400 * Many more errors have been given error codes and extended
7401   explanations
7402 * API documentation continues to be improved, with many new examples
7403
7404 Misc
7405 ----
7406
7407 * [rustc no longer hangs when dependencies recursively re-export
7408   submodules](https://github.com/rust-lang/rust/pull/34542)
7409 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
7410 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
7411   rewritten](https://github.com/rust-lang/rust/pull/33895)
7412 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
7413   No targets use this yet, but it works toward AVR support.
7414
7415 Compatibility Notes
7416 -------------------
7417
7418 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
7419 * [The new follow-set rules that place restrictions on `macro_rules!`
7420   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
7421   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
7422   and has been a warning since 1.10.
7423 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
7424   This causes breakage in some corner cases.
7425
7426
7427 Version 1.10.0 (2016-07-07)
7428 ===========================
7429
7430 Language
7431 --------
7432
7433 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
7434   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
7435 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
7436 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
7437 * [`panic!` can be converted to a runtime abort with the
7438   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
7439   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7440 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
7441   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
7442   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
7443   Note that Cargo does not yet directly support cdylibs.
7444
7445 Stabilized APIs
7446 ---------------
7447
7448 * `os::windows::fs::OpenOptionsExt::access_mode`
7449 * `os::windows::fs::OpenOptionsExt::share_mode`
7450 * `os::windows::fs::OpenOptionsExt::custom_flags`
7451 * `os::windows::fs::OpenOptionsExt::attributes`
7452 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
7453 * `os::unix::fs::OpenOptionsExt::custom_flags`
7454 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
7455 * `Default for sync::Weak`
7456 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
7457 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
7458 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
7459 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
7460 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
7461 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
7462 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
7463 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
7464 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
7465 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
7466 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
7467 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
7468 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
7469 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
7470 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
7471 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
7472 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
7473 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
7474 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
7475 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
7476 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
7477 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
7478 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
7479 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
7480 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
7481 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7482 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7483 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7484 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7485 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
7486 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
7487 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
7488 * Read/Write/RawFd impls for `UnixStream`
7489 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
7490 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
7491 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
7492 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
7493 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
7494 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
7495 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
7496 * RawFd impls for `UnixListener`
7497 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
7498 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
7499 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
7500 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
7501 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
7502 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
7503 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
7504 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
7505 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
7506 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
7507 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
7508 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
7509 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
7510 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
7511 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
7512 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
7513 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
7514 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
7515 * RawFd impls for `UnixDatagram`
7516 * `{BTree,Hash}Map::values_mut`
7517 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
7518
7519 Libraries
7520 ---------
7521
7522 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
7523   The semantics of this minor method are subtle and probably not what
7524   most people want.
7525 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
7526 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
7527   will fall back to `/dev/urandom` temporarily to avoid blocking
7528   during early boot](https://github.com/rust-lang/rust/pull/33086).
7529 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
7530 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
7531 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
7532 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
7533 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
7534 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
7535   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
7536
7537 Cargo
7538 -----
7539 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
7540   This controls the runtime behavior of the `panic!` macro
7541   and can be either "unwind" (the default), or "abort".
7542   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7543 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
7544 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
7545 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
7546   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
7547 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
7548 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
7549 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
7550   By default they are retried twice, which can be customized with the
7551   `net.retry` value in `.cargo/config`.
7552 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
7553 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
7554 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
7555 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
7556   Makes it possible to install multiple crates in parallel.
7557 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
7558 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
7559 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
7560 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
7561 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
7562 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
7563
7564 Performance
7565 -----------
7566
7567 * [rustc memory usage was reduced by refactoring the context used for
7568   type checking](https://github.com/rust-lang/rust/pull/33425).
7569 * [Speed up creation of `HashMap`s by caching the random keys used
7570   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
7571 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
7572 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
7573 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
7574   10x faster than the previous lookup tables.
7575 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
7576
7577 Usability
7578 ---------
7579
7580 * Many incremental improvements to documentation and rustdoc.
7581 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
7582 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
7583 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
7584 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
7585 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
7586 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
7587 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
7588
7589 Misc
7590 ----
7591
7592 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
7593 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
7594 * [`std` no longer prints backtraces on platforms where the running
7595   module must be loaded with `env::current_exe`, which can't be relied
7596   on](https://github.com/rust-lang/rust/pull/33554).
7597 * This release includes std binaries for the i586-unknown-linux-gnu,
7598   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
7599   i586 target is for old x86 hardware without SSE2, and the armv7
7600   target is for Android running on modern ARM architectures.
7601 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
7602   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
7603 * [On Unix the runtime aborts by calling `libc::abort` instead of
7604   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
7605 * [Rust is now bootstrapped from the previous release of Rust,
7606   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
7607
7608 Compatibility Notes
7609 -------------------
7610
7611 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
7612 * [`target_env` for Linux ARM targets is just `gnu`, not
7613   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
7614 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
7615 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
7616 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
7617   Affects how macros are parsed.
7618 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
7619 * [Feature-gated attributes on macro-generated macro invocations are
7620   now rejected](https://github.com/rust-lang/rust/pull/32791).
7621 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
7622   This caused some minor changes to type inference.
7623
7624
7625 Version 1.9.0 (2016-05-26)
7626 ==========================
7627
7628 Language
7629 --------
7630
7631 * The `#[deprecated]` attribute when applied to an API will generate
7632   warnings when used. The warnings may be suppressed with
7633   `#[allow(deprecated)]`. [RFC 1270].
7634 * [`fn` item types are zero sized, and each `fn` names a unique
7635   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7636   `transmute` on a `fn` type will generate a warning for a few cycles,
7637   then will be converted to an error.
7638 * [Field and method resolution understand visibility, so private
7639   fields and methods cannot prevent the proper use of public fields
7640   and methods][1.9fv].
7641 * [The parser considers unicode codepoints in the
7642   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
7643
7644 Stabilized APIs
7645 ---------------
7646
7647 * [`std::panic`]
7648 * [`std::panic::catch_unwind`] (renamed from `recover`)
7649 * [`std::panic::resume_unwind`] (renamed from `propagate`)
7650 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
7651 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
7652 * [`str::is_char_boundary`]
7653 * [`<*const T>::as_ref`]
7654 * [`<*mut T>::as_ref`]
7655 * [`<*mut T>::as_mut`]
7656 * [`AsciiExt::make_ascii_uppercase`]
7657 * [`AsciiExt::make_ascii_lowercase`]
7658 * [`char::decode_utf16`]
7659 * [`char::DecodeUtf16`]
7660 * [`char::DecodeUtf16Error`]
7661 * [`char::DecodeUtf16Error::unpaired_surrogate`]
7662 * [`BTreeSet::take`]
7663 * [`BTreeSet::replace`]
7664 * [`BTreeSet::get`]
7665 * [`HashSet::take`]
7666 * [`HashSet::replace`]
7667 * [`HashSet::get`]
7668 * [`OsString::with_capacity`]
7669 * [`OsString::clear`]
7670 * [`OsString::capacity`]
7671 * [`OsString::reserve`]
7672 * [`OsString::reserve_exact`]
7673 * [`OsStr::is_empty`]
7674 * [`OsStr::len`]
7675 * [`std::os::unix::thread`]
7676 * [`RawPthread`]
7677 * [`JoinHandleExt`]
7678 * [`JoinHandleExt::as_pthread_t`]
7679 * [`JoinHandleExt::into_pthread_t`]
7680 * [`HashSet::hasher`]
7681 * [`HashMap::hasher`]
7682 * [`CommandExt::exec`]
7683 * [`File::try_clone`]
7684 * [`SocketAddr::set_ip`]
7685 * [`SocketAddr::set_port`]
7686 * [`SocketAddrV4::set_ip`]
7687 * [`SocketAddrV4::set_port`]
7688 * [`SocketAddrV6::set_ip`]
7689 * [`SocketAddrV6::set_port`]
7690 * [`SocketAddrV6::set_flowinfo`]
7691 * [`SocketAddrV6::set_scope_id`]
7692 * [`slice::copy_from_slice`]
7693 * [`ptr::read_volatile`]
7694 * [`ptr::write_volatile`]
7695 * [`OpenOptions::create_new`]
7696 * [`TcpStream::set_nodelay`]
7697 * [`TcpStream::nodelay`]
7698 * [`TcpStream::set_ttl`]
7699 * [`TcpStream::ttl`]
7700 * [`TcpStream::set_only_v6`]
7701 * [`TcpStream::only_v6`]
7702 * [`TcpStream::take_error`]
7703 * [`TcpStream::set_nonblocking`]
7704 * [`TcpListener::set_ttl`]
7705 * [`TcpListener::ttl`]
7706 * [`TcpListener::set_only_v6`]
7707 * [`TcpListener::only_v6`]
7708 * [`TcpListener::take_error`]
7709 * [`TcpListener::set_nonblocking`]
7710 * [`UdpSocket::set_broadcast`]
7711 * [`UdpSocket::broadcast`]
7712 * [`UdpSocket::set_multicast_loop_v4`]
7713 * [`UdpSocket::multicast_loop_v4`]
7714 * [`UdpSocket::set_multicast_ttl_v4`]
7715 * [`UdpSocket::multicast_ttl_v4`]
7716 * [`UdpSocket::set_multicast_loop_v6`]
7717 * [`UdpSocket::multicast_loop_v6`]
7718 * [`UdpSocket::set_multicast_ttl_v6`]
7719 * [`UdpSocket::multicast_ttl_v6`]
7720 * [`UdpSocket::set_ttl`]
7721 * [`UdpSocket::ttl`]
7722 * [`UdpSocket::set_only_v6`]
7723 * [`UdpSocket::only_v6`]
7724 * [`UdpSocket::join_multicast_v4`]
7725 * [`UdpSocket::join_multicast_v6`]
7726 * [`UdpSocket::leave_multicast_v4`]
7727 * [`UdpSocket::leave_multicast_v6`]
7728 * [`UdpSocket::take_error`]
7729 * [`UdpSocket::connect`]
7730 * [`UdpSocket::send`]
7731 * [`UdpSocket::recv`]
7732 * [`UdpSocket::set_nonblocking`]
7733
7734 Libraries
7735 ---------
7736
7737 * [`std::sync::Once` is poisoned if its initialization function
7738   fails][1.9o].
7739 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
7740 * [Most types implement `fmt::Debug`][1.9db].
7741 * [The default buffer size used by `BufReader` and `BufWriter` was
7742   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
7743   used by other languages.
7744 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
7745   `Duration` additionally implements `*=` and `/=`][1.9ta].
7746 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
7747 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
7748 * [`Chain` implements `BufRead`][1.9ch].
7749 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
7750
7751 Cargo
7752 -----
7753
7754 * [Cargo can now run concurrently][1.9cc].
7755 * [Top-level overrides allow specific revisions of crates to be
7756   overridden through the entire crate graph][1.9ct].  This is intended
7757   to make upgrades easier for large projects, by allowing crates to be
7758   forked temporarily until they've been upgraded and republished.
7759 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
7760 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
7761   on the commandline][1.9cf]. `rustc` arguments can also be specified
7762   in the `build.rustflags` configuration key.
7763
7764 Performance
7765 -----------
7766
7767 * [The time complexity of comparing variables for equivalence during type
7768   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
7769   to major compilation time improvement in some scenarios.
7770 * [`ToString` is specialized for `str`, giving it the same performance
7771   as `to_owned`][1.9ts].
7772 * [Spawning processes with `Command::output` no longer creates extra
7773   threads][1.9sp].
7774 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
7775   for C-like enums][1.9cl].
7776
7777 Misc
7778 ----
7779
7780 * [Passing the `--quiet` flag to a test runner will produce
7781   much-abbreviated output][1.9q].
7782 * The Rust Project now publishes std binaries for the
7783   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
7784   `i586-pc-windows-msvc` targets.
7785
7786 Compatibility Notes
7787 -------------------
7788
7789 * [`std::sync::Once` is poisoned if its initialization function
7790   fails][1.9o].
7791 * [It is illegal to define methods with the same name in overlapping
7792   inherent `impl` blocks][1.9sn].
7793 * [`fn` item types are zero sized, and each `fn` names a unique
7794   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7795   `transmute` on a `fn` type will generate a warning for a few cycles,
7796   then will be converted to an error.
7797 * [Improvements to const evaluation may trigger new errors when integer
7798   literals are out of range][1.9ce].
7799
7800
7801 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
7802 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
7803 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
7804 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
7805 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
7806 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
7807 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
7808 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
7809 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
7810 [1.9db]: https://github.com/rust-lang/rust/pull/32054
7811 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
7812 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
7813 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
7814 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
7815 [1.9o]: https://github.com/rust-lang/rust/pull/32325
7816 [1.9q]: https://github.com/rust-lang/rust/pull/31887
7817 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
7818 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
7819 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
7820 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
7821 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
7822 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
7823 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
7824 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
7825 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7826 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
7827 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7828 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
7829 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
7830 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
7831 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
7832 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
7833 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
7834 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
7835 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
7836 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
7837 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
7838 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
7839 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
7840 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
7841 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
7842 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
7843 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
7844 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
7845 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
7846 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
7847 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
7848 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
7849 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
7850 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
7851 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
7852 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
7853 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
7854 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
7855 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
7856 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
7857 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
7858 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
7859 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
7860 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
7861 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7862 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7863 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7864 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7865 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7866 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7867 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
7868 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7869 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
7870 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7871 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7872 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7873 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7874 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7875 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
7876 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
7877 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
7878 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
7879 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
7880 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
7881 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
7882 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
7883 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
7884 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
7885 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
7886 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
7887 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
7888 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
7889 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
7890 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
7891 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
7892 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
7893 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
7894 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
7895 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
7896 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
7897 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
7898 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
7899 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
7900 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
7901 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
7902 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
7903 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
7904 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
7905 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
7906 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
7907 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
7908 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
7909 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
7910 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
7911
7912
7913 Version 1.8.0 (2016-04-14)
7914 ==========================
7915
7916 Language
7917 --------
7918
7919 * Rust supports overloading of compound assignment statements like
7920   `+=` by implementing the [`AddAssign`], [`SubAssign`],
7921   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
7922   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
7923   traits. [RFC 953].
7924 * Empty structs can be defined with braces, as in `struct Foo { }`, in
7925   addition to the non-braced form, `struct Foo;`. [RFC 218].
7926
7927 Libraries
7928 ---------
7929
7930 * Stabilized APIs:
7931   * [`str::encode_utf16`] (renamed from `utf16_units`)
7932   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
7933   * [`Ref::map`]
7934   * [`RefMut::map`]
7935   * [`ptr::drop_in_place`]
7936   * [`time::Instant`]
7937   * [`time::SystemTime`]
7938   * [`Instant::now`]
7939   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
7940   * [`Instant::elapsed`]
7941   * [`SystemTime::now`]
7942   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
7943   * [`SystemTime::elapsed`]
7944   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
7945   * [`SystemTimeError`]
7946   * [`SystemTimeError::duration`]
7947   * Various impls for `SystemTimeError`
7948   * [`UNIX_EPOCH`]
7949   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
7950     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
7951     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
7952 * [The `write!` and `writeln!` macros correctly emit errors if any of
7953   their arguments can't be formatted][1.8w].
7954 * [Various I/O functions support large files on 32-bit Linux][1.8l].
7955 * [The Unix-specific `raw` modules, which contain a number of
7956   redefined C types are deprecated][1.8r], including `os::raw::unix`,
7957   `os::raw::macos`, and `os::raw::linux`. These modules defined types
7958   such as `ino_t` and `dev_t`. The inconsistency of these definitions
7959   across platforms was making it difficult to implement `std`
7960   correctly. Those that need these definitions should use the `libc`
7961   crate. [RFC 1415].
7962 * The Unix-specific `MetadataExt` traits, including
7963   `os::unix::fs::MetadataExt`, which expose values such as inode
7964   numbers [no longer return platform-specific types][1.8r], but
7965   instead return widened integers. [RFC 1415].
7966 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
7967 * [Atomic loads and stores are not volatile][1.8a].
7968 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
7969
7970 Performance
7971 -----------
7972
7973 * [Inlining hash functions lead to a 3% compile-time improvement in
7974   some workloads][1.8h].
7975 * When using jemalloc, its symbols are [unprefixed so that it
7976   overrides the libc malloc implementation][1.8h]. This means that for
7977   rustc, LLVM is now using jemalloc, which results in a 6%
7978   compile-time improvement on a specific workload.
7979 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
7980
7981 Misc
7982 ----
7983
7984 * [32-bit MSVC builds finally implement unwinding][1.8ms].
7985   i686-pc-windows-msvc is now considered a tier-1 platform.
7986 * [The `--print targets` flag prints a list of supported targets][1.8t].
7987 * [The `--print cfg` flag prints the `cfg`s defined for the current
7988   target][1.8cf].
7989 * [`rustc` can be built with an new Cargo-based build system, written
7990   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
7991   build system. To enable it configure with `configure --rustbuild`.
7992 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
7993   variants while also indicating the total number of missing variants
7994   if more than 3][1.8m].
7995 * [Executable stacks are disabled on Linux and BSD][1.8nx].
7996 * The Rust Project now publishes binary releases of the standard
7997   library for a number of tier-2 targets:
7998   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
7999   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
8000   `x86_64-rumprun-netbsd`. These can be installed with
8001   tools such as [multirust][1.8mr].
8002
8003 Cargo
8004 -----
8005
8006 * [`cargo init` creates a new Cargo project in the current
8007   directory][1.8ci].  It is otherwise like `cargo new`.
8008 * [Cargo has configuration keys for `-v` and
8009   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
8010   `[term]` section of `.cargo/config`.
8011 * [Configuration keys that evaluate to strings or integers can be set
8012   via environment variables][1.8ce]. For example the `build.jobs` key
8013   can be set via `CARGO_BUILD_JOBS`. Environment variables take
8014   precedence over config files.
8015 * [Target-specific dependencies support Rust `cfg` syntax for
8016   describing targets][1.8cfg] so that dependencies for multiple
8017   targets can be specified together. [RFC 1361].
8018 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
8019   `RUSTDOC` take precedence over the `build.target-dir`,
8020   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
8021 * [The child process tree is killed on Windows when Cargo is
8022   killed][1.8ck].
8023 * [The `build.target` configuration value sets the target platform,
8024   like `--target`][1.8ct].
8025
8026 Compatibility Notes
8027 -------------------
8028
8029 * [Unstable compiler flags have been further restricted][1.8u]. Since
8030   1.0 `-Z` flags have been considered unstable, and other flags that
8031   were considered unstable additionally required passing `-Z
8032   unstable-options` to access. Unlike unstable language and library
8033   features though, these options have been accessible on the stable
8034   release channel. Going forward, *new unstable flags will not be
8035   available on the stable release channel*, and old unstable flags
8036   will warn about their usage. In the future, all unstable flags will
8037   be unavailable on the stable release channel.
8038 * [It is no longer possible to `match` on empty enum variants using
8039   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
8040 * The Unix-specific `MetadataExt` traits, including
8041   `os::unix::fs::MetadataExt`, which expose values such as inode
8042   numbers [no longer return platform-specific types][1.8r], but
8043   instead return widened integers. [RFC 1415].
8044 * [Modules sourced from the filesystem cannot appear within arbitrary
8045   blocks, but only within other modules][1.8mf].
8046 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
8047 * On Unix, [stack overflow triggers a runtime abort instead of a
8048   SIGSEGV][1.8so].
8049 * [`Command::spawn` and its equivalents return an error if any of
8050   its command-line arguments contain interior `NUL`s][1.8n].
8051 * [Tuple and unit enum variants from other crates are in the type
8052   namespace][1.8tn].
8053 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
8054   type instead of `.a` files][1.8st]. Additionally, for the MSVC
8055   toolchain, `rustc` emits import libraries named `foo.dll.lib`
8056   instead of `foo.lib`.
8057
8058
8059 [1.8a]: https://github.com/rust-lang/rust/pull/30962
8060 [1.8b]: https://github.com/rust-lang/rust/pull/31123
8061 [1.8c]: https://github.com/rust-lang/rust/pull/31530
8062 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
8063 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
8064 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
8065 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
8066 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
8067 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
8068 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
8069 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
8070 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
8071 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
8072 [1.8h]: https://github.com/rust-lang/rust/pull/31460
8073 [1.8l]: https://github.com/rust-lang/rust/pull/31668
8074 [1.8m]: https://github.com/rust-lang/rust/pull/31020
8075 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
8076 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
8077 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
8078 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
8079 [1.8n]: https://github.com/rust-lang/rust/pull/31056
8080 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
8081 [1.8r]: https://github.com/rust-lang/rust/pull/31551
8082 [1.8so]: https://github.com/rust-lang/rust/pull/31333
8083 [1.8st]: https://github.com/rust-lang/rust/pull/29520
8084 [1.8t]: https://github.com/rust-lang/rust/pull/31358
8085 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
8086 [1.8u]: https://github.com/rust-lang/rust/pull/31793
8087 [1.8v]: https://github.com/rust-lang/rust/pull/31757
8088 [1.8w]: https://github.com/rust-lang/rust/pull/31904
8089 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
8090 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
8091 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
8092 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
8093 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
8094 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
8095 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
8096 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
8097 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
8098 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
8099 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
8100 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
8101 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
8102 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
8103 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
8104 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
8105 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
8106 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
8107 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
8108 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
8109 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
8110 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
8111 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
8112 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
8113 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
8114 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
8115 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
8116 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
8117 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
8118 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
8119
8120
8121 Version 1.7.0 (2016-03-03)
8122 ==========================
8123
8124 Libraries
8125 ---------
8126
8127 * Stabilized APIs
8128   * `Path`
8129     * [`Path::strip_prefix`] (renamed from relative_from)
8130     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
8131   * `Ipv4Addr`
8132     * [`Ipv4Addr::is_loopback`]
8133     * [`Ipv4Addr::is_private`]
8134     * [`Ipv4Addr::is_link_local`]
8135     * [`Ipv4Addr::is_multicast`]
8136     * [`Ipv4Addr::is_broadcast`]
8137     * [`Ipv4Addr::is_documentation`]
8138   * `Ipv6Addr`
8139     * [`Ipv6Addr::is_unspecified`]
8140     * [`Ipv6Addr::is_loopback`]
8141     * [`Ipv6Addr::is_multicast`]
8142   * `Vec`
8143     * [`Vec::as_slice`]
8144     * [`Vec::as_mut_slice`]
8145   * `String`
8146     * [`String::as_str`]
8147     * [`String::as_mut_str`]
8148   * Slices
8149     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
8150     be the same length
8151     * `<[T]>::`[`sort_by_key`]
8152   * checked, saturated, and overflowing operations
8153     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
8154     * [`i32::saturating_mul`]
8155     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
8156     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
8157     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
8158     * [`u32::saturating_mul`]
8159     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
8160     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
8161     * and checked, saturated, and overflowing operations for other primitive types
8162   * FFI
8163     * [`ffi::IntoStringError`]
8164     * [`CString::into_string`]
8165     * [`CString::into_bytes`]
8166     * [`CString::into_bytes_with_nul`]
8167     * `From<CString> for Vec<u8>`
8168   * `IntoStringError`
8169     * [`IntoStringError::into_cstring`]
8170     * [`IntoStringError::utf8_error`]
8171     * `Error for IntoStringError`
8172   * Hashing
8173     * [`std::hash::BuildHasher`]
8174     * [`BuildHasher::Hasher`]
8175     * [`BuildHasher::build_hasher`]
8176     * [`std::hash::BuildHasherDefault`]
8177     * [`HashMap::with_hasher`]
8178     * [`HashMap::with_capacity_and_hasher`]
8179     * [`HashSet::with_hasher`]
8180     * [`HashSet::with_capacity_and_hasher`]
8181     * [`std::collections::hash_map::RandomState`]
8182     * [`RandomState::new`]
8183 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
8184   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
8185   from bytes is faster.
8186 * [The performance of `LineWriter` (and thus `io::stdout`) was
8187   improved by using `memchr` to search for newlines][1.7m].
8188 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
8189   `f64` variants were stabilized previously.
8190 * [`BTreeMap` was rewritten to use less memory and improve the performance
8191   of insertion and iteration, the latter by as much as 5x][1.7bm].
8192 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
8193   covariant over their contained type][1.7bt].
8194 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
8195   over their contained type][1.7ll].
8196 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
8197   searching methods.
8198 * [`Any` is implemented for unsized types][1.7a].
8199 * [`Hash` is implemented for `Duration`][1.7h].
8200
8201 Misc
8202 ----
8203
8204 * [When running tests with `--test`, rustdoc will pass `--cfg`
8205   arguments to the compiler][1.7dt].
8206 * [The compiler is built with RPATH information by default][1.7rpa].
8207   This means that it will be possible to run `rustc` when installed in
8208   unusual configurations without configuring the dynamic linker search
8209   path explicitly.
8210 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
8211   any RPATH entries (emitted with `-C rpath`) *not* take precedence
8212   over `LD_LIBRARY_PATH`.
8213
8214 Cargo
8215 -----
8216
8217 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
8218   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
8219 * [The `rerun-if-changed` build script directive no longer causes the
8220   build script to incorrectly run twice in certain scenarios][1.7rr].
8221
8222 Compatibility Notes
8223 -------------------
8224
8225 * Soundness fixes to the interactions between associated types and
8226   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
8227   code that violates the new rules. This is a significant change that
8228   is known to break existing code, so it has emitted warnings for the
8229   new error cases since 1.4 to give crate authors time to adapt. The
8230   details of what is changing are subtle; read the RFC for more.
8231 * [Several bugs in the compiler's visibility calculations were
8232   fixed][1.7v]. Since this was found to break significant amounts of
8233   code, the new errors will be emitted as warnings for several release
8234   cycles, under the `private_in_public` lint.
8235 * Defaulted type parameters were accidentally accepted in positions
8236   that were not intended. In this release, [defaulted type parameters
8237   appearing outside of type definitions will generate a
8238   warning][1.7d], which will become an error in future releases.
8239 * [Parsing "." as a float results in an error instead of 0][1.7p].
8240   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
8241 * [Borrows of closure parameters may not outlive the closure][1.7bc].
8242
8243 [1.7a]: https://github.com/rust-lang/rust/pull/30928
8244 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
8245 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
8246 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
8247 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
8248 [1.7d]: https://github.com/rust-lang/rust/pull/30724
8249 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
8250 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
8251 [1.7f]: https://github.com/rust-lang/rust/pull/30672
8252 [1.7h]: https://github.com/rust-lang/rust/pull/30818
8253 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
8254 [1.7m]: https://github.com/rust-lang/rust/pull/30381
8255 [1.7p]: https://github.com/rust-lang/rust/pull/30681
8256 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
8257 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
8258 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
8259 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
8260 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
8261 [1.7v]: https://github.com/rust-lang/rust/pull/29973
8262 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8263 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8264 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
8265 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
8266 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
8267 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
8268 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
8269 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
8270 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
8271 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
8272 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
8273 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
8274 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
8275 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
8276 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
8277 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
8278 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
8279 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
8280 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
8281 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
8282 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
8283 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
8284 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
8285 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
8286 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
8287 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
8288 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
8289 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
8290 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
8291 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
8292 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
8293 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
8294 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
8295 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
8296 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
8297 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
8298 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
8299 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
8300 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
8301 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
8302 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
8303 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
8304 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
8305 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
8306 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
8307 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
8308 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
8309 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8310 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
8311 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8312 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
8313 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
8314 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
8315 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
8316 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
8317 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
8318 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
8319 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
8320 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
8321 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
8322
8323
8324 Version 1.6.0 (2016-01-21)
8325 ==========================
8326
8327 Language
8328 --------
8329
8330 * The `#![no_std]` attribute causes a crate to not be linked to the
8331   standard library, but only the [core library][1.6co], as described
8332   in [RFC 1184]. The core library defines common types and traits but
8333   has no platform dependencies whatsoever, and is the basis for Rust
8334   software in environments that cannot support a full port of the
8335   standard library, such as operating systems. Most of the core
8336   library is now stable.
8337
8338 Libraries
8339 ---------
8340
8341 * Stabilized APIs:
8342   [`Read::read_exact`],
8343   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
8344   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
8345   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
8346   [`os::unix::fs::DirBuilderExt`],
8347   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
8348   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
8349   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
8350   [`collections::hash_map::Drain`],
8351   [`collections::hash_map::HashMap::drain`],
8352   [`collections::hash_set::Drain`],
8353   [`collections::hash_set::HashSet::drain`],
8354   [`collections::binary_heap::Drain`],
8355   [`collections::binary_heap::BinaryHeap::drain`],
8356   [`Vec::extend_from_slice`] (renamed from `push_all`),
8357   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
8358   [`RwLock::into_inner`],
8359   [`Iterator::min_by_key`] (renamed from `min_by`),
8360   [`Iterator::max_by_key`] (renamed from `max_by`).
8361 * The [core library][1.6co] is stable, as are most of its APIs.
8362 * [The `assert_eq!` macro supports arguments that don't implement
8363   `Sized`][1.6ae], such as arrays. In this way it behaves more like
8364   `assert!`.
8365 * Several timer functions that take duration in milliseconds [are
8366   deprecated in favor of those that take `Duration`][1.6ms]. These
8367   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
8368   `thread::park_timeout_ms`.
8369 * The algorithm by which `Vec` reserves additional elements was
8370   [tweaked to not allocate excessive space][1.6a] while still growing
8371   exponentially.
8372 * `From` conversions are [implemented from integers to floats][1.6f]
8373   in cases where the conversion is lossless. Thus they are not
8374   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
8375   or `f64`. They are also not implemented for `isize` and `usize`
8376   because the implementations would be platform-specific. `From` is
8377   also implemented from `f32` to `f64`.
8378 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
8379 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
8380 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
8381 * [`BinaryHeap` was refactored][1.6bh] for modest performance
8382   improvements.
8383 * Sorting slices that are already sorted [is 50% faster in some
8384   cases][1.6s].
8385
8386 Cargo
8387 -----
8388
8389 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
8390 * Cargo build scripts can specify their dependencies by emitting the
8391   [`rerun-if-changed`][1.6rr] key.
8392 * crates.io will reject publication of crates with dependencies that
8393   have a wildcard version constraint. Crates with wildcard
8394   dependencies were seen to cause a variety of problems, as described
8395   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
8396   warning.
8397 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
8398   release folder.  A variety of artifacts that Cargo failed to clean
8399   are now correctly deleted.
8400
8401 Misc
8402 ----
8403
8404 * The `unreachable_code` lint [warns when a function call's argument
8405   diverges][1.6dv].
8406 * The parser indicates [failures that may be caused by
8407   confusingly-similar Unicode characters][1.6uc]
8408 * Certain macro errors [are reported at definition time][1.6m], not
8409   expansion.
8410
8411 Compatibility Notes
8412 -------------------
8413
8414 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
8415   environment variable when locating crates. This was a pre-cargo
8416   feature for integrating with the package manager that was
8417   accidentally never removed.
8418 * [A number of bugs were fixed in the privacy checker][1.6p] that
8419   could cause previously-accepted code to break.
8420 * [Modules and unit/tuple structs may not share the same name][1.6ts].
8421 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
8422   struct pattern syntax (`Foo(..)`) can no longer be used to match
8423   unit structs. This is a warning now, but will become an error in
8424   future releases. Patterns that share the same name as a const are
8425   now an error.
8426 * A bug was fixed that causes [rustc not to apply default type
8427   parameters][1.6xc] when resolving certain method implementations of
8428   traits defined in other crates.
8429
8430 [1.6a]: https://github.com/rust-lang/rust/pull/29454
8431 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
8432 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
8433 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
8434 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
8435 [1.6co]: http://doc.rust-lang.org/core/index.html
8436 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
8437 [1.6f]: https://github.com/rust-lang/rust/pull/29129
8438 [1.6m]: https://github.com/rust-lang/rust/pull/29828
8439 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
8440 [1.6p]: https://github.com/rust-lang/rust/pull/29726
8441 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
8442 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
8443 [1.6s]: https://github.com/rust-lang/rust/pull/29675
8444 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
8445 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
8446 [1.6us]: https://github.com/rust-lang/rust/pull/29383
8447 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
8448 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
8449 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8450 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
8451 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
8452 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
8453 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
8454 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
8455 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
8456 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
8457 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
8458 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
8459 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
8460 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
8461 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
8462 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
8463 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
8464 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
8465 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
8466 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
8467 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
8468 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
8469 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
8470 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
8471 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
8472 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
8473 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
8474 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
8475 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
8476 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
8477
8478
8479 Version 1.5.0 (2015-12-10)
8480 ==========================
8481
8482 * ~700 changes, numerous bugfixes
8483
8484 Highlights
8485 ----------
8486
8487 * Stabilized APIs:
8488   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
8489   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
8490   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
8491   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
8492   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
8493   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
8494   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
8495   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
8496   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
8497   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
8498   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
8499   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
8500   [`Path::read_link`], [`Path::symlink_metadata`],
8501   [`Utf8Error::valid_up_to`], [`Vec::resize`],
8502   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
8503   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
8504   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
8505   [`slice::split_first_mut`], [`slice::split_first`],
8506   [`slice::split_last_mut`], [`slice::split_last`],
8507   [`char::from_u32_unchecked`], [`fs::canonicalize`],
8508   [`str::MatchIndices`], [`str::RMatchIndices`],
8509   [`str::match_indices`], [`str::rmatch_indices`],
8510   [`str::slice_mut_unchecked`], [`string::ParseError`].
8511 * Rust applications hosted on crates.io can be installed locally to
8512   `~/.cargo/bin` with the [`cargo install`] command. Among other
8513   things this makes it easier to augment Cargo with new subcommands:
8514   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
8515   invoked as `cargo foo`.
8516 * Crates with wildcard (`*`) dependencies will [emit warnings when
8517   published][1.5w]. In 1.6 it will no longer be possible to publish
8518   crates with wildcard dependencies.
8519
8520 Breaking Changes
8521 ----------------
8522
8523 * The rules determining when a particular lifetime must outlive
8524   a particular value (known as '[dropck]') have been [modified
8525   to not rely on parametricity][1.5p].
8526 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
8527   and `Arc`][1.5a]. Because these smart pointer types implement
8528   `Deref`, this causes breakage in cases where the interior type
8529   contains methods of the same name.
8530 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
8531   that they could drop their content. Soundness fix.
8532 * All method invocations are [properly checked][1.5wf1] for
8533   [well-formedness][1.5wf2]. Soundness fix.
8534 * Traits whose supertraits contain `Self` are [not object
8535   safe][1.5o]. Soundness fix.
8536 * Target specifications support a [`no_default_libraries`][1.5nd]
8537   setting that controls whether `-nodefaultlibs` is passed to the
8538   linker, and in turn the `is_like_windows` setting no longer affects
8539   the `-nodefaultlibs` flag.
8540 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
8541 * The `#[inline]` and `#[repr]` attributes [can only appear
8542   in valid locations][1.5at].
8543 * Native libraries linked from the local crate are [passed to
8544   the linker before native libraries from upstream crates][1.5nl].
8545 * Two rarely-used attributes, `#[no_debug]` and
8546   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
8547 * Negation of unsigned integers, which has been a warning for
8548   several releases, [is now behind a feature gate and will
8549   generate errors][1.5nu].
8550 * The parser accidentally accepted visibility modifiers on
8551   enum variants, a bug [which has been fixed][1.5ev].
8552 * [A bug was fixed that allowed `use` statements to import unstable
8553   features][1.5use].
8554
8555 Language
8556 --------
8557
8558 * When evaluating expressions at compile-time that are not
8559   compile-time constants (const-evaluating expressions in non-const
8560   contexts), incorrect code such as overlong bitshifts and arithmetic
8561   overflow will [generate a warning instead of an error][1.5ce],
8562   delaying the error until runtime. This will allow the
8563   const-evaluator to be expanded in the future backwards-compatibly.
8564 * The `improper_ctypes` lint [no longer warns about using `isize` and
8565   `usize` in FFI][1.5ict].
8566
8567 Libraries
8568 ---------
8569
8570 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
8571   invariant][1.5c].
8572 * `Default` is [implemented for mutable slices][1.5d].
8573 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
8574 * There are now `From` conversions [between floating point
8575   types][1.5f] where the conversions are lossless.
8576 * There are now `From` conversions [between integer types][1.5i] where
8577   the conversions are lossless.
8578 * [`fs::Metadata` implements `Clone`][1.5fs].
8579 * The `parse` method [accepts a leading "+" when parsing
8580   integers][1.5pi].
8581 * [`AsMut` is implemented for `Vec`][1.5am].
8582 * The `clone_from` implementations for `String` and `BinaryHeap` [have
8583   been optimized][1.5cf] and no longer rely on the default impl.
8584 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
8585   `unsafe extern "C"` function types now [implement `Clone`,
8586   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
8587   `fmt::Debug` for up to 12 arguments][1.5fp].
8588 * [Dropping `Vec`s is much faster in unoptimized builds when the
8589   element types don't implement `Drop`][1.5dv].
8590 * A bug that caused in incorrect behavior when [combining `VecDeque`
8591   with zero-sized types][1.5vdz] was resolved.
8592 * [`PartialOrd` for slices is faster][1.5po].
8593
8594 Miscellaneous
8595 -------------
8596
8597 * [Crate metadata size was reduced by 20%][1.5md].
8598 * [Improvements to code generation reduced the size of libcore by 3.3
8599   MB and rustc's memory usage by 18MB][1.5m].
8600 * [Improvements to deref translation increased performance in
8601   unoptimized builds][1.5dr].
8602 * Various errors in trait resolution [are deduplicated to only be
8603   reported once][1.5te].
8604 * Rust has preliminary [support for rumprun kernels][1.5rr].
8605 * Rust has preliminary [support for NetBSD on amd64][1.5na].
8606
8607 [1.5use]: https://github.com/rust-lang/rust/pull/28364
8608 [1.5po]: https://github.com/rust-lang/rust/pull/28436
8609 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
8610 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
8611 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
8612 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
8613 [1.5md]: https://github.com/rust-lang/rust/pull/28521
8614 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
8615 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
8616 [1.5na]: https://github.com/rust-lang/rust/pull/28543
8617 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
8618 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
8619 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
8620 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
8621 [1.5te]: https://github.com/rust-lang/rust/pull/28645
8622 [1.5at]: https://github.com/rust-lang/rust/pull/28650
8623 [1.5am]: https://github.com/rust-lang/rust/pull/28663
8624 [1.5m]: https://github.com/rust-lang/rust/pull/28778
8625 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
8626 [1.5a]: https://github.com/rust-lang/rust/pull/28811
8627 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
8628 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
8629 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
8630 [1.5i]: https://github.com/rust-lang/rust/pull/28921
8631 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
8632 [1.5f]: https://github.com/rust-lang/rust/pull/29129
8633 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
8634 [1.5s]: https://github.com/rust-lang/rust/pull/29190
8635 [1.5d]: https://github.com/rust-lang/rust/pull/29245
8636 [1.5o]: https://github.com/rust-lang/rust/pull/29259
8637 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
8638 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8639 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
8640 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
8641 [1.5c]: https://github.com/rust-lang/rust/pull/29110
8642 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8643 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
8644 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
8645 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
8646 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
8647 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
8648 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
8649 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
8650 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
8651 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
8652 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
8653 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
8654 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
8655 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
8656 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
8657 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
8658 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
8659 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
8660 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
8661 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
8662 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
8663 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
8664 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
8665 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
8666 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
8667 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
8668 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
8669 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
8670 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
8671 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
8672 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
8673 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
8674 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
8675 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
8676 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
8677 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
8678 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
8679 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
8680 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
8681 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
8682 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
8683 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
8684 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
8685 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
8686 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
8687 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
8688 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
8689 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
8690 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
8691 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
8692 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
8693 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
8694 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
8695 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
8696
8697 Version 1.4.0 (2015-10-29)
8698 ==========================
8699
8700 * ~1200 changes, numerous bugfixes
8701
8702 Highlights
8703 ----------
8704
8705 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
8706   GNU) are now supported and recommended for use.
8707
8708 Breaking Changes
8709 ----------------
8710
8711 * [Several changes have been made to fix type soundness and improve
8712   the behavior of associated types][sound]. See [RFC 1214]. Although
8713   we have mostly introduced these changes as warnings this release, to
8714   become errors next release, there are still some scenarios that will
8715   see immediate breakage.
8716 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
8717   line breaks in addition to `\n`][crlf].
8718 * [Loans of `'static` lifetime extend to the end of a function][stat].
8719 * [`str::parse` no longer introduces avoidable rounding error when
8720   parsing floating point numbers. Together with earlier changes to
8721   float formatting/output, "round trips" like f.to_string().parse()
8722   now preserve the value of f exactly. Additionally, leading plus
8723   signs are now accepted][fp3].
8724
8725
8726 Language
8727 --------
8728
8729 * `use` statements that import multiple items [can now rename
8730   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
8731 * [Binops work correctly on fat pointers][binfat].
8732 * `pub extern crate`, which does not behave as expected, [issues a
8733   warning][pec] until a better solution is found.
8734
8735 Libraries
8736 ---------
8737
8738 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
8739   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
8740   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
8741   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
8742   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
8743   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
8744   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
8745   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
8746   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
8747   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
8748   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
8749   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
8750   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
8751   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
8752   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
8753   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
8754   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
8755   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
8756   [`thread::sleep`].
8757 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
8758   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
8759   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
8760   `f64::from_str_radix`.
8761 * [Reverse-searching strings is faster with the 'two-way'
8762   algorithm][s].
8763 * [`std::io::copy` allows `?Sized` arguments][cc].
8764 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
8765   [override `count`, `nth` and `last` with an *O*(1)
8766   implementation][it].
8767 * [`Default` is implemented for arrays up to `[T; 32]`][d].
8768 * [`IntoRawFd` has been added to the Unix-specific prelude,
8769   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
8770   prelude][pr].
8771 * [`Extend<String>` and `FromIterator<String` are both implemented for
8772   `String`][es].
8773 * [`IntoIterator` is implemented for references to `Option` and
8774   `Result`][into2].
8775 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
8776   Copy`][ext] as part of [RFC 839]. This will cause type inference
8777   breakage in rare situations.
8778 * [`BinaryHeap` implements `Debug`][bh2].
8779 * [`Borrow` and `BorrowMut` are implemented for fixed-size
8780   arrays][bm].
8781 * [`extern fn`s with the "Rust" and "C" ABIs implement common
8782   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
8783 * [String comparison is faster][faststr].
8784 * `&mut T` where `T: std::fmt::Write` [also implements
8785   `std::fmt::Write`][mutw].
8786 * [A stable regression in `VecDeque::push_back` and other
8787   capacity-altering methods that caused panics for zero-sized types
8788   was fixed][vd].
8789 * [Function pointers implement traits for up to 12 parameters][fp2].
8790
8791 Miscellaneous
8792 -------------
8793
8794 * The compiler [no longer uses the 'morestack' feature to prevent
8795   stack overflow][mm]. Instead it uses guard pages and stack
8796   probes (though stack probes are not yet implemented on any platform
8797   but Windows).
8798 * [The compiler matches traits faster when projections are involved][p].
8799 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
8800   `usize`][ffi].
8801 * [Cargo now displays useful information about what its doing during
8802   `cargo update`][cu].
8803
8804 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
8805 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
8806 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
8807 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
8808 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
8809 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
8810 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
8811 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
8812 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
8813 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
8814 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
8815 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
8816 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
8817 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
8818 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
8819 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
8820 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
8821 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
8822 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8823 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8824 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8825 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8826 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8827 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8828 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8829 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8830 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
8831 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
8832 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
8833 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
8834 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
8835 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
8836 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
8837 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
8838 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
8839 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
8840 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
8841 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
8842 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
8843 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
8844 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
8845 [bh2]: https://github.com/rust-lang/rust/pull/28156
8846 [binfat]: https://github.com/rust-lang/rust/pull/28270
8847 [bm]: https://github.com/rust-lang/rust/pull/28197
8848 [cc]: https://github.com/rust-lang/rust/pull/27531
8849 [crlf]: https://github.com/rust-lang/rust/pull/28034
8850 [cu]: https://github.com/rust-lang/cargo/pull/1931
8851 [d]: https://github.com/rust-lang/rust/pull/27825
8852 [dep]: https://github.com/rust-lang/rust/pull/28339
8853 [es]: https://github.com/rust-lang/rust/pull/27956
8854 [ext]: https://github.com/rust-lang/rust/pull/28094
8855 [faststr]: https://github.com/rust-lang/rust/pull/28338
8856 [ffi]: https://github.com/rust-lang/rust/pull/28779
8857 [fp]: https://github.com/rust-lang/rust/pull/28268
8858 [fp2]: https://github.com/rust-lang/rust/pull/28560
8859 [fp3]: https://github.com/rust-lang/rust/pull/27307
8860 [i]: https://github.com/rust-lang/rust/pull/27451
8861 [into2]: https://github.com/rust-lang/rust/pull/28039
8862 [it]: https://github.com/rust-lang/rust/pull/27652
8863 [mm]: https://github.com/rust-lang/rust/pull/27338
8864 [mutw]: https://github.com/rust-lang/rust/pull/28368
8865 [sound]: https://github.com/rust-lang/rust/pull/27641
8866 [p]: https://github.com/rust-lang/rust/pull/27866
8867 [pec]: https://github.com/rust-lang/rust/pull/28486
8868 [pr]: https://github.com/rust-lang/rust/pull/27896
8869 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8870 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8871 [s]: https://github.com/rust-lang/rust/pull/27474
8872 [stab]: https://github.com/rust-lang/rust/pull/28339
8873 [stat]: https://github.com/rust-lang/rust/pull/28321
8874 [vd]: https://github.com/rust-lang/rust/pull/28494
8875
8876 Version 1.3.0 (2015-09-17)
8877 ==============================
8878
8879 * ~900 changes, numerous bugfixes
8880
8881 Highlights
8882 ----------
8883
8884 * The [new object lifetime defaults][nold] have been [turned
8885   on][nold2] after a cycle of warnings about the change. Now types
8886   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
8887   being interpreted as `&'a Box<Trait+'a>` to `&'a
8888   Box<Trait+'static>`.
8889 * [The Rustonomicon][nom] is a new book in the official documentation
8890   that dives into writing unsafe Rust.
8891 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
8892   timekeeping is employed by other std APIs, as well as out-of-tree
8893   time crates.
8894
8895 Breaking Changes
8896 ----------------
8897
8898 * The [new object lifetime defaults][nold] have been [turned
8899   on][nold2] after a cycle of warnings about the change.
8900 * There is a known [regression][lr] in how object lifetime elision is
8901   interpreted, the proper solution for which is undetermined.
8902 * The `#[prelude_import]` attribute, an internal implementation
8903   detail, was accidentally stabilized previously. [It has been put
8904   behind the `prelude_import` feature gate][pi]. This change is
8905   believed to break no existing code.
8906 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8907   [more sane for dynamically sized types][dst3]. Code that relied on
8908   the previous behavior is thought to be broken.
8909 * The `dropck` rules, which checks that destructors can't access
8910   destroyed values, [have been updated][dropck] to match the
8911   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
8912   cause some previously-compiling code to no longer build.
8913
8914 Language
8915 --------
8916
8917 * The [new object lifetime defaults][nold] have been [turned
8918   on][nold2] after a cycle of warnings about the change.
8919 * Semicolons may [now follow types and paths in
8920   macros](https://github.com/rust-lang/rust/pull/27000).
8921 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8922   [more sane for dynamically sized types][dst3]. Code that relied on
8923   the previous behavior is not known to exist, and suspected to be
8924   broken.
8925 * `'static` variables [may now be recursive][st].
8926 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
8927   implementations correctly.
8928 * The `dropck` rules, which checks that destructors can't access
8929   destroyed values, [have been updated][dropck] to match the
8930   [RFC][dropckrfc].
8931
8932 Libraries
8933 ---------
8934
8935 * The [`Duration`] API, [has been stabilized][ds], as well as the
8936   `std::time` module, which presently contains only `Duration`.
8937 * `Box<str>` and `Box<[T]>` both implement `Clone`.
8938 * The owned C string, [`CString`], implements [`Borrow`] and the
8939   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
8940   these allow C strings to be borrowed and cloned in generic code.
8941 * [`CStr`] implements [`Debug`].
8942 * [`AtomicPtr`] implements [`Debug`].
8943 * [`Error`] trait objects [can be downcast to their concrete types][e]
8944   in many common configurations, using the [`is`], [`downcast`],
8945   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
8946   [`Any`] trait.
8947 * Searching for substrings now [employs the two-way algorithm][search]
8948   instead of doing a naive search. This gives major speedups to a
8949   number of methods, including [`contains`][sc], [`find`][sf],
8950   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
8951   [`ends_with`][sew] are also faster.
8952 * The performance of `PartialEq` for slices is [much faster][ps].
8953 * The [`Hash`] trait offers the default method, [`hash_slice`], which
8954   is overridden and optimized by the implementations for scalars.
8955 * The [`Hasher`] trait now has a number of specialized `write_*`
8956   methods for primitive types, for efficiency.
8957 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
8958   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
8959   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
8960   of [`std::error::Error::cause`][iec] also delegates to the inner
8961   error.
8962 * [`process::Child`][pc] gained the [`id`] method, which returns a
8963   `u32` representing the platform-specific process identifier.
8964 * The [`connect`] method on slices is deprecated, replaced by the new
8965   [`join`] method (note that both of these are on the *unstable*
8966   [`SliceConcatExt`] trait, but through the magic of the prelude are
8967   available to stable code anyway).
8968 * The [`Div`] operator is implemented for [`Wrapping`] types.
8969 * [`DerefMut` is implemented for `String`][dms].
8970 * Performance of SipHash (the default hasher for `HashMap`) is
8971   [better for long data][sh].
8972 * [`AtomicPtr`] implements [`Send`].
8973 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
8974   are now [specialized to use uninitialized buffers for increased
8975   performance][rte].
8976 * Lifetime parameters of foreign functions [are now resolved
8977   properly][f].
8978
8979 Misc
8980 ----
8981
8982 * Rust can now, with some coercion, [produce programs that run on
8983   Windows XP][xp], though XP is not considered a supported platform.
8984 * Porting Rust on Windows from the GNU toolchain to MSVC continues
8985   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
8986   recommended for use in 1.3, though should be fully-functional
8987   in the [64-bit 1.4 beta][b14].
8988 * On Fedora-based systems installation will [properly configure the
8989   dynamic linker][fl].
8990 * The compiler gained many new extended error descriptions, which can
8991   be accessed with the `--explain` flag.
8992 * The `dropck` pass, which checks that destructors can't access
8993   destroyed values, [has been rewritten][dropck]. This fixes some
8994   soundness holes, and as such will cause some previously-compiling
8995   code to no longer build.
8996 * `rustc` now uses [LLVM to write archive files where possible][ar].
8997   Eventually this will eliminate the compiler's dependency on the ar
8998   utility.
8999 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
9000   supported FreeBSD on x86_64).
9001 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
9002   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
9003   more strict.
9004 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
9005   will kill the process instead of leaking][nlp].
9006
9007 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
9008 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
9009 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
9010 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
9011 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
9012 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
9013 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
9014 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
9015 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
9016 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
9017 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
9018 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
9019 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
9020 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
9021 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
9022 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
9023 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
9024 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
9025 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
9026 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
9027 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
9028 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
9029 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
9030 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
9031 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
9032 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
9033 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
9034 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
9035 [ar]: https://github.com/rust-lang/rust/pull/26926
9036 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
9037 [dms]: https://github.com/rust-lang/rust/pull/26241
9038 [dropck]: https://github.com/rust-lang/rust/pull/27261
9039 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
9040 [ds]: https://github.com/rust-lang/rust/pull/26818
9041 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
9042 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
9043 [dst3]: https://github.com/rust-lang/rust/pull/27351
9044 [e]: https://github.com/rust-lang/rust/pull/24793
9045 [f]: https://github.com/rust-lang/rust/pull/26588
9046 [fb]: https://github.com/rust-lang/rust/pull/26959
9047 [fl]: https://github.com/rust-lang/rust-installer/pull/41
9048 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
9049 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
9050 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
9051 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
9052 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
9053 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
9054 [lic]: https://github.com/rust-lang/rust/pull/26583
9055 [lnu]: https://github.com/rust-lang/rust/pull/27026
9056 [lr]: https://github.com/rust-lang/rust/issues/27248
9057 [lum]: https://github.com/rust-lang/rust/pull/26378
9058 [lur]: https://github.com/rust-lang/rust/pull/26783
9059 [nlp]: https://github.com/rust-lang/rust/pull/27176
9060 [nold2]: https://github.com/rust-lang/rust/pull/27045
9061 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
9062 [nom]: http://doc.rust-lang.org/nightly/nomicon/
9063 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
9064 [pi]: https://github.com/rust-lang/rust/pull/26699
9065 [ps]: https://github.com/rust-lang/rust/pull/26884
9066 [rte]: https://github.com/rust-lang/rust/pull/26950
9067 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
9068 [search]: https://github.com/rust-lang/rust/pull/26327
9069 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
9070 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
9071 [sh]: https://github.com/rust-lang/rust/pull/27280
9072 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
9073 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
9074 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
9075 [st]: https://github.com/rust-lang/rust/pull/26630
9076 [win1]: https://github.com/rust-lang/rust/pull/26569
9077 [win2]: https://github.com/rust-lang/rust/pull/26741
9078 [win3]: https://github.com/rust-lang/rust/pull/26741
9079 [win4]: https://github.com/rust-lang/rust/pull/27210
9080 [xp]: https://github.com/rust-lang/rust/pull/26569
9081
9082 Version 1.2.0 (2015-08-07)
9083 ==========================
9084
9085 * ~1200 changes, numerous bugfixes
9086
9087 Highlights
9088 ----------
9089
9090 * [Dynamically-sized-type coercions][dst] allow smart pointer types
9091   like `Rc` to contain types without a fixed size, arrays and trait
9092   objects, finally enabling use of `Rc<[T]>` and completing the
9093   implementation of DST.
9094 * [Parallel codegen][parcodegen] is now working again, which can
9095   substantially speed up large builds in debug mode; It also gets
9096   another ~33% speedup when bootstrapping on a 4 core machine (using 8
9097   jobs). It's not enabled by default, but will be "in the near
9098   future". It can be activated with the `-C codegen-units=N` flag to
9099   `rustc`.
9100 * This is the first release with [experimental support for linking
9101   with the MSVC linker and lib C on Windows (instead of using the GNU
9102   variants via MinGW)][win]. It is yet recommended only for the most
9103   intrepid Rustaceans.
9104 * Benchmark compilations are showing a 30% improvement in
9105   bootstrapping over 1.1.
9106
9107 Breaking Changes
9108 ----------------
9109
9110 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
9111   unicode case mapping, which is a previously-planned change in
9112   behavior and considered a bugfix.
9113 * [`mem::align_of`] now specifies [the *minimum alignment* for
9114   T][align], which is usually the alignment programs are interested
9115   in, and the same value reported by clang's
9116   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
9117   break real code.
9118 * [The `#[packed]` attribute is no longer silently accepted by the
9119   compiler][packed]. This attribute did nothing and code that
9120   mentioned it likely did not work as intended.
9121 * Associated type defaults are [now behind the
9122   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
9123   defaults *did not work*, but could be mentioned syntactically. As
9124   such this breakage has minimal impact.
9125
9126 Language
9127 --------
9128
9129 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
9130   matching against dereferenceable values.
9131
9132 Libraries
9133 ---------
9134
9135 * The [`Extend`] trait, which grows a collection from an iterator, is
9136   implemented over iterators of references, for `String`, `Vec`,
9137   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
9138   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
9139 * The [`iter::once`] function returns an iterator that yields a single
9140   element, and [`iter::empty`] returns an iterator that yields no
9141   elements.
9142 * The [`matches`] and [`rmatches`] methods on `str` return iterators
9143   over substring matches.
9144 * [`Cell`] and [`RefCell`] both implement `Eq`.
9145 * A number of methods for wrapping arithmetic are added to the
9146   integral types, [`wrapping_div`], [`wrapping_rem`],
9147   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
9148   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
9149   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
9150   type.. It is illegal for the default arithmetic operations in Rust
9151   to overflow; the desire to wrap must be explicit.
9152 * The `{:#?}` formatting specifier [displays the alternate,
9153   pretty-printed][debugfmt] form of the `Debug` formatter. This
9154   feature was actually introduced prior to 1.0 with little
9155   fanfare.
9156 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
9157   for writing data to formatted strings, similar to [`io::Write`].
9158 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
9159   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
9160   are used by code generators to emit implementations of [`Debug`].
9161 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
9162   methods that convert case, following Unicode case mapping.
9163 * It is now easier to handle poisoned locks. The [`PoisonError`]
9164   type, returned by failing lock operations, exposes `into_inner`,
9165   `get_ref`, and `get_mut`, which all give access to the inner lock
9166   guard, and allow the poisoned lock to continue to operate. The
9167   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
9168   poisoned lock without attempting to take the lock.
9169 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
9170   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
9171   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
9172   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
9173   `ChildStderr`.
9174 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
9175   malformed input.
9176
9177 Misc
9178 ----
9179
9180 * `rustc` employs smarter heuristics for guessing at [typos].
9181 * `rustc` emits more efficient code for [no-op conversions between
9182   unsafe pointers][nop].
9183 * Fat pointers are now [passed in pairs of immediate arguments][fat],
9184   resulting in faster compile times and smaller code.
9185
9186 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
9187 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
9188 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
9189 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
9190 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
9191 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
9192 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
9193 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
9194 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
9195 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
9196 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
9197 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
9198 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
9199 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
9200 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
9201 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
9202 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
9203 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
9204 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
9205 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
9206 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
9207 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
9208 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
9209 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
9210 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
9211 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
9212 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
9213 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
9214 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
9215 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
9216 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
9217 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
9218 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
9219 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9220 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9221 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
9222 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
9223 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
9224 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
9225 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
9226 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
9227 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
9228 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
9229 [align]: https://github.com/rust-lang/rust/pull/25646
9230 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
9231 [typos]: https://github.com/rust-lang/rust/pull/26087
9232 [nop]: https://github.com/rust-lang/rust/pull/26336
9233 [fat]: https://github.com/rust-lang/rust/pull/26411
9234 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
9235 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
9236 [packed]: https://github.com/rust-lang/rust/pull/25541
9237 [ad]: https://github.com/rust-lang/rust/pull/27382
9238 [win]: https://github.com/rust-lang/rust/pull/25350
9239
9240 Version 1.1.0 (2015-06-25)
9241 =========================
9242
9243 * ~850 changes, numerous bugfixes
9244
9245 Highlights
9246 ----------
9247
9248 * The [`std::fs` module has been expanded][fs] to expand the set of
9249   functionality exposed:
9250   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
9251     don't incur a syscall on some platforms.
9252   * A `symlink_metadata` function has been added.
9253   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
9254     access to all underlying information.
9255 * The compiler now contains extended explanations of many errors. When an error
9256   with an explanation occurs the compiler suggests using the `--explain` flag
9257   to read the explanation. Error explanations are also [available online][err-index].
9258 * Thanks to multiple [improvements][sk] to [type checking][pre], as
9259   well as other work, the time to bootstrap the compiler decreased by
9260   32%.
9261
9262 Libraries
9263 ---------
9264
9265 * The [`str::split_whitespace`] method splits a string on unicode
9266   whitespace boundaries.
9267 * On both Windows and Unix, new extension traits provide conversion of
9268   I/O types to and from the underlying system handles. On Unix, these
9269   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
9270   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
9271   `TcpListener`, and `UpdSocket`. Further implementations for
9272   `std::process` will be stabilized later.
9273 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
9274   Windows, symlinks can be created with
9275   `std::os::windows::symlink_dir` and
9276   `std::os::windows::symlink_file`.
9277 * The `mpsc::Receiver` type can now be converted into an iterator with
9278   `into_iter` on the [`IntoIterator`] trait.
9279 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
9280   implementation of the [`From`] trait.
9281 * The `Debug` implementation for `RangeFull` [creates output that is
9282   more consistent with other implementations][rf].
9283 * [`Debug` is implemented for `File`][file].
9284 * The `Default` implementation for `Arc` [no longer requires `Sync +
9285   Send`][arc].
9286 * [The `Iterator` methods `count`, `nth`, and `last` have been
9287   overridden for slices to have *O*(1) performance instead of *O*(*n*)][si].
9288 * Incorrect handling of paths on Windows has been improved in both the
9289   compiler and the standard library.
9290 * [`AtomicPtr` gained a `Default` implementation][ap].
9291 * In accordance with Rust's policy on arithmetic overflow `abs` now
9292   [panics on overflow when debug assertions are enabled][abs].
9293 * The [`Cloned`] iterator, which was accidentally left unstable for
9294   1.0 [has been stabilized][c].
9295 * The [`Incoming`] iterator, which iterates over incoming TCP
9296   connections, and which was accidentally unnamable in 1.0, [is now
9297   properly exported][inc].
9298 * [`BinaryHeap`] no longer corrupts itself [when functions called by
9299   `sift_up` or `sift_down` panic][bh].
9300 * The [`split_off`] method of `LinkedList` [no longer corrupts
9301   the list in certain scenarios][ll].
9302
9303 Misc
9304 ----
9305
9306 * Type checking performance [has improved notably][sk] with
9307   [multiple improvements][pre].
9308 * The compiler [suggests code changes][ch] for more errors.
9309 * rustc and it's build system have experimental support for [building
9310   toolchains against MUSL][m] instead of glibc on Linux.
9311 * The compiler defines the `target_env` cfg value, which is used for
9312   distinguishing toolchains that are otherwise for the same
9313   platform. Presently this is set to `gnu` for common GNU Linux
9314   targets and for MinGW targets, and `musl` for MUSL Linux targets.
9315 * The [`cargo rustc`][crc] command invokes a build with custom flags
9316   to rustc.
9317 * [Android executables are always position independent][pie].
9318 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
9319   with `Drop`][drop].
9320
9321 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
9322 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9323 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9324 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
9325 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
9326 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
9327 [rf]: https://github.com/rust-lang/rust/pull/24491
9328 [err-index]: https://doc.rust-lang.org/error-index.html
9329 [sk]: https://github.com/rust-lang/rust/pull/24615
9330 [pre]: https://github.com/rust-lang/rust/pull/25323
9331 [file]: https://github.com/rust-lang/rust/pull/24598
9332 [ch]: https://github.com/rust-lang/rust/pull/24683
9333 [arc]: https://github.com/rust-lang/rust/pull/24695
9334 [si]: https://github.com/rust-lang/rust/pull/24701
9335 [ap]: https://github.com/rust-lang/rust/pull/24834
9336 [m]: https://github.com/rust-lang/rust/pull/24777
9337 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
9338 [crc]: https://github.com/rust-lang/cargo/pull/1568
9339 [pie]: https://github.com/rust-lang/rust/pull/24953
9340 [abs]: https://github.com/rust-lang/rust/pull/25441
9341 [c]: https://github.com/rust-lang/rust/pull/25496
9342 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
9343 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
9344 [inc]: https://github.com/rust-lang/rust/pull/25522
9345 [bh]: https://github.com/rust-lang/rust/pull/25856
9346 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
9347 [ll]: https://github.com/rust-lang/rust/pull/26022
9348 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
9349 [drop]: https://github.com/rust-lang/rust/pull/24935
9350
9351 Version 1.0.0 (2015-05-15)
9352 ========================
9353
9354 * ~1500 changes, numerous bugfixes
9355
9356 Highlights
9357 ----------
9358
9359 * The vast majority of the standard library is now `#[stable]`. It is
9360   no longer possible to use unstable features with a stable build of
9361   the compiler.
9362 * Many popular crates on [crates.io] now work on the stable release
9363   channel.
9364 * Arithmetic on basic integer types now [checks for overflow in debug
9365   builds][overflow].
9366
9367 Language
9368 --------
9369
9370 * Several [restrictions have been added to trait coherence][coh] in
9371   order to make it easier for upstream authors to change traits
9372   without breaking downstream code.
9373 * Digits of binary and octal literals are [lexed more eagerly][lex] to
9374   improve error messages and macro behavior. For example, `0b1234` is
9375   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
9376 * Trait bounds [are always invariant][inv], eliminating the need for
9377   the `PhantomFn` and `MarkerTrait` lang items, which have been
9378   removed.
9379 * ["-" is no longer a valid character in crate names][cr], the `extern crate
9380   "foo" as bar` syntax has been replaced with `extern crate foo as
9381   bar`, and Cargo now automatically translates "-" in *package* names
9382   to underscore for the crate name.
9383 * [Lifetime shadowing is an error][lt].
9384 * [`Send` no longer implies `'static`][send-rfc].
9385 * [UFCS now supports trait-less associated paths][moar-ufcs] like
9386   `MyType::default()`.
9387 * Primitive types [now have inherent methods][prim-inherent],
9388   obviating the need for extension traits like `SliceExt`.
9389 * Methods with `Self: Sized` in their `where` clause are [considered
9390   object-safe][self-sized], allowing many extension traits like
9391   `IteratorExt` to be merged into the traits they extended.
9392 * You can now [refer to associated types][assoc-where] whose
9393   corresponding trait bounds appear only in a `where` clause.
9394 * The final bits of [OIBIT landed][oibit-final], meaning that traits
9395   like `Send` and `Sync` are now library-defined.
9396 * A [Reflect trait][reflect] was introduced, which means that
9397   downcasting via the `Any` trait is effectively limited to concrete
9398   types. This helps retain the potentially-important "parametricity"
9399   property: generic code cannot behave differently for different type
9400   arguments except in minor ways.
9401 * The `unsafe_destructor` feature is now deprecated in favor of the
9402   [new `dropck`][dropck]. This change is a major reduction in unsafe
9403   code.
9404
9405 Libraries
9406 ---------
9407
9408 * The `thread_local` module [has been renamed to `std::thread`][th].
9409 * The methods of `IteratorExt` [have been moved to the `Iterator`
9410   trait itself][ie].
9411 * Several traits that implement Rust's conventions for type
9412   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
9413   [centralized in the `std::convert` module][con].
9414 * The `FromError` trait [was removed in favor of `From`][fe].
9415 * The basic sleep function [has moved to
9416   `std::thread::sleep_ms`][slp].
9417 * The `splitn` function now takes an `n` parameter that represents the
9418   number of items yielded by the returned iterator [instead of the
9419   number of 'splits'][spl].
9420 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
9421 * [Derived implementations of `PartialOrd` now order enums according
9422   to their explicitly-assigned discriminants][po].
9423 * [Methods for searching strings are generic over `Pattern`s][pat],
9424   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
9425   some others.
9426 * [In method resolution, object methods are resolved before inherent
9427   methods][meth].
9428 * [`String::from_str` has been deprecated in favor of the `From` impl,
9429   `String::from`][sf].
9430 * [`io::Error` implements `Sync`][ios].
9431 * [The `words` method on `&str` has been replaced with
9432   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
9433   a word?'
9434 * The new path and IO modules are complete and `#[stable]`. This
9435   was the major library focus for this cycle.
9436 * The path API was [revised][path-normalize] to normalize `.`,
9437   adjusting the tradeoffs in favor of the most common usage.
9438 * A large number of remaining APIs in `std` were also stabilized
9439   during this cycle; about 75% of the non-deprecated API surface
9440   is now stable.
9441 * The new [string pattern API][string-pattern] landed, which makes
9442   the string slice API much more internally consistent and flexible.
9443 * A new set of [generic conversion traits][conversion] replaced
9444   many existing ad hoc traits.
9445 * Generic numeric traits were [completely removed][num-traits]. This
9446   was made possible thanks to inherent methods for primitive types,
9447   and the removal gives maximal flexibility for designing a numeric
9448   hierarchy in the future.
9449 * The `Fn` traits are now related via [inheritance][fn-inherit]
9450   and provide ergonomic [blanket implementations][fn-blanket].
9451 * The `Index` and `IndexMut` traits were changed to
9452   [take the index by value][index-value], enabling code like
9453   `hash_map["string"]` to work.
9454 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
9455   `Copy` data is known to be `Clone` as well.
9456
9457 Misc
9458 ----
9459
9460 * Many errors now have extended explanations that can be accessed with
9461   the `--explain` flag to `rustc`.
9462 * Many new examples have been added to the standard library
9463   documentation.
9464 * rustdoc has received a number of improvements focused on completion
9465   and polish.
9466 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
9467 * Much headway was made on ecosystem-wide CI, making it possible
9468   to [compare builds for breakage][ci-compare].
9469
9470
9471 [crates.io]: http://crates.io
9472 [clo]: https://github.com/rust-lang/rust/pull/24034
9473 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
9474 [con]: https://github.com/rust-lang/rust/pull/23875
9475 [cr]: https://github.com/rust-lang/rust/pull/23419
9476 [fe]: https://github.com/rust-lang/rust/pull/23879
9477 [ie]: https://github.com/rust-lang/rust/pull/23300
9478 [inv]: https://github.com/rust-lang/rust/pull/23938
9479 [ios]: https://github.com/rust-lang/rust/pull/24133
9480 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
9481 [lt]: https://github.com/rust-lang/rust/pull/24057
9482 [meth]: https://github.com/rust-lang/rust/pull/24056
9483 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
9484 [po]: https://github.com/rust-lang/rust/pull/24270
9485 [sf]: https://github.com/rust-lang/rust/pull/24517
9486 [slp]: https://github.com/rust-lang/rust/pull/23949
9487 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
9488 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
9489 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
9490 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
9491 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
9492 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
9493 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
9494 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
9495 [self-sized]: https://github.com/rust-lang/rust/pull/22301
9496 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
9497 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
9498 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
9499 [reflect]: https://github.com/rust-lang/rust/pull/23712
9500 [conversion]: https://github.com/rust-lang/rfcs/pull/529
9501 [num-traits]: https://github.com/rust-lang/rust/pull/23549
9502 [index-value]: https://github.com/rust-lang/rust/pull/23601
9503 [dropck]: https://github.com/rust-lang/rfcs/pull/769
9504 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
9505 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
9506 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
9507 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
9508 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
9509
9510
9511 Version 1.0.0-alpha.2 (2015-02-20)
9512 =====================================
9513
9514 * ~1300 changes, numerous bugfixes
9515
9516 * Highlights
9517
9518     * The various I/O modules were [overhauled][io-rfc] to reduce
9519       unnecessary abstractions and provide better interoperation with
9520       the underlying platform. The old `io` module remains temporarily
9521       at `std::old_io`.
9522     * The standard library now [participates in feature gating][feat],
9523       so use of unstable libraries now requires a `#![feature(...)]`
9524       attribute. The impact of this change is [described on the
9525       forum][feat-forum]. [RFC][feat-rfc].
9526
9527 * Language
9528
9529     * `for` loops [now operate on the `IntoIterator` trait][into],
9530       which eliminates the need to call `.iter()`, etc. to iterate
9531       over collections. There are some new subtleties to remember
9532       though regarding what sort of iterators various types yield, in
9533       particular that `for foo in bar { }` yields values from a move
9534       iterator, destroying the original collection. [RFC][into-rfc].
9535     * Objects now have [default lifetime bounds][obj], so you don't
9536       have to write `Box<Trait+'static>` when you don't care about
9537       storing references. [RFC][obj-rfc].
9538     * In types that implement `Drop`, [lifetimes must outlive the
9539       value][drop]. This will soon make it possible to safely
9540       implement `Drop` for types where `#[unsafe_destructor]` is now
9541       required. Read the [gorgeous RFC][drop-rfc] for details.
9542     * The fully qualified <T as Trait>::X syntax lets you set the Self
9543       type for a trait method or associated type. [RFC][ufcs-rfc].
9544     * References to types that implement `Deref<U>` now [automatically
9545       coerce to references][deref] to the dereferenced type `U`,
9546       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
9547       should eliminate many unsightly uses of `&*`, as when converting
9548       from references to vectors into references to
9549       slices. [RFC][deref-rfc].
9550     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
9551       `|:|`) is obsolete and closure kind is inferred from context.
9552     * [`Self` is a keyword][Self].
9553
9554 * Libraries
9555
9556     * The `Show` and `String` formatting traits [have been
9557       renamed][fmt] to `Debug` and `Display` to more clearly reflect
9558       their related purposes. Automatically getting a string
9559       conversion to use with `format!("{:?}", something_to_debug)` is
9560       now written `#[derive(Debug)]`.
9561     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
9562       OsStr}`, provide strings in platform-specific encodings for easier
9563       interop with system APIs. [RFC][osstr-rfc].
9564     * The `boxed::into_raw` and `Box::from_raw` functions [convert
9565       between `Box<T>` and `*mut T`][boxraw], a common pattern for
9566       creating raw pointers.
9567
9568 * Tooling
9569
9570     * Certain long error messages of the form 'expected foo found bar'
9571       are now [split neatly across multiple
9572       lines][multiline]. Examples in the PR.
9573     * On Unix Rust can be [uninstalled][un] by running
9574       `/usr/local/lib/rustlib/uninstall.sh`.
9575     * The `#[rustc_on_unimplemented]` attribute, requiring the
9576       'on_unimplemented' feature, lets rustc [display custom error
9577       messages when a trait is expected to be implemented for a type
9578       but is not][onun].
9579
9580 * Misc
9581
9582     * Rust is tested against a [LALR grammar][lalr], which parses
9583       almost all the Rust files that rustc does.
9584
9585 [boxraw]: https://github.com/rust-lang/rust/pull/21318
9586 [close]: https://github.com/rust-lang/rust/pull/21843
9587 [deref]: https://github.com/rust-lang/rust/pull/21351
9588 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
9589 [drop]: https://github.com/rust-lang/rust/pull/21972
9590 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
9591 [feat]: https://github.com/rust-lang/rust/pull/21248
9592 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
9593 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
9594 [fmt]: https://github.com/rust-lang/rust/pull/21457
9595 [into]: https://github.com/rust-lang/rust/pull/20790
9596 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
9597 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9598 [lalr]: https://github.com/rust-lang/rust/pull/21452
9599 [multiline]: https://github.com/rust-lang/rust/pull/19870
9600 [obj]: https://github.com/rust-lang/rust/pull/22230
9601 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
9602 [onun]: https://github.com/rust-lang/rust/pull/20889
9603 [osstr]: https://github.com/rust-lang/rust/pull/21488
9604 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9605 [Self]: https://github.com/rust-lang/rust/pull/22158
9606 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
9607 [un]: https://github.com/rust-lang/rust/pull/22256
9608
9609
9610 Version 1.0.0-alpha (2015-01-09)
9611 ==================================
9612
9613   * ~2400 changes, numerous bugfixes
9614
9615   * Highlights
9616
9617     * The language itself is considered feature complete for 1.0,
9618       though there will be many usability improvements and bugfixes
9619       before the final release.
9620     * Nearly 50% of the public API surface of the standard library has
9621       been declared 'stable'. Those interfaces are unlikely to change
9622       before 1.0.
9623     * The long-running debate over integer types has been
9624       [settled][ints]: Rust will ship with types named `isize` and
9625       `usize`, rather than `int` and `uint`, for pointer-sized
9626       integers. Guidelines will be rolled out during the alpha cycle.
9627     * Most crates that are not `std` have been moved out of the Rust
9628       distribution into the Cargo ecosystem so they can evolve
9629       separately and don't need to be stabilized as quickly, including
9630       'time', 'getopts', 'num', 'regex', and 'term'.
9631     * Documentation continues to be expanded with more API coverage, more
9632       examples, and more in-depth explanations. The guides have been
9633       consolidated into [The Rust Programming Language][trpl].
9634     * "[Rust By Example][rbe]" is now maintained by the Rust team.
9635     * All official Rust binary installers now come with [Cargo], the
9636       Rust package manager.
9637
9638 * Language
9639
9640     * Closures have been [completely redesigned][unboxed] to be
9641       implemented in terms of traits, can now be used as generic type
9642       bounds and thus monomorphized and inlined, or via an opaque
9643       pointer (boxed) as in the old system. The new system is often
9644       referred to as 'unboxed' closures.
9645     * Traits now support [associated types][assoc], allowing families
9646       of related types to be defined together and used generically in
9647       powerful ways.
9648     * Enum variants are [namespaced by their type names][enum].
9649     * [`where` clauses][where] provide a more versatile and attractive
9650       syntax for specifying generic bounds, though the previous syntax
9651       remains valid.
9652     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
9653       numeric types.
9654     * Rust [no longer has a runtime][rt] of any description, and only
9655       supports OS threads, not green threads.
9656     * At long last, Rust has been overhauled for 'dynamically-sized
9657       types' ([DST]), which integrates 'fat pointers' (object types,
9658       arrays, and `str`) more deeply into the type system, making it
9659       more consistent.
9660     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
9661       `..j` that produce range types and which, when combined with the
9662       `Index` operator and multidispatch, leads to a convenient slice
9663       notation, `[i..j]`.
9664     * The new range syntax revealed an ambiguity in the fixed-length
9665       array syntax, so now fixed length arrays [are written `[T;
9666       N]`][arrays].
9667     * The `Copy` trait is no longer implemented automatically. Unsafe
9668       pointers no longer implement `Sync` and `Send` so types
9669       containing them don't automatically either. `Sync` and `Send`
9670       are now 'unsafe traits' so one can "forcibly" implement them via
9671       `unsafe impl` if a type confirms to the requirements for them
9672       even though the internals do not (e.g. structs containing unsafe
9673       pointers like `Arc`). These changes are intended to prevent some
9674       footguns and are collectively known as [opt-in built-in
9675       traits][oibit] (though `Sync` and `Send` will soon become pure
9676       library types unknown to the compiler).
9677     * Operator traits now take their operands [by value][ops], and
9678       comparison traits can use multidispatch to compare one type
9679       against multiple other types, allowing e.g. `String` to be
9680       compared with `&str`.
9681     * `if let` and `while let` are no longer feature-gated.
9682     * Rust has adopted a more [uniform syntax for escaping unicode
9683       characters][unicode].
9684     * `macro_rules!` [has been declared stable][mac]. Though it is a
9685       flawed system it is sufficiently popular that it must be usable
9686       for 1.0. Effort has gone into [future-proofing][mac-future] it
9687       in ways that will allow other macro systems to be developed in
9688       parallel, and won't otherwise impact the evolution of the
9689       language.
9690     * The prelude has been [pared back significantly][prelude] such
9691       that it is the minimum necessary to support the most pervasive
9692       code patterns, and through [generalized where clauses][where]
9693       many of the prelude extension traits have been consolidated.
9694     * Rust's rudimentary reflection [has been removed][refl], as it
9695       incurred too much code generation for little benefit.
9696     * [Struct variants][structvars] are no longer feature-gated.
9697     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
9698       known as 'higher-ranked trait bounds', this crucially allows
9699       unboxed closures to work.
9700     * Macros invocations surrounded by parens or square brackets and
9701       not terminated by a semicolon are [parsed as
9702       expressions][macros], which makes expressions like `vec![1i32,
9703       2, 3].len()` work as expected.
9704     * Trait objects now implement their traits automatically, and
9705       traits that can be coerced to objects now must be [object
9706       safe][objsafe].
9707     * Automatically deriving traits is now done with `#[derive(...)]`
9708       not `#[deriving(...)]` for [consistency with other naming
9709       conventions][derive].
9710     * Importing the containing module or enum at the same time as
9711       items or variants they contain is [now done with `self` instead
9712       of `mod`][self], as in use `foo::{self, bar}`
9713     * Glob imports are no longer feature-gated.
9714     * The `box` operator and `box` patterns have been feature-gated
9715       pending a redesign. For now unique boxes should be allocated
9716       like other containers, with `Box::new`.
9717
9718 * Libraries
9719
9720     * A [series][coll1] of [efforts][coll2] to establish
9721       [conventions][coll3] for collections types has resulted in API
9722       improvements throughout the standard library.
9723     * New [APIs for error handling][err] provide ergonomic interop
9724       between error types, and [new conventions][err-conv] describe
9725       more clearly the recommended error handling strategies in Rust.
9726     * The `fail!` macro has been renamed to [`panic!`][panic] so that
9727       it is easier to discuss failure in the context of error handling
9728       without making clarifications as to whether you are referring to
9729       the 'fail' macro or failure more generally.
9730     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
9731       syscall when available.
9732     * The 'serialize' crate has been renamed 'rustc-serialize' and
9733       moved out of the distribution to Cargo. Although it is widely
9734       used now, it is expected to be superseded in the near future.
9735     * The `Show` formatter, typically implemented with
9736       `#[derive(Show)]` is [now requested with the `{:?}`
9737       specifier][show] and is intended for use by all types, for uses
9738       such as `println!` debugging. The new `String` formatter must be
9739       implemented by hand, uses the `{}` specifier, and is intended
9740       for full-fidelity conversions of things that can logically be
9741       represented as strings.
9742
9743 * Tooling
9744
9745     * [Flexible target specification][flex] allows rustc's code
9746       generation to be configured to support otherwise-unsupported
9747       platforms.
9748     * Rust comes with rust-gdb and rust-lldb scripts that launch their
9749       respective debuggers with Rust-appropriate pretty-printing.
9750     * The Windows installation of Rust is distributed with the
9751       MinGW components currently required to link binaries on that
9752       platform.
9753
9754 * Misc
9755
9756     * Nullable enum optimizations have been extended to more types so
9757       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
9758       space than the inner types themselves.
9759     * Work has begun on supporting AArch64.
9760
9761 [Cargo]: https://crates.io
9762 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
9763 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
9764 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
9765 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
9766 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
9767 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
9768 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
9769 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
9770 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
9771 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
9772 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
9773 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
9774 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
9775 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
9776 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
9777 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
9778 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
9779 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
9780 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
9781 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
9782 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
9783 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
9784 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
9785 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
9786 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
9787 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
9788 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
9789 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
9790 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
9791 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
9792 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
9793 [trpl]: https://doc.rust-lang.org/book/index.html
9794 [rbe]: http://rustbyexample.com/
9795
9796
9797 Version 0.12.0 (2014-10-09)
9798 =============================
9799
9800   * ~1900 changes, numerous bugfixes
9801
9802   * Highlights
9803
9804     * The introductory documentation (now called The Rust Guide) has
9805       been completely rewritten, as have a number of supplementary
9806       guides.
9807     * Rust's package manager, Cargo, continues to improve and is
9808       sometimes considered to be quite awesome.
9809     * Many API's in `std` have been reviewed and updated for
9810       consistency with the in-development Rust coding
9811       guidelines. The standard library documentation tracks
9812       stabilization progress.
9813     * Minor libraries have been moved out-of-tree to the rust-lang org
9814       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
9815       be installed with Cargo.
9816     * Lifetime elision allows lifetime annotations to be left off of
9817       function declarations in many common scenarios.
9818     * Rust now works on 64-bit Windows.
9819
9820   * Language
9821     * Indexing can be overloaded with the `Index` and `IndexMut`
9822       traits.
9823     * The `if let` construct takes a branch only if the `let` pattern
9824       matches, currently behind the 'if_let' feature gate.
9825     * 'where clauses', a more flexible syntax for specifying trait
9826       bounds that is more aesthetic, have been added for traits and
9827       free functions. Where clauses will in the future make it
9828       possible to constrain associated types, which would be
9829       impossible with the existing syntax.
9830     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
9831       the 'slicing_syntax' feature gate, and can be overloaded with
9832       the `Slice` or `SliceMut` traits.
9833     * The syntax for matching of sub-slices has been changed to use a
9834       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
9835       consistency with other uses of `..` and to future-proof
9836       potential additional uses of the syntax.
9837     * The syntax for matching inclusive ranges in patterns has changed
9838       from `0..3` to `0...4` to be consistent with the exclusive range
9839       syntax for slicing.
9840     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
9841       c]`) has been put behind the 'advanced_slice_patterns' feature
9842       gate and may be removed in the future.
9843     * Components of tuples and tuple structs can be extracted using
9844       the `value.0` syntax, currently behind the `tuple_indexing`
9845       feature gate.
9846     * The `#[crate_id]` attribute is no longer supported; versioning
9847       is handled by the package manager.
9848     * Renaming crate imports are now written `extern crate foo as bar`
9849       instead of `extern crate bar = foo`.
9850     * Renaming use statements are now written `use foo as bar` instead
9851       of `use bar = foo`.
9852     * `let` and `match` bindings and argument names in macros are now
9853       hygienic.
9854     * The new, more efficient, closure types ('unboxed closures') have
9855       been added under a feature gate, 'unboxed_closures'. These will
9856       soon replace the existing closure types, once higher-ranked
9857       trait lifetimes are added to the language.
9858     * `move` has been added as a keyword, for indicating closures
9859       that capture by value.
9860     * Mutation and assignment is no longer allowed in pattern guards.
9861     * Generic structs and enums can now have trait bounds.
9862     * The `Share` trait is now called `Sync` to free up the term
9863       'shared' to refer to 'shared reference' (the default reference
9864       type.
9865     * Dynamically-sized types have been mostly implemented,
9866       unifying the behavior of fat-pointer types with the rest of the
9867       type system.
9868     * As part of dynamically-sized types, the `Sized` trait has been
9869       introduced, which qualifying types implement by default, and
9870       which type parameters expect by default. To specify that a type
9871       parameter does not need to be sized, write `<Sized? T>`. Most
9872       types are `Sized`, notable exceptions being unsized arrays
9873       (`[T]`) and trait types.
9874     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
9875     * Lifetime bounds can now be applied to type parameters and object
9876       types.
9877     * The old, reference counted GC type, `Gc<T>` which was once
9878       denoted by the `@` sigil, has finally been removed. GC will be
9879       revisited in the future.
9880
9881   * Libraries
9882     * Library documentation has been improved for a number of modules.
9883     * Bit-vectors, collections::bitv has been modernized.
9884     * The url crate is deprecated in favor of
9885       http://github.com/servo/rust-url, which can be installed with
9886       Cargo.
9887     * Most I/O stream types can be cloned and subsequently closed from
9888       a different thread.
9889     * A `std::time::Duration` type has been added for use in I/O
9890       methods that rely on timers, as well as in the 'time' crate's
9891       `Timespec` arithmetic.
9892     * The runtime I/O abstraction layer that enabled the green thread
9893       scheduler to do non-thread-blocking I/O has been removed, along
9894       with the libuv-based implementation employed by the green thread
9895       scheduler. This will greatly simplify the future I/O work.
9896     * `collections::btree` has been rewritten to have a more
9897       idiomatic and efficient design.
9898
9899   * Tooling
9900     * rustdoc output now indicates the stability levels of API's.
9901     * The `--crate-name` flag can specify the name of the crate
9902       being compiled, like `#[crate_name]`.
9903     * The `-C metadata` specifies additional metadata to hash into
9904       symbol names, and `-C extra-filename` specifies additional
9905       information to put into the output filename, for use by the
9906       package manager for versioning.
9907     * debug info generation has continued to improve and should be
9908       more reliable under both gdb and lldb.
9909     * rustc has experimental support for compiling in parallel
9910       using the `-C codegen-units` flag.
9911     * rustc no longer encodes rpath information into binaries by
9912       default.
9913
9914   * Misc
9915     * Stack usage has been optimized with LLVM lifetime annotations.
9916     * Official Rust binaries on Linux are more compatible with older
9917       kernels and distributions, built on CentOS 5.10.
9918
9919
9920 Version 0.11.0 (2014-07-02)
9921 ==========================
9922
9923   * ~1700 changes, numerous bugfixes
9924
9925   * Language
9926     * ~[T] has been removed from the language. This type is superseded by
9927       the Vec<T> type.
9928     * ~str has been removed from the language. This type is superseded by
9929       the String type.
9930     * ~T has been removed from the language. This type is superseded by the
9931       Box<T> type.
9932     * @T has been removed from the language. This type is superseded by the
9933       standard library's std::gc::Gc<T> type.
9934     * Struct fields are now all private by default.
9935     * Vector indices and shift amounts are both required to be a `uint`
9936       instead of any integral type.
9937     * Byte character, byte string, and raw byte string literals are now all
9938       supported by prefixing the normal literal with a `b`.
9939     * Multiple ABIs are no longer allowed in an ABI string
9940     * The syntax for lifetimes on closures/procedures has been tweaked
9941       slightly: `<'a>|A, B|: 'b + K -> T`
9942     * Floating point modulus has been removed from the language; however it
9943       is still provided by a library implementation.
9944     * Private enum variants are now disallowed.
9945     * The `priv` keyword has been removed from the language.
9946     * A closure can no longer be invoked through a &-pointer.
9947     * The `use foo, bar, baz;` syntax has been removed from the language.
9948     * The transmute intrinsic no longer works on type parameters.
9949     * Statics now allow blocks/items in their definition.
9950     * Trait bounds are separated from objects with + instead of : now.
9951     * Objects can no longer be read while they are mutably borrowed.
9952     * The address of a static is now marked as insignificant unless the
9953       #[inline(never)] attribute is placed it.
9954     * The #[unsafe_destructor] attribute is now behind a feature gate.
9955     * Struct literals are no longer allowed in ambiguous positions such as
9956       if, while, match, and for..in.
9957     * Declaration of lang items and intrinsics are now feature-gated by
9958       default.
9959     * Integral literals no longer default to `int`, and floating point
9960       literals no longer default to `f64`. Literals must be suffixed with an
9961       appropriate type if inference cannot determine the type of the
9962       literal.
9963     * The Box<T> type is no longer implicitly borrowed to &mut T.
9964     * Procedures are now required to not capture borrowed references.
9965
9966   * Libraries
9967     * The standard library is now a "facade" over a number of underlying
9968       libraries. This means that development on the standard library should
9969       be speedier due to smaller crates, as well as a clearer line between
9970       all dependencies.
9971     * A new library, libcore, lives under the standard library's facade
9972       which is Rust's "0-assumption" library, suitable for embedded and
9973       kernel development for example.
9974     * A regex crate has been added to the standard distribution. This crate
9975       includes statically compiled regular expressions.
9976     * The unwrap/unwrap_err methods on Result require a Show bound for
9977       better error messages.
9978     * The return types of the std::comm primitives have been centralized
9979       around the Result type.
9980     * A number of I/O primitives have gained the ability to time out their
9981       operations.
9982     * A number of I/O primitives have gained the ability to close their
9983       reading/writing halves to cancel pending operations.
9984     * Reverse iterator methods have been removed in favor of `rev()` on
9985       their forward-iteration counterparts.
9986     * A bitflags! macro has been added to enable easy interop with C and
9987       management of bit flags.
9988     * A debug_assert! macro is now provided which is disabled when
9989       `--cfg ndebug` is passed to the compiler.
9990     * A graphviz crate has been added for creating .dot files.
9991     * The std::cast module has been migrated into std::mem.
9992     * The std::local_data api has been migrated from freestanding functions
9993       to being based on methods.
9994     * The Pod trait has been renamed to Copy.
9995     * jemalloc has been added as the default allocator for types.
9996     * The API for allocating memory has been changed to use proper alignment
9997       and sized deallocation
9998     * Connecting a TcpStream or binding a TcpListener is now based on a
9999       string address and a u16 port. This allows connecting to a hostname as
10000       opposed to an IP.
10001     * The Reader trait now contains a core method, read_at_least(), which
10002       correctly handles many repeated 0-length reads.
10003     * The process-spawning API is now centered around a builder-style
10004       Command struct.
10005     * The :? printing qualifier has been moved from the standard library to
10006       an external libdebug crate.
10007     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
10008       have been renamed to Eq/Ord.
10009     * The select/plural methods have been removed from format!. The escapes
10010       for { and } have also changed from \{ and \} to {{ and }},
10011       respectively.
10012     * The TaskBuilder API has been re-worked to be a true builder, and
10013       extension traits for spawning native/green tasks have been added.
10014
10015   * Tooling
10016     * All breaking changes to the language or libraries now have their
10017       commit message annotated with `[breaking-change]` to allow for easy
10018       discovery of breaking changes.
10019     * The compiler will now try to suggest how to annotate lifetimes if a
10020       lifetime-related error occurs.
10021     * Debug info continues to be improved greatly with general bug fixes and
10022       better support for situations like link time optimization (LTO).
10023     * Usage of syntax extensions when cross-compiling has been fixed.
10024     * Functionality equivalent to GCC & Clang's -ffunction-sections,
10025       -fdata-sections and --gc-sections has been enabled by default
10026     * The compiler is now stricter about where it will load module files
10027       from when a module is declared via `mod foo;`.
10028     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
10029       Syntax extensions are now discovered via a "plugin registrar" type
10030       which will be extended in the future to other various plugins.
10031     * Lints have been restructured to allow for dynamically loadable lints.
10032     * A number of rustdoc improvements:
10033       * The HTML output has been visually redesigned.
10034       * Markdown is now powered by hoedown instead of sundown.
10035       * Searching heuristics have been greatly improved.
10036       * The search index has been reduced in size by a great amount.
10037       * Cross-crate documentation via `pub use` has been greatly improved.
10038       * Primitive types are now hyperlinked and documented.
10039     * Documentation has been moved from static.rust-lang.org/doc to
10040       doc.rust-lang.org
10041     * A new sandbox, play.rust-lang.org, is available for running and
10042       sharing rust code examples on-line.
10043     * Unused attributes are now more robustly warned about.
10044     * The dead_code lint now warns about unused struct fields.
10045     * Cross-compiling to iOS is now supported.
10046     * Cross-compiling to mipsel is now supported.
10047     * Stability attributes are now inherited by default and no longer apply
10048       to intra-crate usage, only inter-crate usage.
10049     * Error message related to non-exhaustive match expressions have been
10050       greatly improved.
10051
10052
10053 Version 0.10 (2014-04-03)
10054 =========================
10055
10056   * ~1500 changes, numerous bugfixes
10057
10058   * Language
10059     * A new RFC process is now in place for modifying the language.
10060     * Patterns with `@`-pointers have been removed from the language.
10061     * Patterns with unique vectors (`~[T]`) have been removed from the
10062       language.
10063     * Patterns with unique strings (`~str`) have been removed from the
10064       language.
10065     * `@str` has been removed from the language.
10066     * `@[T]` has been removed from the language.
10067     * `@self` has been removed from the language.
10068     * `@Trait` has been removed from the language.
10069     * Headers on `~` allocations which contain `@` boxes inside the type for
10070       reference counting have been removed.
10071     * The semantics around the lifetimes of temporary expressions have changed,
10072       see #3511 and #11585 for more information.
10073     * Cross-crate syntax extensions are now possible, but feature gated. See
10074       #11151 for more information. This includes both `macro_rules!` macros as
10075       well as syntax extensions such as `format!`.
10076     * New lint modes have been added, and older ones have been turned on to be
10077       warn-by-default.
10078       * Unnecessary parentheses
10079       * Uppercase statics
10080       * Camel Case types
10081       * Uppercase variables
10082       * Publicly visible private types
10083       * `#[deriving]` with raw pointers
10084     * Unsafe functions can no longer be coerced to closures.
10085     * Various obscure macros such as `log_syntax!` are now behind feature gates.
10086     * The `#[simd]` attribute is now behind a feature gate.
10087     * Visibility is no longer allowed on `extern crate` statements, and
10088       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
10089     * Trailing commas are now allowed in argument lists and tuple patterns.
10090     * The `do` keyword has been removed, it is now a reserved keyword.
10091     * Default type parameters have been implemented, but are feature gated.
10092     * Borrowed variables through captures in closures are now considered soundly.
10093     * `extern mod` is now `extern crate`
10094     * The `Freeze` trait has been removed.
10095     * The `Share` trait has been added for types that can be shared among
10096       threads.
10097     * Labels in macros are now hygienic.
10098     * Expression/statement macro invocations can be delimited with `{}` now.
10099     * Treatment of types allowed in `static mut` locations has been tweaked.
10100     * The `*` and `.` operators are now overloadable through the `Deref` and
10101       `DerefMut` traits.
10102     * `~Trait` and `proc` no longer have `Send` bounds by default.
10103     * Partial type hints are now supported with the `_` type marker.
10104     * An `Unsafe` type was introduced for interior mutability. It is now
10105       considered undefined to transmute from `&T` to `&mut T` without using the
10106       `Unsafe` type.
10107     * The #[linkage] attribute was implemented for extern statics/functions.
10108     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
10109     * `Pod` was renamed to `Copy`.
10110
10111   * Libraries
10112     * The `libextra` library has been removed. It has now been decomposed into
10113       component libraries with smaller and more focused nuggets of
10114       functionality. The full list of libraries can be found on the
10115       documentation index page.
10116     * std: `std::condition` has been removed. All I/O errors are now propagated
10117       through the `Result` type. In order to assist with error handling, a
10118       `try!` macro for unwrapping errors with an early return and a lint for
10119       unused results has been added. See #12039 for more information.
10120     * std: The `vec` module has been renamed to `slice`.
10121     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
10122       This will become the only growable vector in the future.
10123     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
10124       are now found at `std::io::BufferedReader` instead of
10125       `std::io::buffered::BufferedReader`.
10126     * std: `print` and `println` are no longer in the prelude, the `print!` and
10127       `println!` macros are intended to be used instead.
10128     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
10129       attempts to statically prevent cycles.
10130     * std: The standard distribution is adopting the policy of pushing failure
10131       to the user rather than failing in libraries. Many functions (such as
10132       `slice::last()`) now return `Option<T>` instead of `T` + failing.
10133     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
10134       deriving mode: `#[deriving(Show)]`.
10135     * std: `ToStr` is now implemented for all types implementing `Show`.
10136     * std: The formatting trait methods now take `&self` instead of `&T`
10137     * std: The `invert()` method on iterators has been renamed to `rev()`
10138     * std: `std::num` has seen a reduction in the genericity of its traits,
10139       consolidating functionality into a few core traits.
10140     * std: Backtraces are now printed on task failure if the environment
10141       variable `RUST_BACKTRACE` is present.
10142     * std: Naming conventions for iterators have been standardized. More details
10143       can be found on the wiki's style guide.
10144     * std: `eof()` has been removed from the `Reader` trait. Specific types may
10145       still implement the function.
10146     * std: Networking types are now cloneable to allow simultaneous reads/writes.
10147     * std: `assert_approx_eq!` has been removed
10148     * std: The `e` and `E` formatting specifiers for floats have been added to
10149       print them in exponential notation.
10150     * std: The `Times` trait has been removed
10151     * std: Indications of variance and opting out of builtin bounds is done
10152       through marker types in `std::kinds::marker` now
10153     * std: `hash` has been rewritten, `IterBytes` has been removed, and
10154       `#[deriving(Hash)]` is now possible.
10155     * std: `SharedChan` has been removed, `Sender` is now cloneable.
10156     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
10157     * std: `Chan::new` is now `channel()`.
10158     * std: A new synchronous channel type has been implemented.
10159     * std: A `select!` macro is now provided for selecting over `Receiver`s.
10160     * std: `hashmap` and `trie` have been moved to `libcollections`
10161     * std: `run` has been rolled into `io::process`
10162     * std: `assert_eq!` now uses `{}` instead of `{:?}`
10163     * std: The equality and comparison traits have seen some reorganization.
10164     * std: `rand` has moved to `librand`.
10165     * std: `to_{lower,upper}case` has been implemented for `char`.
10166     * std: Logging has been moved to `liblog`.
10167     * collections: `HashMap` has been rewritten for higher performance and less
10168       memory usage.
10169     * native: The default runtime is now `libnative`. If `libgreen` is desired,
10170       it can be booted manually. The runtime guide has more information and
10171       examples.
10172     * native: All I/O functionality except signals has been implemented.
10173     * green: Task spawning with `libgreen` has been optimized with stack caching
10174       and various trimming of code.
10175     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
10176     * sync: The `extra::sync` module has been updated to modern rust (and moved
10177       to the `sync` library), tweaking and improving various interfaces while
10178       dropping redundant functionality.
10179     * sync: A new `Barrier` type has been added to the `sync` library.
10180     * sync: An efficient mutex for native and green tasks has been implemented.
10181     * serialize: The `base64` module has seen some improvement. It treats
10182       newlines better, has non-string error values, and has seen general
10183       cleanup.
10184     * fourcc: A `fourcc!` macro was introduced
10185     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
10186       hexadecimal literal.
10187
10188   * Tooling
10189     * `rustpkg` has been deprecated and removed from the main repository. Its
10190       replacement, `cargo`, is under development.
10191     * Nightly builds of rust are now available
10192     * The memory usage of rustc has been improved many times throughout this
10193       release cycle.
10194     * The build process supports disabling rpath support for the rustc binary
10195       itself.
10196     * Code generation has improved in some cases, giving more information to the
10197       LLVM optimization passes to enable more extensive optimizations.
10198     * Debuginfo compatibility with lldb on OSX has been restored.
10199     * The master branch is now gated on an android bot, making building for
10200       android much more reliable.
10201     * Output flags have been centralized into one `--emit` flag.
10202     * Crate type flags have been centralized into one `--crate-type` flag.
10203     * Codegen flags have been consolidated behind a `-C` flag.
10204     * Linking against outdated crates now has improved error messages.
10205     * Error messages with lifetimes will often suggest how to annotate the
10206       function to fix the error.
10207     * Many more types are documented in the standard library, and new guides
10208       were written.
10209     * Many `rustdoc` improvements:
10210       * code blocks are syntax highlighted.
10211       * render standalone markdown files.
10212       * the --test flag tests all code blocks by default.
10213       * exported macros are displayed.
10214       * re-exported types have their documentation inlined at the location of the
10215         first re-export.
10216       * search works across crates that have been rendered to the same output
10217         directory.
10218
10219
10220 Version 0.9 (2014-01-09)
10221 ==========================
10222
10223    * ~1800 changes, numerous bugfixes
10224
10225    * Language
10226       * The `float` type has been removed. Use `f32` or `f64` instead.
10227       * A new facility for enabling experimental features (feature gating) has
10228         been added, using the crate-level `#[feature(foo)]` attribute.
10229       * Managed boxes (@) are now behind a feature gate
10230         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
10231         standard library's `Gc` or `Rc` types instead.
10232       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
10233       * Jumping back to the top of a loop is now done with `continue` instead of
10234         `loop`.
10235       * Strings can no longer be mutated through index assignment.
10236       * Raw strings can be created via the basic `r"foo"` syntax or with matched
10237         hash delimiters, as in `r###"foo"###`.
10238       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
10239         called once.
10240       * The `&fn` type is now written `|args| -> ret` to match the literal form.
10241       * `@fn`s have been removed.
10242       * `do` only works with procs in order to make it obvious what the cost
10243         of `do` is.
10244       * Single-element tuple-like structs can no longer be dereferenced to
10245         obtain the inner value. A more comprehensive solution for overloading
10246         the dereference operator will be provided in the future.
10247       * The `#[link(...)]` attribute has been replaced with
10248         `#[crate_id = "name#vers"]`.
10249       * Empty `impl`s must be terminated with empty braces and may not be
10250         terminated with a semicolon.
10251       * Keywords are no longer allowed as lifetime names; the `self` lifetime
10252         no longer has any special meaning.
10253       * The old `fmt!` string formatting macro has been removed.
10254       * `printf!` and `printfln!` (old-style formatting) removed in favor of
10255         `print!` and `println!`.
10256       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
10257       * The `extern mod foo (name = "bar")` syntax has been removed. Use
10258         `extern mod foo = "bar"` instead.
10259       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
10260       * Macros can have attributes.
10261       * Macros can expand to items with attributes.
10262       * Macros can expand to multiple items.
10263       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
10264       * Comments may be nested.
10265       * Values automatically coerce to trait objects they implement, without
10266         an explicit `as`.
10267       * Enum discriminants are no longer an entire word but as small as needed to
10268         contain all the variants. The `repr` attribute can be used to override
10269         the discriminant size, as in `#[repr(int)]` for integer-sized, and
10270         `#[repr(C)]` to match C enums.
10271       * Non-string literals are not allowed in attributes (they never worked).
10272       * The FFI now supports variadic functions.
10273       * Octal numeric literals, as in `0o7777`.
10274       * The `concat!` syntax extension performs compile-time string concatenation.
10275       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
10276         removed as Rust no longer uses segmented stacks.
10277       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
10278       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
10279         not `*`; ignoring remaining fields of a struct is also done with `..`,
10280         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
10281       * `rustc` supports the "win64" calling convention via `extern "win64"`.
10282       * `rustc` supports the "system" calling convention, which defaults to the
10283         preferred convention for the target platform, "stdcall" on 32-bit Windows,
10284         "C" elsewhere.
10285       * The `type_overflow` lint (default: warn) checks literals for overflow.
10286       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
10287       * The `attribute_usage` lint (default: warn) warns about unknown
10288         attributes.
10289       * The `unknown_features` lint (default: warn) warns about unknown
10290         feature gates.
10291       * The `dead_code` lint (default: warn) checks for dead code.
10292       * Rust libraries can be linked statically to one another
10293       * `#[link_args]` is behind the `link_args` feature gate.
10294       * Native libraries are now linked with `#[link(name = "foo")]`
10295       * Native libraries can be statically linked to a rust crate
10296         (`#[link(name = "foo", kind = "static")]`).
10297       * Native OS X frameworks are now officially supported
10298         (`#[link(name = "foo", kind = "framework")]`).
10299       * The `#[thread_local]` attribute creates thread-local (not task-local)
10300         variables. Currently behind the `thread_local` feature gate.
10301       * The `return` keyword may be used in closures.
10302       * Types that can be copied via a memcpy implement the `Pod` kind.
10303       * The `cfg` attribute can now be used on struct fields and enum variants.
10304
10305    * Libraries
10306       * std: The `option` and `result` API's have been overhauled to make them
10307         simpler, more consistent, and more composable.
10308       * std: The entire `std::io` module has been replaced with one that is
10309         more comprehensive and that properly interfaces with the underlying
10310         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
10311         implemented.
10312       * std: `io::util` contains a number of useful implementations of
10313         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
10314         `ZeroReader`, `TeeReader`.
10315       * std: The reference counted pointer type `extra::rc` moved into std.
10316       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
10317         just a wrapper around it).
10318       * std: The `Either` type has been removed.
10319       * std: `fmt::Default` can be implemented for any type to provide default
10320         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
10321       * std: The `rand` API continues to be tweaked.
10322       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
10323         on failure in gdb, is now named `rust_fail`.
10324       * std: The `each_key` and `each_value` methods on `HashMap` have been
10325         replaced by the `keys` and `values` iterators.
10326       * std: Functions dealing with type size and alignment have moved from the
10327         `sys` module to the `mem` module.
10328       * std: The `path` module was written and API changed.
10329       * std: `str::from_utf8` has been changed to cast instead of allocate.
10330       * std: `starts_with` and `ends_with` methods added to vectors via the
10331         `ImmutableEqVector` trait, which is in the prelude.
10332       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
10333         if the index is out of bounds.
10334       * std: Task failure no longer propagates between tasks, as the model was
10335         complex, expensive, and incompatible with thread-based tasks.
10336       * std: The `Any` type can be used for dynamic typing.
10337       * std: `~Any` can be passed to the `fail!` macro and retrieved via
10338         `task::try`.
10339       * std: Methods that produce iterators generally do not have an `_iter`
10340         suffix now.
10341       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
10342         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
10343       * std: `util::ignore` renamed to `prelude::drop`.
10344       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
10345         trait.
10346       * std: `vec::raw` has seen a lot of cleanup and API changes.
10347       * std: The standard library no longer includes any C++ code, and very
10348         minimal C, eliminating the dependency on libstdc++.
10349       * std: Runtime scheduling and I/O functionality has been factored out into
10350         extensible interfaces and is now implemented by two different crates:
10351         libnative, for native threading and I/O; and libgreen, for green threading
10352         and I/O. This paves the way for using the standard library in more limited
10353         embedded environments.
10354       * std: The `comm` module has been rewritten to be much faster, have a
10355         simpler, more consistent API, and to work for both native and green
10356         threading.
10357       * std: All libuv dependencies have been moved into the rustuv crate.
10358       * native: New implementations of runtime scheduling on top of OS threads.
10359       * native: New native implementations of TCP, UDP, file I/O, process spawning,
10360         and other I/O.
10361       * green: The green thread scheduler and message passing types are almost
10362         entirely lock-free.
10363       * extra: The `flatpipes` module had bitrotted and was removed.
10364       * extra: All crypto functions have been removed and Rust now has a policy of
10365         not reimplementing crypto in the standard library. In the future crypto
10366         will be provided by external crates with bindings to established libraries.
10367       * extra: `c_vec` has been modernized.
10368       * extra: The `sort` module has been removed. Use the `sort` method on
10369         mutable slices.
10370
10371    * Tooling
10372       * The `rust` and `rusti` commands have been removed, due to lack of
10373         maintenance.
10374       * `rustdoc` was completely rewritten.
10375       * `rustdoc` can test code examples in documentation.
10376       * `rustpkg` can test packages with the argument, 'test'.
10377       * `rustpkg` supports arbitrary dependencies, including C libraries.
10378       * `rustc`'s support for generating debug info is improved again.
10379       * `rustc` has better error reporting for unbalanced delimiters.
10380       * `rustc`'s JIT support was removed due to bitrot.
10381       * Executables and static libraries can be built with LTO (-Z lto)
10382       * `rustc` adds a `--dep-info` flag for communicating dependencies to
10383         build tools.
10384
10385
10386 Version 0.8 (2013-09-26)
10387 ============================
10388
10389    * ~2200 changes, numerous bugfixes
10390
10391    * Language
10392       * The `for` loop syntax has changed to work with the `Iterator` trait.
10393       * At long last, unwinding works on Windows.
10394       * Default methods are ready for use.
10395       * Many trait inheritance bugs fixed.
10396       * Owned and borrowed trait objects work more reliably.
10397       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
10398       * rustc can omit emission of code for the `debug!` macro if it is passed
10399         `--cfg ndebug`
10400       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
10401         for foo.rs, then foo/mod.rs, and will generate an error when both are
10402         present.
10403       * Strings no longer contain trailing nulls. The new `std::c_str` module
10404         provides new mechanisms for converting to C strings.
10405       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
10406       * The FFI has been overhauled such that foreign functions are called directly,
10407         instead of through a stack-switching wrapper.
10408       * Calling a foreign function must be done through a Rust function with the
10409         `#[fixed_stack_segment]` attribute.
10410       * The `externfn!` macro can be used to declare both a foreign function and
10411         a `#[fixed_stack_segment]` wrapper at once.
10412       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
10413       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
10414       * `priv` is disallowed everywhere except for struct fields and enum variants.
10415       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
10416       * `ref` bindings in irrefutable patterns work correctly now.
10417       * `char` is now prevented from containing invalid code points.
10418       * Casting to `bool` is no longer allowed.
10419       * `\0` is now accepted as an escape in chars and strings.
10420       * `yield` is a reserved keyword.
10421       * `typeof` is a reserved keyword.
10422       * Crates may be imported by URL with `extern mod foo = "url";`.
10423       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
10424       * Static vectors can be initialized with repeating elements,
10425         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
10426       * Static structs can be initialized with functional record update,
10427         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
10428       * `cfg!` can be used to conditionally execute code based on the crate
10429         configuration, similarly to `#[cfg(...)]`.
10430       * The `unnecessary_qualification` lint detects unneeded module
10431         prefixes (default: allow).
10432       * Arithmetic operations have been implemented on the SIMD types in
10433         `std::unstable::simd`.
10434       * Exchange allocation headers were removed, reducing memory usage.
10435       * `format!` implements a completely new, extensible, and higher-performance
10436         string formatting system. It will replace `fmt!`.
10437       * `print!` and `println!` write formatted strings (using the `format!`
10438         extension) to stdout.
10439       * `write!` and `writeln!` write formatted strings (using the `format!`
10440         extension) to the new Writers in `std::rt::io`.
10441       * The library section in which a function or static is placed may
10442         be specified with `#[link_section = "..."]`.
10443       * The `proto!` syntax extension for defining bounded message protocols
10444         was removed.
10445       * `macro_rules!` is hygienic for `let` declarations.
10446       * The `#[export_name]` attribute specifies the name of a symbol.
10447       * `unreachable!` can be used to indicate unreachable code, and fails
10448         if executed.
10449
10450    * Libraries
10451       * std: Transitioned to the new runtime, written in Rust.
10452       * std: Added an experimental I/O library, `rt::io`, based on the new
10453         runtime.
10454       * std: A new generic `range` function was added to the prelude, replacing
10455         `uint::range` and friends.
10456       * std: `range_rev` no longer exists. Since range is an iterator it can be
10457         reversed with `range(lo, hi).invert()`.
10458       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
10459         renamed to `unwrap_or`.
10460       * std: The `iterator` module was renamed to `iter`.
10461       * std: Integral types now support the `checked_add`, `checked_sub`, and
10462         `checked_mul` operations for detecting overflow.
10463       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
10464         consistency.
10465       * std: Methods are standardizing on conventions for casting methods:
10466         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
10467         and cheap casts.
10468       * std: The `CString` type in `c_str` provides new ways to convert to and
10469         from C strings.
10470       * std: `DoubleEndedIterator` can yield elements in two directions.
10471       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
10472         two splices.
10473       * std: `str::from_bytes` renamed to `str::from_utf8`.
10474       * std: `pop_opt` and `shift_opt` methods added to vectors.
10475       * std: The task-local data interface no longer uses @, and keys are
10476         no longer function pointers.
10477       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
10478       * std: Added `SharedPort` to `comm`.
10479       * std: `Eq` has a default method for `ne`; only `eq` is required
10480         in implementations.
10481       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
10482         is required in implementations.
10483       * std: `is_utf8` performance is improved, impacting many string functions.
10484       * std: `os::MemoryMap` provides cross-platform mmap.
10485       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
10486         are not 'in-bounds' are considered undefined.
10487       * std: Many freestanding functions in `vec` removed in favor of methods.
10488       * std: Many freestanding functions on scalar types removed in favor of
10489         methods.
10490       * std: Many options to task builders were removed since they don't make
10491         sense in the new scheduler design.
10492       * std: More containers implement `FromIterator` so can be created by the
10493         `collect` method.
10494       * std: More complete atomic types in `unstable::atomics`.
10495       * std: `comm::PortSet` removed.
10496       * std: Mutating methods in the `Set` and `Map` traits have been moved into
10497         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
10498         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
10499         default implementations.
10500       * std: Various `from_str` functions were removed in favor of a generic
10501         `from_str` which is available in the prelude.
10502       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
10503       * extra: `dlist`, the doubly-linked list was modernized.
10504       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
10505       * extra: Added `glob` module, replacing `std::os::glob`.
10506       * extra: `rope` was removed.
10507       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
10508       * extra: `net`, and `timer` were removed. The experimental replacements
10509         are `std::rt::io::net` and `std::rt::io::timer`.
10510       * extra: Iterators implemented for `SmallIntMap`.
10511       * extra: Iterators implemented for `Bitv` and `BitvSet`.
10512       * extra: `SmallIntSet` removed. Use `BitvSet`.
10513       * extra: Performance of JSON parsing greatly improved.
10514       * extra: `semver` updated to SemVer 2.0.0.
10515       * extra: `term` handles more terminals correctly.
10516       * extra: `dbg` module removed.
10517       * extra: `par` module removed.
10518       * extra: `future` was cleaned up, with some method renames.
10519       * extra: Most free functions in `getopts` were converted to methods.
10520
10521    * Other
10522       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
10523       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
10524         similarly to gcc's `--march` flag.
10525       * rustc's performance compiling small crates is much better.
10526       * rustpkg has received many improvements.
10527       * rustpkg supports git tags as package IDs.
10528       * rustpkg builds into target-specific directories so it can be used for
10529         cross-compiling.
10530       * The number of concurrent test tasks is controlled by the environment
10531         variable RUST_TEST_TASKS.
10532       * The test harness can now report metrics for benchmarks.
10533       * All tools have man pages.
10534       * Programs compiled with `--test` now support the `-h` and `--help` flags.
10535       * The runtime uses jemalloc for allocations.
10536       * Segmented stacks are temporarily disabled as part of the transition to
10537         the new runtime. Stack overflows are possible!
10538       * A new documentation backend, rustdoc_ng, is available for use. It is
10539         still invoked through the normal `rustdoc` command.
10540
10541
10542 Version 0.7 (2013-07-03)
10543 =======================
10544
10545    * ~2000 changes, numerous bugfixes
10546
10547    * Language
10548       * `impl`s no longer accept a visibility qualifier. Put them on methods
10549         instead.
10550       * The borrow checker has been rewritten with flow-sensitivity, fixing
10551         many bugs and inconveniences.
10552       * The `self` parameter no longer implicitly means `&'self self`,
10553         and can be explicitly marked with a lifetime.
10554       * Overloadable compound operators (`+=`, etc.) have been temporarily
10555         removed due to bugs.
10556       * The `for` loop protocol now requires `for`-iterators to return `bool`
10557         so they compose better.
10558       * The `Durable` trait is replaced with the `'static` bounds.
10559       * Trait default methods work more often.
10560       * Structs with the `#[packed]` attribute have byte alignment and
10561         no padding between fields.
10562       * Type parameters bound by `Copy` must now be copied explicitly with
10563         the `copy` keyword.
10564       * It is now illegal to move out of a dereferenced unsafe pointer.
10565       * `Option<~T>` is now represented as a nullable pointer.
10566       * `@mut` does dynamic borrow checks correctly.
10567       * The `main` function is only detected at the topmost level of the crate.
10568         The `#[main]` attribute is still valid anywhere.
10569       * Struct fields may no longer be mutable. Use inherited mutability.
10570       * The `#[no_send]` attribute makes a type that would otherwise be
10571         `Send`, not.
10572       * The `#[no_freeze]` attribute makes a type that would otherwise be
10573         `Freeze`, not.
10574       * Unbounded recursion will abort the process after reaching the limit
10575         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
10576       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
10577         are never implicitly copyable.
10578       * `#[static_assert]` makes compile-time assertions about static bools.
10579       * At long last, 'argument modes' no longer exist.
10580       * The rarely used `use mod` statement no longer exists.
10581
10582    * Syntax extensions
10583       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
10584         argument list.
10585       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
10586         `Rand`, `Zero` and `ToStr` can all be automatically derived with
10587         `#[deriving(...)]`.
10588       * The `bytes!` macro returns a vector of bytes for string, u8, char,
10589         and unsuffixed integer literals.
10590
10591    * Libraries
10592       * The `core` crate was renamed to `std`.
10593       * The `std` crate was renamed to `extra`.
10594       * More and improved documentation.
10595       * std: `iterator` module for external iterator objects.
10596       * Many old-style (internal, higher-order function) iterators replaced by
10597         implementations of `Iterator`.
10598       * std: Many old internal vector and string iterators,
10599         incl. `any`, `all`. removed.
10600       * std: The `finalize` method of `Drop` renamed to `drop`.
10601       * std: The `drop` method now takes `&mut self` instead of `&self`.
10602       * std: The prelude no longer re-exports any modules, only types and traits.
10603       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
10604         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
10605       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
10606         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
10607       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
10608         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
10609       * std: Many types implement `Clone`.
10610       * std: `path` type renamed to `Path`.
10611       * std: `mut` module and `Mut` type removed.
10612       * std: Many standalone functions removed in favor of methods and iterators
10613         in `vec`, `str`. In the future methods will also work as functions.
10614       * std: `reinterpret_cast` removed. Use `transmute`.
10615       * std: ascii string handling in `std::ascii`.
10616       * std: `Rand` is implemented for ~/@.
10617       * std: `run` module for spawning processes overhauled.
10618       * std: Various atomic types added to `unstable::atomic`.
10619       * std: Various types implement `Zero`.
10620       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
10621       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
10622       * std: Added `os::mkdir_recursive`.
10623       * std: Added `os::glob` function performs filesystems globs.
10624       * std: `FuzzyEq` renamed to `ApproxEq`.
10625       * std: `Map` now defines `pop` and `swap` methods.
10626       * std: `Cell` constructors converted to static methods.
10627       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
10628       * extra: `flate` module moved from `std` to `extra`.
10629       * extra: `fileinput` module for iterating over a series of files.
10630       * extra: `Complex` number type and `complex` module.
10631       * extra: `Rational` number type and `rational` module.
10632       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
10633       * extra: `term` uses terminfo now, is more correct.
10634       * extra: `arc` functions converted to methods.
10635       * extra: Implementation of fixed output size variations of SHA-2.
10636
10637    * Tooling
10638       * `unused_variables` lint mode for unused variables (default: warn).
10639       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
10640         (default: warn).
10641       * `unused_mut` lint mode for identifying unused `mut` qualifiers
10642         (default: warn).
10643       * `dead_assignment` lint mode for unread variables (default: warn).
10644       * `unnecessary_allocation` lint mode detects some heap allocations that are
10645         immediately borrowed so could be written without allocating (default: warn).
10646       * `missing_doc` lint mode (default: allow).
10647       * `unreachable_code` lint mode (default: warn).
10648       * The `rusti` command has been rewritten and a number of bugs addressed.
10649       * rustc outputs in color on more terminals.
10650       * rustc accepts a `--link-args` flag to pass arguments to the linker.
10651       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
10652       * Compiling with `-g` will make the binary record information about
10653         dynamic borrowcheck failures for debugging.
10654       * rustdoc has a nicer stylesheet.
10655       * Various improvements to rustdoc.
10656       * Improvements to rustpkg (see the detailed release notes).
10657
10658
10659 Version 0.6 (2013-04-03)
10660 ========================
10661
10662    * ~2100 changes, numerous bugfixes
10663
10664    * Syntax changes
10665       * The self type parameter in traits is now spelled `Self`
10666       * The `self` parameter in trait and impl methods must now be explicitly
10667         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
10668       * Static methods no longer require the `static` keyword and instead
10669         are distinguished by the lack of a `self` parameter
10670       * Replaced the `Durable` trait with the `'static` lifetime
10671       * The old closure type syntax with the trailing sigil has been
10672         removed in favor of the more consistent leading sigil
10673       * `super` is a keyword, and may be prefixed to paths
10674       * Trait bounds are separated with `+` instead of whitespace
10675       * Traits are implemented with `impl Trait for Type`
10676         instead of `impl Type: Trait`
10677       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
10678       * The `export` keyword has finally been removed
10679       * The `move` keyword has been removed (see "Semantic changes")
10680       * The interior mutability qualifier on vectors, `[mut T]`, has been
10681         removed. Use `&mut [T]`, etc.
10682       * `mut` is no longer valid in `~mut T`. Use inherited mutability
10683       * `fail` is no longer a keyword. Use `fail!()`
10684       * `assert` is no longer a keyword. Use `assert!()`
10685       * `log` is no longer a keyword. use `debug!`, etc.
10686       * 1-tuples may be represented as `(T,)`
10687       * Struct fields may no longer be `mut`. Use inherited mutability,
10688         `@mut T`, `core::mut` or `core::cell`
10689       * `extern mod { ... }` is no longer valid syntax for foreign
10690         function modules. Use extern blocks: `extern { ... }`
10691       * Newtype enums removed. Use tuple-structs.
10692       * Trait implementations no longer support visibility modifiers
10693       * Pattern matching over vectors improved and expanded
10694       * `const` renamed to `static` to correspond to lifetime name,
10695         and make room for future `static mut` unsafe mutable globals.
10696       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
10697       * `Clone` implementations can be automatically generated with
10698         `#[deriving(Clone)]`
10699       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
10700         instead of `foo as Bar`.
10701       * Fixed length vector types are now written as `[int, .. 3]`
10702         instead of `[int * 3]`.
10703       * Fixed length vector types can express the length as a constant
10704         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
10705
10706    * Semantic changes
10707       * Types with owned pointers or custom destructors move by default,
10708         eliminating the `move` keyword
10709       * All foreign functions are considered unsafe
10710       * &mut is now unaliasable
10711       * Writes to borrowed @mut pointers are prevented dynamically
10712       * () has size 0
10713       * The name of the main function can be customized using #[main]
10714       * The default type of an inferred closure is &fn instead of @fn
10715       * `use` statements may no longer be "chained" - they cannot import
10716         identifiers imported by previous `use` statements
10717       * `use` statements are crate relative, importing from the "top"
10718         of the crate by default. Paths may be prefixed with `super::`
10719         or `self::` to change the search behavior.
10720       * Method visibility is inherited from the implementation declaration
10721       * Structural records have been removed
10722       * Many more types can be used in static items, including enums
10723         'static-lifetime pointers and vectors
10724       * Pattern matching over vectors improved and expanded
10725       * Typechecking of closure types has been overhauled to
10726         improve inference and eliminate unsoundness
10727       * Macros leave scope at the end of modules, unless that module is
10728         tagged with #[macro_escape]
10729
10730    * Libraries
10731       * Added big integers to `std::bigint`
10732       * Removed `core::oldcomm` module
10733       * Added pipe-based `core::comm` module
10734       * Numeric traits have been reorganized under `core::num`
10735       * `vec::slice` finally returns a slice
10736       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
10737       * Containers reorganized around traits in `core::container`
10738       * `core::dvec` removed, `~[T]` is a drop-in replacement
10739       * `core::send_map` renamed to `core::hashmap`
10740       * `std::map` removed; replaced with `core::hashmap`
10741       * `std::treemap` reimplemented as an owned balanced tree
10742       * `std::deque` and `std::smallintmap` reimplemented as owned containers
10743       * `core::trie` added as a fast ordered map for integer keys
10744       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
10745       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
10746         overload the comparison operators, whereas `TotalOrd` is used
10747         by certain container types
10748
10749    * Other
10750       * Replaced the 'cargo' package manager with 'rustpkg'
10751       * Added all-purpose 'rust' tool
10752       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
10753       * rustc now *attempts* to offer spelling suggestions
10754       * Improved support for ARM and Android
10755       * Preliminary MIPS backend
10756       * Improved foreign function ABI implementation for x86, x86_64
10757       * Various memory usage improvements
10758       * Rust code may be embedded in foreign code under limited circumstances
10759       * Inline assembler supported by new asm!() syntax extension.
10760
10761
10762 Version 0.5 (2012-12-21)
10763 ===========================
10764
10765    * ~900 changes, numerous bugfixes
10766
10767    * Syntax changes
10768       * Removed `<-` move operator
10769       * Completed the transition from the `#fmt` extension syntax to `fmt!`
10770       * Removed old fixed length vector syntax - `[T]/N`
10771       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
10772       * Macros may now expand to items and statements
10773       * `a.b()` is always parsed as a method call, never as a field projection
10774       * `Eq` and `IterBytes` implementations can be automatically generated
10775         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
10776       * Removed the special crate language for `.rc` files
10777       * Function arguments may consist of any irrefutable pattern
10778
10779    * Semantic changes
10780       * `&` and `~` pointers may point to objects
10781       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
10782       * Enum variants may be structs
10783       * Destructors can be added to all nominal types with the Drop trait
10784       * Structs and nullary enum variants may be constants
10785       * Values that cannot be implicitly copied are now automatically moved
10786         without writing `move` explicitly
10787       * `&T` may now be coerced to `*T`
10788       * Coercions happen in `let` statements as well as function calls
10789       * `use` statements now take crate-relative paths
10790       * The module and type namespaces have been merged so that static
10791         method names can be resolved under the trait in which they are
10792         declared
10793
10794    * Improved support for language features
10795       * Trait inheritance works in many scenarios
10796       * More support for explicit self arguments in methods - `self`, `&self`
10797         `@self`, and `~self` all generally work as expected
10798       * Static methods work in more situations
10799       * Experimental: Traits may declare default methods for the implementations
10800         to use
10801
10802    * Libraries
10803       * New condition handling system in `core::condition`
10804       * Timsort added to `std::sort`
10805       * New priority queue, `std::priority_queue`
10806       * Pipes for serializable types, `std::flatpipes'
10807       * Serialization overhauled to be trait-based
10808       * Expanded `getopts` definitions
10809       * Moved futures to `std`
10810       * More functions are pure now
10811       * `core::comm` renamed to `oldcomm`. Still deprecated
10812       * `rustdoc` and `cargo` are libraries now
10813
10814    * Misc
10815       * Added a preliminary REPL, `rusti`
10816       * License changed from MIT to dual MIT/APL2
10817
10818
10819 Version 0.4 (2012-10-15)
10820 ==========================
10821
10822    * ~2000 changes, numerous bugfixes
10823
10824    * Syntax
10825       * All keywords are now strict and may not be used as identifiers anywhere
10826       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
10827         'of', 'with', 'to', 'class'.
10828       * Classes are replaced with simpler structs
10829       * Explicit method self types
10830       * `ret` became `return` and `alt` became `match`
10831       * `import` is now `use`; `use is now `extern mod`
10832       * `extern mod { ... }` is now `extern { ... }`
10833       * `use mod` is the recommended way to import modules
10834       * `pub` and `priv` replace deprecated export lists
10835       * The syntax of `match` pattern arms now uses fat arrow (=>)
10836       * `main` no longer accepts an args vector; use `os::args` instead
10837
10838    * Semantics
10839       * Trait implementations are now coherent, ala Haskell typeclasses
10840       * Trait methods may be static
10841       * Argument modes are deprecated
10842       * Borrowed pointers are much more mature and recommended for use
10843       * Strings and vectors in the static region are stored in constant memory
10844       * Typestate was removed
10845       * Resolution rewritten to be more reliable
10846       * Support for 'dual-mode' data structures (freezing and thawing)
10847
10848    * Libraries
10849       * Most binary operators can now be overloaded via the traits in
10850         `core::ops'
10851       * `std::net::url` for representing URLs
10852       * Sendable hash maps in `core::send_map`
10853       * `core::task' gained a (currently unsafe) task-local storage API
10854
10855    * Concurrency
10856       * An efficient new intertask communication primitive called the pipe,
10857         along with a number of higher-level channel types, in `core::pipes`
10858       * `std::arc`, an atomically reference counted, immutable, shared memory
10859         type
10860       * `std::sync`, various exotic synchronization tools based on arcs and pipes
10861       * Futures are now based on pipes and sendable
10862       * More robust linked task failure
10863       * Improved task builder API
10864
10865    * Other
10866       * Improved error reporting
10867       * Preliminary JIT support
10868       * Preliminary work on precise GC
10869       * Extensive architectural improvements to rustc
10870       * Begun a transition away from buggy C++-based reflection (shape) code to
10871         Rust-based (visitor) code
10872       * All hash functions and tables converted to secure, randomized SipHash
10873
10874
10875 Version 0.3  (2012-07-12)
10876 ========================
10877
10878    * ~1900 changes, numerous bugfixes
10879
10880    * New coding conveniences
10881       * Integer-literal suffix inference
10882       * Per-item control over warnings, errors
10883       * #[cfg(windows)] and #[cfg(unix)] attributes
10884       * Documentation comments
10885       * More compact closure syntax
10886       * 'do' expressions for treating higher-order functions as
10887         control structures
10888       * *-patterns (wildcard extended to all constructor fields)
10889
10890    * Semantic cleanup
10891       * Name resolution pass and exhaustiveness checker rewritten
10892       * Region pointers and borrow checking supersede alias
10893         analysis
10894       * Init-ness checking is now provided by a region-based liveness
10895         pass instead of the typestate pass; same for last-use analysis
10896       * Extensive work on region pointers
10897
10898    * Experimental new language features
10899       * Slices and fixed-size, interior-allocated vectors
10900       * #!-comments for lang versioning, shell execution
10901       * Destructors and iface implementation for classes;
10902         type-parameterized classes and class methods
10903       * 'const' type kind for types that can be used to implement
10904         shared-memory concurrency patterns
10905
10906    * Type reflection
10907
10908    * Removal of various obsolete features
10909       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
10910                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
10911
10912       * Constructs: do-while loops ('do' repurposed), fn binding,
10913                     resources (replaced by destructors)
10914
10915    * Compiler reorganization
10916       * Syntax-layer of compiler split into separate crate
10917       * Clang (from LLVM project) integrated into build
10918       * Typechecker split into sub-modules
10919
10920    * New library code
10921       * New time functions
10922       * Extension methods for many built-in types
10923       * Arc: atomic-refcount read-only / exclusive-use shared cells
10924       * Par: parallel map and search routines
10925       * Extensive work on libuv interface
10926       * Much vector code moved to libraries
10927       * Syntax extensions: #line, #col, #file, #mod, #stringify,
10928         #include, #include_str, #include_bin
10929
10930    * Tool improvements
10931       * Cargo automatically resolves dependencies
10932
10933
10934 Version 0.2  (2012-03-29)
10935 =========================
10936
10937    * >1500 changes, numerous bugfixes
10938
10939    * New docs and doc tooling
10940
10941    * New port: FreeBSD x86_64
10942
10943    * Compilation model enhancements
10944       * Generics now specialized, multiply instantiated
10945       * Functions now inlined across separate crates
10946
10947    * Scheduling, stack and threading fixes
10948       * Noticeably improved message-passing performance
10949       * Explicit schedulers
10950       * Callbacks from C
10951       * Helgrind clean
10952
10953    * Experimental new language features
10954       * Operator overloading
10955       * Region pointers
10956       * Classes
10957
10958    * Various language extensions
10959       * C-callback function types: 'crust fn ...'
10960       * Infinite-loop construct: 'loop { ... }'
10961       * Shorten 'mutable' to 'mut'
10962       * Required mutable-local qualifier: 'let mut ...'
10963       * Basic glob-exporting: 'export foo::*;'
10964       * Alt now exhaustive, 'alt check' for runtime-checked
10965       * Block-function form of 'for' loop, with 'break' and 'ret'.
10966
10967    * New library code
10968       * AST quasi-quote syntax extension
10969       * Revived libuv interface
10970       * New modules: core::{future, iter}, std::arena
10971       * Merged per-platform std::{os*, fs*} to core::{libc, os}
10972       * Extensive cleanup, regularization in libstd, libcore
10973
10974
10975 Version 0.1  (2012-01-20)
10976 ===============================
10977
10978    * Most language features work, including:
10979       * Unique pointers, unique closures, move semantics
10980       * Interface-constrained generics
10981       * Static interface dispatch
10982       * Stack growth
10983       * Multithread task scheduling
10984       * Typestate predicates
10985       * Failure unwinding, destructors
10986       * Pattern matching and destructuring assignment
10987       * Lightweight block-lambda syntax
10988       * Preliminary macro-by-example
10989
10990    * Compiler works with the following configurations:
10991       * Linux: x86 and x86_64 hosts and targets
10992       * macOS: x86 and x86_64 hosts and targets
10993       * Windows: x86 hosts and targets
10994
10995    * Cross compilation / multi-target configuration supported.
10996
10997    * Preliminary API-documentation and package-management tools included.
10998
10999 Known issues:
11000
11001    * Documentation is incomplete.
11002
11003    * Performance is below intended target.
11004
11005    * Standard library APIs are subject to extensive change, reorganization.
11006
11007    * Language-level versioning is not yet operational - future code will
11008      break unexpectedly.