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.
  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 - [`Duration::as_secs_f64`]
  57 - [`Duration::as_secs_f32`]
  58 - [`Duration::from_secs_f64`]
  59 - [`Duration::from_secs_f32`]
  60 - [`Duration::mul_f64`]
  61 - [`Duration::mul_f32`]
  62 - [`Duration::div_f64`]
  63 - [`Duration::div_f32`]
  64 - [`Duration::div_duration_f64`]
  65 - [`Duration::div_duration_f32`]
  66 - [`MaybeUninit::as_ptr`]
  67 - [`MaybeUninit::as_mut_ptr`]
  68 - [`MaybeUninit::assume_init`]
  69 - [`MaybeUninit::assume_init_ref`]
  70
  71 Cargo
  72 -----
  73
  74 - [Add --message-format for install command][cargo/10107]
  75 - [Warn when alias shadows external subcommand][cargo/10082]
  76
  77 Rustdoc
  78 -------
  79
  80 - [Show all Deref implementations recursively in rustdoc][90183]
  81 - [Use computed visibility in rustdoc][88447]
  82
  83 Compatibility Notes
  84 -------------------
  85
  86 - [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.
  87 - Windows: [`std::process::Command` will no longer search the current directory for executables.][87704]
  88 - [All proc-macro backward-compatibility lints are now deny-by-default.][88041]
  89 - [proc_macro: Append .0 to unsuffixed float if it would otherwise become int token][90297]
  90 - [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.
  91 - [rustdoc now rejects some unexpected semicolons in doctests][91026]
  92
  93 Internal Changes
  94 ----------------
  95
  96 These changes provide no direct user facing benefits, but represent significant
  97 improvements to the internals and overall performance of rustc
  98 and related tools.
  99
 100 - [Implement coherence checks for negative trait impls][90104]
 101 - [Add rustc lint, warning when iterating over hashmaps][89558]
 102 - [Optimize live point computation][90491]
 103 - [Enable verification for 1/32nd of queries loaded from disk][90361]
 104 - [Implement version of normalize_erasing_regions that allows for normalization failure][91255]
 105
 106 [87337]: https://github.com/rust-lang/rust/pull/87337/
 107 [87467]: https://github.com/rust-lang/rust/pull/87467/
 108 [87704]: https://github.com/rust-lang/rust/pull/87704/
 109 [88041]: https://github.com/rust-lang/rust/pull/88041/
 110 [88300]: https://github.com/rust-lang/rust/pull/88300/
 111 [88447]: https://github.com/rust-lang/rust/pull/88447/
 112 [88601]: https://github.com/rust-lang/rust/pull/88601/
 113 [88624]: https://github.com/rust-lang/rust/pull/88624/
 114 [89062]: https://github.com/rust-lang/rust/pull/89062/
 115 [89174]: https://github.com/rust-lang/rust/pull/89174/
 116 [89542]: https://github.com/rust-lang/rust/pull/89542/
 117 [89551]: https://github.com/rust-lang/rust/pull/89551/
 118 [89558]: https://github.com/rust-lang/rust/pull/89558/
 119 [89580]: https://github.com/rust-lang/rust/pull/89580/
 120 [89652]: https://github.com/rust-lang/rust/pull/89652/
 121 [89677]: https://github.com/rust-lang/rust/pull/89677/
 122 [89951]: https://github.com/rust-lang/rust/pull/89951/
 123 [90058]: https://github.com/rust-lang/rust/pull/90058/
 124 [90104]: https://github.com/rust-lang/rust/pull/90104/
 125 [90117]: https://github.com/rust-lang/rust/pull/90117/
 126 [90175]: https://github.com/rust-lang/rust/pull/90175/
 127 [90183]: https://github.com/rust-lang/rust/pull/90183/
 128 [90297]: https://github.com/rust-lang/rust/pull/90297/
 129 [90329]: https://github.com/rust-lang/rust/pull/90329/
 130 [90361]: https://github.com/rust-lang/rust/pull/90361/
 131 [90417]: https://github.com/rust-lang/rust/pull/90417/
 132 [90473]: https://github.com/rust-lang/rust/pull/90473/
 133 [90491]: https://github.com/rust-lang/rust/pull/90491/
 134 [90733]: https://github.com/rust-lang/rust/pull/90733/
 135 [90833]: https://github.com/rust-lang/rust/pull/90833/
 136 [90846]: https://github.com/rust-lang/rust/pull/90846/
 137 [90896]: https://github.com/rust-lang/rust/pull/90896/
 138 [91026]: https://github.com/rust-lang/rust/pull/91026/
 139 [91207]: https://github.com/rust-lang/rust/pull/91207/
 140 [91255]: https://github.com/rust-lang/rust/pull/91255/
 141 [91301]: https://github.com/rust-lang/rust/pull/91301/
 142 [cargo/10082]: https://github.com/rust-lang/cargo/pull/10082/
 143 [cargo/10107]: https://github.com/rust-lang/cargo/pull/10107/
 144 [`Metadata::is_symlink`]: https://doc.rust-lang.org/stable/std/fs/struct.Metadata.html#method.is_symlink
 145 [`Path::is_symlink`]: https://doc.rust-lang.org/stable/std/path/struct.Path.html#method.is_symlink
 146 [`{integer}::saturating_div`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.saturating_div
 147 [`Option::unwrap_unchecked`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.unwrap_unchecked
 148 [`NonZero{unsigned}::is_power_of_two`]: https://doc.rust-lang.org/stable/std/num/struct.NonZeroU8.html#method.is_power_of_two
 149 [`unix::process::ExitStatusExt::core_dumped`]: https://doc.rust-lang.org/stable/std/os/unix/process/trait.ExitStatusExt.html#tymethod.core_dumped
 150 [`unix::process::ExitStatusExt::stopped_signal`]: https://doc.rust-lang.org/stable/std/os/unix/process/trait.ExitStatusExt.html#tymethod.stopped_signal
 151 [`unix::process::ExitStatusExt::continued`]: https://doc.rust-lang.org/stable/std/os/unix/process/trait.ExitStatusExt.html#tymethod.continued
 152 [`unix::process::ExitStatusExt::into_raw`]: https://doc.rust-lang.org/stable/std/os/unix/process/trait.ExitStatusExt.html#tymethod.into_raw
 153 [`Duration::new`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.new
 154 [`Duration::checked_add`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.checked_add
 155 [`Duration::saturating_add`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.saturating_add
 156 [`Duration::checked_sub`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.checked_sub
 157 [`Duration::saturating_sub`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.saturating_sub
 158 [`Duration::checked_mul`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.checked_mul
 159 [`Duration::saturating_mul`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.saturating_mul
 160 [`Duration::checked_div`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.checked_div
 161 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.as_secs_f64
 162 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.as_secs_f32
 163 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.from_secs_f64
 164 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.from_secs_f32
 165 [`Duration::mul_f64`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.mul_f64
 166 [`Duration::mul_f32`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.mul_f32
 167 [`Duration::div_f64`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.div_f64
 168 [`Duration::div_f32`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.div_f32
 169 [`Duration::div_duration_f64`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.div_duration_f64
 170 [`Duration::div_duration_f32`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.div_duration_f32
 171 [`MaybeUninit::as_ptr`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.as_ptr
 172 [`MaybeUninit::as_mut_ptr`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.as_mut_ptr
 173 [`MaybeUninit::assume_init`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init
 174 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
 175
 176 Version 1.57.0 (2021-12-02)
 177 ==========================
 178
 179 Language
 180 --------
 181
 182 - [Macro attributes may follow `#[derive]` and will see the original (pre-`cfg`) input.][87220]
 183 - [Accept curly-brace macros in expressions, like `m!{ .. }.method()` and `m!{ .. }?`.][88690]
 184 - [Allow panicking in constant evaluation.][89508]
 185
 186 Compiler
 187 --------
 188
 189 - [Create more accurate debuginfo for vtables.][89597]
 190 - [Add `armv6k-nintendo-3ds` at Tier 3\*.][88529]
 191 - [Add `armv7-unknown-linux-uclibceabihf` at Tier 3\*.][88952]
 192 - [Add `m68k-unknown-linux-gnu` at Tier 3\*.][88321]
 193 - [Add SOLID targets at Tier 3\*:][86191] `aarch64-kmc-solid_asp3`, `armv7a-kmc-solid_asp3-eabi`, `armv7a-kmc-solid_asp3-eabihf`
 194
 195 \* Refer to Rust's [platform support page][platform-support-doc] for more
 196    information on Rust's tiered platform support.
 197
 198 Libraries
 199 ---------
 200
 201 - [Avoid allocations and copying in `Vec::leak`][89337]
 202 - [Add `#[repr(i8)]` to `Ordering`][89507]
 203 - [Optimize `File::read_to_end` and `read_to_string`][89582]
 204 - [Update to Unicode 14.0][89614]
 205 - [Many more functions are marked `#[must_use]`][89692], producing a warning
 206   when ignoring their return value. This helps catch mistakes such as expecting
 207   a function to mutate a value in place rather than return a new value.
 208
 209 Stabilised APIs
 210 ---------------
 211
 212 - [`[T; N]::as_mut_slice`][`array::as_mut_slice`]
 213 - [`[T; N]::as_slice`][`array::as_slice`]
 214 - [`collections::TryReserveError`]
 215 - [`HashMap::try_reserve`]
 216 - [`HashSet::try_reserve`]
 217 - [`String::try_reserve`]
 218 - [`String::try_reserve_exact`]
 219 - [`Vec::try_reserve`]
 220 - [`Vec::try_reserve_exact`]
 221 - [`VecDeque::try_reserve`]
 222 - [`VecDeque::try_reserve_exact`]
 223 - [`Iterator::map_while`]
 224 - [`iter::MapWhile`]
 225 - [`proc_macro::is_available`]
 226 - [`Command::get_program`]
 227 - [`Command::get_args`]
 228 - [`Command::get_envs`]
 229 - [`Command::get_current_dir`]
 230 - [`CommandArgs`]
 231 - [`CommandEnvs`]
 232
 233 These APIs are now usable in const contexts:
 234
 235 - [`hint::unreachable_unchecked`]
 236
 237 Cargo
 238 -----
 239
 240 - [Stabilize custom profiles][cargo/9943]
 241
 242 Compatibility notes
 243 -------------------
 244
 245 Internal changes
 246 ----------------
 247 These changes provide no direct user facing benefits, but represent significant
 248 improvements to the internals and overall performance of rustc
 249 and related tools.
 250
 251 - [Added an experimental backend for codegen with `libgccjit`.][87260]
 252
 253 [86191]: https://github.com/rust-lang/rust/pull/86191/
 254 [87220]: https://github.com/rust-lang/rust/pull/87220/
 255 [87260]: https://github.com/rust-lang/rust/pull/87260/
 256 [88243]: https://github.com/rust-lang/rust/pull/88243/
 257 [88321]: https://github.com/rust-lang/rust/pull/88321/
 258 [88529]: https://github.com/rust-lang/rust/pull/88529/
 259 [88690]: https://github.com/rust-lang/rust/pull/88690/
 260 [88952]: https://github.com/rust-lang/rust/pull/88952/
 261 [89337]: https://github.com/rust-lang/rust/pull/89337/
 262 [89507]: https://github.com/rust-lang/rust/pull/89507/
 263 [89508]: https://github.com/rust-lang/rust/pull/89508/
 264 [89582]: https://github.com/rust-lang/rust/pull/89582/
 265 [89597]: https://github.com/rust-lang/rust/pull/89597/
 266 [89614]: https://github.com/rust-lang/rust/pull/89614/
 267 [89692]: https://github.com/rust-lang/rust/issues/89692/
 268 [cargo/9943]: https://github.com/rust-lang/cargo/pull/9943/
 269 [`array::as_mut_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_mut_slice
 270 [`array::as_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_slice
 271 [`collections::TryReserveError`]: https://doc.rust-lang.org/std/collections/struct.TryReserveError.html
 272 [`HashMap::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_map/struct.HashMap.html#method.try_reserve
 273 [`HashSet::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_set/struct.HashSet.html#method.try_reserve
 274 [`String::try_reserve`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve
 275 [`String::try_reserve_exact`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve_exact
 276 [`Vec::try_reserve`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve
 277 [`Vec::try_reserve_exact`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve_exact
 278 [`VecDeque::try_reserve`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve
 279 [`VecDeque::try_reserve_exact`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve_exact
 280 [`Iterator::map_while`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.map_while
 281 [`iter::MapWhile`]: https://doc.rust-lang.org/std/iter/struct.MapWhile.html
 282 [`proc_macro::is_available`]: https://doc.rust-lang.org/proc_macro/fn.is_available.html
 283 [`Command::get_program`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_program
 284 [`Command::get_args`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_args
 285 [`Command::get_envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_envs
 286 [`Command::get_current_dir`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_current_dir
 287 [`CommandArgs`]: https://doc.rust-lang.org/std/process/struct.CommandArgs.html
 288 [`CommandEnvs`]: https://doc.rust-lang.org/std/process/struct.CommandEnvs.html
 289
 290 Version 1.56.1 (2021-11-01)
 291 ===========================
 292
 293 - New lints to detect the presence of bidirectional-override Unicode
 294   codepoints in the compiled source code ([CVE-2021-42574])
 295
 296 [CVE-2021-42574]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-42574
 297
 298 Version 1.56.0 (2021-10-21)
 299 ========================
 300
 301 Language
 302 --------
 303
 304 - [The 2021 Edition is now stable.][rust#88100]
 305   See [the edition guide][rust-2021-edition-guide] for more details.
 306 - [The pattern in `binding @ pattern` can now also introduce new bindings.][rust#85305]
 307 - [Union field access is permitted in `const fn`.][rust#85769]
 308
 309 [rust-2021-edition-guide]: https://doc.rust-lang.org/nightly/edition-guide/rust-2021/index.html
 310
 311 Compiler
 312 --------
 313
 314 - [Upgrade to LLVM 13.][rust#87570]
 315 - [Support memory, address, and thread sanitizers on aarch64-unknown-freebsd.][rust#88023]
 316 - [Allow specifying a deployment target version for all iOS targets][rust#87699]
 317 - [Warnings can be forced on with `--force-warn`.][rust#87472]
 318   This feature is primarily intended for usage by `cargo fix`, rather than end users.
 319 - [Promote `aarch64-apple-ios-sim` to Tier 2\*.][rust#87760]
 320 - [Add `powerpc-unknown-freebsd` at Tier 3\*.][rust#87370]
 321 - [Add `riscv32imc-esp-espidf` at Tier 3\*.][rust#87666]
 322
 323 \* Refer to Rust's [platform support page][platform-support-doc] for more
 324 information on Rust's tiered platform support.
 325
 326 Libraries
 327 ---------
 328
 329 - [Allow writing of incomplete UTF-8 sequences via stdout/stderr on Windows.][rust#83342]
 330   The Windows console still requires valid Unicode, but this change allows
 331   splitting a UTF-8 character across multiple write calls. This allows, for
 332   instance, programs that just read and write data buffers (e.g. copying a file
 333   to stdout) without regard for Unicode or character boundaries.
 334 - [Prefer `AtomicU{64,128}` over Mutex for Instant backsliding protection.][rust#83093]
 335   For this use case, atomics scale much better under contention.
 336 - [Implement `Extend<(A, B)>` for `(Extend<A>, Extend<B>)`][rust#85835]
 337 - [impl Default, Copy, Clone for std::io::Sink and std::io::Empty][rust#86744]
 338 - [`impl From<[(K, V); N]>` for all collections.][rust#84111]
 339 - [Remove `P: Unpin` bound on impl Future for Pin.][rust#81363]
 340 - [Treat invalid environment variable names as non-existent.][rust#86183]
 341   Previously, the environment functions would panic if given a variable name
 342   with an internal null character or equal sign (`=`). Now, these functions will
 343   just treat such names as non-existent variables, since the OS cannot represent
 344   the existence of a variable with such a name.
 345
 346 Stabilised APIs
 347 ---------------
 348
 349 - [`std::os::unix::fs::chroot`]
 350 - [`UnsafeCell::raw_get`]
 351 - [`BufWriter::into_parts`]
 352 - [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]
 353   These APIs were previously stable in `std`, but are now also available in `core`.
 354 - [`Vec::shrink_to`]
 355 - [`String::shrink_to`]
 356 - [`OsString::shrink_to`]
 357 - [`PathBuf::shrink_to`]
 358 - [`BinaryHeap::shrink_to`]
 359 - [`VecDeque::shrink_to`]
 360 - [`HashMap::shrink_to`]
 361 - [`HashSet::shrink_to`]
 362
 363 These APIs are now usable in const contexts:
 364
 365 - [`std::mem::transmute`]
 366 - [`[T]::first`][`slice::first`]
 367 - [`[T]::split_first`][`slice::split_first`]
 368 - [`[T]::last`][`slice::last`]
 369 - [`[T]::split_last`][`slice::split_last`]
 370
 371 Cargo
 372 -----
 373
 374 - [Cargo supports specifying a minimum supported Rust version in Cargo.toml.][`rust-version`]
 375   This has no effect at present on dependency version selection.
 376   We encourage crates to specify their minimum supported Rust version, and we encourage CI systems
 377   that support Rust code to include a crate's specified minimum version in the test matrix for that
 378   crate by default.
 379
 380 Compatibility notes
 381 -------------------
 382
 383 - [Update to new argument parsing rules on Windows.][rust#87580]
 384   This adjusts Rust's standard library to match the behavior of the standard
 385   libraries for C/C++. The rules have changed slightly over time, and this PR
 386   brings us to the latest set of rules (changed in 2008).
 387 - [Disallow the aapcs calling convention on aarch64][rust#88399]
 388   This was already not supported by LLVM; this change surfaces this lack of
 389   support with a better error message.
 390 - [Make `SEMICOLON_IN_EXPRESSIONS_FROM_MACROS` warn by default][rust#87385]
 391 - [Warn when an escaped newline skips multiple lines.][rust#87671]
 392 - [Calls to `libc::getpid` / `std::process::id` from `Command::pre_exec`
 393    may return different values on glibc <= 2.24.][rust#81825]
 394    Rust now invokes the `clone3` system call directly, when available, to use new functionality
 395    available via that system call. Older versions of glibc cache the result of `getpid`, and only
 396    update that cache when calling glibc's clone/fork functions, so a direct system call bypasses
 397    that cache update. glibc 2.25 and newer no longer cache `getpid` for exactly this reason.
 398
 399 Internal changes
 400 ----------------
 401 These changes provide no direct user facing benefits, but represent significant
 402 improvements to the internals and overall performance of rustc
 403 and related tools.
 404
 405 - [LLVM is compiled with PGO in published x86_64-unknown-linux-gnu artifacts.][rust#88069]
 406   This improves the performance of most Rust builds.
 407 - [Unify representation of macros in internal data structures.][rust#88019]
 408   This change fixes a host of bugs with the handling of macros by the compiler,
 409   as well as rustdoc.
 410
 411 [`std::os::unix::fs::chroot`]: https://doc.rust-lang.org/stable/std/os/unix/fs/fn.chroot.html
 412 [`Iterator::intersperse`]: https://doc.rust-lang.org/stable/std/iter/trait.Iterator.html#method.intersperse
 413 [`Iterator::intersperse_with`]: https://doc.rust-lang.org/stable/std/iter/trait.Iterator.html#method.intersperse
 414 [`UnsafeCell::raw_get`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.raw_get
 415 [`BufWriter::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.BufWriter.html#method.into_parts
 416 [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]: https://github.com/rust-lang/rust/pull/84662
 417 [`Vec::shrink_to`]: https://doc.rust-lang.org/stable/std/vec/struct.Vec.html#method.shrink_to
 418 [`String::shrink_to`]: https://doc.rust-lang.org/stable/std/string/struct.String.html#method.shrink_to
 419 [`OsString::shrink_to`]: https://doc.rust-lang.org/stable/std/ffi/struct.OsString.html#method.shrink_to
 420 [`PathBuf::shrink_to`]: https://doc.rust-lang.org/stable/std/path/struct.PathBuf.html#method.shrink_to
 421 [`BinaryHeap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.BinaryHeap.html#method.shrink_to
 422 [`VecDeque::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.VecDeque.html#method.shrink_to
 423 [`HashMap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_map/struct.HashMap.html#method.shrink_to
 424 [`HashSet::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_set/struct.HashSet.html#method.shrink_to
 425 [`std::mem::transmute`]: https://doc.rust-lang.org/stable/std/mem/fn.transmute.html
 426 [`slice::first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.first
 427 [`slice::split_first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_first
 428 [`slice::last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.last
 429 [`slice::split_last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_last
 430 [`rust-version`]: https://doc.rust-lang.org/nightly/cargo/reference/manifest.html#the-rust-version-field
 431 [rust#87671]: https://github.com/rust-lang/rust/pull/87671
 432 [rust#86183]: https://github.com/rust-lang/rust/pull/86183
 433 [rust#87385]: https://github.com/rust-lang/rust/pull/87385
 434 [rust#88100]: https://github.com/rust-lang/rust/pull/88100
 435 [rust#86860]: https://github.com/rust-lang/rust/pull/86860
 436 [rust#84039]: https://github.com/rust-lang/rust/pull/84039
 437 [rust#86492]: https://github.com/rust-lang/rust/pull/86492
 438 [rust#88363]: https://github.com/rust-lang/rust/pull/88363
 439 [rust#85305]: https://github.com/rust-lang/rust/pull/85305
 440 [rust#87832]: https://github.com/rust-lang/rust/pull/87832
 441 [rust#88069]: https://github.com/rust-lang/rust/pull/88069
 442 [rust#87472]: https://github.com/rust-lang/rust/pull/87472
 443 [rust#87699]: https://github.com/rust-lang/rust/pull/87699
 444 [rust#87570]: https://github.com/rust-lang/rust/pull/87570
 445 [rust#88023]: https://github.com/rust-lang/rust/pull/88023
 446 [rust#87760]: https://github.com/rust-lang/rust/pull/87760
 447 [rust#87370]: https://github.com/rust-lang/rust/pull/87370
 448 [rust#87580]: https://github.com/rust-lang/rust/pull/87580
 449 [rust#83342]: https://github.com/rust-lang/rust/pull/83342
 450 [rust#83093]: https://github.com/rust-lang/rust/pull/83093
 451 [rust#88177]: https://github.com/rust-lang/rust/pull/88177
 452 [rust#88548]: https://github.com/rust-lang/rust/pull/88548
 453 [rust#88551]: https://github.com/rust-lang/rust/pull/88551
 454 [rust#88299]: https://github.com/rust-lang/rust/pull/88299
 455 [rust#88220]: https://github.com/rust-lang/rust/pull/88220
 456 [rust#85835]: https://github.com/rust-lang/rust/pull/85835
 457 [rust#86879]: https://github.com/rust-lang/rust/pull/86879
 458 [rust#86744]: https://github.com/rust-lang/rust/pull/86744
 459 [rust#84662]: https://github.com/rust-lang/rust/pull/84662
 460 [rust#86593]: https://github.com/rust-lang/rust/pull/86593
 461 [rust#81050]: https://github.com/rust-lang/rust/pull/81050
 462 [rust#81363]: https://github.com/rust-lang/rust/pull/81363
 463 [rust#84111]: https://github.com/rust-lang/rust/pull/84111
 464 [rust#85769]: https://github.com/rust-lang/rust/pull/85769#issuecomment-854363720
 465 [rust#88490]: https://github.com/rust-lang/rust/pull/88490
 466 [rust#88269]: https://github.com/rust-lang/rust/pull/88269
 467 [rust#84176]: https://github.com/rust-lang/rust/pull/84176
 468 [rust#88399]: https://github.com/rust-lang/rust/pull/88399
 469 [rust#88227]: https://github.com/rust-lang/rust/pull/88227
 470 [rust#88200]: https://github.com/rust-lang/rust/pull/88200
 471 [rust#82776]: https://github.com/rust-lang/rust/pull/82776
 472 [rust#88077]: https://github.com/rust-lang/rust/pull/88077
 473 [rust#87728]: https://github.com/rust-lang/rust/pull/87728
 474 [rust#87050]: https://github.com/rust-lang/rust/pull/87050
 475 [rust#87619]: https://github.com/rust-lang/rust/pull/87619
 476 [rust#81825]: https://github.com/rust-lang/rust/pull/81825#issuecomment-808406918
 477 [rust#88019]: https://github.com/rust-lang/rust/pull/88019
 478 [rust#87666]: https://github.com/rust-lang/rust/pull/87666
 479
 480 Version 1.55.0 (2021-09-09)
 481 ============================
 482
 483 Language
 484 --------
 485 - [You can now write open "from" range patterns (`X..`), which will start at `X` and
 486   will end at the maximum value of the integer.][83918]
 487 - [You can now explicitly import the prelude of different editions
 488   through `std::prelude` (e.g. `use std::prelude::rust_2021::*;`).][86294]
 489
 490 Compiler
 491 --------
 492 - [Added tier 3\* support for `powerpc64le-unknown-freebsd`.][83572]
 493
 494 \* Refer to Rust's [platform support page][platform-support-doc] for more
 495    information on Rust's tiered platform support.
 496
 497 Libraries
 498 ---------
 499
 500 - [Updated std's float parsing to use the Eisel-Lemire algorithm.][86761]
 501   These improvements should in general provide faster string parsing of floats,
 502   no longer reject certain valid floating point values, and reduce
 503   the produced code size for non-stripped artifacts.
 504 - [`string::Drain` now implements `AsRef<str>` and `AsRef<[u8]>`.][86858]
 505
 506 Stabilised APIs
 507 ---------------
 508
 509 - [`Bound::cloned`]
 510 - [`Drain::as_str`]
 511 - [`IntoInnerError::into_error`]
 512 - [`IntoInnerError::into_parts`]
 513 - [`MaybeUninit::assume_init_mut`]
 514 - [`MaybeUninit::assume_init_ref`]
 515 - [`MaybeUninit::write`]
 516 - [`array::map`]
 517 - [`ops::ControlFlow`]
 518 - [`x86::_bittest`]
 519 - [`x86::_bittestandcomplement`]
 520 - [`x86::_bittestandreset`]
 521 - [`x86::_bittestandset`]
 522 - [`x86_64::_bittest64`]
 523 - [`x86_64::_bittestandcomplement64`]
 524 - [`x86_64::_bittestandreset64`]
 525 - [`x86_64::_bittestandset64`]
 526
 527 The following previously stable functions are now `const`.
 528
 529 - [`str::from_utf8_unchecked`]
 530
 531
 532 Cargo
 533 -----
 534 - [Cargo will now deduplicate compiler diagnostics to the terminal when invoking
 535   rustc in parallel such as when using `cargo test`.][cargo/9675]
 536 - [The package definition in `cargo metadata` now includes the `"default_run"`
 537   field from the manifest.][cargo/9550]
 538 - [Added `cargo d` as an alias for `cargo doc`.][cargo/9680]
 539 - [Added `{lib}` as formatting option for `cargo tree` to print the `"lib_name"`
 540   of packages.][cargo/9663]
 541
 542 Rustdoc
 543 -------
 544 - [Added "Go to item on exact match" search option.][85876]
 545 - [The "Implementors" section on traits no longer shows redundant
 546   method definitions.][85970]
 547 - [Trait implementations are toggled open by default.][86260] This should make the
 548   implementations more searchable by tools like `CTRL+F` in your browser.
 549 - [Intra-doc links should now correctly resolve associated items (e.g. methods)
 550   through type aliases.][86334]
 551 - [Traits which are marked with `#[doc(hidden)]` will no longer appear in the
 552   "Trait Implementations" section.][86513]
 553
 554
 555 Compatibility Notes
 556 -------------------
 557 - [std functions that return an `io::Error` will no longer use the
 558   `ErrorKind::Other` variant.][85746] This is to better reflect that these
 559   kinds of errors could be categorised [into newer more specific `ErrorKind`
 560   variants][79965], and that they do not represent a user error.
 561 - [Using environment variable names with `process::Command` on Windows now
 562   behaves as expected.][85270] Previously using envionment variables with
 563   `Command` would cause them to be ASCII-uppercased.
 564 - [Rustdoc will now warn on using rustdoc lints that aren't prefixed
 565   with `rustdoc::`][86849]
 566 - `RUSTFLAGS` is no longer set for build scripts. Build scripts
 567   should use `CARGO_ENCODED_RUSTFLAGS` instead. See the
 568   [documentation](https://doc.rust-lang.org/nightly/cargo/reference/environment-variables.html#environment-variables-cargo-sets-for-build-scripts)
 569   for more details.
 570
 571 [86849]: https://github.com/rust-lang/rust/pull/86849
 572 [86513]: https://github.com/rust-lang/rust/pull/86513
 573 [86334]: https://github.com/rust-lang/rust/pull/86334
 574 [86260]: https://github.com/rust-lang/rust/pull/86260
 575 [85970]: https://github.com/rust-lang/rust/pull/85970
 576 [85876]: https://github.com/rust-lang/rust/pull/85876
 577 [83572]: https://github.com/rust-lang/rust/pull/83572
 578 [86294]: https://github.com/rust-lang/rust/pull/86294
 579 [86858]: https://github.com/rust-lang/rust/pull/86858
 580 [86761]: https://github.com/rust-lang/rust/pull/86761
 581 [85769]: https://github.com/rust-lang/rust/pull/85769
 582 [85746]: https://github.com/rust-lang/rust/pull/85746
 583 [85305]: https://github.com/rust-lang/rust/pull/85305
 584 [85270]: https://github.com/rust-lang/rust/pull/85270
 585 [84111]: https://github.com/rust-lang/rust/pull/84111
 586 [83918]: https://github.com/rust-lang/rust/pull/83918
 587 [79965]: https://github.com/rust-lang/rust/pull/79965
 588 [87370]: https://github.com/rust-lang/rust/pull/87370
 589 [87298]: https://github.com/rust-lang/rust/pull/87298
 590 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
 591 [cargo/9675]: https://github.com/rust-lang/cargo/pull/9675
 592 [cargo/9550]: https://github.com/rust-lang/cargo/pull/9550
 593 [cargo/9680]: https://github.com/rust-lang/cargo/pull/9680
 594 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
 595 [`array::map`]: https://doc.rust-lang.org/stable/std/primitive.array.html#method.map
 596 [`Bound::cloned`]: https://doc.rust-lang.org/stable/std/ops/enum.Bound.html#method.cloned
 597 [`Drain::as_str`]: https://doc.rust-lang.org/stable/std/string/struct.Drain.html#method.as_str
 598 [`IntoInnerError::into_error`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_error
 599 [`IntoInnerError::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_parts
 600 [`MaybeUninit::assume_init_mut`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_mut
 601 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
 602 [`MaybeUninit::write`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.write
 603 [`Seek::rewind`]: https://doc.rust-lang.org/stable/std/io/trait.Seek.html#method.rewind
 604 [`ops::ControlFlow`]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html
 605 [`str::from_utf8_unchecked`]: https://doc.rust-lang.org/stable/std/str/fn.from_utf8_unchecked.html
 606 [`x86::_bittest`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittest.html
 607 [`x86::_bittestandcomplement`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandcomplement.html
 608 [`x86::_bittestandreset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandreset.html
 609 [`x86::_bittestandset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandset.html
 610 [`x86_64::_bittest64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittest64.html
 611 [`x86_64::_bittestandcomplement64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandcomplement64.html
 612 [`x86_64::_bittestandreset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandreset64.html
 613 [`x86_64::_bittestandset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandset64.html
 614
 615
 616 Version 1.54.0 (2021-07-29)
 617 ============================
 618
 619 Language
 620 -----------------------
 621
 622 - [You can now use macros for values in some built-in attributes.][83366]
 623   This primarily allows you to call macros within the `#[doc]` attribute. For
 624   example, to include external documentation in your crate, you can now write
 625   the following:
 626   ```rust
 627   #![doc = include_str!("README.md")]
 628   ```
 629
 630 - [You can now cast between unsized slice types (and types which contain
 631   unsized slices) in `const fn`.][85078]
 632 - [You can now use multiple generic lifetimes with `impl Trait` where the
 633    lifetimes don't explicitly outlive another.][84701] In code this means
 634    that you can now have `impl Trait<'a, 'b>` where as before you could
 635    only have `impl Trait<'a, 'b> where 'b: 'a`.
 636
 637 Compiler
 638 -----------------------
 639
 640 - [Rustc will now search for custom JSON targets in
 641   `/lib/rustlib/<target-triple>/target.json` where `/` is the "sysroot"
 642   directory.][83800] You can find your sysroot directory by running
 643   `rustc --print sysroot`.
 644 - [Added `wasm` as a `target_family` for WebAssembly platforms.][84072]
 645 - [You can now use `#[target_feature]` on safe functions when targeting
 646   WebAssembly platforms.][84988]
 647 - [Improved debugger output for enums on Windows MSVC platforms.][85292]
 648 - [Added tier 3\* support for `bpfel-unknown-none`
 649    and `bpfeb-unknown-none`.][79608]
 650 - [`-Zmutable-noalias=yes`][82834] is enabled by default when using LLVM 12 or above.
 651
 652 \* Refer to Rust's [platform support page][platform-support-doc] for more
 653    information on Rust's tiered platform support.
 654
 655 Libraries
 656 -----------------------
 657
 658 - [`panic::panic_any` will now `#[track_caller]`.][85745]
 659 - [Added `OutOfMemory` as a variant of `io::ErrorKind`.][84744]
 660 - [ `proc_macro::Literal` now implements `FromStr`.][84717]
 661 - [The implementations of vendor intrinsics in core::arch have been
 662    significantly refactored.][83278] The main user-visible changes are
 663    a 50% reduction in the size of libcore.rlib and stricter validation
 664    of constant operands passed to intrinsics. The latter is technically
 665    a breaking change, but allows Rust to more closely match the C vendor
 666    intrinsics API.
 667
 668 Stabilized APIs
 669 ---------------
 670
 671 - [`BTreeMap::into_keys`]
 672 - [`BTreeMap::into_values`]
 673 - [`HashMap::into_keys`]
 674 - [`HashMap::into_values`]
 675 - [`arch::wasm32`]
 676 - [`VecDeque::binary_search`]
 677 - [`VecDeque::binary_search_by`]
 678 - [`VecDeque::binary_search_by_key`]
 679 - [`VecDeque::partition_point`]
 680
 681 Cargo
 682 -----
 683
 684 - [Added the `--prune <spec>` option to `cargo-tree` to remove a package from
 685   the dependency graph.][cargo/9520]
 686 - [Added the `--depth` option to `cargo-tree` to print only to a certain depth
 687   in the tree ][cargo/9499]
 688 - [Added the `no-proc-macro` value to `cargo-tree --edges` to hide procedural
 689   macro dependencies.][cargo/9488]
 690 - [A new environment variable named `CARGO_TARGET_TMPDIR` is available.][cargo/9375]
 691   This variable points to a directory that integration tests and benches
 692   can use as a "scratchpad" for testing filesystem operations.
 693
 694 Compatibility Notes
 695 -------------------
 696 - [Mixing Option and Result via `?` is no longer permitted in closures for inferred types.][86831]
 697 - [Previously unsound code is no longer permitted where different constructors in branches
 698   could require different lifetimes.][85574]
 699 - As previously mentioned the [`std::arch` instrinsics now uses stricter const checking][83278]
 700   than before and may reject some previously accepted code.
 701 - [`i128` multiplication on Cortex M0+ platforms currently unconditionally causes overflow
 702    when compiled with `codegen-units = 1`.][86063]
 703
 704 [85574]: https://github.com/rust-lang/rust/issues/85574
 705 [86831]: https://github.com/rust-lang/rust/issues/86831
 706 [86063]: https://github.com/rust-lang/rust/issues/86063
 707 [86831]: https://github.com/rust-lang/rust/issues/86831
 708 [79608]: https://github.com/rust-lang/rust/pull/79608
 709 [84988]: https://github.com/rust-lang/rust/pull/84988
 710 [84701]: https://github.com/rust-lang/rust/pull/84701
 711 [84072]: https://github.com/rust-lang/rust/pull/84072
 712 [85745]: https://github.com/rust-lang/rust/pull/85745
 713 [84744]: https://github.com/rust-lang/rust/pull/84744
 714 [85078]: https://github.com/rust-lang/rust/pull/85078
 715 [84717]: https://github.com/rust-lang/rust/pull/84717
 716 [83800]: https://github.com/rust-lang/rust/pull/83800
 717 [83366]: https://github.com/rust-lang/rust/pull/83366
 718 [83278]: https://github.com/rust-lang/rust/pull/83278
 719 [85292]: https://github.com/rust-lang/rust/pull/85292
 720 [82834]: https://github.com/rust-lang/rust/pull/82834
 721 [cargo/9520]: https://github.com/rust-lang/cargo/pull/9520
 722 [cargo/9499]: https://github.com/rust-lang/cargo/pull/9499
 723 [cargo/9488]: https://github.com/rust-lang/cargo/pull/9488
 724 [cargo/9375]: https://github.com/rust-lang/cargo/pull/9375
 725 [`BTreeMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_keys
 726 [`BTreeMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_values
 727 [`HashMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_keys
 728 [`HashMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_values
 729 [`arch::wasm32`]: https://doc.rust-lang.org/core/arch/wasm32/index.html
 730 [`VecDeque::binary_search`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search
 731 [`VecDeque::binary_search_by`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by
 732
 733 [`VecDeque::binary_search_by_key`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by_key
 734
 735 [`VecDeque::partition_point`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.partition_point
 736
 737 Version 1.53.0 (2021-06-17)
 738 ============================
 739
 740 Language
 741 -----------------------
 742 - [You can now use unicode for identifiers.][83799] This allows multilingual
 743   identifiers but still doesn't allow glyphs that are not considered characters
 744   such as `◆` or `🦀`. More specifically you can now use any identifier that
 745   matches the UAX #31 "Unicode Identifier and Pattern Syntax" standard. This
 746   is the same standard as languages like Python, however Rust uses NFC
 747   normalization which may be different from other languages.
 748 - [You can now specify "or patterns" inside pattern matches.][79278]
 749   Previously you could only use `|` (OR) on complete patterns. E.g.
 750   ```rust
 751   let x = Some(2u8);
 752   // Before
 753   matches!(x, Some(1) | Some(2));
 754   // Now
 755   matches!(x, Some(1 | 2));
 756   ```
 757 - [Added the `:pat_param` `macro_rules!` matcher.][83386] This matcher
 758   has the same semantics as the `:pat` matcher. This is to allow `:pat`
 759   to change semantics to being a pattern fragment in a future edition.
 760
 761 Compiler
 762 -----------------------
 763 - [Updated the minimum external LLVM version to LLVM 10.][83387]
 764 - [Added Tier 3\* support for the `wasm64-unknown-unknown` target.][80525]
 765 - [Improved debuginfo for closures and async functions on Windows MSVC.][83941]
 766
 767 \* Refer to Rust's [platform support page][platform-support-doc] for more
 768 information on Rust's tiered platform support.
 769
 770 Libraries
 771 -----------------------
 772 - [Abort messages will now forward to `android_set_abort_message` on
 773   Android platforms when available.][81469]
 774 - [`slice::IterMut<'_, T>` now implements `AsRef<[T]>`][82771]
 775 - [Arrays of any length now implement `IntoIterator`.][84147]
 776   Currently calling `.into_iter()` as a method on an array will
 777   return `impl Iterator<Item=&T>`, but this may change in a
 778   future edition to change `Item` to `T`. Calling `IntoIterator::into_iter`
 779   directly on arrays will provide `impl Iterator<Item=T>` as expected.
 780 - [`leading_zeros`, and `trailing_zeros` are now available on all
 781   `NonZero` integer types.][84082]
 782 - [`{f32, f64}::from_str` now parse and print special values
 783   (`NaN`, `-0`) according to IEEE 754.][78618]
 784 - [You can now index into slices using `(Bound<usize>, Bound<usize>)`.][77704]
 785 - [Add the `BITS` associated constant to all numeric types.][82565]
 786
 787 Stabilised APIs
 788 ---------------
 789 - [`AtomicBool::fetch_update`]
 790 - [`AtomicPtr::fetch_update`]
 791 - [`BTreeMap::retain`]
 792 - [`BTreeSet::retain`]
 793 - [`BufReader::seek_relative`]
 794 - [`DebugStruct::non_exhaustive`]
 795 - [`Duration::MAX`]
 796 - [`Duration::ZERO`]
 797 - [`Duration::is_zero`]
 798 - [`Duration::saturating_add`]
 799 - [`Duration::saturating_mul`]
 800 - [`Duration::saturating_sub`]
 801 - [`ErrorKind::Unsupported`]
 802 - [`Option::insert`]
 803 - [`Ordering::is_eq`]
 804 - [`Ordering::is_ge`]
 805 - [`Ordering::is_gt`]
 806 - [`Ordering::is_le`]
 807 - [`Ordering::is_lt`]
 808 - [`Ordering::is_ne`]
 809 - [`OsStr::is_ascii`]
 810 - [`OsStr::make_ascii_lowercase`]
 811 - [`OsStr::make_ascii_uppercase`]
 812 - [`OsStr::to_ascii_lowercase`]
 813 - [`OsStr::to_ascii_uppercase`]
 814 - [`Peekable::peek_mut`]
 815 - [`Rc::decrement_strong_count`]
 816 - [`Rc::increment_strong_count`]
 817 - [`Vec::extend_from_within`]
 818 - [`array::from_mut`]
 819 - [`array::from_ref`]
 820 - [`cmp::max_by_key`]
 821 - [`cmp::max_by`]
 822 - [`cmp::min_by_key`]
 823 - [`cmp::min_by`]
 824 - [`f32::is_subnormal`]
 825 - [`f64::is_subnormal`]
 826
 827 Cargo
 828 -----------------------
 829 - [Cargo now supports git repositories where the default `HEAD` branch is not
 830   "master".][cargo/9392] This also includes a switch to the version 3 `Cargo.lock` format
 831   which can handle default branches correctly.
 832 - [macOS targets now default to `unpacked` split-debuginfo.][cargo/9298]
 833 - [The `authors` field is no longer included in `Cargo.toml` for new
 834   projects.][cargo/9282]
 835
 836 Rustdoc
 837 -----------------------
 838 - [Added the `rustdoc::bare_urls` lint that warns when you have URLs
 839   without hyperlinks.][81764]
 840
 841 Compatibility Notes
 842 -------------------
 843 - [Implement token-based handling of attributes during expansion][82608]
 844 - [`Ipv4::from_str` will now reject octal format IP addresses in addition
 845   to rejecting hexadecimal IP addresses.][83652] The octal format can lead
 846   to confusion and potential security vulnerabilities and [is no
 847   longer recommended][ietf6943].
 848 - [The added `BITS` constant may conflict with external definitions.][85667]
 849   In particular, this was known to be a problem in the `lexical-core` crate,
 850   but they have published fixes for semantic versions 0.4 through 0.7. To
 851   update this dependency alone, use `cargo update -p lexical-core`.
 852 - Incremental compilation remains off by default, unless one uses the `RUSTC_FORCE_INCREMENTAL=1` environment variable added in 1.52.1.
 853
 854 Internal Only
 855 -------------
 856 These changes provide no direct user facing benefits, but represent significant
 857 improvements to the internals and overall performance of rustc and
 858 related tools.
 859
 860 - [Rework the `std::sys::windows::alloc` implementation.][83065]
 861 - [rustdoc: Don't enter an infer_ctxt in get_blanket_impls for impls that aren't blanket impls.][82864]
 862 - [rustdoc: Only look at blanket impls in `get_blanket_impls`][83681]
 863 - [Rework rustdoc const type][82873]
 864
 865 [85667]: https://github.com/rust-lang/rust/pull/85667
 866 [83386]: https://github.com/rust-lang/rust/pull/83386
 867 [82771]: https://github.com/rust-lang/rust/pull/82771
 868 [84147]: https://github.com/rust-lang/rust/pull/84147
 869 [84082]: https://github.com/rust-lang/rust/pull/84082
 870 [83799]: https://github.com/rust-lang/rust/pull/83799
 871 [83681]: https://github.com/rust-lang/rust/pull/83681
 872 [83652]: https://github.com/rust-lang/rust/pull/83652
 873 [83387]: https://github.com/rust-lang/rust/pull/83387
 874 [82873]: https://github.com/rust-lang/rust/pull/82873
 875 [82864]: https://github.com/rust-lang/rust/pull/82864
 876 [82608]: https://github.com/rust-lang/rust/pull/82608
 877 [82565]: https://github.com/rust-lang/rust/pull/82565
 878 [80525]: https://github.com/rust-lang/rust/pull/80525
 879 [79278]: https://github.com/rust-lang/rust/pull/79278
 880 [78618]: https://github.com/rust-lang/rust/pull/78618
 881 [77704]: https://github.com/rust-lang/rust/pull/77704
 882 [83941]: https://github.com/rust-lang/rust/pull/83941
 883 [83065]: https://github.com/rust-lang/rust/pull/83065
 884 [81764]: https://github.com/rust-lang/rust/pull/81764
 885 [81469]: https://github.com/rust-lang/rust/pull/81469
 886 [cargo/9298]: https://github.com/rust-lang/cargo/pull/9298
 887 [cargo/9282]: https://github.com/rust-lang/cargo/pull/9282
 888 [cargo/9392]: https://github.com/rust-lang/cargo/pull/9392
 889 [`AtomicBool::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicBool.html#method.fetch_update
 890 [`AtomicPtr::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicPtr.html#method.fetch_update
 891 [`BTreeMap::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.retain
 892 [`BTreeSet::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeSet.html#method.retain
 893 [`BufReader::seek_relative`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.seek_relative
 894 [`DebugStruct::non_exhaustive`]: https://doc.rust-lang.org/std/fmt/struct.DebugStruct.html#method.finish_non_exhaustive
 895 [`Duration::MAX`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
 896 [`Duration::ZERO`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.ZERO
 897 [`Duration::is_zero`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.is_zero
 898 [`Duration::saturating_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_add
 899 [`Duration::saturating_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_mul
 900 [`Duration::saturating_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_sub
 901 [`ErrorKind::Unsupported`]: https://doc.rust-lang.org/std/io/enum.ErrorKind.html#variant.Unsupported
 902 [`Option::insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.insert
 903 [`Ordering::is_eq`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_eq
 904 [`Ordering::is_ge`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ge
 905 [`Ordering::is_gt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_gt
 906 [`Ordering::is_le`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_le
 907 [`Ordering::is_lt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_lt
 908 [`Ordering::is_ne`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ne
 909 [`OsStr::eq_ignore_ascii_case`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.eq_ignore_ascii_case
 910 [`OsStr::is_ascii`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.is_ascii
 911 [`OsStr::make_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_lowercase
 912 [`OsStr::make_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_uppercase
 913 [`OsStr::to_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_lowercase
 914 [`OsStr::to_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_uppercase
 915 [`Peekable::peek_mut`]: https://doc.rust-lang.org/std/iter/struct.Peekable.html#method.peek_mut
 916 [`Rc::decrement_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
 917 [`Rc::increment_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
 918 [`Vec::extend_from_within`]: https://doc.rust-lang.org/beta/std/vec/struct.Vec.html#method.extend_from_within
 919 [`array::from_mut`]: https://doc.rust-lang.org/beta/std/array/fn.from_mut.html
 920 [`array::from_ref`]: https://doc.rust-lang.org/beta/std/array/fn.from_ref.html
 921 [`cmp::max_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by_key.html
 922 [`cmp::max_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by.html
 923 [`cmp::min_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by_key.html
 924 [`cmp::min_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by.html
 925 [`f32::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
 926 [`f64::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
 927 [ietf6943]: https://datatracker.ietf.org/doc/html/rfc6943#section-3.1.1
 928
 929
 930 Version 1.52.1 (2021-05-10)
 931 ============================
 932
 933 This release disables incremental compilation, unless the user has explicitly
 934 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
 935
 936 This is due to the widespread, and frequently occuring, breakage encountered by
 937 Rust users due to newly enabled incremental verification in 1.52.0. Notably,
 938 Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
 939 newly added incremental verification are still present in past stable versions,
 940 and are not yet fixed on any channel. These bugs can lead to miscompilation of
 941 Rust binaries.
 942
 943 These problems only affect incremental builds, so release builds with Cargo
 944 should not be affected unless the user has explicitly opted into incremental.
 945 Debug and check builds are affected.
 946
 947 See [84970] for more details.
 948
 949 [84970]: https://github.com/rust-lang/rust/issues/84970
 950
 951 Version 1.52.0 (2021-05-06)
 952 ============================
 953
 954 Language
 955 --------
 956 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
 957   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
 958   is allowed by default, and may become a warning or hard error in a
 959   future edition.
 960 - [You can now cast mutable references to arrays to a pointer of the same type as
 961   the element.][81479]
 962
 963 Compiler
 964 --------
 965 - [Upgraded the default LLVM to LLVM 12.][81451]
 966
 967 Added tier 3\* support for the following targets.
 968
 969 - [`s390x-unknown-linux-musl`][82166]
 970 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
 971 - [`powerpc-unknown-openbsd`][82733]
 972
 973 \* Refer to Rust's [platform support page][platform-support-doc] for more
 974 information on Rust's tiered platform support.
 975
 976 Libraries
 977 ---------
 978 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
 979 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
 980 - [`Arc<impl Error>` now implements `error::Error`.][80553]
 981 - [All integer division and remainder operations are now `const`.][80962]
 982
 983 Stabilised APIs
 984 -------------
 985 - [`Arguments::as_str`]
 986 - [`char::MAX`]
 987 - [`char::REPLACEMENT_CHARACTER`]
 988 - [`char::UNICODE_VERSION`]
 989 - [`char::decode_utf16`]
 990 - [`char::from_digit`]
 991 - [`char::from_u32_unchecked`]
 992 - [`char::from_u32`]
 993 - [`slice::partition_point`]
 994 - [`str::rsplit_once`]
 995 - [`str::split_once`]
 996
 997 The following previously stable APIs are now `const`.
 998
 999 - [`char::len_utf8`]
1000 - [`char::len_utf16`]
1001 - [`char::to_ascii_uppercase`]
1002 - [`char::to_ascii_lowercase`]
1003 - [`char::eq_ignore_ascii_case`]
1004 - [`u8::to_ascii_uppercase`]
1005 - [`u8::to_ascii_lowercase`]
1006 - [`u8::eq_ignore_ascii_case`]
1007
1008 Rustdoc
1009 -------
1010 - [Rustdoc lints are now treated as a tool lint, meaning that
1011   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
1012   Using the old style is still allowed, and will become a warning in
1013   a future release.
1014 - [Rustdoc now supports argument files.][82261]
1015 - [Rustdoc now generates smart punctuation for documentation.][79423]
1016 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
1017   ```markdown
1018   - [x] Complete
1019   - [ ] Todo
1020   ```
1021
1022 Misc
1023 ----
1024 - [You can now pass multiple filters to tests.][81356] E.g.
1025   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
1026 - [Rustup now distributes PDB symbols for the `std` library on Windows,
1027   allowing you to see `std` symbols when debugging.][82218]
1028
1029 Internal Only
1030 -------------
1031 These changes provide no direct user facing benefits, but represent significant
1032 improvements to the internals and overall performance of rustc and
1033 related tools.
1034
1035 - [Check the result cache before the DepGraph when ensuring queries][81855]
1036 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
1037 - [Only store a LocalDefId in some HIR nodes][81611]
1038 - [Store HIR attributes in a side table][79519]
1039
1040 Compatibility Notes
1041 -------------------
1042 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
1043 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
1044 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
1045 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
1046   languages in code blocks.][78429]
1047 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
1048 - [Changes in how proc macros handle whitespace may lead to panics when used
1049   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
1050 - [Turn `#[derive]` into a regular macro attribute][79078]
1051
1052 [84136]: https://github.com/rust-lang/rust/issues/84136
1053 [80763]: https://github.com/rust-lang/rust/pull/80763
1054 [82166]: https://github.com/rust-lang/rust/pull/82166
1055 [82121]: https://github.com/rust-lang/rust/pull/82121
1056 [81879]: https://github.com/rust-lang/rust/pull/81879
1057 [82261]: https://github.com/rust-lang/rust/pull/82261
1058 [82218]: https://github.com/rust-lang/rust/pull/82218
1059 [82216]: https://github.com/rust-lang/rust/pull/82216
1060 [82202]: https://github.com/rust-lang/rust/pull/82202
1061 [81855]: https://github.com/rust-lang/rust/pull/81855
1062 [81766]: https://github.com/rust-lang/rust/pull/81766
1063 [81744]: https://github.com/rust-lang/rust/pull/81744
1064 [81611]: https://github.com/rust-lang/rust/pull/81611
1065 [81479]: https://github.com/rust-lang/rust/pull/81479
1066 [81451]: https://github.com/rust-lang/rust/pull/81451
1067 [81356]: https://github.com/rust-lang/rust/pull/81356
1068 [80962]: https://github.com/rust-lang/rust/pull/80962
1069 [80553]: https://github.com/rust-lang/rust/pull/80553
1070 [80527]: https://github.com/rust-lang/rust/pull/80527
1071 [79519]: https://github.com/rust-lang/rust/pull/79519
1072 [79423]: https://github.com/rust-lang/rust/pull/79423
1073 [79208]: https://github.com/rust-lang/rust/pull/79208
1074 [78429]: https://github.com/rust-lang/rust/pull/78429
1075 [82733]: https://github.com/rust-lang/rust/pull/82733
1076 [82594]: https://github.com/rust-lang/rust/pull/82594
1077 [79078]: https://github.com/rust-lang/rust/pull/79078
1078 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
1079 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
1080 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
1081 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
1082 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
1083 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
1084 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
1085 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
1086 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
1087 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
1088 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
1089 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
1090 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
1091 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
1092 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
1093 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
1094 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
1095 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
1096 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
1097 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
1098 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
1099 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
1100
1101 Version 1.51.0 (2021-03-25)
1102 ============================
1103
1104 Language
1105 --------
1106 - [You can now parameterize items such as functions, traits, and `struct`s by constant
1107   values in addition to by types and lifetimes.][79135] Also known as "const generics"
1108   E.g. you can now write the following. Note: Only values of primitive integers,
1109   `bool`, or `char` types are currently permitted.
1110   ```rust
1111   struct GenericArray<T, const LENGTH: usize> {
1112       inner: [T; LENGTH]
1113   }
1114
1115   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
1116       const fn last(&self) -> Option<&T> {
1117           if LENGTH == 0 {
1118               None
1119           } else {
1120               Some(&self.inner[LENGTH - 1])
1121           }
1122       }
1123   }
1124   ```
1125
1126
1127 Compiler
1128 --------
1129
1130 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
1131   This option controls whether debug information is split across multiple files
1132   or packed into a single file. **Note** This option is unstable on other platforms.
1133 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
1134   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
1135 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
1136 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
1137
1138 \* Refer to Rust's [platform support page][platform-support-doc] for more
1139 information on Rust's tiered platform support.
1140
1141 Libraries
1142 ---------
1143
1144 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
1145 - [`str` now implements `AsMut<str>`.][80279]
1146 - [`u64` and `u128` now implement `From<char>`.][79502]
1147 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
1148 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
1149 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
1150 - [`io::Empty` now implements `io::Seek`.][78044]
1151 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
1152   `T: ?Sized` types.][80764]
1153 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
1154
1155
1156 Stabilized APIs
1157 ---------------
1158
1159 - [`Arc::decrement_strong_count`]
1160 - [`Arc::increment_strong_count`]
1161 - [`Once::call_once_force`]
1162 - [`Peekable::next_if_eq`]
1163 - [`Peekable::next_if`]
1164 - [`Seek::stream_position`]
1165 - [`array::IntoIter`]
1166 - [`panic::panic_any`]
1167 - [`ptr::addr_of!`]
1168 - [`ptr::addr_of_mut!`]
1169 - [`slice::fill_with`]
1170 - [`slice::split_inclusive_mut`]
1171 - [`slice::split_inclusive`]
1172 - [`slice::strip_prefix`]
1173 - [`slice::strip_suffix`]
1174 - [`str::split_inclusive`]
1175 - [`sync::OnceState`]
1176 - [`task::Wake`]
1177 - [`VecDeque::range`]
1178 - [`VecDeque::range_mut`]
1179
1180 Cargo
1181 -----
1182 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
1183   codegen option.][cargo/9112]
1184 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
1185   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
1186   to avoid unifying features of dependencies where that unification could be unwanted.
1187   Such as using the same dependency with a `std` feature in a build scripts and
1188   proc-macros, while using the `no-std` feature in the final binary. See the
1189   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
1190
1191 Rustdoc
1192 -------
1193
1194 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
1195 - [You can now provide a `--default-theme` flag which sets the default theme to use for
1196   documentation.][79642]
1197
1198 Various improvements to intra-doc links:
1199
1200 - [You can link to non-path primitives such as `slice`.][80181]
1201 - [You can link to associated items.][74489]
1202 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
1203
1204 Misc
1205 ----
1206 - [You can now pass `--include-ignored` to tests (e.g. with
1207   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
1208
1209 Compatibility Notes
1210 -------------------
1211
1212 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
1213 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
1214   could fail.][80579]
1215 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
1216   for the distributed artifacts.][81521]
1217     - `armv5te-unknown-linux-gnueabi`
1218     - `sparc64-unknown-linux-gnu`
1219     - `thumbv7neon-unknown-linux-gnueabihf`
1220     - `armv7-unknown-linux-gnueabi`
1221     - `x86_64-unknown-linux-gnux32`
1222 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
1223
1224 Internal Only
1225 -------------
1226
1227 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
1228
1229 [79135]: https://github.com/rust-lang/rust/pull/79135
1230 [74489]: https://github.com/rust-lang/rust/pull/74489
1231 [76934]: https://github.com/rust-lang/rust/pull/76934
1232 [79570]: https://github.com/rust-lang/rust/pull/79570
1233 [80181]: https://github.com/rust-lang/rust/pull/80181
1234 [79642]: https://github.com/rust-lang/rust/pull/79642
1235 [80945]: https://github.com/rust-lang/rust/pull/80945
1236 [80279]: https://github.com/rust-lang/rust/pull/80279
1237 [80053]: https://github.com/rust-lang/rust/pull/80053
1238 [79502]: https://github.com/rust-lang/rust/pull/79502
1239 [75180]: https://github.com/rust-lang/rust/pull/75180
1240 [79135]: https://github.com/rust-lang/rust/pull/79135
1241 [81521]: https://github.com/rust-lang/rust/pull/81521
1242 [80968]: https://github.com/rust-lang/rust/pull/80968
1243 [80959]: https://github.com/rust-lang/rust/pull/80959
1244 [80718]: https://github.com/rust-lang/rust/pull/80718
1245 [80653]: https://github.com/rust-lang/rust/pull/80653
1246 [80579]: https://github.com/rust-lang/rust/pull/80579
1247 [79998]: https://github.com/rust-lang/rust/pull/79998
1248 [78044]: https://github.com/rust-lang/rust/pull/78044
1249 [81455]: https://github.com/rust-lang/rust/pull/81455
1250 [80764]: https://github.com/rust-lang/rust/pull/80764
1251 [80749]: https://github.com/rust-lang/rust/pull/80749
1252 [80662]: https://github.com/rust-lang/rust/pull/80662
1253 [79134]: https://github.com/rust-lang/rust/pull/79134
1254 [80966]: https://github.com/rust-lang/rust/pull/80966
1255 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
1256 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
1257 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
1258 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
1259 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
1260 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
1261 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
1262 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
1263 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
1264 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
1265 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
1266 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
1267 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
1268 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
1269 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
1270 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
1271 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
1272 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
1273 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
1274 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
1275 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
1276 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
1277 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
1278
1279 Version 1.50.0 (2021-02-11)
1280 ============================
1281
1282 Language
1283 -----------------------
1284 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
1285   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
1286 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
1287
1288 Compiler
1289 -----------------------
1290 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
1291 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
1292 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
1293 - [Dropped support for all cloudabi targets.][78439]
1294
1295 \* Refer to Rust's [platform support page][platform-support-doc] for more
1296 information on Rust's tiered platform support.
1297
1298 Libraries
1299 -----------------------
1300
1301 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
1302 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
1303 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
1304   This value cannot be a valid file descriptor, and now means `Option<File>` takes
1305   up the same amount of space as `File`.
1306
1307 Stabilized APIs
1308 ---------------
1309
1310 - [`bool::then`]
1311 - [`btree_map::Entry::or_insert_with_key`]
1312 - [`f32::clamp`]
1313 - [`f64::clamp`]
1314 - [`hash_map::Entry::or_insert_with_key`]
1315 - [`Ord::clamp`]
1316 - [`RefCell::take`]
1317 - [`slice::fill`]
1318 - [`UnsafeCell::get_mut`]
1319
1320 The following previously stable methods are now `const`.
1321
1322 - [`IpAddr::is_ipv4`]
1323 - [`IpAddr::is_ipv6`]
1324 - [`IpAddr::is_unspecified`]
1325 - [`IpAddr::is_loopback`]
1326 - [`IpAddr::is_multicast`]
1327 - [`Ipv4Addr::octets`]
1328 - [`Ipv4Addr::is_loopback`]
1329 - [`Ipv4Addr::is_private`]
1330 - [`Ipv4Addr::is_link_local`]
1331 - [`Ipv4Addr::is_multicast`]
1332 - [`Ipv4Addr::is_broadcast`]
1333 - [`Ipv4Addr::is_documentation`]
1334 - [`Ipv4Addr::to_ipv6_compatible`]
1335 - [`Ipv4Addr::to_ipv6_mapped`]
1336 - [`Ipv6Addr::segments`]
1337 - [`Ipv6Addr::is_unspecified`]
1338 - [`Ipv6Addr::is_loopback`]
1339 - [`Ipv6Addr::is_multicast`]
1340 - [`Ipv6Addr::to_ipv4`]
1341 - [`Layout::size`]
1342 - [`Layout::align`]
1343 - [`Layout::from_size_align`]
1344 - `pow` for all integer types.
1345 - `checked_pow` for all integer types.
1346 - `saturating_pow` for all integer types.
1347 - `wrapping_pow` for all integer types.
1348 - `next_power_of_two` for all unsigned integer types.
1349 - `checked_next_power_of_two` for all unsigned integer types.
1350
1351 Cargo
1352 -----------------------
1353
1354 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
1355   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
1356 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
1357   contents of that directory for changes.][cargo/8973]
1358 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
1359
1360 Misc
1361 ----
1362
1363 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
1364 - [Running tests will now print the total time taken to execute.][75752]
1365
1366 Compatibility Notes
1367 -------------------
1368
1369 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
1370   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
1371 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
1372   unhygenic `macro_rules!` macros.][79472]
1373 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
1374   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
1375 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
1376 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
1377   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
1378 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
1379
1380 [74989]: https://github.com/rust-lang/rust/pull/74989
1381 [79261]: https://github.com/rust-lang/rust/pull/79261
1382 [79896]: https://github.com/rust-lang/rust/pull/79896
1383 [79484]: https://github.com/rust-lang/rust/pull/79484
1384 [79472]: https://github.com/rust-lang/rust/pull/79472
1385 [79270]: https://github.com/rust-lang/rust/pull/79270
1386 [79003]: https://github.com/rust-lang/rust/pull/79003
1387 [78864]: https://github.com/rust-lang/rust/pull/78864
1388 [78636]: https://github.com/rust-lang/rust/pull/78636
1389 [78439]: https://github.com/rust-lang/rust/pull/78439
1390 [78343]: https://github.com/rust-lang/rust/pull/78343
1391 [78296]: https://github.com/rust-lang/rust/pull/78296
1392 [78068]: https://github.com/rust-lang/rust/pull/78068
1393 [75752]: https://github.com/rust-lang/rust/pull/75752
1394 [74699]: https://github.com/rust-lang/rust/pull/74699
1395 [78142]: https://github.com/rust-lang/rust/pull/78142
1396 [77484]: https://github.com/rust-lang/rust/pull/77484
1397 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
1398 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
1399 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
1400 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
1401 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
1402 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
1403 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
1404 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
1405 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
1406 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
1407 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
1408 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
1409 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
1410 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
1411 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
1412 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
1413 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
1414 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
1415 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
1416 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
1417 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
1418 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
1419 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
1420 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
1421 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
1422 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
1423 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
1424 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
1425 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
1426 [`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
1427 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
1428 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
1429 [`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
1430 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
1431
1432
1433 Version 1.49.0 (2020-12-31)
1434 ============================
1435
1436 Language
1437 -----------------------
1438
1439 - [Unions can now implement `Drop`, and you can now have a field in a union
1440   with `ManuallyDrop<T>`.][77547]
1441 - [You can now cast uninhabited enums to integers.][76199]
1442 - [You can now bind by reference and by move in patterns.][76119] This
1443   allows you to selectively borrow individual components of a type. E.g.
1444   ```rust
1445   #[derive(Debug)]
1446   struct Person {
1447       name: String,
1448       age: u8,
1449   }
1450
1451   let person = Person {
1452       name: String::from("Alice"),
1453       age: 20,
1454   };
1455
1456   // `name` is moved out of person, but `age` is referenced.
1457   let Person { name, ref age } = person;
1458   println!("{} {}", name, age);
1459   ```
1460
1461 Compiler
1462 -----------------------
1463
1464 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
1465 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
1466 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
1467 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
1468 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
1469 - [Output from threads spawned in tests is now captured.][78227]
1470 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
1471
1472 \* Refer to Rust's [platform support page][platform-support-doc] for more
1473 information on Rust's tiered platform support.
1474
1475 Libraries
1476 -----------------------
1477
1478 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
1479 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
1480
1481 Stabilized APIs
1482 ---------------
1483
1484 - [`slice::select_nth_unstable`]
1485 - [`slice::select_nth_unstable_by`]
1486 - [`slice::select_nth_unstable_by_key`]
1487
1488 The following previously stable methods are now `const`.
1489
1490 - [`Poll::is_ready`]
1491 - [`Poll::is_pending`]
1492
1493 Cargo
1494 -----------------------
1495 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
1496 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
1497 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
1498   variable will be set if the crate being built is one the user selected to build, either
1499   with `-p` or through defaults.
1500 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
1501
1502
1503 Compatibility Notes
1504 -------------------
1505
1506 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
1507 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
1508 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
1509   Previously such invalid or unused attributes could be ignored.
1510 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
1511   read [this post about the changes][rustdoc-ws-post] for more details.
1512 - [Trait bounds are no longer inferred for associated types.][79904]
1513
1514 Internal Only
1515 -------------
1516 These changes provide no direct user facing benefits, but represent significant
1517 improvements to the internals and overall performance of rustc and
1518 related tools.
1519
1520 - [rustc's internal crates are now compiled using the `initial-exec` Thread
1521   Local Storage model.][78201]
1522 - [Calculate visibilities once in resolve.][78077]
1523 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
1524 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
1525
1526
1527 [75991]: https://github.com/rust-lang/rust/pull/75991
1528 [78951]: https://github.com/rust-lang/rust/pull/78951
1529 [78848]: https://github.com/rust-lang/rust/pull/78848
1530 [78746]: https://github.com/rust-lang/rust/pull/78746
1531 [78376]: https://github.com/rust-lang/rust/pull/78376
1532 [78228]: https://github.com/rust-lang/rust/pull/78228
1533 [78227]: https://github.com/rust-lang/rust/pull/78227
1534 [78201]: https://github.com/rust-lang/rust/pull/78201
1535 [78109]: https://github.com/rust-lang/rust/pull/78109
1536 [78077]: https://github.com/rust-lang/rust/pull/78077
1537 [77997]: https://github.com/rust-lang/rust/pull/77997
1538 [77703]: https://github.com/rust-lang/rust/pull/77703
1539 [77547]: https://github.com/rust-lang/rust/pull/77547
1540 [77015]: https://github.com/rust-lang/rust/pull/77015
1541 [76199]: https://github.com/rust-lang/rust/pull/76199
1542 [76119]: https://github.com/rust-lang/rust/pull/76119
1543 [75914]: https://github.com/rust-lang/rust/pull/75914
1544 [79004]: https://github.com/rust-lang/rust/pull/79004
1545 [78676]: https://github.com/rust-lang/rust/pull/78676
1546 [79904]: https://github.com/rust-lang/rust/issues/79904
1547 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
1548 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
1549 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
1550 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
1551 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
1552 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
1553 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
1554 [`hint::spin_loop`]: https://doc.rust-lang.org/stable/std/hint/fn.spin_loop.html
1555 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
1556 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
1557 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
1558
1559 Version 1.48.0 (2020-11-19)
1560 ==========================
1561
1562 Language
1563 --------
1564
1565 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
1566   is still rejected *semantically*, but can now be parsed by procedural macros.
1567
1568 Compiler
1569 --------
1570 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
1571   `rustc` whether to link its own C runtime and libraries or to rely on a external
1572   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
1573 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
1574   Note: If you're using cargo you must explicitly pass the `--target` flag.
1575 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
1576
1577 \* Refer to Rust's [platform support page][platform-support-doc] for more
1578 information on Rust's tiered platform support.
1579
1580 Libraries
1581 ---------
1582 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
1583   and `&Stderr`.][76275]
1584 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
1585 - [The `matches!` macro now supports having a trailing comma.][74880]
1586 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
1587 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
1588
1589 Stabilized APIs
1590 ---------------
1591 - [`slice::as_ptr_range`]
1592 - [`slice::as_mut_ptr_range`]
1593 - [`VecDeque::make_contiguous`]
1594 - [`future::pending`]
1595 - [`future::ready`]
1596
1597 The following previously stable methods are now `const fn`'s:
1598
1599 - [`Option::is_some`]
1600 - [`Option::is_none`]
1601 - [`Option::as_ref`]
1602 - [`Result::is_ok`]
1603 - [`Result::is_err`]
1604 - [`Result::as_ref`]
1605 - [`Ordering::reverse`]
1606 - [`Ordering::then`]
1607
1608 Cargo
1609 -----
1610
1611 Rustdoc
1612 -------
1613 - [You can now link to items in `rustdoc` using the intra-doc link
1614   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
1615   a link to `std::future`'s documentation. See ["Linking to items by
1616   name"][intradoc-links] for more information.
1617 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
1618   when searching through `rustdoc`'s UI.][75740]
1619
1620 Compatibility Notes
1621 -------------------
1622 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
1623   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
1624   promoted to `'static` lifetime any more inside `const fn`s.
1625 - [Associated type bindings on trait objects are now verified to meet the bounds
1626   declared on the trait when checking that they implement the trait.][27675]
1627 - [When trait bounds on associated types or opaque types are ambiguous, the
1628   compiler no longer makes an arbitrary choice on which bound to use.][54121]
1629 - [Fixed recursive nonterminals not being expanded in macros during
1630   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
1631   correctly handling recursive nonterminal tokens.
1632 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
1633 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
1634   in places where they have no effect.][73461]
1635 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
1636   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
1637 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
1638   disallow zero-initialization.][71274]
1639 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
1640 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
1641   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
1642   see the [`catch_unwind`] documentation for further information.
1643
1644
1645
1646 Internal Only
1647 -------------
1648 These changes provide no direct user facing benefits, but represent significant
1649 improvements to the internals and overall performance of rustc and
1650 related tools.
1651
1652 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
1653   You can continue building with `make` by setting `ninja=false` in
1654   your `config.toml`.
1655 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
1656 - [Made `ensure_sufficient_stack()` non-generic][76680]
1657
1658 [78143]: https://github.com/rust-lang/rust/issues/78143
1659 [76680]: https://github.com/rust-lang/rust/pull/76680/
1660 [76030]: https://github.com/rust-lang/rust/pull/76030/
1661 [70212]: https://github.com/rust-lang/rust/pull/70212/
1662 [27675]: https://github.com/rust-lang/rust/issues/27675/
1663 [54121]: https://github.com/rust-lang/rust/issues/54121/
1664 [71274]: https://github.com/rust-lang/rust/pull/71274/
1665 [77386]: https://github.com/rust-lang/rust/pull/77386/
1666 [77153]: https://github.com/rust-lang/rust/pull/77153/
1667 [77055]: https://github.com/rust-lang/rust/pull/77055/
1668 [76275]: https://github.com/rust-lang/rust/pull/76275/
1669 [76310]: https://github.com/rust-lang/rust/pull/76310/
1670 [76420]: https://github.com/rust-lang/rust/pull/76420/
1671 [76158]: https://github.com/rust-lang/rust/pull/76158/
1672 [75857]: https://github.com/rust-lang/rust/pull/75857/
1673 [75585]: https://github.com/rust-lang/rust/pull/75585/
1674 [75740]: https://github.com/rust-lang/rust/pull/75740/
1675 [75502]: https://github.com/rust-lang/rust/pull/75502/
1676 [74880]: https://github.com/rust-lang/rust/pull/74880/
1677 [74922]: https://github.com/rust-lang/rust/pull/74922/
1678 [74430]: https://github.com/rust-lang/rust/pull/74430/
1679 [74194]: https://github.com/rust-lang/rust/pull/74194/
1680 [73461]: https://github.com/rust-lang/rust/pull/73461/
1681 [73166]: https://github.com/rust-lang/rust/pull/73166/
1682 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
1683 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
1684 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
1685 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
1686 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
1687 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
1688 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
1689 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
1690 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
1691 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
1692 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
1693 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
1694 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
1695 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
1696 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
1697
1698
1699 Version 1.47.0 (2020-10-08)
1700 ==========================
1701
1702 Language
1703 --------
1704 - [Closures will now warn when not used.][74869]
1705
1706 Compiler
1707 --------
1708 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
1709   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
1710   platforms.
1711 - [Upgraded to LLVM 11.][73526]
1712 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
1713 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
1714 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
1715
1716 \* Refer to Rust's [platform support page][platform-support-doc] for more
1717 information on Rust's tiered platform support.
1718
1719 Libraries
1720 ---------
1721 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
1722 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
1723   those of length less than 33.][74060]
1724 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
1725 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
1726   `PartialEq`, and `PartialOrd`.][73583]
1727
1728 Stabilized APIs
1729 ---------------
1730 - [`Ident::new_raw`]
1731 - [`Range::is_empty`]
1732 - [`RangeInclusive::is_empty`]
1733 - [`Result::as_deref`]
1734 - [`Result::as_deref_mut`]
1735 - [`Vec::leak`]
1736 - [`pointer::offset_from`]
1737 - [`f32::TAU`]
1738 - [`f64::TAU`]
1739
1740 The following previously stable APIs have now been made const.
1741
1742 - [The `new` method for all `NonZero` integers.][73858]
1743 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
1744   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
1745   methods for all integers.][73858]
1746 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
1747   signed integers.][73858]
1748 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
1749   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
1750   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
1751   `is_ascii_control` methods for `char` and `u8`.][73858]
1752
1753 Cargo
1754 -----
1755 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
1756   You can override this by setting the following in your `Cargo.toml`.
1757   ```toml
1758   [profile.release.build-override]
1759   opt-level = 3
1760   ```
1761 - [`cargo-help` will now display man pages for commands rather just the
1762   `--help` text.][cargo/8456]
1763 - [`cargo-metadata` now emits a `test` field indicating if a target has
1764   tests enabled.][cargo/8478]
1765 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
1766 - [`cargo-publish` will now use an alternative registry by default if it's the
1767   only registry specified in `package.publish`.][cargo/8571]
1768
1769 Misc
1770 ----
1771 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
1772   type based search.][75366]
1773 - [Added the Ayu theme to rustdoc.][71237]
1774
1775 Compatibility Notes
1776 -------------------
1777 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
1778 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
1779 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
1780   help to preserve more span information.][73084] These changes may cause
1781   compiliation errors if your macro was unhygenic or didn't correctly handle
1782   `Delimiter::None`.
1783 - [Moved support for the CloudABI target to tier 3.][75568]
1784 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
1785 - [Added the `rustc-docs` component.][75560] This allows you to install
1786   and read the documentation for the compiler internal APIs. (Currently only
1787   available for `x86_64-unknown-linux-gnu`.)
1788
1789 Internal Only
1790 --------
1791
1792 - [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.
1793
1794 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
1795 [75048]: https://github.com/rust-lang/rust/pull/75048/
1796 [74163]: https://github.com/rust-lang/rust/pull/74163/
1797 [71237]: https://github.com/rust-lang/rust/pull/71237/
1798 [74869]: https://github.com/rust-lang/rust/pull/74869/
1799 [73858]: https://github.com/rust-lang/rust/pull/73858/
1800 [75716]: https://github.com/rust-lang/rust/pull/75716/
1801 [75908]: https://github.com/rust-lang/rust/pull/75908/
1802 [75516]: https://github.com/rust-lang/rust/pull/75516/
1803 [75560]: https://github.com/rust-lang/rust/pull/75560/
1804 [75568]: https://github.com/rust-lang/rust/pull/75568/
1805 [75366]: https://github.com/rust-lang/rust/pull/75366/
1806 [75204]: https://github.com/rust-lang/rust/pull/75204/
1807 [74650]: https://github.com/rust-lang/rust/pull/74650/
1808 [74419]: https://github.com/rust-lang/rust/pull/74419/
1809 [73964]: https://github.com/rust-lang/rust/pull/73964/
1810 [74021]: https://github.com/rust-lang/rust/pull/74021/
1811 [74060]: https://github.com/rust-lang/rust/pull/74060/
1812 [73893]: https://github.com/rust-lang/rust/pull/73893/
1813 [73526]: https://github.com/rust-lang/rust/pull/73526/
1814 [73583]: https://github.com/rust-lang/rust/pull/73583/
1815 [73084]: https://github.com/rust-lang/rust/pull/73084/
1816 [73197]: https://github.com/rust-lang/rust/pull/73197/
1817 [72488]: https://github.com/rust-lang/rust/pull/72488/
1818 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
1819 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
1820 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
1821 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
1822 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
1823 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
1824 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
1825 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
1826 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
1827 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
1828 [`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
1829 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
1830 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
1831 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
1832 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
1833
1834
1835 Version 1.46.0 (2020-08-27)
1836 ==========================
1837
1838 Language
1839 --------
1840 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
1841 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
1842   const functions.][73862]
1843 - [The `#[track_caller]` attribute can now be added to functions to use the
1844   function's caller's location information for panic messages.][72445]
1845 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
1846   `x.0.0` over `(x.0).0`.
1847 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
1848   You currently can't use `mem::transmute` in constant functions.
1849
1850 Compiler
1851 --------
1852 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
1853 - [Enabled static "Position Independent Executables" by default
1854   for `x86_64-unknown-linux-musl`.][70740]
1855
1856 Libraries
1857 ---------
1858 - [`mem::forget` is now a `const fn`.][73887]
1859 - [`String` now implements `From<char>`.][73466]
1860 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
1861   integer types.][73032]
1862 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
1863 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
1864   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
1865 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
1866 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
1867 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
1868
1869 Stabilized APIs
1870 ---------------
1871 - [`Option::zip`]
1872 - [`vec::Drain::as_slice`]
1873
1874 Cargo
1875 -----
1876 Added a number of new environment variables that are now available when
1877 compiling your crate.
1878
1879 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
1880   the specific binary being compiled and the name of the crate.
1881 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
1882 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
1883
1884 Compatibility Notes
1885 -------------------
1886 - [The target configuration option `abi_blacklist` has been renamed
1887   to `unsupported_abis`.][74150] The old name will still continue to work.
1888 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
1889   This was previously accepted but will become a hard error in a future release.
1890 - [Rustc will fail to compile if you have a struct with
1891   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
1892   allowed on `enum`s.
1893 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
1894   ensure that spans have the correct information, and may cause breakage if you
1895   were relying on receiving spans with dummy information.
1896 - [The InnoSetup installer for Windows is no longer available.][72569] This was
1897   a legacy installer that was replaced by a MSI installer a few years ago but
1898   was still being built.
1899 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
1900 - [Rustc will no longer accept overlapping trait implementations that only
1901   differ in how the lifetime was bound.][72493]
1902 - [Rustc now correctly relates the lifetime of an existential associated
1903   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
1904   you to pass a shorter lifetime than expected.
1905 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
1906   The library will need to be installed for `rustc` to work, even though we
1907   expect it to be already available on most systems.
1908 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
1909   under QEMU.][74820]
1910 - [Pretty printing of some tokens in procedural macros changed.][75453] The
1911   exact output returned by rustc's pretty printing is an unstable
1912   implementation detail: we recommend any macro relying on it to switch to a
1913   more robust parsing system.
1914
1915 [75453]: https://github.com/rust-lang/rust/issues/75453/
1916 [74820]: https://github.com/rust-lang/rust/issues/74820/
1917 [74420]: https://github.com/rust-lang/rust/issues/74420/
1918 [74109]: https://github.com/rust-lang/rust/pull/74109/
1919 [74150]: https://github.com/rust-lang/rust/pull/74150/
1920 [73862]: https://github.com/rust-lang/rust/pull/73862/
1921 [73887]: https://github.com/rust-lang/rust/pull/73887/
1922 [73466]: https://github.com/rust-lang/rust/pull/73466/
1923 [73516]: https://github.com/rust-lang/rust/pull/73516/
1924 [73293]: https://github.com/rust-lang/rust/pull/73293/
1925 [73007]: https://github.com/rust-lang/rust/pull/73007/
1926 [73032]: https://github.com/rust-lang/rust/pull/73032/
1927 [72920]: https://github.com/rust-lang/rust/pull/72920/
1928 [72569]: https://github.com/rust-lang/rust/pull/72569/
1929 [72583]: https://github.com/rust-lang/rust/pull/72583/
1930 [72584]: https://github.com/rust-lang/rust/pull/72584/
1931 [72717]: https://github.com/rust-lang/rust/pull/72717/
1932 [72437]: https://github.com/rust-lang/rust/pull/72437/
1933 [72445]: https://github.com/rust-lang/rust/pull/72445/
1934 [72486]: https://github.com/rust-lang/rust/pull/72486/
1935 [72493]: https://github.com/rust-lang/rust/pull/72493/
1936 [72331]: https://github.com/rust-lang/rust/pull/72331/
1937 [71896]: https://github.com/rust-lang/rust/pull/71896/
1938 [71660]: https://github.com/rust-lang/rust/pull/71660/
1939 [71322]: https://github.com/rust-lang/rust/pull/71322/
1940 [70740]: https://github.com/rust-lang/rust/pull/70740/
1941 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
1942 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
1943 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
1944 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
1945 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
1946
1947
1948 Version 1.45.2 (2020-08-03)
1949 ==========================
1950
1951 * [Fix bindings in tuple struct patterns][74954]
1952 * [Fix track_caller integration with trait objects][74784]
1953
1954 [74954]: https://github.com/rust-lang/rust/issues/74954
1955 [74784]: https://github.com/rust-lang/rust/issues/74784
1956
1957
1958 Version 1.45.1 (2020-07-30)
1959 ==========================
1960
1961 * [Fix const propagation with references.][73613]
1962 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1963 * [Avoid spurious implicit region bound.][74509]
1964 * [Install clippy on x.py install][74457]
1965
1966 [73613]: https://github.com/rust-lang/rust/pull/73613
1967 [73078]: https://github.com/rust-lang/rust/issues/73078
1968 [74509]: https://github.com/rust-lang/rust/pull/74509
1969 [74457]: https://github.com/rust-lang/rust/pull/74457
1970
1971
1972 Version 1.45.0 (2020-07-16)
1973 ==========================
1974
1975 Language
1976 --------
1977 - [Out of range float to int conversions using `as` has been defined as a saturating
1978   conversion.][71269] This was previously undefined behaviour, but you can use the
1979    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
1980    may be desirable in rare performance sensitive situations.
1981 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
1982   using `u64`.][70705]
1983 - [Function like procedural macros can now be used in expression, pattern, and  statement
1984   positions.][68717] This means you can now use a function-like procedural macro
1985   anywhere you can use a declarative (`macro_rules!`) macro.
1986
1987 Compiler
1988 --------
1989 - [You can now override individual target features through the `target-feature`
1990   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
1991   equivalent to `-C target-feature=+avx2,+fma`.
1992 - [Added the `force-unwind-tables` flag.][69984] This option allows
1993   rustc to always generate unwind tables regardless of panic strategy.
1994 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
1995   to include LLVM bitcode into generated `rlib`s (this is on by default).
1996 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
1997 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
1998 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
1999 - [Upgraded to LLVM 10.][67759]
2000
2001 \* Refer to Rust's [platform support page][platform-support-doc] for more
2002 information on Rust's tiered platform support.
2003
2004
2005 Libraries
2006 ---------
2007 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
2008   and `Ord`.][72239]
2009 - [`proc_macro::TokenStream` now implements `Default`.][72234]
2010 - [You can now use `char` with
2011   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
2012   a range of codepoints.][72413] E.g.
2013   you can now write the following;
2014   ```rust
2015   for ch in 'a'..='z' {
2016       print!("{}", ch);
2017   }
2018   println!();
2019   // Prints "abcdefghijklmnopqrstuvwxyz"
2020   ```
2021 - [`OsString` now implements `FromStr`.][71662]
2022 - [The `saturating_neg` method has been added to all signed integer primitive
2023   types, and the `saturating_abs` method has been added for all integer
2024   primitive types.][71886]
2025 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
2026   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
2027   or `Path`.][71447]
2028 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
2029 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
2030   integer types.][69813]
2031 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
2032   integer types.][72324]
2033 - [The `fetch_update` method has been added to all atomic integer types.][71843]
2034
2035 Stabilized APIs
2036 ---------------
2037 - [`Arc::as_ptr`]
2038 - [`BTreeMap::remove_entry`]
2039 - [`Rc::as_ptr`]
2040 - [`rc::Weak::as_ptr`]
2041 - [`rc::Weak::from_raw`]
2042 - [`rc::Weak::into_raw`]
2043 - [`str::strip_prefix`]
2044 - [`str::strip_suffix`]
2045 - [`sync::Weak::as_ptr`]
2046 - [`sync::Weak::from_raw`]
2047 - [`sync::Weak::into_raw`]
2048 - [`char::UNICODE_VERSION`]
2049 - [`Span::resolved_at`]
2050 - [`Span::located_at`]
2051 - [`Span::mixed_site`]
2052 - [`unix::process::CommandExt::arg0`]
2053
2054 Cargo
2055 -----
2056
2057 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
2058   time.][cargo/8066]
2059
2060 Misc
2061 ----
2062 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
2063   `~~outdated information~~` becomes "~~outdated information~~".
2064 - [Added an emoji to Rustdoc's deprecated API message.][72014]
2065
2066 Compatibility Notes
2067 -------------------
2068 - [Trying to self initialize a static value (that is creating a value using
2069   itself) is unsound and now causes a compile error.][71140]
2070 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
2071   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
2072 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
2073   previously undocumented and not intended for public use. Rustdoc still provides
2074   a non-zero exit code on errors.
2075 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
2076   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
2077   flags while cargo is adding `embed-bitcode` itself. The recommended way to
2078   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
2079   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
2080
2081 Internals Only
2082 --------------
2083 - [Make clippy a git subtree instead of a git submodule][70655]
2084 - [Unify the undo log of all snapshot types][69464]
2085
2086 [71848]: https://github.com/rust-lang/rust/issues/71848/
2087 [73420]: https://github.com/rust-lang/rust/issues/73420/
2088 [72324]: https://github.com/rust-lang/rust/pull/72324/
2089 [71843]: https://github.com/rust-lang/rust/pull/71843/
2090 [71886]: https://github.com/rust-lang/rust/pull/71886/
2091 [72234]: https://github.com/rust-lang/rust/pull/72234/
2092 [72239]: https://github.com/rust-lang/rust/pull/72239/
2093 [72397]: https://github.com/rust-lang/rust/pull/72397/
2094 [72413]: https://github.com/rust-lang/rust/pull/72413/
2095 [72014]: https://github.com/rust-lang/rust/pull/72014/
2096 [72062]: https://github.com/rust-lang/rust/pull/72062/
2097 [72094]: https://github.com/rust-lang/rust/pull/72094/
2098 [72133]: https://github.com/rust-lang/rust/pull/72133/
2099 [67759]: https://github.com/rust-lang/rust/pull/67759/
2100 [71900]: https://github.com/rust-lang/rust/pull/71900/
2101 [71928]: https://github.com/rust-lang/rust/pull/71928/
2102 [71662]: https://github.com/rust-lang/rust/pull/71662/
2103 [71716]: https://github.com/rust-lang/rust/pull/71716/
2104 [71447]: https://github.com/rust-lang/rust/pull/71447/
2105 [71269]: https://github.com/rust-lang/rust/pull/71269/
2106 [71095]: https://github.com/rust-lang/rust/pull/71095/
2107 [71140]: https://github.com/rust-lang/rust/pull/71140/
2108 [70655]: https://github.com/rust-lang/rust/pull/70655/
2109 [70705]: https://github.com/rust-lang/rust/pull/70705/
2110 [69984]: https://github.com/rust-lang/rust/pull/69984/
2111 [69813]: https://github.com/rust-lang/rust/pull/69813/
2112 [69464]: https://github.com/rust-lang/rust/pull/69464/
2113 [68717]: https://github.com/rust-lang/rust/pull/68717/
2114 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
2115 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
2116 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
2117 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
2118 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
2119 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
2120 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
2121 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
2122 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
2123 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
2124 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
2125 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
2126 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
2127 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
2128 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
2129 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
2130 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
2131
2132
2133 Version 1.44.1 (2020-06-18)
2134 ===========================
2135
2136 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
2137 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
2138 * [Fix crashes when finding backtrace on macOS.][71397]
2139 * [Clippy applies lint levels into different files.][clippy/5356]
2140
2141 [71397]: https://github.com/rust-lang/rust/issues/71397
2142 [73078]: https://github.com/rust-lang/rust/issues/73078
2143 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
2144 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
2145
2146
2147 Version 1.44.0 (2020-06-04)
2148 ==========================
2149
2150 Language
2151 --------
2152 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
2153 - [Added the `unused_braces` lint.][70081]
2154
2155 **Syntax-only changes**
2156
2157 - [Expansion-driven outline module parsing][69838]
2158 ```rust
2159 #[cfg(FALSE)]
2160 mod foo {
2161     mod bar {
2162         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
2163     }
2164 }
2165 ```
2166
2167 These are still rejected semantically, so you will likely receive an error but
2168 these changes can be seen and parsed by macros and conditional compilation.
2169
2170 Compiler
2171 --------
2172 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
2173   Additionally when in incremental mode rustc defaults to 256 codegen units.
2174 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
2175   a panic is thrown.][67502]
2176 - [Added tier 3\* support for the `aarch64-unknown-none` and
2177   `aarch64-unknown-none-softfloat` targets.][68334]
2178 - [Added tier 3 support for `arm64-apple-tvos` and
2179   `x86_64-apple-tvos` targets.][68191]
2180
2181
2182 Libraries
2183 ---------
2184 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
2185   `vec![]` to be able to be used in `const` contexts.
2186 - [`convert::Infallible` now implements `Hash`.][70281]
2187 - [`OsString` now implements `DerefMut` and `IndexMut` returning
2188   a `&mut OsStr`.][70048]
2189 - [Unicode 13 is now supported.][69929]
2190 - [`String` now implements `From<&mut str>`.][69661]
2191 - [`IoSlice` now implements `Copy`.][69403]
2192 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
2193 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
2194 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
2195   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
2196   integer types.][69373]
2197
2198 Stabilized APIs
2199 ---------------
2200 - [`PathBuf::with_capacity`]
2201 - [`PathBuf::capacity`]
2202 - [`PathBuf::clear`]
2203 - [`PathBuf::reserve`]
2204 - [`PathBuf::reserve_exact`]
2205 - [`PathBuf::shrink_to_fit`]
2206 - [`f32::to_int_unchecked`]
2207 - [`f64::to_int_unchecked`]
2208 - [`Layout::align_to`]
2209 - [`Layout::pad_to_align`]
2210 - [`Layout::array`]
2211 - [`Layout::extend`]
2212
2213 Cargo
2214 -----
2215 - [Added the `cargo tree` command which will print a tree graph of
2216   your dependencies.][cargo/8062] E.g.
2217   ```
2218     mdbook v0.3.2 (/Users/src/rust/mdbook)
2219   ├── ammonia v3.0.0
2220   │   ├── html5ever v0.24.0
2221   │   │   ├── log v0.4.8
2222   │   │   │   └── cfg-if v0.1.9
2223   │   │   ├── mac v0.1.1
2224   │   │   └── markup5ever v0.9.0
2225   │   │       ├── log v0.4.8 (*)
2226   │   │       ├── phf v0.7.24
2227   │   │       │   └── phf_shared v0.7.24
2228   │   │       │       ├── siphasher v0.2.3
2229   │   │       │       └── unicase v1.4.2
2230   │   │       │           [build-dependencies]
2231   │   │       │           └── version_check v0.1.5
2232   ...
2233   ```
2234   You can also display dependencies on multiple versions of the same crate with
2235   `cargo tree -d` (short for `cargo tree --duplicates`).
2236
2237 Misc
2238 ----
2239 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
2240   the version in the sidebar.][69494]
2241
2242 Compatibility Notes
2243 -------------------
2244 - [Rustc now correctly generates static libraries on Windows GNU targets with
2245   the `.a` extension, rather than the previous `.lib`.][70937]
2246 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
2247 - [The `file_name` property in JSON output of macro errors now points the actual
2248   source file rather than the previous format of `<NAME macros>`.][70969]
2249   **Note:** this may not point to a file that actually exists on the user's system.
2250 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
2251 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
2252   not allow zero initialization such as `NonZeroU8`.][66059] This was
2253   previously a warning.
2254 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
2255   operator has been defined as a saturating operation.][71269] This was previously
2256   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
2257   continue using the current behaviour, which may be desirable in rare performance
2258   sensitive situations.
2259
2260 Internal Only
2261 -------------
2262 These changes provide no direct user facing benefits, but represent significant
2263 improvements to the internals and overall performance of rustc and
2264 related tools.
2265
2266 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
2267 - [Replace big JS dict with JSON parsing.][71250]
2268
2269 [69373]: https://github.com/rust-lang/rust/pull/69373/
2270 [66059]: https://github.com/rust-lang/rust/pull/66059/
2271 [68191]: https://github.com/rust-lang/rust/pull/68191/
2272 [68899]: https://github.com/rust-lang/rust/pull/68899/
2273 [71147]: https://github.com/rust-lang/rust/pull/71147/
2274 [71250]: https://github.com/rust-lang/rust/pull/71250/
2275 [70937]: https://github.com/rust-lang/rust/pull/70937/
2276 [70969]: https://github.com/rust-lang/rust/pull/70969/
2277 [70632]: https://github.com/rust-lang/rust/pull/70632/
2278 [70281]: https://github.com/rust-lang/rust/pull/70281/
2279 [70345]: https://github.com/rust-lang/rust/pull/70345/
2280 [70048]: https://github.com/rust-lang/rust/pull/70048/
2281 [70081]: https://github.com/rust-lang/rust/pull/70081/
2282 [70156]: https://github.com/rust-lang/rust/pull/70156/
2283 [71269]: https://github.com/rust-lang/rust/pull/71269/
2284 [69838]: https://github.com/rust-lang/rust/pull/69838/
2285 [69929]: https://github.com/rust-lang/rust/pull/69929/
2286 [69661]: https://github.com/rust-lang/rust/pull/69661/
2287 [69778]: https://github.com/rust-lang/rust/pull/69778/
2288 [69494]: https://github.com/rust-lang/rust/pull/69494/
2289 [69403]: https://github.com/rust-lang/rust/pull/69403/
2290 [69033]: https://github.com/rust-lang/rust/pull/69033/
2291 [68692]: https://github.com/rust-lang/rust/pull/68692/
2292 [68334]: https://github.com/rust-lang/rust/pull/68334/
2293 [67502]: https://github.com/rust-lang/rust/pull/67502/
2294 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
2295 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
2296 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
2297 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
2298 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
2299 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
2300 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
2301 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
2302 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
2303 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
2304 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
2305 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
2306 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
2307
2308
2309 Version 1.43.1 (2020-05-07)
2310 ===========================
2311
2312 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
2313 * [Fixed the stabilization of AVX-512 features.][71473]
2314 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
2315
2316 [71430]: https://github.com/rust-lang/rust/pull/71430
2317 [71473]: https://github.com/rust-lang/rust/issues/71473
2318 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
2319
2320
2321 Version 1.43.0 (2020-04-23)
2322 ==========================
2323
2324 Language
2325 --------
2326 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
2327   the type inferred correctly.][68129]
2328 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
2329
2330 **Syntax only changes**
2331 - [Allow `type Foo: Ord` syntactically.][69361]
2332 - [Fuse associated and extern items up to defaultness.][69194]
2333 - [Syntactically allow `self` in all `fn` contexts.][68764]
2334 - [Merge `fn` syntax + cleanup item parsing.][68728]
2335 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
2336   For example, you may now write:
2337   ```rust
2338   macro_rules! mac_trait {
2339       ($i:item) => {
2340           trait T { $i }
2341       }
2342   }
2343   mac_trait! {
2344       fn foo() {}
2345   }
2346   ```
2347
2348 These are still rejected *semantically*, so you will likely receive an error but
2349 these changes can be seen and parsed by macros and
2350 conditional compilation.
2351
2352
2353 Compiler
2354 --------
2355 - [You can now pass multiple lint flags to rustc to override the previous
2356   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
2357   everything in the `unused` lint group except `unused-variables` which
2358   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
2359   everything in the `unused` lint group **including** `unused-variables` since
2360   the allow flag is specified before the deny flag (and therefore overridden).
2361 - [rustc will now prefer your system MinGW libraries over its bundled libraries
2362   if they are available on `windows-gnu`.][67429]
2363 - [rustc now buffers errors/warnings printed in JSON.][69227]
2364
2365 Libraries
2366 ---------
2367 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
2368   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
2369   respectively.][69538] **Note** These conversions are only available when `N`
2370   is `0..=32`.
2371 - [You can now use associated constants on floats and integers directly, rather
2372   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
2373   `f32::NAN` with no imports.
2374 - [`u8::is_ascii` is now `const`.][68984]
2375 - [`String` now implements `AsMut<str>`.][68742]
2376 - [Added the `primitive` module to `std` and `core`.][67637] This module
2377   reexports Rust's primitive types. This is mainly useful in macros
2378   where you want avoid these types being shadowed.
2379 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
2380 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
2381
2382 Stabilized APIs
2383 ---------------
2384 - [`Once::is_completed`]
2385 - [`f32::LOG10_2`]
2386 - [`f32::LOG2_10`]
2387 - [`f64::LOG10_2`]
2388 - [`f64::LOG2_10`]
2389 - [`iter::once_with`]
2390
2391 Cargo
2392 -----
2393 - [You can now set config `[profile]`s in your `.cargo/config`, or through
2394   your environment.][cargo/7823]
2395 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
2396   executable path when running integration tests or benchmarks.][cargo/7697]
2397   `<name>` is the name of your binary as-is e.g. If you wanted the executable
2398   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
2399
2400 Misc
2401 ----
2402 - [Certain checks in the `const_err` lint were deemed unrelated to const
2403   evaluation][69185], and have been moved to the `unconditional_panic` and
2404   `arithmetic_overflow` lints.
2405
2406 Compatibility Notes
2407 -------------------
2408
2409 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
2410   has been a warning since 1.36.0.
2411 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
2412   led to some instances being accepted, and now correctly emits a hard error.
2413
2414 [69340]: https://github.com/rust-lang/rust/pull/69340
2415
2416 Internal Only
2417 -------------
2418 These changes provide no direct user facing benefits, but represent significant
2419 improvements to the internals and overall performance of `rustc` and
2420 related tools.
2421
2422 - [All components are now built with `opt-level=3` instead of `2`.][67878]
2423 - [Improved how rustc generates drop code.][67332]
2424 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
2425 - [traits: preallocate 2 Vecs of known initial size][69022]
2426 - [Avoid exponential behaviour when relating types][68772]
2427 - [Skip `Drop` terminators for enum variants without drop glue][68943]
2428 - [Improve performance of coherence checks][68966]
2429 - [Deduplicate types in the generator witness][68672]
2430 - [Invert control in struct_lint_level.][68725]
2431
2432 [67332]: https://github.com/rust-lang/rust/pull/67332/
2433 [67429]: https://github.com/rust-lang/rust/pull/67429/
2434 [67637]: https://github.com/rust-lang/rust/pull/67637/
2435 [67642]: https://github.com/rust-lang/rust/pull/67642/
2436 [67878]: https://github.com/rust-lang/rust/pull/67878/
2437 [67885]: https://github.com/rust-lang/rust/pull/67885/
2438 [68129]: https://github.com/rust-lang/rust/pull/68129/
2439 [68672]: https://github.com/rust-lang/rust/pull/68672/
2440 [68725]: https://github.com/rust-lang/rust/pull/68725/
2441 [68728]: https://github.com/rust-lang/rust/pull/68728/
2442 [68738]: https://github.com/rust-lang/rust/pull/68738/
2443 [68742]: https://github.com/rust-lang/rust/pull/68742/
2444 [68764]: https://github.com/rust-lang/rust/pull/68764/
2445 [68772]: https://github.com/rust-lang/rust/pull/68772/
2446 [68943]: https://github.com/rust-lang/rust/pull/68943/
2447 [68952]: https://github.com/rust-lang/rust/pull/68952/
2448 [68966]: https://github.com/rust-lang/rust/pull/68966/
2449 [68984]: https://github.com/rust-lang/rust/pull/68984/
2450 [69022]: https://github.com/rust-lang/rust/pull/69022/
2451 [69185]: https://github.com/rust-lang/rust/pull/69185/
2452 [69194]: https://github.com/rust-lang/rust/pull/69194/
2453 [69201]: https://github.com/rust-lang/rust/pull/69201/
2454 [69227]: https://github.com/rust-lang/rust/pull/69227/
2455 [69548]: https://github.com/rust-lang/rust/pull/69548/
2456 [69256]: https://github.com/rust-lang/rust/pull/69256/
2457 [69361]: https://github.com/rust-lang/rust/pull/69361/
2458 [69366]: https://github.com/rust-lang/rust/pull/69366/
2459 [69538]: https://github.com/rust-lang/rust/pull/69538/
2460 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
2461 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
2462 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
2463 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
2464 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
2465 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
2466 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
2467 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
2468
2469
2470 Version 1.42.0 (2020-03-12)
2471 ==========================
2472
2473 Language
2474 --------
2475 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
2476   ```rust
2477   fn foo(words: &[&str]) {
2478       match words {
2479           ["Hello", "World", "!", ..] => println!("Hello World!"),
2480           ["Foo", "Bar", ..] => println!("Baz"),
2481           rest => println!("{:?}", rest),
2482       }
2483   }
2484   ```
2485 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
2486   that you can create an enum that has the exact layout and ABI of the type
2487   it contains.
2488 - [You can now use outer attribute procedural macros on inline modules.][64273]
2489 - [There are some *syntax-only* changes:][67131]
2490    - `default` is syntactically allowed before items in `trait` definitions.
2491    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
2492      leave out their bodies in favor of `;`.
2493    - Bounds on associated types in `impl`s are now syntactically allowed
2494      (e.g. `type Foo: Ord;`).
2495    - `...` (the C-variadic type) may occur syntactically directly as the type of
2496       any function parameter.
2497
2498   These are still rejected *semantically*, so you will likely receive an error
2499   but these changes can be seen and parsed by procedural macros and
2500   conditional compilation.
2501
2502 Compiler
2503 --------
2504 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
2505 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
2506 - [`Option::{expect,unwrap}` and
2507    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
2508    pointing to the location where they were called, rather than
2509    `core`'s internals. ][67887]
2510
2511 \* Refer to Rust's [platform support page][platform-support-doc] for more
2512 information on Rust's tiered platform support.
2513
2514 Libraries
2515 ---------
2516 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
2517 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
2518    to implement `Sized`.][67935]
2519 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
2520 - [`Layout::new` is now `const`.][66254]
2521 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
2522
2523
2524 Stabilized APIs
2525 ---------------
2526 - [`CondVar::wait_while`]
2527 - [`CondVar::wait_timeout_while`]
2528 - [`DebugMap::key`]
2529 - [`DebugMap::value`]
2530 - [`ManuallyDrop::take`]
2531 - [`matches!`]
2532 - [`ptr::slice_from_raw_parts_mut`]
2533 - [`ptr::slice_from_raw_parts`]
2534
2535 Cargo
2536 -----
2537 - [You no longer need to include `extern crate proc_macro;` to be able to
2538   `use proc_macro;` in the `2018` edition.][cargo/7700]
2539
2540 Compatibility Notes
2541 -------------------
2542 - [`Error::description` has been deprecated, and its use will now produce a
2543   warning.][66919] It's recommended to use `Display`/`to_string` instead.
2544
2545 [68253]: https://github.com/rust-lang/rust/pull/68253/
2546 [68348]: https://github.com/rust-lang/rust/pull/68348/
2547 [67935]: https://github.com/rust-lang/rust/pull/67935/
2548 [68339]: https://github.com/rust-lang/rust/pull/68339/
2549 [68122]: https://github.com/rust-lang/rust/pull/68122/
2550 [64273]: https://github.com/rust-lang/rust/pull/64273/
2551 [67712]: https://github.com/rust-lang/rust/pull/67712/
2552 [67887]: https://github.com/rust-lang/rust/pull/67887/
2553 [67131]: https://github.com/rust-lang/rust/pull/67131/
2554 [67233]: https://github.com/rust-lang/rust/pull/67233/
2555 [66899]: https://github.com/rust-lang/rust/pull/66899/
2556 [66919]: https://github.com/rust-lang/rust/pull/66919/
2557 [66254]: https://github.com/rust-lang/rust/pull/66254/
2558 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
2559 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
2560 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
2561 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
2562 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
2563 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
2564 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
2565 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
2566 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
2567
2568
2569 Version 1.41.1 (2020-02-27)
2570 ===========================
2571
2572 * [Always check types of static items][69145]
2573 * [Always check lifetime bounds of `Copy` impls][69145]
2574 * [Fix miscompilation in callers of `Layout::repeat`][69225]
2575
2576 [69225]: https://github.com/rust-lang/rust/issues/69225
2577 [69145]: https://github.com/rust-lang/rust/pull/69145
2578
2579
2580 Version 1.41.0 (2020-01-30)
2581 ===========================
2582
2583 Language
2584 --------
2585
2586 - [You can now pass type parameters to foreign items when implementing
2587   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
2588 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
2589   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
2590   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
2591 - [You can now use any valid identifier in a `format_args` macro.][66847]
2592   Previously identifiers starting with an underscore were not allowed.
2593 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
2594   enum variants.][66183] These are still rejected semantically, but
2595   can be seen and parsed by procedural macros and conditional compilation.
2596
2597 Compiler
2598 --------
2599
2600 - [Rustc will now warn if you have unused loop `'label`s.][66325]
2601 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
2602 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
2603 - [You can now pass an arguments file passing the `@path` syntax
2604   to rustc.][66172] Note that the format differs somewhat from what is
2605   found in other tooling; please see [the documentation][argfile-docs] for
2606   more information.
2607 - [You can now provide `--extern` flag without a path, indicating that it is
2608   available from the search path or specified with an `-L` flag.][64882]
2609
2610 \* Refer to Rust's [platform support page][platform-support-doc] for more
2611 information on Rust's tiered platform support.
2612
2613 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
2614
2615 Libraries
2616 ---------
2617
2618 - [The `core::panic` module is now stable.][66771] It was already stable
2619   through `std`.
2620 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
2621   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
2622 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
2623
2624 Stabilized APIs
2625 ---------------
2626
2627 - [`Result::map_or`]
2628 - [`Result::map_or_else`]
2629 - [`std::rc::Weak::weak_count`]
2630 - [`std::rc::Weak::strong_count`]
2631 - [`std::sync::Weak::weak_count`]
2632 - [`std::sync::Weak::strong_count`]
2633
2634 Cargo
2635 -----
2636
2637 - [Cargo will now document all the private items for binary crates
2638   by default.][cargo/7593]
2639 - [`cargo-install` will now reinstall the package if it detects that it is out
2640   of date.][cargo/7560]
2641 - [Cargo.lock now uses a more git friendly format that should help to reduce
2642   merge conflicts.][cargo/7579]
2643 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
2644   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
2645   optimisation level to `2` for debug builds. You can also use
2646   `[profile.<profile>.build-override]` to override build scripts and
2647   their dependencies.
2648
2649 Misc
2650 ----
2651
2652 - [You can now specify `edition` in documentation code blocks to compile the block
2653   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
2654   should be compiled the 2018 edition of Rust.
2655 - [You can now provide custom themes to rustdoc with `--theme`, and check the
2656   current theme with `--check-theme`.][54733]
2657 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
2658
2659 Compatibility Notes
2660 -------------------
2661
2662 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
2663   Apple targets.][apple-32bit-drop] This means that the source code is still
2664   available to build, but the targets are no longer being tested and release
2665   binaries for those platforms will no longer be distributed by the Rust project.
2666   Please refer to the linked blog post for more information.
2667
2668 [54733]: https://github.com/rust-lang/rust/pull/54733/
2669 [61351]: https://github.com/rust-lang/rust/pull/61351/
2670 [67255]: https://github.com/rust-lang/rust/pull/67255/
2671 [66661]: https://github.com/rust-lang/rust/pull/66661/
2672 [66771]: https://github.com/rust-lang/rust/pull/66771/
2673 [66847]: https://github.com/rust-lang/rust/pull/66847/
2674 [66238]: https://github.com/rust-lang/rust/pull/66238/
2675 [66277]: https://github.com/rust-lang/rust/pull/66277/
2676 [66325]: https://github.com/rust-lang/rust/pull/66325/
2677 [66172]: https://github.com/rust-lang/rust/pull/66172/
2678 [66183]: https://github.com/rust-lang/rust/pull/66183/
2679 [65879]: https://github.com/rust-lang/rust/pull/65879/
2680 [65013]: https://github.com/rust-lang/rust/pull/65013/
2681 [64882]: https://github.com/rust-lang/rust/pull/64882/
2682 [64325]: https://github.com/rust-lang/rust/pull/64325/
2683 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
2684 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
2685 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
2686 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
2687 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
2688 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
2689 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
2690 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
2691 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
2692 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
2693 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
2694
2695 Version 1.40.0 (2019-12-19)
2696 ===========================
2697
2698 Language
2699 --------
2700 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
2701   `const` contexts.][65188] e.g.
2702
2703   ```rust
2704   pub struct Point(i32, i32);
2705
2706   const ORIGIN: Point = {
2707       let constructor = Point;
2708
2709       constructor(0, 0)
2710   };
2711   ```
2712
2713 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
2714   indicate that there may be variants or fields added in the future.][64639]
2715   For example this requires adding a wild-card branch (`_ => {}`) to any match
2716   statements on a non-exhaustive `enum`. [(RFC 2008)]
2717 - [You can now use function-like procedural macros in `extern` blocks and in
2718   type positions.][63931] e.g. `type Generated = macro!();`
2719 - [Function-like and attribute procedural macros can now emit
2720   `macro_rules!` items, so you can now have your macros generate macros.][64035]
2721 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
2722   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
2723   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
2724
2725 Compiler
2726 --------
2727 - [Added tier 3 support\* for the
2728   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
2729 - [Added tier 3 support for the
2730   `aarch64-unknown-none-softfloat` target.][64589]
2731 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
2732   `mips64el-unknown-linux-muslabi64` targets.][65843]
2733
2734 \* Refer to Rust's [platform support page][platform-support-doc] for more
2735   information on Rust's tiered platform support.
2736
2737 Libraries
2738 ---------
2739 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
2740
2741 Stabilized APIs
2742 ---------------
2743 - [`BTreeMap::get_key_value`]
2744 - [`HashMap::get_key_value`]
2745 - [`Option::as_deref_mut`]
2746 - [`Option::as_deref`]
2747 - [`Option::flatten`]
2748 - [`UdpSocket::peer_addr`]
2749 - [`f32::to_be_bytes`]
2750 - [`f32::to_le_bytes`]
2751 - [`f32::to_ne_bytes`]
2752 - [`f64::to_be_bytes`]
2753 - [`f64::to_le_bytes`]
2754 - [`f64::to_ne_bytes`]
2755 - [`f32::from_be_bytes`]
2756 - [`f32::from_le_bytes`]
2757 - [`f32::from_ne_bytes`]
2758 - [`f64::from_be_bytes`]
2759 - [`f64::from_le_bytes`]
2760 - [`f64::from_ne_bytes`]
2761 - [`mem::take`]
2762 - [`slice::repeat`]
2763 - [`todo!`]
2764
2765 Cargo
2766 -----
2767 - [Cargo will now always display warnings, rather than only on
2768   fresh builds.][cargo/7450]
2769 - [Feature flags (except `--all-features`) passed to a virtual workspace will
2770   now produce an error.][cargo/7507] Previously these flags were ignored.
2771 - [You can now publish `dev-dependencies` without including
2772   a `version`.][cargo/7333]
2773
2774 Misc
2775 ----
2776 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
2777   when running documentation tests with `rustdoc`.][63803]
2778
2779 Compatibility Notes
2780 -------------------
2781 - [As previously announced, any previous NLL warnings in the 2015 edition are
2782   now hard errors.][64221]
2783 - [The `include!` macro will now warn if it failed to include the
2784   entire file.][64284] The `include!` macro unintentionally only includes the
2785   first _expression_ in a file, and this can be unintuitive. This will become
2786   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
2787 - [Using `#[inline]` on function prototypes and consts now emits a warning under
2788   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
2789   or `extern` blocks now correctly emits a hard error.
2790
2791 [65294]: https://github.com/rust-lang/rust/pull/65294/
2792 [66103]: https://github.com/rust-lang/rust/pull/66103/
2793 [65843]: https://github.com/rust-lang/rust/pull/65843/
2794 [65188]: https://github.com/rust-lang/rust/pull/65188/
2795 [65092]: https://github.com/rust-lang/rust/pull/65092/
2796 [64589]: https://github.com/rust-lang/rust/pull/64589/
2797 [64639]: https://github.com/rust-lang/rust/pull/64639/
2798 [64221]: https://github.com/rust-lang/rust/pull/64221/
2799 [64284]: https://github.com/rust-lang/rust/pull/64284/
2800 [63931]: https://github.com/rust-lang/rust/pull/63931/
2801 [64035]: https://github.com/rust-lang/rust/pull/64035/
2802 [63674]: https://github.com/rust-lang/rust/pull/63674/
2803 [63803]: https://github.com/rust-lang/rust/pull/63803/
2804 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
2805 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
2806 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
2807 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
2808 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
2809 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
2810 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
2811 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
2812 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
2813 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
2814 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
2815 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
2816 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
2817 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
2818 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
2819 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
2820 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
2821 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
2822 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
2823 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
2824 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
2825 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
2826 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
2827 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
2828 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
2829 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
2830
2831
2832 Version 1.39.0 (2019-11-07)
2833 ===========================
2834
2835 Language
2836 --------
2837 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
2838   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
2839 - [You can now use certain attributes on function, closure, and function pointer
2840   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
2841   `deny`, `forbid` as well as inert helper attributes used by procedural macro
2842   attributes applied to items. e.g.
2843   ```rust
2844   fn len(
2845       #[cfg(windows)] slice: &[u16],
2846       #[cfg(not(windows))] slice: &[u8],
2847   ) -> usize {
2848       slice.len()
2849   }
2850   ```
2851 - [You can now take shared references to bind-by-move patterns in the `if` guards
2852   of `match` arms.][63118] e.g.
2853   ```rust
2854   fn main() {
2855       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
2856
2857       match array {
2858           nums
2859   //      ---- `nums` is bound by move.
2860               if nums.iter().sum::<u8>() == 10
2861   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
2862           => {
2863               drop(nums);
2864   //          ----------- Legal as `nums` was bound by move and so we have ownership.
2865           }
2866           _ => unreachable!(),
2867       }
2868   }
2869   ```
2870
2871
2872
2873 Compiler
2874 --------
2875 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
2876 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
2877 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
2878   **Note** Cargo currently doesn't use this feature. Refer to
2879   [cargo#7315][cargo/7315] to track this feature's progress.
2880 - [You can now pass `--show-output` argument to test binaries to print the
2881   output of successful tests.][62600]
2882
2883
2884 \* Refer to Rust's [platform support page][platform-support-doc] for more
2885 information on Rust's tiered platform support.
2886
2887 Libraries
2888 ---------
2889 - [`Vec::new` and `String::new` are now `const` functions.][64028]
2890 - [`LinkedList::new` is now a `const` function.][63684]
2891 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
2892 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
2893   now `const`.][63786]
2894
2895 Stabilized APIs
2896 ---------------
2897 - [`Pin::into_inner`]
2898 - [`Instant::checked_duration_since`]
2899 - [`Instant::saturating_duration_since`]
2900
2901 Cargo
2902 -----
2903 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
2904 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
2905   `--all` is now deprecated.
2906
2907 Misc
2908 ----
2909 - [You can now pass `-Clinker` to rustdoc to control the linker used
2910   for compiling doctests.][63834]
2911
2912 Compatibility Notes
2913 -------------------
2914 - [Code that was previously accepted by the old borrow checker, but rejected by
2915   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
2916   previously a warning, and will also become a hard error in the Rust 2015
2917   edition in the 1.40.0 release.
2918 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
2919   run tests.][63827] This should improve performance when running a large
2920   amount of doctests.
2921 - [The `try!` macro will now issue a deprecation warning.][62672] It is
2922   recommended to use the `?` operator instead.
2923 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
2924   returned `0.0`.
2925
2926 [62600]: https://github.com/rust-lang/rust/pull/62600/
2927 [62672]: https://github.com/rust-lang/rust/pull/62672/
2928 [63118]: https://github.com/rust-lang/rust/pull/63118/
2929 [63209]: https://github.com/rust-lang/rust/pull/63209/
2930 [63402]: https://github.com/rust-lang/rust/pull/63402/
2931 [63565]: https://github.com/rust-lang/rust/pull/63565/
2932 [63595]: https://github.com/rust-lang/rust/pull/63595/
2933 [63684]: https://github.com/rust-lang/rust/pull/63684/
2934 [63698]: https://github.com/rust-lang/rust/pull/63698/
2935 [63770]: https://github.com/rust-lang/rust/pull/63770/
2936 [63786]: https://github.com/rust-lang/rust/pull/63786/
2937 [63827]: https://github.com/rust-lang/rust/pull/63827/
2938 [63834]: https://github.com/rust-lang/rust/pull/63834/
2939 [63927]: https://github.com/rust-lang/rust/pull/63927/
2940 [63933]: https://github.com/rust-lang/rust/pull/63933/
2941 [63934]: https://github.com/rust-lang/rust/pull/63934/
2942 [63938]: https://github.com/rust-lang/rust/pull/63938/
2943 [63940]: https://github.com/rust-lang/rust/pull/63940/
2944 [63941]: https://github.com/rust-lang/rust/pull/63941/
2945 [63945]: https://github.com/rust-lang/rust/pull/63945/
2946 [64010]: https://github.com/rust-lang/rust/pull/64010/
2947 [64028]: https://github.com/rust-lang/rust/pull/64028/
2948 [64334]: https://github.com/rust-lang/rust/pull/64334/
2949 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
2950 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
2951 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
2952 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
2953 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
2954 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
2955
2956 Version 1.38.0 (2019-09-26)
2957 ==========================
2958
2959 Language
2960 --------
2961 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
2962 - [The `#[deprecated]` attribute can now be used on macros.][62042]
2963
2964 Compiler
2965 --------
2966 - [Added pipelined compilation support to `rustc`.][62766] This will
2967   improve compilation times in some cases. For further information please refer
2968   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
2969 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
2970   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
2971   `x86_64-uwp-windows-msvc` targets.][60260]
2972 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
2973   `armv7-unknown-linux-musleabi` targets.][63107]
2974 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
2975 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
2976 - [Upgraded to LLVM 9.][62592]
2977
2978 \* Refer to Rust's [platform support page][platform-support-doc] for more
2979 information on Rust's tiered platform support.
2980
2981 Libraries
2982 ---------
2983 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
2984 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
2985   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
2986   is available at `std::clone::Clone`). This also makes all built-in macros
2987   available in `std`/`core` root. e.g. `std::include_bytes!`.
2988 - [`str::Chars` now implements `Debug`.][63000]
2989 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
2990 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
2991 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
2992 - [Added euclidean remainder and division operations (`div_euclid`,
2993   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
2994   `overflowing`, and `wrapping` versions are available for all
2995   integer primitives.
2996 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
2997   `PartialEq`.][61491]
2998 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
2999
3000 Stabilized APIs
3001 ---------------
3002 - [`<*const T>::cast`]
3003 - [`<*mut T>::cast`]
3004 - [`Duration::as_secs_f32`]
3005 - [`Duration::as_secs_f64`]
3006 - [`Duration::div_f32`]
3007 - [`Duration::div_f64`]
3008 - [`Duration::from_secs_f32`]
3009 - [`Duration::from_secs_f64`]
3010 - [`Duration::mul_f32`]
3011 - [`Duration::mul_f64`]
3012 - [`any::type_name`]
3013
3014 Cargo
3015 -----
3016 - [Added pipelined compilation support to `cargo`.][cargo/7143]
3017 - [You can now pass the `--features` option multiple times to enable
3018   multiple features.][cargo/7084]
3019
3020 Rustdoc
3021 -------
3022
3023 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
3024
3025 Misc
3026 ----
3027 - [`rustc` will now warn about some incorrect uses of
3028   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
3029
3030 Compatibility Notes
3031 -------------------
3032 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
3033   1.38.0.
3034 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
3035   issues][62896] with certain crates such as libc.
3036
3037 [60260]: https://github.com/rust-lang/rust/pull/60260/
3038 [61457]: https://github.com/rust-lang/rust/pull/61457/
3039 [61491]: https://github.com/rust-lang/rust/pull/61491/
3040 [61884]: https://github.com/rust-lang/rust/pull/61884/
3041 [61953]: https://github.com/rust-lang/rust/pull/61953/
3042 [62042]: https://github.com/rust-lang/rust/pull/62042/
3043 [62528]: https://github.com/rust-lang/rust/pull/62528/
3044 [62583]: https://github.com/rust-lang/rust/pull/62583/
3045 [62735]: https://github.com/rust-lang/rust/pull/62735/
3046 [62766]: https://github.com/rust-lang/rust/pull/62766/
3047 [62784]: https://github.com/rust-lang/rust/pull/62784/
3048 [62592]: https://github.com/rust-lang/rust/pull/62592/
3049 [62785]: https://github.com/rust-lang/rust/issues/62785/
3050 [62814]: https://github.com/rust-lang/rust/pull/62814/
3051 [62896]: https://github.com/rust-lang/rust/issues/62896/
3052 [63000]: https://github.com/rust-lang/rust/pull/63000/
3053 [63056]: https://github.com/rust-lang/rust/pull/63056/
3054 [63107]: https://github.com/rust-lang/rust/pull/63107/
3055 [63346]: https://github.com/rust-lang/rust/pull/63346/
3056 [63421]: https://github.com/rust-lang/rust/pull/63421/
3057 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
3058 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
3059 [63048]: https://github.com/rust-lang/rust/pull/63048
3060 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
3061 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
3062 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
3063 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
3064 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
3065 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
3066 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
3067 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
3068 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
3069 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
3070 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
3071 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
3072 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
3073
3074 Version 1.37.0 (2019-08-15)
3075 ==========================
3076
3077 Language
3078 --------
3079 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
3080   [`Box`][62228], or an [array][62235] and unused.
3081 - [You can now use the `cfg` and `cfg_attr` attributes on
3082   generic parameters.][61547]
3083 - [You can now use enum variants through type alias.][61682] e.g. You can
3084   write the following:
3085   ```rust
3086   type MyOption = Option<u8>;
3087
3088   fn increment_or_zero(x: MyOption) -> u8 {
3089       match x {
3090           MyOption::Some(y) => y + 1,
3091           MyOption::None => 0,
3092       }
3093   }
3094   ```
3095 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
3096   `const _: u32 = 5;`.
3097 - [You can now use `#[repr(align(X)]` on enums.][61229]
3098 - [The  `?` Kleene macro operator is now available in the
3099   2015 edition.][60932]
3100
3101 Compiler
3102 --------
3103 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
3104   and `-C profile-use` flags.][61268] For more information on how to use profile
3105   guided optimization, please refer to the [rustc book][rustc-book-pgo].
3106 - [The `rust-lldb` wrapper script should now work again.][61827]
3107
3108 Libraries
3109 ---------
3110 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
3111
3112 Stabilized APIs
3113 ---------------
3114 - [`BufReader::buffer`]
3115 - [`BufWriter::buffer`]
3116 - [`Cell::from_mut`]
3117 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
3118 - [`DoubleEndedIterator::nth_back`]
3119 - [`Option::xor`]
3120 - [`Wrapping::reverse_bits`]
3121 - [`i128::reverse_bits`]
3122 - [`i16::reverse_bits`]
3123 - [`i32::reverse_bits`]
3124 - [`i64::reverse_bits`]
3125 - [`i8::reverse_bits`]
3126 - [`isize::reverse_bits`]
3127 - [`slice::copy_within`]
3128 - [`u128::reverse_bits`]
3129 - [`u16::reverse_bits`]
3130 - [`u32::reverse_bits`]
3131 - [`u64::reverse_bits`]
3132 - [`u8::reverse_bits`]
3133 - [`usize::reverse_bits`]
3134
3135 Cargo
3136 -----
3137 - [`Cargo.lock` files are now included by default when publishing executable crates
3138   with executables.][cargo/7026]
3139 - [You can now specify `default-run="foo"` in `[package]` to specify the
3140   default executable to use for `cargo run`.][cargo/7056]
3141
3142 Misc
3143 ----
3144
3145 Compatibility Notes
3146 -------------------
3147 - [Using `...` for inclusive range patterns will now warn by default.][61342]
3148   Please transition your code to using the `..=` syntax for inclusive
3149   ranges instead.
3150 - [Using a trait object without the `dyn` will now warn by default.][61203]
3151   Please transition your code to use `dyn Trait` for trait objects instead.
3152
3153 [62228]: https://github.com/rust-lang/rust/pull/62228/
3154 [62235]: https://github.com/rust-lang/rust/pull/62235/
3155 [61802]: https://github.com/rust-lang/rust/pull/61802/
3156 [61827]: https://github.com/rust-lang/rust/pull/61827/
3157 [61547]: https://github.com/rust-lang/rust/pull/61547/
3158 [61682]: https://github.com/rust-lang/rust/pull/61682/
3159 [61268]: https://github.com/rust-lang/rust/pull/61268/
3160 [61342]: https://github.com/rust-lang/rust/pull/61342/
3161 [61347]: https://github.com/rust-lang/rust/pull/61347/
3162 [61100]: https://github.com/rust-lang/rust/pull/61100/
3163 [61203]: https://github.com/rust-lang/rust/pull/61203/
3164 [61229]: https://github.com/rust-lang/rust/pull/61229/
3165 [60932]: https://github.com/rust-lang/rust/pull/60932/
3166 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
3167 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
3168 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
3169 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
3170 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
3171 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
3172 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
3173 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
3174 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
3175 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
3176 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
3177 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
3178 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
3179 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
3180 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
3181 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
3182 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
3183 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
3184 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
3185 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
3186 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
3187 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
3188 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
3189 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
3190
3191
3192 Version 1.36.0 (2019-07-04)
3193 ==========================
3194
3195 Language
3196 --------
3197 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
3198 - [The order of traits in trait objects no longer affects the semantics of that
3199   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
3200   `dyn fmt::Debug + Send`, where this was previously not the case.
3201
3202 Libraries
3203 ---------
3204 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
3205 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
3206 - [`mem::needs_drop` is now available as a const fn.][60364]
3207 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
3208 - [`String` now implements `BorrowMut<str>`.][60404]
3209 - [`io::Cursor` now implements `Default`.][60234]
3210 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
3211 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
3212   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
3213   environment has access to heap memory allocation.
3214 - [`String` now implements `From<&String>`.][59825]
3215 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
3216   return a tuple of each argument when there is multiple arguments.
3217 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
3218   not used.][59648]
3219
3220 Stabilized APIs
3221 ---------------
3222 - [`VecDeque::rotate_left`]
3223 - [`VecDeque::rotate_right`]
3224 - [`Iterator::copied`]
3225 - [`io::IoSlice`]
3226 - [`io::IoSliceMut`]
3227 - [`Read::read_vectored`]
3228 - [`Write::write_vectored`]
3229 - [`str::as_mut_ptr`]
3230 - [`mem::MaybeUninit`]
3231 - [`pointer::align_offset`]
3232 - [`future::Future`]
3233 - [`task::Context`]
3234 - [`task::RawWaker`]
3235 - [`task::RawWakerVTable`]
3236 - [`task::Waker`]
3237 - [`task::Poll`]
3238
3239 Cargo
3240 -----
3241 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
3242 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
3243
3244 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
3245
3246 Clippy
3247 ------
3248 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
3249
3250 Misc
3251 ----
3252
3253 Compatibility Notes
3254 -------------------
3255 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
3256   longer recommended, and will be deprecated in 1.39.0.
3257
3258 [60318]: https://github.com/rust-lang/rust/pull/60318/
3259 [60364]: https://github.com/rust-lang/rust/pull/60364/
3260 [60370]: https://github.com/rust-lang/rust/pull/60370/
3261 [60404]: https://github.com/rust-lang/rust/pull/60404/
3262 [60234]: https://github.com/rust-lang/rust/pull/60234/
3263 [60244]: https://github.com/rust-lang/rust/pull/60244/
3264 [58623]: https://github.com/rust-lang/rust/pull/58623/
3265 [59648]: https://github.com/rust-lang/rust/pull/59648/
3266 [59675]: https://github.com/rust-lang/rust/pull/59675/
3267 [59825]: https://github.com/rust-lang/rust/pull/59825/
3268 [59826]: https://github.com/rust-lang/rust/pull/59826/
3269 [59445]: https://github.com/rust-lang/rust/pull/59445/
3270 [59114]: https://github.com/rust-lang/rust/pull/59114/
3271 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
3272 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
3273 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
3274 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
3275 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
3276 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
3277 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
3278 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
3279 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
3280 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
3281 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
3282 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
3283 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
3284 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
3285 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
3286 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
3287 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
3288 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
3289 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
3290 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
3291
3292
3293 Version 1.35.0 (2019-05-23)
3294 ==========================
3295
3296 Language
3297 --------
3298 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
3299   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
3300 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
3301   ```rust
3302   unsafe fn call_unsafe(func: unsafe fn()) {
3303       func()
3304   }
3305
3306   pub fn main() {
3307       unsafe { call_unsafe(|| {}); }
3308   }
3309   ```
3310
3311
3312 Compiler
3313 --------
3314 - [Added the `armv6-unknown-freebsd-gnueabihf` and
3315   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
3316 - [Added the `wasm32-unknown-wasi` target.][59464]
3317
3318
3319 Libraries
3320 ---------
3321 - [`Thread` will now show its ID in `Debug` output.][59460]
3322 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
3323 - [`alloc::System` now implements `Default`.][59451]
3324 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
3325   last field.][59076]
3326 - [`char::{ToLowercase, ToUppercase}` now
3327   implement `ExactSizeIterator`.][58778]
3328 - [All `NonZero` numeric types now implement `FromStr`.][58717]
3329 - [Removed the `Read` trait bounds
3330   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
3331 - [You can now call the `dbg!` macro without any parameters to print the file
3332   and line where it is called.][57847]
3333 - [In place ASCII case conversions are now up to 4× faster.][59283]
3334   e.g. `str::make_ascii_lowercase`
3335 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
3336   and `Send`.][58369]
3337
3338 Stabilized APIs
3339 ---------------
3340 - [`f32::copysign`]
3341 - [`f64::copysign`]
3342 - [`RefCell::replace_with`]
3343 - [`RefCell::map_split`]
3344 - [`ptr::hash`]
3345 - [`Range::contains`]
3346 - [`RangeFrom::contains`]
3347 - [`RangeTo::contains`]
3348 - [`RangeInclusive::contains`]
3349 - [`RangeToInclusive::contains`]
3350 - [`Option::copied`]
3351
3352 Cargo
3353 -----
3354 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
3355   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
3356   platform specific.
3357
3358 Misc
3359 ----
3360 - [The Rust toolchain is now available natively for musl based distros.][58575]
3361
3362 [59460]: https://github.com/rust-lang/rust/pull/59460/
3363 [59464]: https://github.com/rust-lang/rust/pull/59464/
3364 [59500]: https://github.com/rust-lang/rust/pull/59500/
3365 [59512]: https://github.com/rust-lang/rust/pull/59512/
3366 [59580]: https://github.com/rust-lang/rust/pull/59580/
3367 [59283]: https://github.com/rust-lang/rust/pull/59283/
3368 [59451]: https://github.com/rust-lang/rust/pull/59451/
3369 [59076]: https://github.com/rust-lang/rust/pull/59076/
3370 [58778]: https://github.com/rust-lang/rust/pull/58778/
3371 [58717]: https://github.com/rust-lang/rust/pull/58717/
3372 [58369]: https://github.com/rust-lang/rust/pull/58369/
3373 [58423]: https://github.com/rust-lang/rust/pull/58423/
3374 [58080]: https://github.com/rust-lang/rust/pull/58080/
3375 [57847]: https://github.com/rust-lang/rust/pull/57847/
3376 [58575]: https://github.com/rust-lang/rust/pull/58575
3377 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
3378 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
3379 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
3380 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
3381 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
3382 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
3383 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
3384 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
3385 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
3386 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
3387 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
3388 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
3389
3390 Version 1.34.2 (2019-05-14)
3391 ===========================
3392
3393 * [Destabilize the `Error::type_id` function due to a security
3394    vulnerability][60785] ([CVE-2019-12083])
3395
3396 [60785]: https://github.com/rust-lang/rust/pull/60785
3397 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
3398
3399 Version 1.34.1 (2019-04-25)
3400 ===========================
3401
3402 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
3403 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
3404 * [Fix Clippy panic when checking some macros][clippy/3805]
3405
3406 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
3407 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
3408 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
3409
3410 Version 1.34.0 (2019-04-11)
3411 ==========================
3412
3413 Language
3414 --------
3415 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
3416   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
3417   but had no effect.
3418 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
3419   `#[attr{}]` procedural macros.][57367]
3420 - [You can now write `extern crate self as foo;`][57407] to import your
3421   crate's root into the extern prelude.
3422
3423
3424 Compiler
3425 --------
3426 - [You can now target `riscv64imac-unknown-none-elf` and
3427   `riscv64gc-unknown-none-elf`.][58406]
3428 - [You can now enable linker plugin LTO optimisations with
3429   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
3430   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
3431   boundaries.
3432 - [You can now target `powerpc64-unknown-freebsd`.][57809]
3433
3434
3435 Libraries
3436 ---------
3437 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
3438   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
3439   the `Hash` trait to create an iterator.
3440 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
3441   methods.][58421] Most notably you no longer require the `Ord` trait to create
3442   an iterator.
3443 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
3444   for all numeric types.][58044]
3445 - [Indexing a `str` is now generic over all types that
3446   implement `SliceIndex<str>`.][57604]
3447 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
3448   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
3449   produce a warning if their returning type is unused.
3450 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
3451   `overflowing_pow` are now available for all numeric types.][57873] These are
3452   equivalent to methods such as `wrapping_add` for the `pow` operation.
3453
3454
3455 Stabilized APIs
3456 ---------------
3457
3458 #### std & core
3459 * [`Any::type_id`]
3460 * [`Error::type_id`]
3461 * [`atomic::AtomicI16`]
3462 * [`atomic::AtomicI32`]
3463 * [`atomic::AtomicI64`]
3464 * [`atomic::AtomicI8`]
3465 * [`atomic::AtomicU16`]
3466 * [`atomic::AtomicU32`]
3467 * [`atomic::AtomicU64`]
3468 * [`atomic::AtomicU8`]
3469 * [`convert::Infallible`]
3470 * [`convert::TryFrom`]
3471 * [`convert::TryInto`]
3472 * [`iter::from_fn`]
3473 * [`iter::successors`]
3474 * [`num::NonZeroI128`]
3475 * [`num::NonZeroI16`]
3476 * [`num::NonZeroI32`]
3477 * [`num::NonZeroI64`]
3478 * [`num::NonZeroI8`]
3479 * [`num::NonZeroIsize`]
3480 * [`slice::sort_by_cached_key`]
3481 * [`str::escape_debug`]
3482 * [`str::escape_default`]
3483 * [`str::escape_unicode`]
3484 * [`str::split_ascii_whitespace`]
3485
3486 #### std
3487 * [`Instant::checked_add`]
3488 * [`Instant::checked_sub`]
3489 * [`SystemTime::checked_add`]
3490 * [`SystemTime::checked_sub`]
3491
3492 Cargo
3493 -----
3494 - [You can now use alternative registries to crates.io.][cargo/6654]
3495
3496 Misc
3497 ----
3498 - [You can now use the `?` operator in your documentation tests without manually
3499   adding `fn main() -> Result<(), _> {}`.][56470]
3500
3501 Compatibility Notes
3502 -------------------
3503 - [`Command::before_exec` is being replaced by the unsafe method
3504   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
3505 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
3506   can now use `const` functions in `static` variables.
3507
3508 [58370]: https://github.com/rust-lang/rust/pull/58370/
3509 [58406]: https://github.com/rust-lang/rust/pull/58406/
3510 [58421]: https://github.com/rust-lang/rust/pull/58421/
3511 [58166]: https://github.com/rust-lang/rust/pull/58166/
3512 [58044]: https://github.com/rust-lang/rust/pull/58044/
3513 [58057]: https://github.com/rust-lang/rust/pull/58057/
3514 [58059]: https://github.com/rust-lang/rust/pull/58059/
3515 [57809]: https://github.com/rust-lang/rust/pull/57809/
3516 [57873]: https://github.com/rust-lang/rust/pull/57873/
3517 [57604]: https://github.com/rust-lang/rust/pull/57604/
3518 [57367]: https://github.com/rust-lang/rust/pull/57367/
3519 [57407]: https://github.com/rust-lang/rust/pull/57407/
3520 [57425]: https://github.com/rust-lang/rust/pull/57425/
3521 [57106]: https://github.com/rust-lang/rust/pull/57106/
3522 [56470]: https://github.com/rust-lang/rust/pull/56470/
3523 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
3524 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
3525 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
3526 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
3527 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
3528 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
3529 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
3530 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
3531 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
3532 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
3533 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
3534 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
3535 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
3536 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
3537 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
3538 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
3539 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
3540 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
3541 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
3542 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
3543 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
3544 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
3545 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
3546 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
3547 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
3548 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
3549 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
3550 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
3551 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
3552 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
3553 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
3554
3555
3556 Version 1.33.0 (2019-02-28)
3557 ==========================
3558
3559 Language
3560 --------
3561 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
3562   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
3563 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
3564   E.g. You can have match statement on a `u8` that covers `0..=255` and
3565   you would no longer be required to have a `_ => unreachable!()` case.
3566 - [You can now have multiple patterns in `if let` and `while let`
3567   expressions.][57532] You can do this with the same syntax as a `match`
3568   expression. E.g.
3569   ```rust
3570   enum Creature {
3571       Crab(String),
3572       Lobster(String),
3573       Person(String),
3574   }
3575
3576   fn main() {
3577       let state = Creature::Crab("Ferris");
3578
3579       if let Creature::Crab(name) | Creature::Person(name) = state {
3580           println!("This creature's name is: {}", name);
3581       }
3582   }
3583   ```
3584 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
3585   this feature will by default produce a warning as this behaviour can be
3586   unintuitive. E.g. `if let _ = 5 {}`
3587 - [You can now use `let` bindings, assignments, expression statements,
3588   and irrefutable pattern destructuring in const functions.][57175]
3589 - [You can now call unsafe const functions.][57067] E.g.
3590   ```rust
3591   const unsafe fn foo() -> i32 { 5 }
3592   const fn bar() -> i32 {
3593       unsafe { foo() }
3594   }
3595   ```
3596 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
3597   E.g. `#[cfg_attr(all(), must_use, optimize)]`
3598 - [You can now specify a specific alignment with the `#[repr(packed)]`
3599   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
3600   with an alignment of 2 bytes and a size of 6 bytes.
3601 - [You can now import an item from a module as an `_`.][56303] This allows you to
3602   import a trait's impls, and not have the name in the namespace. E.g.
3603   ```rust
3604   use std::io::Read as _;
3605
3606   // Allowed as there is only one `Read` in the module.
3607   pub trait Read {}
3608   ```
3609 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
3610
3611 Compiler
3612 --------
3613 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
3614   command line argument.][56351]
3615 - [The minimum required LLVM version has been bumped to 6.0.][56642]
3616 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
3617 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
3618   tier 2 support.][57130] Visit the [platform support][platform-support] page for
3619   information on Rust's platform support.
3620 - [Added support for the `thumbv7neon-linux-androideabi` and
3621   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
3622 - [Added support for the `x86_64-unknown-uefi` target.][56769]
3623
3624 Libraries
3625 ---------
3626 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
3627   functions for all numeric types.][57566]
3628 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
3629   are now `const` functions for all numeric types.][57105]
3630 - [The methods `is_positive` and `is_negative` are now `const` functions for
3631   all signed numeric types.][57105]
3632 - [The `get` method for all `NonZero` types is now `const`.][57167]
3633 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
3634   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
3635   numeric types.][57234]
3636 - [`Ipv4Addr::new` is now a `const` function][57234]
3637
3638 Stabilized APIs
3639 ---------------
3640 - [`unix::FileExt::read_exact_at`]
3641 - [`unix::FileExt::write_all_at`]
3642 - [`Option::transpose`]
3643 - [`Result::transpose`]
3644 - [`convert::identity`]
3645 - [`pin::Pin`]
3646 - [`marker::Unpin`]
3647 - [`marker::PhantomPinned`]
3648 - [`Vec::resize_with`]
3649 - [`VecDeque::resize_with`]
3650 - [`Duration::as_millis`]
3651 - [`Duration::as_micros`]
3652 - [`Duration::as_nanos`]
3653
3654
3655 Cargo
3656 -----
3657 - [You can now publish crates that require a feature flag to compile with
3658   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
3659 - [Cargo should now rebuild a crate if a file was modified during the initial
3660   build.][cargo/6484]
3661
3662 Compatibility Notes
3663 -------------------
3664 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
3665   are now deprecated in the standard library, and their usage will now produce a warning.
3666   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
3667   methods instead.
3668 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
3669   downcasting.
3670 - [Libtest no longer creates a new thread for each test when
3671   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
3672
3673 [55982]: https://github.com/rust-lang/rust/pull/55982/
3674 [56243]: https://github.com/rust-lang/rust/pull/56243
3675 [56303]: https://github.com/rust-lang/rust/pull/56303/
3676 [56351]: https://github.com/rust-lang/rust/pull/56351/
3677 [56362]: https://github.com/rust-lang/rust/pull/56362
3678 [56642]: https://github.com/rust-lang/rust/pull/56642/
3679 [56769]: https://github.com/rust-lang/rust/pull/56769/
3680 [56805]: https://github.com/rust-lang/rust/pull/56805
3681 [56947]: https://github.com/rust-lang/rust/pull/56947/
3682 [57049]: https://github.com/rust-lang/rust/pull/57049/
3683 [57067]: https://github.com/rust-lang/rust/pull/57067/
3684 [57105]: https://github.com/rust-lang/rust/pull/57105
3685 [57130]: https://github.com/rust-lang/rust/pull/57130/
3686 [57167]: https://github.com/rust-lang/rust/pull/57167/
3687 [57175]: https://github.com/rust-lang/rust/pull/57175/
3688 [57234]: https://github.com/rust-lang/rust/pull/57234/
3689 [57332]: https://github.com/rust-lang/rust/pull/57332/
3690 [57465]: https://github.com/rust-lang/rust/pull/57465/
3691 [57532]: https://github.com/rust-lang/rust/pull/57532/
3692 [57535]: https://github.com/rust-lang/rust/pull/57535/
3693 [57566]: https://github.com/rust-lang/rust/pull/57566/
3694 [57615]: https://github.com/rust-lang/rust/pull/57615/
3695 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
3696 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
3697 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
3698 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
3699 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
3700 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
3701 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
3702 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
3703 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
3704 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
3705 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
3706 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
3707 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
3708 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
3709 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
3710 [platform-support]: https://forge.rust-lang.org/platform-support.html
3711
3712 Version 1.32.0 (2019-01-17)
3713 ==========================
3714
3715 Language
3716 --------
3717 #### 2018 edition
3718 - [You can now use the `?` operator in macro definitions.][56245] The `?`
3719   operator allows you to specify zero or one repetitions similar to the `*` and
3720   `+` operators.
3721 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
3722   now always resolve to the item (`enum`, `struct`, etc.) available in the
3723   module if present, before resolving to a external crate or an item the prelude.][56759]
3724   E.g.
3725   ```rust
3726   enum Color { Red, Green, Blue }
3727
3728   use Color::*;
3729   ```
3730
3731 #### All editions
3732 - [You can now match against `PhantomData<T>` types.][55837]
3733 - [You can now match against literals in macros with the `literal`
3734   specifier.][56072] This will match against a literal of any type.
3735   E.g. `1`, `'A'`, `"Hello World"`
3736 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
3737   ```rust
3738   struct Point(i32, i32);
3739
3740   impl Point {
3741       pub fn new(x: i32, y: i32) -> Self {
3742           Self(x, y)
3743       }
3744
3745       pub fn is_origin(&self) -> bool {
3746           match self {
3747               Self(0, 0) => true,
3748               _ => false,
3749           }
3750       }
3751   }
3752   ```
3753 - [Self can also now be used in type definitions.][56366] E.g.
3754   ```rust
3755   enum List<T>
3756   where
3757       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
3758   {
3759       Nil,
3760       Cons(T, Box<Self>) // likewise here
3761   }
3762   ```
3763 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
3764   a `impl Trait` or `dyn Trait` is returned and unused in the program.
3765
3766 Compiler
3767 --------
3768 - [The default allocator has changed from jemalloc to the default allocator on
3769   your system.][55238] The compiler itself on Linux & macOS will still use
3770   jemalloc, but programs compiled with it will use the system allocator.
3771 - [Added the `aarch64-pc-windows-msvc` target.][55702]
3772
3773 Libraries
3774 ---------
3775 - [`PathBuf` now implements `FromStr`.][55148]
3776 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
3777 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
3778   easily debug expressions in your rust program. E.g.
3779   ```rust
3780   let a = 2;
3781   let b = dbg!(a * 2) + 1;
3782   //      ^-- prints: [src/main.rs:4] a * 2 = 4
3783   assert_eq!(b, 5);
3784   ```
3785
3786 The following APIs are now `const` functions and can be used in a
3787 `const` context.
3788
3789 - [`Cell::as_ptr`]
3790 - [`UnsafeCell::get`]
3791 - [`char::is_ascii`]
3792 - [`iter::empty`]
3793 - [`ManuallyDrop::new`]
3794 - [`ManuallyDrop::into_inner`]
3795 - [`RangeInclusive::start`]
3796 - [`RangeInclusive::end`]
3797 - [`NonNull::as_ptr`]
3798 - [`slice::as_ptr`]
3799 - [`str::as_ptr`]
3800 - [`Duration::as_secs`]
3801 - [`Duration::subsec_millis`]
3802 - [`Duration::subsec_micros`]
3803 - [`Duration::subsec_nanos`]
3804 - [`CStr::as_ptr`]
3805 - [`Ipv4Addr::is_unspecified`]
3806 - [`Ipv6Addr::new`]
3807 - [`Ipv6Addr::octets`]
3808
3809 Stabilized APIs
3810 ---------------
3811 - [`i8::to_be_bytes`]
3812 - [`i8::to_le_bytes`]
3813 - [`i8::to_ne_bytes`]
3814 - [`i8::from_be_bytes`]
3815 - [`i8::from_le_bytes`]
3816 - [`i8::from_ne_bytes`]
3817 - [`i16::to_be_bytes`]
3818 - [`i16::to_le_bytes`]
3819 - [`i16::to_ne_bytes`]
3820 - [`i16::from_be_bytes`]
3821 - [`i16::from_le_bytes`]
3822 - [`i16::from_ne_bytes`]
3823 - [`i32::to_be_bytes`]
3824 - [`i32::to_le_bytes`]
3825 - [`i32::to_ne_bytes`]
3826 - [`i32::from_be_bytes`]
3827 - [`i32::from_le_bytes`]
3828 - [`i32::from_ne_bytes`]
3829 - [`i64::to_be_bytes`]
3830 - [`i64::to_le_bytes`]
3831 - [`i64::to_ne_bytes`]
3832 - [`i64::from_be_bytes`]
3833 - [`i64::from_le_bytes`]
3834 - [`i64::from_ne_bytes`]
3835 - [`i128::to_be_bytes`]
3836 - [`i128::to_le_bytes`]
3837 - [`i128::to_ne_bytes`]
3838 - [`i128::from_be_bytes`]
3839 - [`i128::from_le_bytes`]
3840 - [`i128::from_ne_bytes`]
3841 - [`isize::to_be_bytes`]
3842 - [`isize::to_le_bytes`]
3843 - [`isize::to_ne_bytes`]
3844 - [`isize::from_be_bytes`]
3845 - [`isize::from_le_bytes`]
3846 - [`isize::from_ne_bytes`]
3847 - [`u8::to_be_bytes`]
3848 - [`u8::to_le_bytes`]
3849 - [`u8::to_ne_bytes`]
3850 - [`u8::from_be_bytes`]
3851 - [`u8::from_le_bytes`]
3852 - [`u8::from_ne_bytes`]
3853 - [`u16::to_be_bytes`]
3854 - [`u16::to_le_bytes`]
3855 - [`u16::to_ne_bytes`]
3856 - [`u16::from_be_bytes`]
3857 - [`u16::from_le_bytes`]
3858 - [`u16::from_ne_bytes`]
3859 - [`u32::to_be_bytes`]
3860 - [`u32::to_le_bytes`]
3861 - [`u32::to_ne_bytes`]
3862 - [`u32::from_be_bytes`]
3863 - [`u32::from_le_bytes`]
3864 - [`u32::from_ne_bytes`]
3865 - [`u64::to_be_bytes`]
3866 - [`u64::to_le_bytes`]
3867 - [`u64::to_ne_bytes`]
3868 - [`u64::from_be_bytes`]
3869 - [`u64::from_le_bytes`]
3870 - [`u64::from_ne_bytes`]
3871 - [`u128::to_be_bytes`]
3872 - [`u128::to_le_bytes`]
3873 - [`u128::to_ne_bytes`]
3874 - [`u128::from_be_bytes`]
3875 - [`u128::from_le_bytes`]
3876 - [`u128::from_ne_bytes`]
3877 - [`usize::to_be_bytes`]
3878 - [`usize::to_le_bytes`]
3879 - [`usize::to_ne_bytes`]
3880 - [`usize::from_be_bytes`]
3881 - [`usize::from_le_bytes`]
3882 - [`usize::from_ne_bytes`]
3883
3884 Cargo
3885 -----
3886 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
3887 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
3888
3889 Misc
3890 ----
3891 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
3892
3893 Compatibility Notes
3894 -------------------
3895 - [The argument types for AVX's
3896   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
3897   been changed from `*const` to `*mut` as the previous implementation
3898   was unsound.
3899
3900
3901 [55148]: https://github.com/rust-lang/rust/pull/55148/
3902 [55238]: https://github.com/rust-lang/rust/pull/55238/
3903 [55280]: https://github.com/rust-lang/rust/pull/55280/
3904 [55610]: https://github.com/rust-lang/rust/pull/55610/
3905 [55663]: https://github.com/rust-lang/rust/pull/55663/
3906 [55702]: https://github.com/rust-lang/rust/pull/55702/
3907 [55837]: https://github.com/rust-lang/rust/pull/55837/
3908 [55843]: https://github.com/rust-lang/rust/pull/55843/
3909 [56072]: https://github.com/rust-lang/rust/pull/56072/
3910 [56245]: https://github.com/rust-lang/rust/pull/56245/
3911 [56365]: https://github.com/rust-lang/rust/pull/56365/
3912 [56366]: https://github.com/rust-lang/rust/pull/56366/
3913 [56395]: https://github.com/rust-lang/rust/pull/56395/
3914 [56759]: https://github.com/rust-lang/rust/pull/56759/
3915 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
3916 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
3917 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
3918 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
3919 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
3920 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3921 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3922 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
3923 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
3924 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
3925 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
3926 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
3927 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
3928 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
3929 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
3930 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
3931 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
3932 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
3933 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
3934 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
3935 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
3936 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
3937 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
3938 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
3939 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
3940 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
3941 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
3942 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
3943 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
3944 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
3945 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
3946 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
3947 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
3948 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
3949 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
3950 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
3951 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
3952 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
3953 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
3954 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
3955 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
3956 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
3957 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
3958 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
3959 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
3960 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
3961 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
3962 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
3963 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
3964 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
3965 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
3966 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
3967 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
3968 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
3969 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
3970 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
3971 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
3972 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
3973 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
3974 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
3975 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
3976 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
3977 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
3978 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
3979 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
3980 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
3981 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
3982 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
3983 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
3984 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
3985 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
3986 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
3987 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
3988 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
3989 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
3990 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
3991 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
3992 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
3993 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
3994 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
3995 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
3996 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
3997 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
3998 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
3999 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
4000 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
4001 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
4002 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
4003 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
4004 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
4005 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
4006 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
4007 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
4008
4009
4010 Version 1.31.1 (2018-12-20)
4011 ===========================
4012
4013 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
4014 - [Fix broken go-to-definition in RLS][rls/1171]
4015 - [Fix infinite loop on hover in RLS][rls/1170]
4016
4017 [56562]: https://github.com/rust-lang/rust/pull/56562
4018 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
4019 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
4020
4021 Version 1.31.0 (2018-12-06)
4022 ==========================
4023
4024 Language
4025 --------
4026 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
4027 - [New lifetime elision rules now allow for eliding lifetimes in functions and
4028   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
4029   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
4030   in structs.
4031 - [You can now define and use `const` functions.][54835] These are currently
4032   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
4033   [language reference][const-reference] for what exactly is available.
4034 - [You can now use tool lints, which allow you to scope lints from external
4035   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
4036 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
4037   a crate, not just in exported functions.][54451]
4038 - [You can now use parentheses in pattern matches.][54497]
4039
4040 Compiler
4041 --------
4042 - [Updated musl to 1.1.20][54430]
4043
4044 Libraries
4045 ---------
4046 - [You can now convert `num::NonZero*` types to their raw equivalents using the
4047   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
4048 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
4049   into `Option<&mut T>` using the `From` trait.][53218]
4050 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
4051
4052
4053 Stabilized APIs
4054 ---------------
4055 - [`slice::align_to`]
4056 - [`slice::align_to_mut`]
4057 - [`slice::chunks_exact`]
4058 - [`slice::chunks_exact_mut`]
4059 - [`slice::rchunks`]
4060 - [`slice::rchunks_mut`]
4061 - [`slice::rchunks_exact`]
4062 - [`slice::rchunks_exact_mut`]
4063 - [`Option::replace`]
4064
4065 Cargo
4066 -----
4067 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
4068 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
4069   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
4070
4071 [52813]: https://github.com/rust-lang/rust/pull/52813/
4072 [53218]: https://github.com/rust-lang/rust/pull/53218/
4073 [53555]: https://github.com/rust-lang/rust/issues/53555/
4074 [54057]: https://github.com/rust-lang/rust/pull/54057/
4075 [54240]: https://github.com/rust-lang/rust/pull/54240/
4076 [54430]: https://github.com/rust-lang/rust/pull/54430/
4077 [54451]: https://github.com/rust-lang/rust/pull/54451/
4078 [54497]: https://github.com/rust-lang/rust/pull/54497/
4079 [54778]: https://github.com/rust-lang/rust/pull/54778/
4080 [54835]: https://github.com/rust-lang/rust/pull/54835/
4081 [54870]: https://github.com/rust-lang/rust/pull/54870/
4082 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
4083 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
4084 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
4085 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
4086 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
4087 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
4088 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
4089 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
4090 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
4091 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
4092 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
4093 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
4094 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
4095 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
4096
4097 Version 1.30.1 (2018-11-08)
4098 ===========================
4099
4100 - [Fixed overflow ICE in rustdoc][54199]
4101 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
4102
4103 [54199]: https://github.com/rust-lang/rust/pull/54199
4104 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
4105
4106 Version 1.30.0 (2018-10-25)
4107 ==========================
4108
4109 Language
4110 --------
4111 - [Procedural macros are now available.][52081] These kinds of macros allow for
4112   more powerful code generation. There is a [new chapter available][proc-macros]
4113   in the Rust Programming Language book that goes further in depth.
4114 - [You can now use keywords as identifiers using the raw identifiers
4115   syntax (`r#`),][53236] e.g. `let r#for = true;`
4116 - [Using anonymous parameters in traits is now deprecated with a warning and
4117   will be a hard error in the 2018 edition.][53272]
4118 - [You can now use `crate` in paths.][54404] This allows you to refer to the
4119   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
4120 - [Using a external crate no longer requires being prefixed with `::`.][54404]
4121   Previously, using a external crate in a module without a use statement
4122   required `let json = ::serde_json::from_str(foo);` but can now be written
4123   as `let json = serde_json::from_str(foo);`.
4124 - [You can now apply the `#[used]` attribute to static items to prevent the
4125   compiler from optimising them away, even if they appear to be unused,][51363]
4126   e.g. `#[used] static FOO: u32 = 1;`
4127 - [You can now import and reexport macros from other crates with the `use`
4128   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
4129   the root module of the crate. If your macro relies on calling other local
4130   macros, it is recommended to export with the
4131   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
4132   those macros.
4133 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
4134   using the `vis` specifier.][53370]
4135 - [Non-macro attributes now allow all forms of literals, not just
4136   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
4137   write `#[attr(true)]`.
4138 - [You can now specify a function to handle a panic in the Rust runtime with the
4139   `#[panic_handler]` attribute.][51366]
4140
4141 Compiler
4142 --------
4143 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
4144 - [Added the `aarch64-unknown-netbsd` target][53165]
4145 - [Upgraded to LLVM 8.][53611]
4146
4147 Libraries
4148 ---------
4149 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
4150
4151 Stabilized APIs
4152 ---------------
4153 - [`Ipv4Addr::BROADCAST`]
4154 - [`Ipv4Addr::LOCALHOST`]
4155 - [`Ipv4Addr::UNSPECIFIED`]
4156 - [`Ipv6Addr::LOCALHOST`]
4157 - [`Ipv6Addr::UNSPECIFIED`]
4158 - [`Iterator::find_map`]
4159
4160   The following methods are replacement methods for `trim_left`, `trim_right`,
4161   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
4162   in 1.33.0:
4163 - [`str::trim_end_matches`]
4164 - [`str::trim_end`]
4165 - [`str::trim_start_matches`]
4166 - [`str::trim_start`]
4167
4168 Cargo
4169 ----
4170 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
4171 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
4172   equivalent to calling `rustdoc --error-format=json`.
4173 - [Cargo will now provide a progress bar for builds.][cargo/5995]
4174
4175 Misc
4176 ----
4177 - [`rustdoc` allows you to specify what edition to treat your code as with the
4178   `--edition` option.][54057]
4179 - [`rustdoc` now has the `--color` (specify whether to output color) and
4180   `--error-format` (specify error format, e.g. `json`) options.][53003]
4181 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
4182   debug symbols.][53774]
4183 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
4184   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
4185
4186 [50911]: https://github.com/rust-lang/rust/pull/50911/
4187 [51363]: https://github.com/rust-lang/rust/pull/51363/
4188 [51366]: https://github.com/rust-lang/rust/pull/51366/
4189 [52081]: https://github.com/rust-lang/rust/pull/52081/
4190 [53003]: https://github.com/rust-lang/rust/pull/53003/
4191 [53033]: https://github.com/rust-lang/rust/pull/53033/
4192 [53044]: https://github.com/rust-lang/rust/pull/53044/
4193 [53165]: https://github.com/rust-lang/rust/pull/53165/
4194 [53611]: https://github.com/rust-lang/rust/pull/53611/
4195 [53213]: https://github.com/rust-lang/rust/pull/53213/
4196 [53236]: https://github.com/rust-lang/rust/pull/53236/
4197 [53272]: https://github.com/rust-lang/rust/pull/53272/
4198 [53370]: https://github.com/rust-lang/rust/pull/53370/
4199 [53459]: https://github.com/rust-lang/rust/pull/53459/
4200 [53774]: https://github.com/rust-lang/rust/pull/53774/
4201 [53822]: https://github.com/rust-lang/rust/pull/53822/
4202 [54057]: https://github.com/rust-lang/rust/pull/54057/
4203 [54146]: https://github.com/rust-lang/rust/pull/54146/
4204 [54404]: https://github.com/rust-lang/rust/pull/54404/
4205 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
4206 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
4207 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
4208 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
4209
4210 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
4211 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
4212 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
4213 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
4214 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
4215 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
4216 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
4217 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
4218 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
4219 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
4220
4221
4222 Version 1.29.2 (2018-10-11)
4223 ===========================
4224
4225 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
4226 - The `rls-preview` component on the windows-gnu targets has been restored.
4227
4228 [54639]: https://github.com/rust-lang/rust/pull/54639
4229
4230
4231 Version 1.29.1 (2018-09-25)
4232 ===========================
4233
4234 Security Notes
4235 --------------
4236
4237 - The standard library's `str::repeat` function contained an out of bounds write
4238   caused by an integer overflow. This has been fixed by deterministically
4239   panicking when an overflow happens.
4240
4241   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
4242   us.
4243
4244
4245 Version 1.29.0 (2018-09-13)
4246 ==========================
4247
4248 Compiler
4249 --------
4250 - [Bumped minimum LLVM version to 5.0.][51899]
4251 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
4252 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
4253 - [Upgraded to LLVM 7.][51966]
4254
4255 Libraries
4256 ---------
4257 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
4258 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
4259 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
4260 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
4261   for `&str`.][51178]
4262 - [`Cell<T>` now allows `T` to be unsized.][50494]
4263 - [`SocketAddr` is now stable on Redox.][52656]
4264
4265 Stabilized APIs
4266 ---------------
4267 - [`Arc::downcast`]
4268 - [`Iterator::flatten`]
4269 - [`Rc::downcast`]
4270
4271 Cargo
4272 -----
4273 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
4274   `--locked` to disable this behavior.
4275 - [`cargo-install` will now allow you to cross compile an install
4276   using `--target`.][cargo/5614]
4277 - [Added the `cargo-fix` subcommand to automatically move project code from
4278   2015 edition to 2018.][cargo/5723]
4279 - [`cargo doc` can now optionally document private types using the
4280   `--document-private-items` flag.][cargo/5543]
4281
4282 Misc
4283 ----
4284 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
4285   the specified level to that level.][52354] For example `--cap-lints warn`
4286   will demote `deny` and `forbid` lints to `warn`.
4287 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
4288   fails and `101` if there is a panic.][52197]
4289 - [A preview of clippy has been made available through rustup.][51122]
4290   You can install the preview with `rustup component add clippy-preview`.
4291
4292 Compatibility Notes
4293 -------------------
4294 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
4295   Use `str::get_unchecked(begin..end)` instead.
4296 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
4297   Consider using the `home_dir` function from
4298   https://crates.io/crates/dirs instead.
4299 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
4300 - [`cfg` attributes and `--cfg` command line flags are now more
4301   strictly validated.][53893]
4302
4303 [53893]: https://github.com/rust-lang/rust/pull/53893/
4304 [52861]: https://github.com/rust-lang/rust/pull/52861/
4305 [51966]: https://github.com/rust-lang/rust/pull/51966/
4306 [52656]: https://github.com/rust-lang/rust/pull/52656/
4307 [52239]: https://github.com/rust-lang/rust/pull/52239/
4308 [52330]: https://github.com/rust-lang/rust/pull/52330/
4309 [52354]: https://github.com/rust-lang/rust/pull/52354/
4310 [52402]: https://github.com/rust-lang/rust/pull/52402/
4311 [52103]: https://github.com/rust-lang/rust/pull/52103/
4312 [52197]: https://github.com/rust-lang/rust/pull/52197/
4313 [51807]: https://github.com/rust-lang/rust/pull/51807/
4314 [51899]: https://github.com/rust-lang/rust/pull/51899/
4315 [51912]: https://github.com/rust-lang/rust/pull/51912/
4316 [51511]: https://github.com/rust-lang/rust/pull/51511/
4317 [51619]: https://github.com/rust-lang/rust/pull/51619/
4318 [51656]: https://github.com/rust-lang/rust/pull/51656/
4319 [51178]: https://github.com/rust-lang/rust/pull/51178/
4320 [51122]: https://github.com/rust-lang/rust/pull/51122
4321 [50494]: https://github.com/rust-lang/rust/pull/50494/
4322 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
4323 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
4324 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
4325 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
4326 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
4327 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
4328 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
4329
4330
4331 Version 1.28.0 (2018-08-02)
4332 ===========================
4333
4334 Language
4335 --------
4336 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
4337   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
4338   the inner type across Foreign Function Interface (FFI) boundaries.
4339 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
4340   and can now be used as identifiers.][51196]
4341 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
4342   stable.][51241] This will allow users to specify a global allocator for
4343   their program.
4344 - [Unit test functions marked with the `#[test]` attribute can now return
4345   `Result<(), E: Debug>` in addition to `()`.][51298]
4346 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
4347   allows macros to easily target lifetimes.
4348
4349 Compiler
4350 --------
4351 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
4352   prioritise making smaller binary sizes. `z` is the same as `s` with the
4353   exception that it does not vectorise loops, which typically results in an even
4354   smaller binary.
4355 - [The short error format is now stable.][49546] Specified with
4356   `--error-format=short` this option will provide a more compressed output of
4357   rust error messages.
4358 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
4359 - [Reduced the number of allocations in the macro parser.][50855] This can
4360   improve compile times of macro heavy crates on average by 5%.
4361
4362 Libraries
4363 ---------
4364 - [Implemented `Default` for `&mut str`.][51306]
4365 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
4366 - [Implemented `Extend` for `()`.][50234]
4367 - [The `Debug` implementation of `time::Duration` should now be more easily
4368   human readable.][50364] Previously a `Duration` of one second would printed as
4369   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
4370 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
4371   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
4372   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
4373   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
4374   for `PathBuf`.][50170]
4375 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
4376   and `Wrapping<i128>`.][50465]
4377 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
4378   possible.][51050] This can provide up to a 40% speed increase.
4379 - [Improved error messages when using `format!`.][50610]
4380
4381 Stabilized APIs
4382 ---------------
4383 - [`Iterator::step_by`]
4384 - [`Path::ancestors`]
4385 - [`SystemTime::UNIX_EPOCH`]
4386 - [`alloc::GlobalAlloc`]
4387 - [`alloc::Layout`]
4388 - [`alloc::LayoutErr`]
4389 - [`alloc::System`]
4390 - [`alloc::alloc`]
4391 - [`alloc::alloc_zeroed`]
4392 - [`alloc::dealloc`]
4393 - [`alloc::realloc`]
4394 - [`alloc::handle_alloc_error`]
4395 - [`btree_map::Entry::or_default`]
4396 - [`fmt::Alignment`]
4397 - [`hash_map::Entry::or_default`]
4398 - [`iter::repeat_with`]
4399 - [`num::NonZeroUsize`]
4400 - [`num::NonZeroU128`]
4401 - [`num::NonZeroU16`]
4402 - [`num::NonZeroU32`]
4403 - [`num::NonZeroU64`]
4404 - [`num::NonZeroU8`]
4405 - [`ops::RangeBounds`]
4406 - [`slice::SliceIndex`]
4407 - [`slice::from_mut`]
4408 - [`slice::from_ref`]
4409 - [`{Any + Send + Sync}::downcast_mut`]
4410 - [`{Any + Send + Sync}::downcast_ref`]
4411 - [`{Any + Send + Sync}::is`]
4412
4413 Cargo
4414 -----
4415 - [Cargo will now no longer allow you to publish crates with build scripts that
4416   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
4417   considered to be immutable.
4418
4419 Misc
4420 ----
4421 - [The `suggestion_applicability` field in `rustc`'s json output is now
4422   stable.][50486] This will allow dev tools to check whether a code suggestion
4423   would apply to them.
4424
4425 Compatibility Notes
4426 -------------------
4427 - [Rust will consider trait objects with duplicated constraints to be the same
4428   type as without the duplicated constraint.][51276] For example the below code will
4429   now fail to compile.
4430   ```rust
4431   trait Trait {}
4432
4433   impl Trait + Send {
4434       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
4435   }
4436
4437   impl Trait + Send + Send {
4438       fn test(&self) { println!("two"); }
4439   }
4440   ```
4441
4442 [49546]: https://github.com/rust-lang/rust/pull/49546/
4443 [50143]: https://github.com/rust-lang/rust/pull/50143/
4444 [50170]: https://github.com/rust-lang/rust/pull/50170/
4445 [50234]: https://github.com/rust-lang/rust/pull/50234/
4446 [50265]: https://github.com/rust-lang/rust/pull/50265/
4447 [50364]: https://github.com/rust-lang/rust/pull/50364/
4448 [50385]: https://github.com/rust-lang/rust/pull/50385/
4449 [50465]: https://github.com/rust-lang/rust/pull/50465/
4450 [50486]: https://github.com/rust-lang/rust/pull/50486/
4451 [50554]: https://github.com/rust-lang/rust/pull/50554/
4452 [50610]: https://github.com/rust-lang/rust/pull/50610/
4453 [50855]: https://github.com/rust-lang/rust/pull/50855/
4454 [51050]: https://github.com/rust-lang/rust/pull/51050/
4455 [51196]: https://github.com/rust-lang/rust/pull/51196/
4456 [51200]: https://github.com/rust-lang/rust/pull/51200/
4457 [51241]: https://github.com/rust-lang/rust/pull/51241/
4458 [51276]: https://github.com/rust-lang/rust/pull/51276/
4459 [51298]: https://github.com/rust-lang/rust/pull/51298/
4460 [51306]: https://github.com/rust-lang/rust/pull/51306/
4461 [51562]: https://github.com/rust-lang/rust/pull/51562/
4462 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
4463 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
4464 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
4465 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
4466 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
4467 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
4468 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
4469 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
4470 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
4471 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
4472 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
4473 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
4474 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
4475 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
4476 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
4477 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
4478 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
4479 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
4480 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
4481 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
4482 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
4483 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
4484 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
4485 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
4486 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
4487 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
4488 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
4489 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
4490 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
4491 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
4492
4493 Version 1.27.2 (2018-07-20)
4494 ===========================
4495
4496 Compatibility Notes
4497 -------------------
4498
4499 - The borrow checker was fixed to avoid potential unsoundness when using
4500   match ergonomics: [#52213][52213].
4501
4502 [52213]: https://github.com/rust-lang/rust/issues/52213
4503
4504 Version 1.27.1 (2018-07-10)
4505 ===========================
4506
4507 Security Notes
4508 --------------
4509
4510 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
4511   when running, which enabled executing code as some other user on a
4512   given machine. This release fixes that vulnerability; you can read
4513   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
4514
4515   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
4516
4517 Compatibility Notes
4518 -------------------
4519
4520 - The borrow checker was fixed to avoid an additional potential unsoundness when using
4521   match ergonomics: [#51415][51415], [#49534][49534].
4522
4523 [51415]: https://github.com/rust-lang/rust/issues/51415
4524 [49534]: https://github.com/rust-lang/rust/issues/49534
4525 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
4526 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
4527
4528 Version 1.27.0 (2018-06-21)
4529 ==========================
4530
4531 Language
4532 --------
4533 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
4534   be used as an identifier.
4535 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
4536   bare `Trait` syntax, and should make it clearer when being used in tandem with
4537   `impl Trait` because it is equivalent to the following syntax:
4538   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
4539   `Box<Trait> == Box<dyn Trait>`.
4540 - [Attributes on generic parameters such as types and lifetimes are
4541   now stable.][48851] e.g.
4542   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
4543 - [The `#[must_use]` attribute can now also be used on functions as well as
4544   types.][48925] It provides a lint that by default warns users when the
4545   value returned by a function has not been used.
4546
4547 Compiler
4548 --------
4549 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
4550
4551 Libraries
4552 ---------
4553 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
4554   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
4555   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
4556   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
4557   the `cfg` attribute.
4558 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
4559   std are now available in core.][49896]
4560 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
4561   to `Self`.][49630]
4562 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
4563   that the operation isn't done in place.
4564 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
4565   the `#[must_use]` attribute][49533] to warn about unused potentially
4566   expensive allocations.
4567
4568 Stabilized APIs
4569 ---------------
4570 - [`DoubleEndedIterator::rfind`]
4571 - [`DoubleEndedIterator::rfold`]
4572 - [`DoubleEndedIterator::try_rfold`]
4573 - [`Duration::from_micros`]
4574 - [`Duration::from_nanos`]
4575 - [`Duration::subsec_micros`]
4576 - [`Duration::subsec_millis`]
4577 - [`HashMap::remove_entry`]
4578 - [`Iterator::try_fold`]
4579 - [`Iterator::try_for_each`]
4580 - [`NonNull::cast`]
4581 - [`Option::filter`]
4582 - [`String::replace_range`]
4583 - [`Take::set_limit`]
4584 - [`hint::unreachable_unchecked`]
4585 - [`os::unix::process::parent_id`]
4586 - [`ptr::swap_nonoverlapping`]
4587 - [`slice::rsplit_mut`]
4588 - [`slice::rsplit`]
4589 - [`slice::swap_with_slice`]
4590
4591 Cargo
4592 -----
4593 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
4594   `readme`, and `repository` fields.][cargo/5386]
4595 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
4596 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
4597   a different directory than `target` for placing compilation artifacts.
4598 - [Cargo will be adding automatic target inference for binaries, benchmarks,
4599   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
4600   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
4601   where cargo would infer a binary, Cargo will produce a warning. You can
4602   disable this feature ahead of time by setting any of the following to false:
4603   `autobins`, `autobenches`, `autoexamples`, `autotests`.
4604 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
4605   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
4606
4607 Misc
4608 ----
4609 - [Added “The Rustc book” into the official documentation.][49707]
4610   [“The Rustc book”] documents and teaches how to use the rustc compiler.
4611 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
4612
4613 Compatibility Notes
4614 -------------------
4615 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
4616   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
4617   compile, `"".is_empty()` will still compile.
4618 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
4619   will only print the inner type.][48553] E.g.
4620   `print!("{:?}", AtomicBool::new(true))` will print `true`,
4621   not `AtomicBool(true)`.
4622 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
4623   could enter higher numbers but they were not supported by LLVM. Up to 512MB
4624   alignment should cover all use cases.
4625 - The `.description()` method on the `std::error::Error` trait
4626   [has been soft-deprecated][50163]. It is no longer required to implement it.
4627
4628 [48553]: https://github.com/rust-lang/rust/pull/48553/
4629 [48851]: https://github.com/rust-lang/rust/pull/48851/
4630 [48925]: https://github.com/rust-lang/rust/pull/48925/
4631 [49533]: https://github.com/rust-lang/rust/pull/49533/
4632 [49623]: https://github.com/rust-lang/rust/pull/49623/
4633 [49630]: https://github.com/rust-lang/rust/pull/49630/
4634 [49664]: https://github.com/rust-lang/rust/pull/49664/
4635 [49699]: https://github.com/rust-lang/rust/pull/49699/
4636 [49707]: https://github.com/rust-lang/rust/pull/49707/
4637 [49719]: https://github.com/rust-lang/rust/pull/49719/
4638 [49896]: https://github.com/rust-lang/rust/pull/49896/
4639 [49968]: https://github.com/rust-lang/rust/pull/49968/
4640 [50163]: https://github.com/rust-lang/rust/pull/50163
4641 [50177]: https://github.com/rust-lang/rust/pull/50177/
4642 [50378]: https://github.com/rust-lang/rust/pull/50378/
4643 [50398]: https://github.com/rust-lang/rust/pull/50398/
4644 [50423]: https://github.com/rust-lang/rust/pull/50423/
4645 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
4646 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
4647 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
4648 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
4649 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
4650 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
4651 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
4652 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
4653 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
4654 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
4655 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
4656 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
4657 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
4658 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
4659 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
4660 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
4661 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
4662 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
4663 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
4664 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
4665 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
4666 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
4667 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4668 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
4669 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
4670 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
4671 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
4672 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
4673 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
4674 [“The Rustc book”]: https://doc.rust-lang.org/rustc
4675
4676
4677 Version 1.26.2 (2018-06-05)
4678 ==========================
4679
4680 Compatibility Notes
4681 -------------------
4682
4683 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
4684
4685 [51117]: https://github.com/rust-lang/rust/issues/51117
4686
4687
4688 Version 1.26.1 (2018-05-29)
4689 ==========================
4690
4691 Tools
4692 -----
4693
4694 - [RLS now works on Windows.][50646]
4695 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
4696
4697
4698 Compatibility Notes
4699 --------
4700
4701 - [`fn main() -> impl Trait` no longer works for non-Termination
4702   trait.][50656]
4703   This reverts an accidental stabilization.
4704 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
4705 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
4706
4707 [50646]: https://github.com/rust-lang/rust/issues/50646
4708 [50656]: https://github.com/rust-lang/rust/pull/50656
4709 [50812]: https://github.com/rust-lang/rust/pull/50812
4710 [50950]: https://github.com/rust-lang/rust/issues/50950
4711 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
4712
4713 Version 1.26.0 (2018-05-10)
4714 ==========================
4715
4716 Language
4717 --------
4718 - [Closures now implement `Copy` and/or `Clone` if all captured variables
4719   implement either or both traits.][49299]
4720 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
4721 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
4722   lifetime can be elided.][49458]
4723 - [`impl Trait` is now stable allowing you to have abstract types in returns
4724    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
4725   `fn open(path: impl AsRef<Path>)`.
4726 - [Pattern matching will now automatically apply dereferences.][49394]
4727 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
4728 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
4729 - [A lot of operations are now available in a const context.][46882] E.g. You
4730   can now index into constant arrays, reference and dereference into constants,
4731   and use tuple struct constructors.
4732 - [Fixed entry slice patterns are now stable.][48516] E.g.
4733   ```rust
4734   let points = [1, 2, 3, 4];
4735   match points {
4736       [1, 2, 3, 4] => println!("All points were sequential."),
4737       _ => println!("Not all points were sequential."),
4738   }
4739   ```
4740
4741
4742 Compiler
4743 --------
4744 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
4745 - [Fixed exponential projection complexity on nested types.][48296]
4746   This can provide up to a ~12% reduction in compile times for certain crates.
4747 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
4748   to remap path prefixes outputted by the compiler.
4749 - [Added `powerpc-unknown-netbsd` target.][48281]
4750
4751 Libraries
4752 ---------
4753 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
4754 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
4755   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
4756 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
4757 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
4758 - [`ascii::escape_default` is now available in libcore.][48735]
4759 - [Trailing commas are now supported in std and core macros.][48056]
4760 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
4761 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
4762
4763 Stabilized APIs
4764 ---------------
4765 - [`*const T::add`]
4766 - [`*const T::copy_to_nonoverlapping`]
4767 - [`*const T::copy_to`]
4768 - [`*const T::read_unaligned`]
4769 - [`*const T::read_volatile`]
4770 - [`*const T::read`]
4771 - [`*const T::sub`]
4772 - [`*const T::wrapping_add`]
4773 - [`*const T::wrapping_sub`]
4774 - [`*mut T::add`]
4775 - [`*mut T::copy_to_nonoverlapping`]
4776 - [`*mut T::copy_to`]
4777 - [`*mut T::read_unaligned`]
4778 - [`*mut T::read_volatile`]
4779 - [`*mut T::read`]
4780 - [`*mut T::replace`]
4781 - [`*mut T::sub`]
4782 - [`*mut T::swap`]
4783 - [`*mut T::wrapping_add`]
4784 - [`*mut T::wrapping_sub`]
4785 - [`*mut T::write_bytes`]
4786 - [`*mut T::write_unaligned`]
4787 - [`*mut T::write_volatile`]
4788 - [`*mut T::write`]
4789 - [`Box::leak`]
4790 - [`FromUtf8Error::as_bytes`]
4791 - [`LocalKey::try_with`]
4792 - [`Option::cloned`]
4793 - [`btree_map::Entry::and_modify`]
4794 - [`fs::read_to_string`]
4795 - [`fs::read`]
4796 - [`fs::write`]
4797 - [`hash_map::Entry::and_modify`]
4798 - [`iter::FusedIterator`]
4799 - [`ops::RangeInclusive`]
4800 - [`ops::RangeToInclusive`]
4801 - [`process::id`]
4802 - [`slice::rotate_left`]
4803 - [`slice::rotate_right`]
4804 - [`String::retain`]
4805
4806
4807 Cargo
4808 -----
4809 - [Cargo will now output path to custom commands when `-v` is
4810   passed with `--list`][cargo/5041]
4811 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
4812
4813 Misc
4814 ----
4815 - [The second edition of "The Rust Programming Language" book is now recommended
4816   over the first.][48404]
4817
4818 Compatibility Notes
4819 -------------------
4820
4821 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
4822   syntax is now invalid.
4823   ```
4824   use std::ops::Fn as dyn;
4825   fn g(_: Box<dyn(std::fmt::Debug)>) {}
4826   ```
4827 - [The result of dereferences are no longer promoted to `'static`.][47408]
4828   e.g.
4829   ```rust
4830   fn main() {
4831       const PAIR: &(i32, i32) = &(0, 1);
4832       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
4833   }
4834   ```
4835 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
4836 - [`".e0"` will now no longer parse as `0.0` and will instead cause
4837   an error.][48235]
4838 - [Removed hoedown from rustdoc.][48274]
4839 - [Bounds on higher-kinded lifetimes a hard error.][48326]
4840
4841 [46882]: https://github.com/rust-lang/rust/pull/46882
4842 [47379]: https://github.com/rust-lang/rust/pull/47379
4843 [47408]: https://github.com/rust-lang/rust/pull/47408
4844 [47813]: https://github.com/rust-lang/rust/pull/47813
4845 [48056]: https://github.com/rust-lang/rust/pull/48056
4846 [48125]: https://github.com/rust-lang/rust/pull/48125
4847 [48166]: https://github.com/rust-lang/rust/pull/48166
4848 [48235]: https://github.com/rust-lang/rust/pull/48235
4849 [48274]: https://github.com/rust-lang/rust/pull/48274
4850 [48281]: https://github.com/rust-lang/rust/pull/48281
4851 [48296]: https://github.com/rust-lang/rust/pull/48296
4852 [48326]: https://github.com/rust-lang/rust/pull/48326
4853 [48359]: https://github.com/rust-lang/rust/pull/48359
4854 [48404]: https://github.com/rust-lang/rust/pull/48404
4855 [48481]: https://github.com/rust-lang/rust/pull/48481
4856 [48516]: https://github.com/rust-lang/rust/pull/48516
4857 [48628]: https://github.com/rust-lang/rust/pull/48628
4858 [48629]: https://github.com/rust-lang/rust/pull/48629
4859 [48657]: https://github.com/rust-lang/rust/pull/48657
4860 [48735]: https://github.com/rust-lang/rust/pull/48735
4861 [48978]: https://github.com/rust-lang/rust/pull/48978
4862 [49101]: https://github.com/rust-lang/rust/pull/49101
4863 [49109]: https://github.com/rust-lang/rust/pull/49109
4864 [49121]: https://github.com/rust-lang/rust/pull/49121
4865 [49162]: https://github.com/rust-lang/rust/pull/49162
4866 [49184]: https://github.com/rust-lang/rust/pull/49184
4867 [49234]: https://github.com/rust-lang/rust/pull/49234
4868 [49255]: https://github.com/rust-lang/rust/pull/49255
4869 [49299]: https://github.com/rust-lang/rust/pull/49299
4870 [49305]: https://github.com/rust-lang/rust/pull/49305
4871 [49394]: https://github.com/rust-lang/rust/pull/49394
4872 [49458]: https://github.com/rust-lang/rust/pull/49458
4873 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
4874 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
4875 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
4876 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
4877 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
4878 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
4879 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
4880 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
4881 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
4882 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
4883 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
4884 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
4885 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
4886 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
4887 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
4888 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
4889 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
4890 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
4891 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
4892 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
4893 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
4894 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
4895 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
4896 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
4897 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
4898 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
4899 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
4900 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
4901 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
4902 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
4903 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
4904 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
4905 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
4906 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
4907 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
4908 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
4909 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4910 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
4911 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
4912 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
4913 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
4914 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
4915
4916
4917 Version 1.25.0 (2018-03-29)
4918 ==========================
4919
4920 Language
4921 --------
4922 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
4923 - [You can now use nested groups of imports.][47948]
4924   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
4925 - [You can now have `|` at the start of a match arm.][47947] e.g.
4926 ```rust
4927 enum Foo { A, B, C }
4928
4929 fn main() {
4930     let x = Foo::A;
4931     match x {
4932         | Foo::A
4933         | Foo::B => println!("AB"),
4934         | Foo::C => println!("C"),
4935     }
4936 }
4937 ```
4938
4939 Compiler
4940 --------
4941 - [Upgraded to LLVM 6.][47828]
4942 - [Added `-C lto=val` option.][47521]
4943 - [Added `i586-unknown-linux-musl` target][47282]
4944
4945 Libraries
4946 ---------
4947 - [Impl Send for `process::Command` on Unix.][47760]
4948 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
4949 - [`UnsafeCell::into_inner` is now safe.][47204]
4950 - [Implement libstd for CloudABI.][47268]
4951 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
4952 - [Implement `AsRef<Path>` for Component][46985]
4953 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
4954 - [Moved `Duration` to libcore.][46666]
4955
4956 Stabilized APIs
4957 ---------------
4958 - [`Location::column`]
4959 - [`ptr::NonNull`]
4960
4961 The following functions can now be used in a constant expression.
4962 eg. `static MINUTE: Duration = Duration::from_secs(60);`
4963 - [`Duration::new`][47300]
4964 - [`Duration::from_secs`][47300]
4965 - [`Duration::from_millis`][47300]
4966
4967 Cargo
4968 -----
4969 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
4970 - [`cargo new` now defaults to creating a binary crate, instead of a
4971   library crate.][cargo/5029]
4972
4973 Misc
4974 ----
4975 - [Rust by example is now shipped with new releases][46196]
4976
4977 Compatibility Notes
4978 -------------------
4979 - [Deprecated `net::lookup_host`.][47510]
4980 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
4981 - The borrow checker was sometimes incorrectly permitting overlapping borrows
4982   around indexing operations (see [#47349][47349]). This has been fixed (which also
4983   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
4984 - [Removed deprecated unstable attribute `#[simd]`.][47251]
4985
4986 [33903]: https://github.com/rust-lang/rust/pull/33903
4987 [47947]: https://github.com/rust-lang/rust/pull/47947
4988 [47948]: https://github.com/rust-lang/rust/pull/47948
4989 [47760]: https://github.com/rust-lang/rust/pull/47760
4990 [47790]: https://github.com/rust-lang/rust/pull/47790
4991 [47828]: https://github.com/rust-lang/rust/pull/47828
4992 [47398]: https://github.com/rust-lang/rust/pull/47398
4993 [47510]: https://github.com/rust-lang/rust/pull/47510
4994 [47521]: https://github.com/rust-lang/rust/pull/47521
4995 [47204]: https://github.com/rust-lang/rust/pull/47204
4996 [47251]: https://github.com/rust-lang/rust/pull/47251
4997 [47268]: https://github.com/rust-lang/rust/pull/47268
4998 [47282]: https://github.com/rust-lang/rust/pull/47282
4999 [47300]: https://github.com/rust-lang/rust/pull/47300
5000 [47349]: https://github.com/rust-lang/rust/pull/47349
5001 [46931]: https://github.com/rust-lang/rust/pull/46931
5002 [46985]: https://github.com/rust-lang/rust/pull/46985
5003 [47006]: https://github.com/rust-lang/rust/pull/47006
5004 [46830]: https://github.com/rust-lang/rust/pull/46830
5005 [46095]: https://github.com/rust-lang/rust/pull/46095
5006 [46666]: https://github.com/rust-lang/rust/pull/46666
5007 [46196]: https://github.com/rust-lang/rust/pull/46196
5008 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
5009 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
5010 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
5011 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
5012 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
5013
5014
5015 Version 1.24.1 (2018-03-01)
5016 ==========================
5017
5018  - [Do not abort when unwinding through FFI][48251]
5019  - [Emit UTF-16 files for linker arguments on Windows][48318]
5020  - [Make the error index generator work again][48308]
5021  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
5022
5023 [48251]: https://github.com/rust-lang/rust/issues/48251
5024 [48308]: https://github.com/rust-lang/rust/issues/48308
5025 [48318]: https://github.com/rust-lang/rust/issues/48318
5026 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
5027
5028
5029 Version 1.24.0 (2018-02-15)
5030 ==========================
5031
5032 Language
5033 --------
5034 - [External `sysv64` ffi is now available.][46528]
5035   eg. `extern "sysv64" fn foo () {}`
5036
5037 Compiler
5038 --------
5039 - [rustc now uses 16 codegen units by default for release builds.][46910]
5040   For the fastest builds, utilize `codegen-units=1`.
5041 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
5042 - [Add `aarch64-unknown-openbsd` support][46760]
5043
5044 Libraries
5045 ---------
5046 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
5047   improvement in performance in the majority of cases.
5048 - [`OsStr`'s `Debug` implementation is now lossless and consistent
5049   with Windows.][46798]
5050 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
5051 - [impl `From<bool>` for `AtomicBool`][46293]
5052 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
5053 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
5054 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
5055 - [float::from_bits now just uses transmute.][46012] This provides
5056   some optimisations from LLVM.
5057 - [Copied `AsciiExt` methods onto `char`][46077]
5058 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
5059 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
5060 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
5061 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
5062
5063 Stabilized APIs
5064 ---------------
5065 - [`RefCell::replace`]
5066 - [`RefCell::swap`]
5067 - [`atomic::spin_loop_hint`]
5068
5069 The following functions can now be used in a constant expression.
5070 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
5071
5072 - [`AtomicBool::new`][46287]
5073 - [`AtomicUsize::new`][46287]
5074 - [`AtomicIsize::new`][46287]
5075 - [`AtomicPtr::new`][46287]
5076 - [`Cell::new`][46287]
5077 - [`{integer}::min_value`][46287]
5078 - [`{integer}::max_value`][46287]
5079 - [`mem::size_of`][46287]
5080 - [`mem::align_of`][46287]
5081 - [`ptr::null`][46287]
5082 - [`ptr::null_mut`][46287]
5083 - [`RefCell::new`][46287]
5084 - [`UnsafeCell::new`][46287]
5085
5086 Cargo
5087 -----
5088 - [Added a `workspace.default-members` config that
5089   overrides implied `--all` in virtual workspaces.][cargo/4743]
5090 - [Enable incremental by default on development builds.][cargo/4817] Also added
5091   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
5092   per-project or global basis respectively.
5093
5094 Misc
5095 ----
5096
5097 Compatibility Notes
5098 -------------------
5099 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
5100 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
5101   in accordance with IETF RFC 4291 §2.2.
5102 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
5103 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
5104   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
5105 - [Leading zeros in tuple struct members is now an error][47084]
5106 - [`column!()` macro is one-based instead of zero-based][46977]
5107 - [`fmt::Arguments` can no longer be shared across threads][45198]
5108 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
5109 - [Cargo sets a different working directory for the compiler][cargo/4788]
5110
5111 [44884]: https://github.com/rust-lang/rust/pull/44884
5112 [45198]: https://github.com/rust-lang/rust/pull/45198
5113 [45506]: https://github.com/rust-lang/rust/pull/45506
5114 [45904]: https://github.com/rust-lang/rust/pull/45904
5115 [45990]: https://github.com/rust-lang/rust/pull/45990
5116 [46012]: https://github.com/rust-lang/rust/pull/46012
5117 [46077]: https://github.com/rust-lang/rust/pull/46077
5118 [46094]: https://github.com/rust-lang/rust/pull/46094
5119 [46284]: https://github.com/rust-lang/rust/pull/46284
5120 [46287]: https://github.com/rust-lang/rust/pull/46287
5121 [46293]: https://github.com/rust-lang/rust/pull/46293
5122 [46528]: https://github.com/rust-lang/rust/pull/46528
5123 [46671]: https://github.com/rust-lang/rust/pull/46671
5124 [46713]: https://github.com/rust-lang/rust/pull/46713
5125 [46735]: https://github.com/rust-lang/rust/pull/46735
5126 [46749]: https://github.com/rust-lang/rust/pull/46749
5127 [46760]: https://github.com/rust-lang/rust/pull/46760
5128 [46798]: https://github.com/rust-lang/rust/pull/46798
5129 [46828]: https://github.com/rust-lang/rust/pull/46828
5130 [46831]: https://github.com/rust-lang/rust/pull/46831
5131 [46833]: https://github.com/rust-lang/rust/pull/46833
5132 [46910]: https://github.com/rust-lang/rust/pull/46910
5133 [46977]: https://github.com/rust-lang/rust/pull/46977
5134 [47018]: https://github.com/rust-lang/rust/pull/47018
5135 [47080]: https://github.com/rust-lang/rust/pull/47080
5136 [47084]: https://github.com/rust-lang/rust/pull/47084
5137 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
5138 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
5139 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
5140 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
5141 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
5142 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
5143
5144
5145 Version 1.23.0 (2018-01-04)
5146 ==========================
5147
5148 Language
5149 --------
5150 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
5151 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
5152   Which should fix some confusing errors in some operations.
5153
5154 Compiler
5155 --------
5156 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
5157   undefined behavior.][45920]
5158 - [rustc now suggests renaming import if names clash.][45660]
5159 - [Display errors/warnings correctly when there are zero-width or
5160   wide characters.][45711]
5161 - [rustc now avoids unnecessary copies of arguments that are
5162   simple bindings][45380] This should improve memory usage on average by 5-10%.
5163 - [Updated musl used to build musl rustc to 1.1.17][45393]
5164
5165 Libraries
5166 ---------
5167 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
5168 - [Implement Hash for raw pointers to unsized types][45483]
5169 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
5170 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
5171 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
5172 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
5173   and `<*mut T>::as_mut`][44932]
5174 - [Optimized `Thread::{park, unpark}` implementation][45524]
5175 - [Improved `SliceExt::binary_search` performance.][45333]
5176 - [impl `FromIterator<()>` for `()`][45379]
5177 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
5178   is now deprecated.
5179
5180 Stabilized APIs
5181 ---------------
5182
5183 Cargo
5184 -----
5185 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
5186   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
5187 - [Added unit test checking to `cargo check`][cargo/4592]
5188 - [Cargo now lets you install a specific version
5189   using `cargo install --version`][cargo/4637]
5190
5191 Misc
5192 ----
5193 - [Releases now ship with the Cargo book documentation.][45692]
5194 - [rustdoc now prints rendering warnings on every run.][45324]
5195
5196 Compatibility Notes
5197 -------------------
5198 - [Changes have been made to type equality to make it more correct,
5199   in rare cases this could break some code.][45853] [Tracking issue for
5200   further information][45852]
5201 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
5202 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
5203   Android 9, the minimum supported version is Android 14.
5204 - [Bumped the minimum LLVM to 3.9][45326]
5205
5206 [44042]: https://github.com/rust-lang/rust/pull/44042
5207 [44932]: https://github.com/rust-lang/rust/pull/44932
5208 [45267]: https://github.com/rust-lang/rust/pull/45267
5209 [45324]: https://github.com/rust-lang/rust/pull/45324
5210 [45326]: https://github.com/rust-lang/rust/pull/45326
5211 [45333]: https://github.com/rust-lang/rust/pull/45333
5212 [45379]: https://github.com/rust-lang/rust/pull/45379
5213 [45380]: https://github.com/rust-lang/rust/pull/45380
5214 [45393]: https://github.com/rust-lang/rust/pull/45393
5215 [45435]: https://github.com/rust-lang/rust/pull/45435
5216 [45483]: https://github.com/rust-lang/rust/pull/45483
5217 [45524]: https://github.com/rust-lang/rust/pull/45524
5218 [45571]: https://github.com/rust-lang/rust/pull/45571
5219 [45580]: https://github.com/rust-lang/rust/pull/45580
5220 [45610]: https://github.com/rust-lang/rust/pull/45610
5221 [45660]: https://github.com/rust-lang/rust/pull/45660
5222 [45692]: https://github.com/rust-lang/rust/pull/45692
5223 [45711]: https://github.com/rust-lang/rust/pull/45711
5224 [45772]: https://github.com/rust-lang/rust/pull/45772
5225 [45852]: https://github.com/rust-lang/rust/issues/45852
5226 [45853]: https://github.com/rust-lang/rust/pull/45853
5227 [45887]: https://github.com/rust-lang/rust/pull/45887
5228 [45920]: https://github.com/rust-lang/rust/pull/45920
5229 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
5230 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
5231 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
5232
5233
5234 Version 1.22.1 (2017-11-22)
5235 ==========================
5236
5237 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
5238
5239 [46183]: https://github.com/rust-lang/rust/pull/46183
5240
5241 Version 1.22.0 (2017-11-22)
5242 ==========================
5243
5244 Language
5245 --------
5246 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
5247 - [Now accepts underscores in unicode escapes][43716]
5248 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
5249 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
5250
5251 Compiler
5252 --------
5253 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
5254 - [rustc will no longer inline in codegen units when compiling for debug][45075]
5255   This should decrease compile times for debug builds.
5256 - [strict memory alignment now enabled on ARMv6][45094]
5257 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
5258
5259 Libraries
5260 ---------
5261 - [Allow atomic operations up to 32 bits
5262   on `armv5te_unknown_linux_gnueabi`][44978]
5263 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
5264 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
5265 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
5266 - [Properly detect overflow in `Instant += Duration`.][44220]
5267 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
5268 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
5269 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
5270
5271 Stabilized APIs
5272 ---------------
5273
5274 Cargo
5275 -----
5276 - [Cargo will now build multi file examples in subdirectories of the `examples`
5277   folder that have a `main.rs` file.][cargo/4496]
5278 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
5279   the old format will continue to work and can be updated with `cargo update`.
5280 - [Now supports vendoring git repositories][cargo/3992]
5281
5282 Misc
5283 ----
5284 - [`libbacktrace` is now available on Apple platforms.][44251]
5285 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
5286   This now lets you specify that a given code example will fail to compile.
5287
5288 Compatibility Notes
5289 -------------------
5290 - [The minimum Android version that rustc can build for has been bumped
5291   to `4.0` from `2.3`][45656]
5292 - [Allowing `T op= &T` for numeric types has broken some type
5293   inference cases][45480]
5294
5295
5296 [42526]: https://github.com/rust-lang/rust/pull/42526
5297 [43017]: https://github.com/rust-lang/rust/pull/43017
5298 [43716]: https://github.com/rust-lang/rust/pull/43716
5299 [43949]: https://github.com/rust-lang/rust/pull/43949
5300 [44015]: https://github.com/rust-lang/rust/pull/44015
5301 [44220]: https://github.com/rust-lang/rust/pull/44220
5302 [44251]: https://github.com/rust-lang/rust/pull/44251
5303 [44287]: https://github.com/rust-lang/rust/pull/44287
5304 [44303]: https://github.com/rust-lang/rust/pull/44303
5305 [44456]: https://github.com/rust-lang/rust/pull/44456
5306 [44466]: https://github.com/rust-lang/rust/pull/44466
5307 [44895]: https://github.com/rust-lang/rust/pull/44895
5308 [44966]: https://github.com/rust-lang/rust/pull/44966
5309 [44978]: https://github.com/rust-lang/rust/pull/44978
5310 [45041]: https://github.com/rust-lang/rust/pull/45041
5311 [45064]: https://github.com/rust-lang/rust/pull/45064
5312 [45075]: https://github.com/rust-lang/rust/pull/45075
5313 [45094]: https://github.com/rust-lang/rust/pull/45094
5314 [45095]: https://github.com/rust-lang/rust/pull/45095
5315 [45480]: https://github.com/rust-lang/rust/issues/45480
5316 [45656]: https://github.com/rust-lang/rust/pull/45656
5317 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
5318 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
5319 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
5320
5321
5322
5323
5324
5325
5326 Version 1.21.0 (2017-10-12)
5327 ==========================
5328
5329 Language
5330 --------
5331 - [You can now use static references for literals.][43838]
5332   Example:
5333   ```rust
5334   fn main() {
5335       let x: &'static u32 = &0;
5336   }
5337   ```
5338 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
5339   Example:
5340   ```rust
5341   my_macro!(Vec<i32>::new); // Always worked
5342   my_macro!(Vec::<i32>::new); // Now works
5343   ```
5344
5345 Compiler
5346 --------
5347 - [Upgraded jemalloc to 4.5.0][43911]
5348 - [Enabled unwinding panics on Redox][43917]
5349 - [Now runs LLVM in parallel during translation phase.][43506]
5350   This should reduce peak memory usage.
5351
5352 Libraries
5353 ---------
5354 - [Generate builtin impls for `Clone` for all arrays and tuples that
5355   are `T: Clone`][43690]
5356 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
5357 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
5358   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
5359
5360 Stabilized APIs
5361 ---------------
5362
5363 [`std::mem::discriminant`]
5364
5365 Cargo
5366 -----
5367 - [You can now call `cargo install` with multiple package names][cargo/4216]
5368 - [Cargo commands inside a virtual workspace will now implicitly
5369   pass `--all`][cargo/4335]
5370 - [Added a `[patch]` section to `Cargo.toml` to handle
5371   prepublication dependencies][cargo/4123] [RFC 1969]
5372 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
5373   like patterns][cargo/4270]
5374 - [Added the `--all-targets` option][cargo/4400]
5375 - [Using required dependencies as a feature is now deprecated and emits
5376   a warning][cargo/4364]
5377
5378
5379 Misc
5380 ----
5381 - [Cargo docs are moving][43916]
5382   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
5383 - [The rustdoc book is now available][43863]
5384   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
5385 - [Added a preview of RLS has been made available through rustup][44204]
5386   Install with `rustup component add rls-preview`
5387 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
5388   Previously only showed `std::os::unix`.
5389
5390 Compatibility Notes
5391 -------------------
5392 - [Changes in method matching against higher-ranked types][43880] This may cause
5393   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
5394 - [rustc's JSON error output's byte position start at top of file.][42973]
5395   Was previously relative to the rustc's internal `CodeMap` struct which
5396   required the unstable library `libsyntax` to correctly use.
5397 - [`unused_results` lint no longer ignores booleans][43728]
5398
5399 [42565]: https://github.com/rust-lang/rust/pull/42565
5400 [42973]: https://github.com/rust-lang/rust/pull/42973
5401 [43348]: https://github.com/rust-lang/rust/pull/43348
5402 [43459]: https://github.com/rust-lang/rust/pull/43459
5403 [43506]: https://github.com/rust-lang/rust/pull/43506
5404 [43540]: https://github.com/rust-lang/rust/pull/43540
5405 [43690]: https://github.com/rust-lang/rust/pull/43690
5406 [43728]: https://github.com/rust-lang/rust/pull/43728
5407 [43838]: https://github.com/rust-lang/rust/pull/43838
5408 [43863]: https://github.com/rust-lang/rust/pull/43863
5409 [43880]: https://github.com/rust-lang/rust/pull/43880
5410 [43911]: https://github.com/rust-lang/rust/pull/43911
5411 [43916]: https://github.com/rust-lang/rust/pull/43916
5412 [43917]: https://github.com/rust-lang/rust/pull/43917
5413 [44204]: https://github.com/rust-lang/rust/pull/44204
5414 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
5415 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
5416 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5417 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
5418 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
5419 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
5420 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
5421 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
5422 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
5423
5424 Version 1.20.0 (2017-08-31)
5425 ===========================
5426
5427 Language
5428 --------
5429 - [Associated constants are now stabilised.][42809]
5430 - [A lot of macro bugs are now fixed.][42913]
5431
5432 Compiler
5433 --------
5434
5435 - [Struct fields are now properly coerced to the expected field type.][42807]
5436 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
5437   `wasm32-experimental-emscripten` target.
5438 - [Changed some of the error messages to be more helpful.][42033]
5439 - [Add support for RELRO(RELocation Read-Only) for platforms that support
5440   it.][43170]
5441 - [rustc now reports the total number of errors on compilation failure][43015]
5442   previously this was only the number of errors in the pass that failed.
5443 - [Expansion in rustc has been sped up 29x.][42533]
5444 - [added `msp430-none-elf` target.][43099]
5445 - [rustc will now suggest one-argument enum variant to fix type mismatch when
5446   applicable][43178]
5447 - [Fixes backtraces on Redox][43228]
5448 - [rustc now identifies different versions of same crate when absolute paths of
5449   different types match in an error message.][42826]
5450
5451 Libraries
5452 ---------
5453
5454
5455 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
5456 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
5457   tuples.][43011]
5458 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
5459   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
5460 - [Impl `Clone` for `DefaultHasher`.][42799]
5461 - [Impl `Sync` for `SyncSender`.][42397]
5462 - [Impl `FromStr` for `char`][42271]
5463 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
5464   NaN.][42431]
5465 - [allow messages in the `unimplemented!()` macro.][42155]
5466   ie. `unimplemented!("Waiting for 1.21 to be stable")`
5467 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
5468 - [Upgrade to Unicode 10.0.0][42999]
5469 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
5470 - [Skip the main thread's manual stack guard on Linux][43072]
5471 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in *O*(1) time][43077]
5472 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
5473   previously 2^15.
5474 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
5475
5476 Stabilized APIs
5477 ---------------
5478
5479 - [`CStr::into_c_string`]
5480 - [`CString::as_c_str`]
5481 - [`CString::into_boxed_c_str`]
5482 - [`Chain::get_mut`]
5483 - [`Chain::get_ref`]
5484 - [`Chain::into_inner`]
5485 - [`Option::get_or_insert_with`]
5486 - [`Option::get_or_insert`]
5487 - [`OsStr::into_os_string`]
5488 - [`OsString::into_boxed_os_str`]
5489 - [`Take::get_mut`]
5490 - [`Take::get_ref`]
5491 - [`Utf8Error::error_len`]
5492 - [`char::EscapeDebug`]
5493 - [`char::escape_debug`]
5494 - [`compile_error!`]
5495 - [`f32::from_bits`]
5496 - [`f32::to_bits`]
5497 - [`f64::from_bits`]
5498 - [`f64::to_bits`]
5499 - [`mem::ManuallyDrop`]
5500 - [`slice::sort_unstable_by_key`]
5501 - [`slice::sort_unstable_by`]
5502 - [`slice::sort_unstable`]
5503 - [`str::from_boxed_utf8_unchecked`]
5504 - [`str::as_bytes_mut`]
5505 - [`str::as_bytes_mut`]
5506 - [`str::from_utf8_mut`]
5507 - [`str::from_utf8_unchecked_mut`]
5508 - [`str::get_mut`]
5509 - [`str::get_unchecked_mut`]
5510 - [`str::get_unchecked`]
5511 - [`str::get`]
5512 - [`str::into_boxed_bytes`]
5513
5514
5515 Cargo
5516 -----
5517 - [Cargo API token location moved from `~/.cargo/config` to
5518   `~/.cargo/credentials`.][cargo/3978]
5519 - [Cargo will now build `main.rs` binaries that are in sub-directories of
5520   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
5521   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
5522 - [You can now specify version of a binary when installed through
5523   `cargo install` using `--vers`.][cargo/4229]
5524 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
5525   failure.][cargo/4248]
5526 - [Changed the convention around which file is the crate root.][cargo/4259]
5527 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
5528   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
5529
5530 Compatibility Notes
5531 -------------------
5532
5533 - [Functions with `'static` in their return types will now not be as usable as
5534   if they were using lifetime parameters instead.][42417]
5535 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
5536   takes the sign of NaN into account where previously didn't.][42430]
5537
5538 [42033]: https://github.com/rust-lang/rust/pull/42033
5539 [42155]: https://github.com/rust-lang/rust/pull/42155
5540 [42271]: https://github.com/rust-lang/rust/pull/42271
5541 [42397]: https://github.com/rust-lang/rust/pull/42397
5542 [42417]: https://github.com/rust-lang/rust/pull/42417
5543 [42430]: https://github.com/rust-lang/rust/pull/42430
5544 [42431]: https://github.com/rust-lang/rust/pull/42431
5545 [42533]: https://github.com/rust-lang/rust/pull/42533
5546 [42571]: https://github.com/rust-lang/rust/pull/42571
5547 [42613]: https://github.com/rust-lang/rust/pull/42613
5548 [42799]: https://github.com/rust-lang/rust/pull/42799
5549 [42807]: https://github.com/rust-lang/rust/pull/42807
5550 [42809]: https://github.com/rust-lang/rust/pull/42809
5551 [42822]: https://github.com/rust-lang/rust/pull/42822
5552 [42826]: https://github.com/rust-lang/rust/pull/42826
5553 [42854]: https://github.com/rust-lang/rust/pull/42854
5554 [42913]: https://github.com/rust-lang/rust/pull/42913
5555 [42999]: https://github.com/rust-lang/rust/pull/42999
5556 [43011]: https://github.com/rust-lang/rust/pull/43011
5557 [43015]: https://github.com/rust-lang/rust/pull/43015
5558 [43072]: https://github.com/rust-lang/rust/pull/43072
5559 [43077]: https://github.com/rust-lang/rust/pull/43077
5560 [43097]: https://github.com/rust-lang/rust/pull/43097
5561 [43099]: https://github.com/rust-lang/rust/pull/43099
5562 [43170]: https://github.com/rust-lang/rust/pull/43170
5563 [43178]: https://github.com/rust-lang/rust/pull/43178
5564 [43185]: https://github.com/rust-lang/rust/pull/43185
5565 [43228]: https://github.com/rust-lang/rust/pull/43228
5566 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
5567 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
5568 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
5569 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
5570 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
5571 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5572 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
5573 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
5574 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
5575 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
5576 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
5577 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
5578 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
5579 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
5580 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
5581 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
5582 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
5583 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
5584 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
5585 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
5586 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
5587 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
5588 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
5589 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
5590 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
5591 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
5592 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
5593 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
5594 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
5595 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
5596 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
5597 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
5598 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
5599 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
5600 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
5601 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
5602 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
5603 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
5604 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
5605
5606
5607 Version 1.19.0 (2017-07-20)
5608 ===========================
5609
5610 Language
5611 --------
5612
5613 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
5614   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
5615 - [Macro recursion limit increased to 1024 from 64.][41676]
5616 - [Added lint for detecting unused macros.][41907]
5617 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
5618   For example: `let x = loop { break 7; };`
5619 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
5620   contain `Copy` types and cannot have a `Drop` implementation.
5621   Example: `union Foo { bar: u8, baz: usize }`
5622 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
5623   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
5624
5625 Compiler
5626 --------
5627
5628 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
5629 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
5630   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
5631   you should use `--target armv7-linux-androideabi`.
5632 - [Fixed ICE when removing a source file between compilation sessions.][41873]
5633 - [Minor optimisation of string operations.][42037]
5634 - [Compiler error message is now `aborting due to previous error(s)` instead of
5635   `aborting due to N previous errors`][42150] This was previously inaccurate and
5636   would only count certain kinds of errors.
5637 - [The compiler now supports Visual Studio 2017][42225]
5638 - [The compiler is now built against LLVM 4.0.1 by default][42948]
5639 - [Added a lot][42264] of [new error codes][42302]
5640 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
5641   libraries with C Run-time Libraries(CRT) to be statically linked.
5642 - [Fixed various ARM codegen bugs][42740]
5643
5644 Libraries
5645 ---------
5646
5647 - [`String` now implements `FromIterator<Cow<'a, str>>` and
5648   `Extend<Cow<'a, str>>`][41449]
5649 - [`Vec` now implements `From<&mut [T]>`][41530]
5650 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
5651 - [`SplitWhitespace` now implements `Clone`][41659]
5652 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
5653   1.5x faster][41764]
5654 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
5655   macros, but for printing to stderr.
5656
5657 Stabilized APIs
5658 ---------------
5659
5660 - [`OsString::shrink_to_fit`]
5661 - [`cmp::Reverse`]
5662 - [`Command::envs`]
5663 - [`thread::ThreadId`]
5664
5665 Cargo
5666 -----
5667
5668 - [Build scripts can now add environment variables to the environment
5669   the crate is being compiled in.
5670   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
5671 - [Subcommands now replace the current process rather than spawning a new
5672   child process][cargo/3970]
5673 - [Workspace members can now accept glob file patterns][cargo/3979]
5674 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
5675   the members in a given workspace.][cargo/3988]
5676 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
5677 - [Target directory path is now in the cargo metadata][cargo/4022]
5678 - [Cargo no longer checks out a local working directory for the
5679   crates.io index][cargo/4026] This should provide smaller file size for the
5680   registry, and improve cloning times, especially on Windows machines.
5681 - [Added an `--exclude` option for excluding certain packages when using the
5682   `--all` option][cargo/4031]
5683 - [Cargo will now automatically retry when receiving a 5xx error
5684   from crates.io][cargo/4032]
5685 - [The `--features` option now accepts multiple comma or space
5686   delimited values.][cargo/4084]
5687 - [Added support for custom target specific runners][cargo/3954]
5688
5689 Misc
5690 ----
5691
5692 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
5693   Windows Debugger.
5694 - [Rust will now release XZ compressed packages][rust-installer/57]
5695 - [rustup will now prefer to download rust packages with
5696   XZ compression][rustup/1100] over GZip packages.
5697 - [Added the ability to escape `#` in rust documentation][41785] By adding
5698   additional `#`'s ie. `##` is now `#`
5699
5700 Compatibility Notes
5701 -------------------
5702
5703 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
5704 - [`-Z` flags are now no longer allowed to be used on the stable
5705   compiler.][41751] This has been a warning for a year previous to this.
5706 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
5707   longer works][42844]. Users should migrate to the built-in `check`
5708   command, which has been available since 1.16.
5709 - [Ending a float literal with `._` is now a hard error.
5710   Example: `42._` .][41946]
5711 - [Any use of a private `extern crate` outside of its module is now a
5712   hard error.][36886] This was previously a warning.
5713 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
5714   relative while the `::` prefix makes a path absolute, but was ignored and the
5715   path was relative regardless.
5716 - [Floating point constants in match patterns is now a hard error][36890]
5717   This was previously a warning.
5718 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
5719   match patterns is now a hard error][36891] This was previously a warning.
5720 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
5721   a warning.
5722 - [From the pound escape, lines consisting of multiple `#`s are
5723   now visible][41785]
5724 - [It is an error to re-export private enum variants][42460]. This is
5725   known to break a number of crates that depend on an older version of
5726   mustache.
5727 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
5728   to use it to find the linker, and the build will fail where it did
5729   not previously][42607]
5730
5731 [36886]: https://github.com/rust-lang/rust/issues/36886
5732 [36888]: https://github.com/rust-lang/rust/issues/36888
5733 [36890]: https://github.com/rust-lang/rust/issues/36890
5734 [36891]: https://github.com/rust-lang/rust/issues/36891
5735 [36892]: https://github.com/rust-lang/rust/issues/36892
5736 [37406]: https://github.com/rust-lang/rust/issues/37406
5737 [39983]: https://github.com/rust-lang/rust/pull/39983
5738 [41145]: https://github.com/rust-lang/rust/pull/41145
5739 [41192]: https://github.com/rust-lang/rust/pull/41192
5740 [41258]: https://github.com/rust-lang/rust/pull/41258
5741 [41370]: https://github.com/rust-lang/rust/pull/41370
5742 [41449]: https://github.com/rust-lang/rust/pull/41449
5743 [41530]: https://github.com/rust-lang/rust/pull/41530
5744 [41624]: https://github.com/rust-lang/rust/pull/41624
5745 [41656]: https://github.com/rust-lang/rust/pull/41656
5746 [41659]: https://github.com/rust-lang/rust/pull/41659
5747 [41676]: https://github.com/rust-lang/rust/pull/41676
5748 [41751]: https://github.com/rust-lang/rust/pull/41751
5749 [41764]: https://github.com/rust-lang/rust/pull/41764
5750 [41785]: https://github.com/rust-lang/rust/pull/41785
5751 [41873]: https://github.com/rust-lang/rust/pull/41873
5752 [41907]: https://github.com/rust-lang/rust/pull/41907
5753 [41946]: https://github.com/rust-lang/rust/pull/41946
5754 [42016]: https://github.com/rust-lang/rust/pull/42016
5755 [42037]: https://github.com/rust-lang/rust/pull/42037
5756 [42068]: https://github.com/rust-lang/rust/pull/42068
5757 [42150]: https://github.com/rust-lang/rust/pull/42150
5758 [42162]: https://github.com/rust-lang/rust/pull/42162
5759 [42225]: https://github.com/rust-lang/rust/pull/42225
5760 [42264]: https://github.com/rust-lang/rust/pull/42264
5761 [42302]: https://github.com/rust-lang/rust/pull/42302
5762 [42460]: https://github.com/rust-lang/rust/issues/42460
5763 [42607]: https://github.com/rust-lang/rust/issues/42607
5764 [42740]: https://github.com/rust-lang/rust/pull/42740
5765 [42844]: https://github.com/rust-lang/rust/issues/42844
5766 [42948]: https://github.com/rust-lang/rust/pull/42948
5767 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
5768 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
5769 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
5770 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
5771 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
5772 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
5773 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
5774 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
5775 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
5776 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
5777 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
5778 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
5779 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
5780 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
5781 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
5782 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
5783 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
5784 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
5785 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
5786 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
5787 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
5788 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
5789
5790
5791 Version 1.18.0 (2017-06-08)
5792 ===========================
5793
5794 Language
5795 --------
5796
5797 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
5798   make the item visible to just that module tree. Also accepts the keyword
5799   `crate` to make something public to the whole crate but not users of the
5800   library. Example: `pub(crate) mod utils;`. [RFC 1422].
5801 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
5802   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
5803 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
5804   types like `Write + Send`, trailing `+` are now supported in trait objects,
5805   and better error reporting for trait objects starting with `?Sized`.
5806 - [0e+10 is now a valid floating point literal][40589]
5807 - [Now warns if you bind a lifetime parameter to 'static][40734]
5808 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
5809   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
5810   representation in some cases.][40377]
5811
5812 Compiler
5813 --------
5814
5815 - [rustc can now emit mir with `--emit mir`][39891]
5816 - [Improved LLVM IR for trivial functions][40367]
5817 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
5818 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
5819   opportunities found through profiling
5820 - [Improved backtrace formatting when panicking][38165]
5821
5822 Libraries
5823 ---------
5824
5825 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
5826   iterator hasn't been advanced the original `Vec` is reassembled with no actual
5827   iteration or reallocation.
5828 - [Simplified HashMap Bucket interface][40561] provides performance
5829   improvements for iterating and cloning.
5830 - [Specialize Vec::from_elem to use calloc][40409]
5831 - [Fixed Race condition in fs::create_dir_all][39799]
5832 - [No longer caching stdio on Windows][40516]
5833 - [Optimized insertion sort in slice][40807] insertion sort in some cases
5834   2.50%~ faster and in one case now 12.50% faster.
5835 - [Optimized `AtomicBool::fetch_nand`][41143]
5836
5837 Stabilized APIs
5838 ---------------
5839
5840 - [`Child::try_wait`]
5841 - [`HashMap::retain`]
5842 - [`HashSet::retain`]
5843 - [`PeekMut::pop`]
5844 - [`TcpStream::peek`]
5845 - [`UdpSocket::peek`]
5846 - [`UdpSocket::peek_from`]
5847
5848 Cargo
5849 -----
5850
5851 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
5852   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
5853 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
5854 - [Added Android build support][cargo/3885]
5855 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
5856   of a certain type, for example `cargo build --bins` will build all
5857   binaries.
5858 - [Added support for haiku][cargo/3952]
5859
5860 Misc
5861 ----
5862
5863 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
5864 - [Added rust-windbg script for better debugging on Windows][39983]
5865 - [Rust now uses the official cross compiler for NetBSD][40612]
5866 - [rustdoc now accepts `#` at the start of files][40828]
5867 - [Fixed jemalloc support for musl][41168]
5868
5869 Compatibility Notes
5870 -------------------
5871
5872 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
5873   always placed after the sign if it exists and before the digits. With the `#`
5874   flag the zeroes are placed after the prefix and before the digits.
5875 - [Due to the struct field optimisation][40377], using `transmute` on structs
5876   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
5877   always been undefined behavior, but is now more likely to break in practice.
5878 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
5879   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
5880   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
5881 - [Overlapping inherent `impl`s are now a hard error][40728]
5882 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
5883 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
5884   `out.asm` and `out.ll` instead of only one of the filetypes.
5885 - [ calling a function that returns `Self` will no longer work][41805] when
5886   the size of `Self` cannot be statically determined.
5887 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
5888   this has caused a few regressions namely:
5889
5890   - Changed the link order of local static/dynamic libraries (respecting the
5891     order on given rather than having the compiler reorder).
5892   - Changed how MinGW is linked, native code linked to dynamic libraries
5893     may require manually linking to the gcc support library (for the native
5894     code itself)
5895
5896 [38165]: https://github.com/rust-lang/rust/pull/38165
5897 [39799]: https://github.com/rust-lang/rust/pull/39799
5898 [39891]: https://github.com/rust-lang/rust/pull/39891
5899 [39983]: https://github.com/rust-lang/rust/pull/39983
5900 [40043]: https://github.com/rust-lang/rust/pull/40043
5901 [40241]: https://github.com/rust-lang/rust/pull/40241
5902 [40338]: https://github.com/rust-lang/rust/pull/40338
5903 [40367]: https://github.com/rust-lang/rust/pull/40367
5904 [40377]: https://github.com/rust-lang/rust/pull/40377
5905 [40409]: https://github.com/rust-lang/rust/pull/40409
5906 [40516]: https://github.com/rust-lang/rust/pull/40516
5907 [40556]: https://github.com/rust-lang/rust/pull/40556
5908 [40561]: https://github.com/rust-lang/rust/pull/40561
5909 [40589]: https://github.com/rust-lang/rust/pull/40589
5910 [40612]: https://github.com/rust-lang/rust/pull/40612
5911 [40723]: https://github.com/rust-lang/rust/pull/40723
5912 [40728]: https://github.com/rust-lang/rust/pull/40728
5913 [40731]: https://github.com/rust-lang/rust/pull/40731
5914 [40734]: https://github.com/rust-lang/rust/pull/40734
5915 [40805]: https://github.com/rust-lang/rust/pull/40805
5916 [40807]: https://github.com/rust-lang/rust/pull/40807
5917 [40828]: https://github.com/rust-lang/rust/pull/40828
5918 [40870]: https://github.com/rust-lang/rust/pull/40870
5919 [41085]: https://github.com/rust-lang/rust/pull/41085
5920 [41143]: https://github.com/rust-lang/rust/pull/41143
5921 [41168]: https://github.com/rust-lang/rust/pull/41168
5922 [41270]: https://github.com/rust-lang/rust/issues/41270
5923 [41469]: https://github.com/rust-lang/rust/pull/41469
5924 [41805]: https://github.com/rust-lang/rust/issues/41805
5925 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
5926 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
5927 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
5928 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
5929 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
5930 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
5931 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
5932 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
5933 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
5934 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
5935 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
5936 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
5937 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
5938 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
5939
5940
5941 Version 1.17.0 (2017-04-27)
5942 ===========================
5943
5944 Language
5945 --------
5946
5947 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
5948 * [Fields of structs may be initialized without duplicating the field/variable
5949   names][39761]. [RFC 1682]
5950 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
5951 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5952   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
5953   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
5954   `'b`. Soundness fix.
5955 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
5956 * [Static variables may contain references to other statics][40027]
5957
5958 Compiler
5959 --------
5960
5961 * [Exit quickly on only `--emit dep-info`][40336]
5962 * [Make `-C relocation-model` more correctly determine whether the linker
5963   creates a position-independent executable][40245]
5964 * [Add `-C overflow-checks` to directly control whether integer overflow
5965   panics][40037]
5966 * [The rustc type checker now checks items on demand instead of in a single
5967   in-order pass][40008]. This is mostly an internal refactoring in support of
5968   future work, including incremental type checking, but also resolves [RFC
5969   1647], allowing `Self` to appear in `impl` `where` clauses.
5970 * [Optimize vtable loads][39995]
5971 * [Turn off vectorization for Emscripten targets][39990]
5972 * [Provide suggestions for unknown macros imported with `use`][39953]
5973 * [Fix ICEs in path resolution][39939]
5974 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
5975 * [Add clearer error message using `&str + &str`][39116]
5976
5977 Stabilized APIs
5978 ---------------
5979
5980 * [`Arc::into_raw`]
5981 * [`Arc::from_raw`]
5982 * [`Arc::ptr_eq`]
5983 * [`Rc::into_raw`]
5984 * [`Rc::from_raw`]
5985 * [`Rc::ptr_eq`]
5986 * [`Ordering::then`]
5987 * [`Ordering::then_with`]
5988 * [`BTreeMap::range`]
5989 * [`BTreeMap::range_mut`]
5990 * [`collections::Bound`]
5991 * [`process::abort`]
5992 * [`ptr::read_unaligned`]
5993 * [`ptr::write_unaligned`]
5994 * [`Result::expect_err`]
5995 * [`Cell::swap`]
5996 * [`Cell::replace`]
5997 * [`Cell::into_inner`]
5998 * [`Cell::take`]
5999
6000 Libraries
6001 ---------
6002
6003 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
6004 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
6005 * [`String` implements `FromIterator<&char>`][40028]
6006 * `Box` [implements][40009] a number of new conversions:
6007   `From<Box<str>> for String`,
6008   `From<Box<[T]>> for Vec<T>`,
6009   `From<Box<CStr>> for CString`,
6010   `From<Box<OsStr>> for OsString`,
6011   `From<Box<Path>> for PathBuf`,
6012   `Into<Box<str>> for String`,
6013   `Into<Box<[T]>> for Vec<T>`,
6014   `Into<Box<CStr>> for CString`,
6015   `Into<Box<OsStr>> for OsString`,
6016   `Into<Box<Path>> for PathBuf`,
6017   `Default for Box<str>`,
6018   `Default for Box<CStr>`,
6019   `Default for Box<OsStr>`,
6020   `From<&CStr> for Box<CStr>`,
6021   `From<&OsStr> for Box<OsStr>`,
6022   `From<&Path> for Box<Path>`
6023 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
6024 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
6025 * [Slightly optimize `slice::sort`][39538]
6026 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
6027 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
6028   `Box<str>` implements `From<&str>`][39438]
6029 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
6030   `From<(I, u16)> where I: Into<IpAddr>`][39372]
6031 * [`format!` estimates the needed capacity before writing a string][39356]
6032 * [Support unprivileged symlink creation in Windows][38921]
6033 * [`PathBuf` implements `Default`][38764]
6034 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
6035 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
6036   and poor hash functions.
6037
6038 Cargo
6039 -----
6040
6041 * [Add `cargo check --all`][cargo/3731]
6042 * [Add an option to ignore SSL revocation checking][cargo/3699]
6043 * [Add `cargo run --package`][cargo/3691]
6044 * [Add `required_features`][cargo/3667]
6045 * [Assume `build.rs` is a build script][cargo/3664]
6046 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
6047
6048 Misc
6049 ----
6050
6051 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
6052   `rustbook`][39633]
6053 * [The "Unstable Book" documents nightly-only features][ubook]
6054 * [Improve the style of the sidebar in rustdoc output][40265]
6055 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
6056 * [Fix MSP430 breakage due to `i128`][40257]
6057 * [Preliminary Solaris/SPARCv9 support][39903]
6058 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
6059   run without installing the MSVC runtime.
6060 * [`rustdoc --test` includes file names in test names][39788]
6061 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
6062   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
6063 * [Initial support for `aarch64-unknown-freebsd`][39491]
6064 * [Initial support for `i686-unknown-netbsd`][39426]
6065 * [This release no longer includes the old makefile build system][39431]. Rust
6066   is built with a custom build system, written in Rust, and with Cargo.
6067 * [Add Debug implementations for libcollection structs][39002]
6068 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
6069 * [`--test-threads=0` produces an error][38945]
6070 * [`rustup` installs documentation by default][40526]
6071 * [The Rust source includes NatVis visualizations][39843]. These can be used by
6072   WinDbg and Visual Studio to improve the debugging experience.
6073
6074 Compatibility Notes
6075 -------------------
6076
6077 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
6078   workaround, either use MSVC 2015 or run vcvars.bat.
6079 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
6080   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
6081   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
6082   fix.
6083 * [`format!` and `Display::to_string` panic if an underlying formatting
6084   implementation returns an error][40117]. Previously the error was silently
6085   ignored. It is incorrect for `write_fmt` to return an error when writing
6086   to a string.
6087 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
6088   crates were marked stable and could be accessed from the stable toolchain.
6089 * [Rust git source no longer includes vendored crates][39728]. Those that need
6090   to build with vendored crates should build from release tarballs.
6091 * [Fix inert attributes from `proc_macro_derives`][39572]
6092 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
6093   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
6094   build system.
6095 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
6096   existing code generally ignores the type of dead-code unless a type-hint is
6097   provided; this can cause surprising inference interactions particularly around
6098   defaulting. The new code uniformly ignores the result type of dead-code.
6099 * [Tuple-struct constructors with private fields are no longer visible][38932]
6100 * [Lifetime parameters that do not appear in the arguments are now considered
6101   early-bound][38897], resolving a soundness bug (#[32330]). The
6102   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
6103   April of 2016.
6104 * [rustdoc: fix doctests with non-feature crate attributes][38161]
6105 * [Make transmuting from fn item types to pointer-sized types a hard
6106   error][34198]
6107
6108 [27787]: https://github.com/rust-lang/rust/issues/27787
6109 [32330]: https://github.com/rust-lang/rust/issues/32330
6110 [34198]: https://github.com/rust-lang/rust/pull/34198
6111 [38161]: https://github.com/rust-lang/rust/pull/38161
6112 [38368]: https://github.com/rust-lang/rust/pull/38368
6113 [38584]: https://github.com/rust-lang/rust/issues/38584
6114 [38661]: https://github.com/rust-lang/rust/pull/38661
6115 [38764]: https://github.com/rust-lang/rust/pull/38764
6116 [38864]: https://github.com/rust-lang/rust/issues/38864
6117 [38897]: https://github.com/rust-lang/rust/pull/38897
6118 [38921]: https://github.com/rust-lang/rust/pull/38921
6119 [38932]: https://github.com/rust-lang/rust/pull/38932
6120 [38945]: https://github.com/rust-lang/rust/pull/38945
6121 [38981]: https://github.com/rust-lang/rust/pull/38981
6122 [39002]: https://github.com/rust-lang/rust/pull/39002
6123 [39116]: https://github.com/rust-lang/rust/pull/39116
6124 [39193]: https://github.com/rust-lang/rust/pull/39193
6125 [39265]: https://github.com/rust-lang/rust/pull/39265
6126 [39356]: https://github.com/rust-lang/rust/pull/39356
6127 [39372]: https://github.com/rust-lang/rust/pull/39372
6128 [39426]: https://github.com/rust-lang/rust/pull/39426
6129 [39431]: https://github.com/rust-lang/rust/pull/39431
6130 [39438]: https://github.com/rust-lang/rust/pull/39438
6131 [39440]: https://github.com/rust-lang/rust/pull/39440
6132 [39485]: https://github.com/rust-lang/rust/pull/39485
6133 [39491]: https://github.com/rust-lang/rust/pull/39491
6134 [39518]: https://github.com/rust-lang/rust/pull/39518
6135 [39538]: https://github.com/rust-lang/rust/pull/39538
6136 [39572]: https://github.com/rust-lang/rust/pull/39572
6137 [39633]: https://github.com/rust-lang/rust/pull/39633
6138 [39642]: https://github.com/rust-lang/rust/pull/39642
6139 [39728]: https://github.com/rust-lang/rust/pull/39728
6140 [39761]: https://github.com/rust-lang/rust/pull/39761
6141 [39788]: https://github.com/rust-lang/rust/pull/39788
6142 [39793]: https://github.com/rust-lang/rust/pull/39793
6143 [39837]: https://github.com/rust-lang/rust/pull/39837
6144 [39843]: https://github.com/rust-lang/rust/pull/39843
6145 [39851]: https://github.com/rust-lang/rust/pull/39851
6146 [39903]: https://github.com/rust-lang/rust/pull/39903
6147 [39939]: https://github.com/rust-lang/rust/pull/39939
6148 [39953]: https://github.com/rust-lang/rust/pull/39953
6149 [39960]: https://github.com/rust-lang/rust/pull/39960
6150 [39990]: https://github.com/rust-lang/rust/pull/39990
6151 [39995]: https://github.com/rust-lang/rust/pull/39995
6152 [40008]: https://github.com/rust-lang/rust/pull/40008
6153 [40009]: https://github.com/rust-lang/rust/pull/40009
6154 [40027]: https://github.com/rust-lang/rust/pull/40027
6155 [40028]: https://github.com/rust-lang/rust/pull/40028
6156 [40037]: https://github.com/rust-lang/rust/pull/40037
6157 [40117]: https://github.com/rust-lang/rust/pull/40117
6158 [40166]: https://github.com/rust-lang/rust/pull/40166
6159 [40245]: https://github.com/rust-lang/rust/pull/40245
6160 [40257]: https://github.com/rust-lang/rust/pull/40257
6161 [40261]: https://github.com/rust-lang/rust/pull/40261
6162 [40265]: https://github.com/rust-lang/rust/pull/40265
6163 [40319]: https://github.com/rust-lang/rust/pull/40319
6164 [40336]: https://github.com/rust-lang/rust/pull/40336
6165 [40526]: https://github.com/rust-lang/rust/pull/40526
6166 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
6167 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
6168 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
6169 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
6170 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
6171 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
6172 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
6173 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
6174 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
6175 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
6176 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
6177 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
6178 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
6179 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
6180 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
6181 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
6182 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
6183 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
6184 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
6185 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
6186 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
6187 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
6188 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
6189 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
6190 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
6191 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
6192 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
6193 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
6194 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
6195 [mdbook]: https://crates.io/crates/mdbook
6196 [ubook]: https://doc.rust-lang.org/unstable-book/
6197
6198
6199 Version 1.16.0 (2017-03-16)
6200 ===========================
6201
6202 Language
6203 --------
6204
6205 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6206 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6207   match patterns][38069]
6208 * [Clean up semantics of `self` in an import list][38313]
6209 * [`Self` may appear in `impl` headers][38920]
6210 * [`Self` may appear in struct expressions][39282]
6211
6212 Compiler
6213 --------
6214
6215 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
6216   a `.rmeta` file containing only crate metadata][38571]. This can be
6217   used by tools like the Rust Language Service to perform
6218   metadata-only builds.
6219 * [Levenshtein based typo suggestions now work in most places, while
6220   previously they worked only for fields and sometimes for local
6221   variables][38927]. Together with the overhaul of "no
6222   resolution"/"unexpected resolution" errors (#[38154]) they result in
6223   large and systematic improvement in resolution diagnostics.
6224 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
6225   `U`][38670]
6226 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
6227 * [`rustc` no longer attempts to provide "consider using an explicit
6228   lifetime" suggestions][37057]. They were inaccurate.
6229
6230 Stabilized APIs
6231 ---------------
6232
6233 * [`VecDeque::truncate`]
6234 * [`VecDeque::resize`]
6235 * [`String::insert_str`]
6236 * [`Duration::checked_add`]
6237 * [`Duration::checked_sub`]
6238 * [`Duration::checked_div`]
6239 * [`Duration::checked_mul`]
6240 * [`str::replacen`]
6241 * [`str::repeat`]
6242 * [`SocketAddr::is_ipv4`]
6243 * [`SocketAddr::is_ipv6`]
6244 * [`IpAddr::is_ipv4`]
6245 * [`IpAddr::is_ipv6`]
6246 * [`Vec::dedup_by`]
6247 * [`Vec::dedup_by_key`]
6248 * [`Result::unwrap_or_default`]
6249 * [`<*const T>::wrapping_offset`]
6250 * [`<*mut T>::wrapping_offset`]
6251 * `CommandExt::creation_flags`
6252 * [`File::set_permissions`]
6253 * [`String::split_off`]
6254
6255 Libraries
6256 ---------
6257
6258 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
6259   their argument by `Borrow` parameter][37761]
6260 * [All public types in std implement `Debug`][38006]
6261 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
6262 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
6263 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6264   Windows][38274]
6265 * [std: Fix partial writes in `LineWriter`][38062]
6266 * [std: Clamp max read/write sizes on Unix][38062]
6267 * [Use more specific panic message for `&str` slicing errors][38066]
6268 * [`TcpListener::set_only_v6` is deprecated][38304]. This
6269   functionality cannot be achieved in std currently.
6270 * [`writeln!`, like `println!`, now accepts a form with no string
6271   or formatting arguments, to just print a newline][38469]
6272 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
6273 * [Reduce the size of static data in `std_unicode::tables`][38781]
6274 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
6275   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
6276   `Display`][38909]
6277 * [`Duration` implements `Sum`][38712]
6278 * [`String` implements `ToSocketAddrs`][39048]
6279
6280 Cargo
6281 -----
6282
6283 * [The `cargo check` command does a type check of a project without
6284   building it][cargo/3296]
6285 * [crates.io will display CI badges from Travis and AppVeyor, if
6286   specified in Cargo.toml][cargo/3546]
6287 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
6288 * [Compilation profiles accept integer values for `debug`, in addition
6289   to `true` and `false`. These are passed to `rustc` as the value to
6290   `-C debuginfo`][cargo/3534]
6291 * [Implement `cargo --version --verbose`][cargo/3604]
6292 * [All builds now output 'dep-info' build dependencies compatible with
6293   make and ninja][cargo/3557]
6294 * [Build all workspace members with `build --all`][cargo/3511]
6295 * [Document all workspace members with `doc --all`][cargo/3515]
6296 * [Path deps outside workspace are not members][cargo/3443]
6297
6298 Misc
6299 ----
6300
6301 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
6302   the path to the Rust implementation][38589]
6303 * [The `armv7-linux-androideabi` target no longer enables NEON
6304   extensions, per Google's ABI guide][38413]
6305 * [The stock standard library can be compiled for Redox OS][38401]
6306 * [Rust has initial SPARC support][38726]. Tier 3. No builds
6307   available.
6308 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
6309   builds available.
6310 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
6311
6312 Compatibility Notes
6313 -------------------
6314
6315 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6316   match patterns][38069]
6317 * In this release, references to uninhabited types can not be
6318   pattern-matched. This was accidentally allowed in 1.15.
6319 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6320 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6321   Windows][38274]
6322 * [Clean up semantics of `self` in an import list][38313]
6323 * Reimplemented lifetime elision. This change was almost entirely compatible
6324   with existing code, but it did close a number of small bugs and loopholes,
6325   as well as being more accepting in some other [cases][41105].
6326
6327 [37057]: https://github.com/rust-lang/rust/pull/37057
6328 [37761]: https://github.com/rust-lang/rust/pull/37761
6329 [38006]: https://github.com/rust-lang/rust/pull/38006
6330 [38051]: https://github.com/rust-lang/rust/pull/38051
6331 [38062]: https://github.com/rust-lang/rust/pull/38062
6332 [38062]: https://github.com/rust-lang/rust/pull/38622
6333 [38066]: https://github.com/rust-lang/rust/pull/38066
6334 [38069]: https://github.com/rust-lang/rust/pull/38069
6335 [38131]: https://github.com/rust-lang/rust/pull/38131
6336 [38154]: https://github.com/rust-lang/rust/pull/38154
6337 [38274]: https://github.com/rust-lang/rust/pull/38274
6338 [38304]: https://github.com/rust-lang/rust/pull/38304
6339 [38313]: https://github.com/rust-lang/rust/pull/38313
6340 [38314]: https://github.com/rust-lang/rust/pull/38314
6341 [38327]: https://github.com/rust-lang/rust/pull/38327
6342 [38401]: https://github.com/rust-lang/rust/pull/38401
6343 [38413]: https://github.com/rust-lang/rust/pull/38413
6344 [38469]: https://github.com/rust-lang/rust/pull/38469
6345 [38559]: https://github.com/rust-lang/rust/pull/38559
6346 [38571]: https://github.com/rust-lang/rust/pull/38571
6347 [38580]: https://github.com/rust-lang/rust/pull/38580
6348 [38589]: https://github.com/rust-lang/rust/pull/38589
6349 [38670]: https://github.com/rust-lang/rust/pull/38670
6350 [38712]: https://github.com/rust-lang/rust/pull/38712
6351 [38726]: https://github.com/rust-lang/rust/pull/38726
6352 [38781]: https://github.com/rust-lang/rust/pull/38781
6353 [38798]: https://github.com/rust-lang/rust/pull/38798
6354 [38909]: https://github.com/rust-lang/rust/pull/38909
6355 [38920]: https://github.com/rust-lang/rust/pull/38920
6356 [38927]: https://github.com/rust-lang/rust/pull/38927
6357 [39048]: https://github.com/rust-lang/rust/pull/39048
6358 [39282]: https://github.com/rust-lang/rust/pull/39282
6359 [39379]: https://github.com/rust-lang/rust/pull/39379
6360 [41105]: https://github.com/rust-lang/rust/issues/41105
6361 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6362 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6363 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
6364 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
6365 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
6366 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
6367 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
6368 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
6369 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
6370 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
6371 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
6372 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
6373 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
6374 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
6375 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
6376 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
6377 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
6378 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
6379 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
6380 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
6381 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
6382 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
6383 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
6384 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
6385 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
6386 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
6387 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
6388 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
6389 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
6390 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
6391
6392
6393 Version 1.15.1 (2017-02-09)
6394 ===========================
6395
6396 * [Fix IntoIter::as_mut_slice's signature][39466]
6397 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
6398
6399 [39466]: https://github.com/rust-lang/rust/pull/39466
6400 [39523]: https://github.com/rust-lang/rust/pull/39523
6401
6402
6403 Version 1.15.0 (2017-02-02)
6404 ===========================
6405
6406 Language
6407 --------
6408
6409 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
6410   stable. This allows popular code-generating crates like Serde and Diesel to
6411   work ergonomically. [RFC 1681].
6412 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
6413   with curly braces][36868]. Part of [RFC 1506].
6414 * [A number of minor changes to name resolution have been activated][37127].
6415   They add up to more consistent semantics, allowing for future evolution of
6416   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6417   details of what is different. The breaking changes here have been transitioned
6418   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6419 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
6420   bounds][38279]
6421 * [`?Sized` can be used in `where` clauses][37791]
6422 * [There is now a limit on the size of monomorphized types and it can be
6423   modified with the `#![type_size_limit]` crate attribute, similarly to
6424   the `#![recursion_limit]` attribute][37789]
6425
6426 Compiler
6427 --------
6428
6429 * [On Windows, the compiler will apply dllimport attributes when linking to
6430   extern functions][37973]. Additional attributes and flags can control which
6431   library kind is linked and its name. [RFC 1717].
6432 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6433 * [The `--test` flag works with procedural macro crates][38107]
6434 * [Fix `extern "aapcs" fn` ABI][37814]
6435 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
6436 * [The `format!` expander recognizes incorrect `printf` and shell-style
6437   formatting directives and suggests the correct format][37613].
6438 * [Only report one error for all unused imports in an import list][37456]
6439
6440 Compiler Performance
6441 --------------------
6442
6443 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
6444 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
6445 * [Don't clone in `UnificationTable::probe`][37848]
6446 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
6447 * [Use small vectors in type walker][37760]
6448 * [Macro expansion performance was improved][37701]
6449 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
6450 * [Replace FNV with a faster hash function][37229]
6451
6452 Stabilized APIs
6453 ---------------
6454
6455 * [`std::iter::Iterator::min_by`]
6456 * [`std::iter::Iterator::max_by`]
6457 * [`std::os::*::fs::FileExt`]
6458 * [`std::sync::atomic::Atomic*::get_mut`]
6459 * [`std::sync::atomic::Atomic*::into_inner`]
6460 * [`std::vec::IntoIter::as_slice`]
6461 * [`std::vec::IntoIter::as_mut_slice`]
6462 * [`std::sync::mpsc::Receiver::try_iter`]
6463 * [`std::os::unix::process::CommandExt::before_exec`]
6464 * [`std::rc::Rc::strong_count`]
6465 * [`std::rc::Rc::weak_count`]
6466 * [`std::sync::Arc::strong_count`]
6467 * [`std::sync::Arc::weak_count`]
6468 * [`std::char::encode_utf8`]
6469 * [`std::char::encode_utf16`]
6470 * [`std::cell::Ref::clone`]
6471 * [`std::io::Take::into_inner`]
6472
6473 Libraries
6474 ---------
6475
6476 * [The standard sorting algorithm has been rewritten for dramatic performance
6477   improvements][38192]. It is a hybrid merge sort, drawing influences from
6478   Timsort. Previously it was a naive merge sort.
6479 * [`Iterator::nth` no longer has a `Sized` bound][38134]
6480 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
6481   performance.
6482 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
6483   and `char_indices().last()`][37882]
6484 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
6485 * [Chinese characters display correctly in `fmt::Debug`][37855]
6486 * [Derive `Default` for `Duration`][37699]
6487 * [Support creation of anonymous pipes on WinXP/2k][37677]
6488 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
6489 * [Don't pass overlapped handles to processes][38835]
6490
6491 Cargo
6492 -----
6493
6494 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6495   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6496   should instead check the variable at runtime with `std::env`. That the value
6497   was set at build time was a bug, and incorrect when cross-compiling. This
6498   change is known to cause breakage.
6499 * [Add `--all` flag to `cargo test`][cargo/3221]
6500 * [Compile statically against the MSVC CRT][cargo/3363]
6501 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
6502 * [Link OpenSSL statically on OSX][cargo/3311]
6503 * [Apply new fingerprinting to build dir outputs][cargo/3310]
6504 * [Test for bad path overrides with summaries][cargo/3336]
6505 * [Require `cargo install --vers` to take a semver version][cargo/3338]
6506 * [Fix retrying crate downloads for network errors][cargo/3348]
6507 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
6508 * [Emit more info on --message-format=json][cargo/3319]
6509 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
6510 * [Don't ignore errors in workspace manifest][cargo/3409]
6511 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
6512
6513 Tooling
6514 -------
6515
6516 * [Test runners (binaries built with `--test`) now support a `--list` argument
6517   that lists the tests it contains][38185]
6518 * [Test runners now support a `--exact` argument that makes the test filter
6519   match exactly, instead of matching only a substring of the test name][38181]
6520 * [rustdoc supports a `--playground-url` flag][37763]
6521 * [rustdoc provides more details about `#[should_panic]` errors][37749]
6522
6523 Misc
6524 ----
6525
6526 * [The Rust build system is now written in Rust][37817]. The Makefiles may
6527   continue to be used in this release by passing `--disable-rustbuild` to the
6528   configure script, but they will be deleted soon. Note that the new build
6529   system uses a different on-disk layout that will likely affect any scripts
6530   building Rust.
6531 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
6532   releases.
6533 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
6534 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
6535   releases.
6536
6537 Compatibility Notes
6538 -------------------
6539
6540 * [A number of minor changes to name resolution have been activated][37127].
6541   They add up to more consistent semantics, allowing for future evolution of
6542   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6543   details of what is different. The breaking changes here have been transitioned
6544   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6545 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6546   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6547   should instead check the variable at runtime with `std::env`. That the value
6548   was set at build time was a bug, and incorrect when cross-compiling. This
6549   change is known to cause breakage.
6550 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
6551   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
6552   1.10 and is now an error by default. It will become a hard error in the near
6553   future.
6554 * [The semantics relating modules to file system directories are changing in
6555   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
6556   lint, which is a warning in this release, and will become a hard error in the
6557   future.
6558 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6559 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
6560   the underlying iterator][37834]
6561
6562 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
6563 [33685]: https://github.com/rust-lang/rust/issues/33685
6564 [36868]: https://github.com/rust-lang/rust/pull/36868
6565 [37127]: https://github.com/rust-lang/rust/pull/37127
6566 [37229]: https://github.com/rust-lang/rust/pull/37229
6567 [37456]: https://github.com/rust-lang/rust/pull/37456
6568 [37527]: https://github.com/rust-lang/rust/pull/37527
6569 [37602]: https://github.com/rust-lang/rust/pull/37602
6570 [37613]: https://github.com/rust-lang/rust/pull/37613
6571 [37615]: https://github.com/rust-lang/rust/pull/37615
6572 [37636]: https://github.com/rust-lang/rust/pull/37636
6573 [37627]: https://github.com/rust-lang/rust/pull/37627
6574 [37642]: https://github.com/rust-lang/rust/pull/37642
6575 [37677]: https://github.com/rust-lang/rust/pull/37677
6576 [37699]: https://github.com/rust-lang/rust/pull/37699
6577 [37701]: https://github.com/rust-lang/rust/pull/37701
6578 [37705]: https://github.com/rust-lang/rust/pull/37705
6579 [37749]: https://github.com/rust-lang/rust/pull/37749
6580 [37760]: https://github.com/rust-lang/rust/pull/37760
6581 [37763]: https://github.com/rust-lang/rust/pull/37763
6582 [37764]: https://github.com/rust-lang/rust/pull/37764
6583 [37789]: https://github.com/rust-lang/rust/pull/37789
6584 [37791]: https://github.com/rust-lang/rust/pull/37791
6585 [37814]: https://github.com/rust-lang/rust/pull/37814
6586 [37817]: https://github.com/rust-lang/rust/pull/37817
6587 [37834]: https://github.com/rust-lang/rust/pull/37834
6588 [37848]: https://github.com/rust-lang/rust/pull/37848
6589 [37855]: https://github.com/rust-lang/rust/pull/37855
6590 [37882]: https://github.com/rust-lang/rust/pull/37882
6591 [37888]: https://github.com/rust-lang/rust/pull/37888
6592 [37973]: https://github.com/rust-lang/rust/pull/37973
6593 [37979]: https://github.com/rust-lang/rust/pull/37979
6594 [38086]: https://github.com/rust-lang/rust/pull/38086
6595 [38107]: https://github.com/rust-lang/rust/pull/38107
6596 [38117]: https://github.com/rust-lang/rust/pull/38117
6597 [38134]: https://github.com/rust-lang/rust/pull/38134
6598 [38146]: https://github.com/rust-lang/rust/pull/38146
6599 [38181]: https://github.com/rust-lang/rust/pull/38181
6600 [38182]: https://github.com/rust-lang/rust/pull/38182
6601 [38185]: https://github.com/rust-lang/rust/pull/38185
6602 [38192]: https://github.com/rust-lang/rust/pull/38192
6603 [38279]: https://github.com/rust-lang/rust/pull/38279
6604 [38835]: https://github.com/rust-lang/rust/pull/38835
6605 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6606 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6607 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
6608 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
6609 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
6610 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
6611 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
6612 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
6613 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
6614 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
6615 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
6616 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
6617 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
6618 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
6619 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
6620 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
6621 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
6622 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
6623 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
6624 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
6625 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
6626 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
6627 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
6628 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
6629 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
6630 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
6631 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
6632 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
6633 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
6634 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
6635 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
6636 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
6637 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
6638 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
6639 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
6640 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
6641 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
6642 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
6643
6644
6645 Version 1.14.0 (2016-12-22)
6646 ===========================
6647
6648 Language
6649 --------
6650
6651 * [`..` matches multiple tuple fields in enum variants, structs
6652   and tuples][36843]. [RFC 1492].
6653 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
6654 * [`use *` and `use ::*` both glob-import from the crate root][37367]
6655 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
6656   dereferencing][36822]
6657
6658 Compiler
6659 --------
6660
6661 * [Mark enums with non-zero discriminant as non-zero][37224]
6662 * [Lower-case `static mut` names are linted like other
6663   statics and consts][37162]
6664 * [Fix ICE on some macros in const integer positions
6665    (e.g. `[u8; m!()]`)][36819]
6666 * [Improve error message and snippet for "did you mean `x`"][36798]
6667 * [Add a panic-strategy field to the target specification][36794]
6668 * [Include LLVM version in `--version --verbose`][37200]
6669
6670 Compile-time Optimizations
6671 --------------------------
6672
6673 * [Improve macro expansion performance][37569]
6674 * [Shrink `Expr_::ExprInlineAsm`][37445]
6675 * [Replace all uses of SHA-256 with BLAKE2b][37439]
6676 * [Reduce the number of bytes hashed by `IchHasher`][37427]
6677 * [Avoid more allocations when compiling html5ever][37373]
6678 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
6679 * [Avoid some allocations in the macro parser][37318]
6680 * [Use a faster deflate setting][37298]
6681 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
6682   during interning of slices][37270]
6683 * [Optimize `write_metadata`][37267]
6684 * [Don't process obligation forest cycles when stalled][37231]
6685 * [Avoid many `CrateConfig` clones][37161]
6686 * [Optimize `Substs::super_fold_with`][37108]
6687 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
6688 * [Speed up `plug_leaks`][36917]
6689
6690 Libraries
6691 ---------
6692
6693 * [`println!()`, with no arguments, prints newline][36825].
6694   Previously, an empty string was required to achieve the same.
6695 * [`Wrapping` impls standard binary and unary operators, as well as
6696    the `Sum` and `Product` iterators][37356]
6697 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
6698   Vec<T>`][37326]
6699 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
6700   `VecDeque` iterators][37315]
6701 * [Improve `SipHasher` performance on small values][37312]
6702 * [Add Iterator trait TrustedLen to enable better FromIterator /
6703   Extend][37306]
6704 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
6705 * [`ReadDir` implements `Debug`][37221]
6706 * [Implement `RefUnwindSafe` for atomic types][37178]
6707 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
6708 * [Avoid allocations in `Decoder::read_str`][37064]
6709 * [`io::Error` implements `From<io::ErrorKind>`][37037]
6710 * [Impl `Debug` for raw pointers to unsized data][36880]
6711 * [Don't reuse `HashMap` random seeds][37470]
6712 * [The internal memory layout of `HashMap` is more cache-friendly, for
6713   significant improvements in some operations][36692]
6714 * [`HashMap` uses less memory on 32-bit architectures][36595]
6715 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
6716
6717 Cargo
6718 -----
6719
6720 * [Expose rustc cfg values to build scripts][cargo/3243]
6721 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
6722 * [Fix passing --features when testing multiple packages][cargo/3280]
6723 * [Use a single profile set per workspace][cargo/3249]
6724 * [Load `replace` sections from lock files][cargo/3220]
6725 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
6726
6727 Tooling
6728 -------
6729
6730 * [rustup is the recommended Rust installation method][1.14rustup]
6731 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
6732   S390x. These are [tier 2] platforms and may have major defects. Follow the
6733   instructions on the website to install, or add the targets to an existing
6734   installation with `rustup target add`. The new target triples are:
6735   - `mips-unknown-linux-gnu`
6736   - `mipsel-unknown-linux-gnu`
6737   - `mips64-unknown-linux-gnuabi64`
6738   - `mips64el-unknown-linux-gnuabi64 `
6739   - `powerpc-unknown-linux-gnu`
6740   - `powerpc64-unknown-linux-gnu`
6741   - `powerpc64le-unknown-linux-gnu`
6742   - `s390x-unknown-linux-gnu `
6743 * This release includes target (std) builds for ARM Linux running MUSL
6744   libc. These are [tier 2] platforms and may have major defects. Add the
6745   following triples to an existing rustup installation with `rustup target add`:
6746   - `arm-unknown-linux-musleabi`
6747   - `arm-unknown-linux-musleabihf`
6748   - `armv7-unknown-linux-musleabihf`
6749 * This release includes [experimental support for WebAssembly][1.14wasm], via
6750   the `wasm32-unknown-emscripten` target. This target is known to have major
6751   defects. Please test, report, and fix.
6752 * rustup no longer installs documentation by default. Run `rustup
6753   component add rust-docs` to install.
6754 * [Fix line stepping in debugger][37310]
6755 * [Enable line number debuginfo in releases][37280]
6756
6757 Misc
6758 ----
6759
6760 * [Disable jemalloc on aarch64/powerpc/mips][37392]
6761 * [Add support for Fuchsia OS][37313]
6762 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
6763
6764 Compatibility Notes
6765 -------------------
6766
6767 * [A number of forward-compatibility lints used by the compiler
6768   to gradually introduce language changes have been converted
6769   to deny by default][36894]:
6770   - ["use of inaccessible extern crate erroneously allowed"][36886]
6771   - ["type parameter default erroneously allowed in invalid location"][36887]
6772   - ["detects super or self keywords at the beginning of global path"][36888]
6773   - ["two overlapping inherent impls define an item with the same name
6774     were erroneously allowed"][36889]
6775   - ["floating-point constants cannot be used in patterns"][36890]
6776   - ["constants of struct or enum type can only be used in a pattern if
6777      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
6778   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
6779 * [Prohibit patterns in trait methods without bodies][37378]
6780 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
6781 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
6782 * [The `$crate` macro variable is accepted in fewer locations][37213]
6783 * [Impls specifying extra region requirements beyond the trait
6784   they implement are rejected][37167]
6785 * [Enums may not be unsized][37111]. Unsized enums are intended to
6786   work but never have. For now they are forbidden.
6787 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
6788
6789 [tier 2]: https://forge.rust-lang.org/platform-support.html
6790 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
6791 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
6792 [36430]: https://github.com/rust-lang/rust/pull/36430
6793 [36595]: https://github.com/rust-lang/rust/pull/36595
6794 [36595]: https://github.com/rust-lang/rust/pull/36595
6795 [36692]: https://github.com/rust-lang/rust/pull/36692
6796 [36767]: https://github.com/rust-lang/rust/pull/36767
6797 [36794]: https://github.com/rust-lang/rust/pull/36794
6798 [36798]: https://github.com/rust-lang/rust/pull/36798
6799 [36819]: https://github.com/rust-lang/rust/pull/36819
6800 [36822]: https://github.com/rust-lang/rust/pull/36822
6801 [36825]: https://github.com/rust-lang/rust/pull/36825
6802 [36843]: https://github.com/rust-lang/rust/pull/36843
6803 [36880]: https://github.com/rust-lang/rust/pull/36880
6804 [36886]: https://github.com/rust-lang/rust/issues/36886
6805 [36887]: https://github.com/rust-lang/rust/issues/36887
6806 [36888]: https://github.com/rust-lang/rust/issues/36888
6807 [36889]: https://github.com/rust-lang/rust/issues/36889
6808 [36890]: https://github.com/rust-lang/rust/issues/36890
6809 [36891]: https://github.com/rust-lang/rust/issues/36891
6810 [36892]: https://github.com/rust-lang/rust/issues/36892
6811 [36894]: https://github.com/rust-lang/rust/pull/36894
6812 [36917]: https://github.com/rust-lang/rust/pull/36917
6813 [36993]: https://github.com/rust-lang/rust/pull/36993
6814 [37037]: https://github.com/rust-lang/rust/pull/37037
6815 [37064]: https://github.com/rust-lang/rust/pull/37064
6816 [37094]: https://github.com/rust-lang/rust/pull/37094
6817 [37108]: https://github.com/rust-lang/rust/pull/37108
6818 [37111]: https://github.com/rust-lang/rust/pull/37111
6819 [37161]: https://github.com/rust-lang/rust/pull/37161
6820 [37162]: https://github.com/rust-lang/rust/pull/37162
6821 [37167]: https://github.com/rust-lang/rust/pull/37167
6822 [37178]: https://github.com/rust-lang/rust/pull/37178
6823 [37200]: https://github.com/rust-lang/rust/pull/37200
6824 [37213]: https://github.com/rust-lang/rust/pull/37213
6825 [37221]: https://github.com/rust-lang/rust/pull/37221
6826 [37224]: https://github.com/rust-lang/rust/pull/37224
6827 [37230]: https://github.com/rust-lang/rust/pull/37230
6828 [37231]: https://github.com/rust-lang/rust/pull/37231
6829 [37247]: https://github.com/rust-lang/rust/pull/37247
6830 [37267]: https://github.com/rust-lang/rust/pull/37267
6831 [37270]: https://github.com/rust-lang/rust/pull/37270
6832 [37273]: https://github.com/rust-lang/rust/pull/37273
6833 [37280]: https://github.com/rust-lang/rust/pull/37280
6834 [37298]: https://github.com/rust-lang/rust/pull/37298
6835 [37306]: https://github.com/rust-lang/rust/pull/37306
6836 [37310]: https://github.com/rust-lang/rust/pull/37310
6837 [37312]: https://github.com/rust-lang/rust/pull/37312
6838 [37313]: https://github.com/rust-lang/rust/pull/37313
6839 [37315]: https://github.com/rust-lang/rust/pull/37315
6840 [37318]: https://github.com/rust-lang/rust/pull/37318
6841 [37322]: https://github.com/rust-lang/rust/pull/37322
6842 [37326]: https://github.com/rust-lang/rust/pull/37326
6843 [37351]: https://github.com/rust-lang/rust/pull/37351
6844 [37356]: https://github.com/rust-lang/rust/pull/37356
6845 [37367]: https://github.com/rust-lang/rust/pull/37367
6846 [37373]: https://github.com/rust-lang/rust/pull/37373
6847 [37378]: https://github.com/rust-lang/rust/pull/37378
6848 [37389]: https://github.com/rust-lang/rust/pull/37389
6849 [37392]: https://github.com/rust-lang/rust/pull/37392
6850 [37427]: https://github.com/rust-lang/rust/pull/37427
6851 [37439]: https://github.com/rust-lang/rust/pull/37439
6852 [37445]: https://github.com/rust-lang/rust/pull/37445
6853 [37470]: https://github.com/rust-lang/rust/pull/37470
6854 [37569]: https://github.com/rust-lang/rust/pull/37569
6855 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6856 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
6857 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
6858 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
6859 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
6860 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
6861 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
6862
6863
6864 Version 1.13.0 (2016-11-10)
6865 ===========================
6866
6867 Language
6868 --------
6869
6870 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
6871   errors, like the `try!` macro, described in [RFC 0243].
6872 * [Stabilize macros in type position][36014]. Described in [RFC 873].
6873 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
6874 * [Fix `#[derive]` for empty tuple structs/variants][35728]
6875 * [Fix lifetime rules for 'if' conditions][36029]
6876 * [Avoid loading and parsing unconfigured non-inline modules][36482]
6877
6878 Compiler
6879 --------
6880
6881 * [Add the `-C link-arg` argument][36574]
6882 * [Remove the old AST-based backend from rustc_trans][35764]
6883 * [Don't enable NEON by default on armv7 Linux][35814]
6884 * [Fix debug line number info for macro expansions][35238]
6885 * [Do not emit "class method" debuginfo for types that are not
6886   DICompositeType][36008]
6887 * [Warn about multiple conflicting #[repr] hints][34623]
6888 * [When sizing DST, don't double-count nested struct prefixes][36351]
6889 * [Default RUST_MIN_STACK to 16MiB for now][36505]
6890 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
6891 * [Reject macros with empty repetitions to avoid infinite loop][36721]
6892 * [Expand macros without recursing to avoid stack overflows][36214]
6893
6894 Diagnostics
6895 -----------
6896
6897 * [Replace macro backtraces with labeled local uses][35702]
6898 * [Improve error message for misplaced doc comments][33922]
6899 * [Buffer unix and lock windows to prevent message interleaving][35975]
6900 * [Update lifetime errors to specifically note temporaries][36171]
6901 * [Special case a few colors for Windows][36178]
6902 * [Suggest `use self` when such an import resolves][36289]
6903 * [Be more specific when type parameter shadows primitive type][36338]
6904 * Many minor improvements
6905
6906 Compile-time Optimizations
6907 --------------------------
6908
6909 * [Compute and cache HIR hashes at beginning][35854]
6910 * [Don't hash types in loan paths][36004]
6911 * [Cache projections in trans][35761]
6912 * [Optimize the parser's last token handling][36527]
6913 * [Only instantiate #[inline] functions in codegen units referencing
6914   them][36524]. This leads to big improvements in cases where crates export
6915   define many inline functions without using them directly.
6916 * [Lazily allocate TypedArena's first chunk][36592]
6917 * [Don't allocate during default HashSet creation][36734]
6918
6919 Stabilized APIs
6920 ---------------
6921
6922 * [`checked_abs`]
6923 * [`wrapping_abs`]
6924 * [`overflowing_abs`]
6925 * [`RefCell::try_borrow`]
6926 * [`RefCell::try_borrow_mut`]
6927
6928 Libraries
6929 ---------
6930
6931 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
6932 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
6933   covariant][35354]
6934 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
6935 * [Implement `Debug` for `std::vec::IntoIter`][35707]
6936 * [`CString`: avoid excessive growth just to 0-terminate][35871]
6937 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
6938 * [Use arc4rand on FreeBSD][35884]
6939 * [memrchr: Correct aligned offset computation][35969]
6940 * [Improve Demangling of Rust Symbols][36059]
6941 * [Use monotonic time in condition variables][35048]
6942 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
6943 * [Implement conversion traits for `char`][35755]
6944 * [Fix illegal instruction caused by overflow in channel cloning][36104]
6945 * [Zero first byte of CString on drop][36264]
6946 * [Inherit overflow checks for sum and product][36372]
6947 * [Add missing Eq implementations][36423]
6948 * [Implement `Debug` for `DirEntry`][36631]
6949 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
6950   `errno`][36754]
6951 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6952 * [Implement more traits for `std::io::ErrorKind`][35911]
6953 * [Optimize BinaryHeap bounds checking][36072]
6954 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
6955   `extend_with_element`][36355]
6956 * [Fix overflow checking in unsigned pow()][34942]
6957
6958 Cargo
6959 -----
6960
6961 * This release includes security fixes to both curl and OpenSSL.
6962 * [Fix transitive doctests when panic=abort][cargo/3021]
6963 * [Add --all-features flag to cargo][cargo/3038]
6964 * [Reject path-based dependencies in `cargo package`][cargo/3060]
6965 * [Don't parse the home directory more than once][cargo/3078]
6966 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
6967 * [Update OpenSSL to 1.0.2j][cargo/3121]
6968 * [Add license and license_file to cargo metadata output][cargo/3110]
6969 * [Make crates-io registry URL optional in config; ignore all changes to
6970   source.crates-io][cargo/3089]
6971 * [Don't download dependencies from other platforms][cargo/3123]
6972 * [Build transitive dev-dependencies when needed][cargo/3125]
6973 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
6974 * [Avoid updating registry when adding existing deps][cargo/3144]
6975 * [Warn about path overrides that won't work][cargo/3136]
6976 * [Use workspaces during `cargo install`][cargo/3146]
6977 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
6978 * [Add --message-format flag][cargo/3000]
6979 * [Pass target environment for rustdoc][cargo/3205]
6980 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
6981 * [Update curl and curl-sys][cargo/3241]
6982 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
6983
6984 Tooling
6985 -------
6986
6987 * [rustdoc: Add the `--sysroot` argument][36586]
6988 * [rustdoc: Fix a couple of issues with the search results][35655]
6989 * [rustdoc: remove the `!` from macro URLs and titles][35234]
6990 * [gdb: Fix pretty-printing special-cased Rust types][35585]
6991 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
6992
6993 Misc
6994 ----
6995
6996 * [Remove unmaintained style guide][35124]
6997 * [Add s390x support][36369]
6998 * [Initial work at Haiku OS support][36727]
6999 * [Add mips-uclibc targets][35734]
7000 * [Crate-ify compiler-rt into compiler-builtins][35021]
7001 * [Add rustc version info (git hash + date) to dist tarball][36213]
7002 * Many documentation improvements
7003
7004 Compatibility Notes
7005 -------------------
7006
7007 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
7008 * [Deny (by default) transmuting from fn item types to pointer-sized
7009   types][34923]. Continuing the long transition to zero-sized fn items,
7010   per [RFC 401].
7011 * [Fix `#[derive]` for empty tuple structs/variants][35728].
7012   Part of [RFC 1506].
7013 * [Issue deprecation warnings for safe accesses to extern statics][36173]
7014 * [Fix lifetime rules for 'if' conditions][36029].
7015 * [Inherit overflow checks for sum and product][36372].
7016 * [Forbid user-defined macros named "macro_rules"][36730].
7017
7018 [33922]: https://github.com/rust-lang/rust/pull/33922
7019 [34623]: https://github.com/rust-lang/rust/pull/34623
7020 [34923]: https://github.com/rust-lang/rust/pull/34923
7021 [34942]: https://github.com/rust-lang/rust/pull/34942
7022 [34982]: https://github.com/rust-lang/rust/pull/34982
7023 [35021]: https://github.com/rust-lang/rust/pull/35021
7024 [35048]: https://github.com/rust-lang/rust/pull/35048
7025 [35074]: https://github.com/rust-lang/rust/pull/35074
7026 [35124]: https://github.com/rust-lang/rust/pull/35124
7027 [35234]: https://github.com/rust-lang/rust/pull/35234
7028 [35238]: https://github.com/rust-lang/rust/pull/35238
7029 [35354]: https://github.com/rust-lang/rust/pull/35354
7030 [35559]: https://github.com/rust-lang/rust/pull/35559
7031 [35585]: https://github.com/rust-lang/rust/pull/35585
7032 [35627]: https://github.com/rust-lang/rust/pull/35627
7033 [35655]: https://github.com/rust-lang/rust/pull/35655
7034 [35702]: https://github.com/rust-lang/rust/pull/35702
7035 [35707]: https://github.com/rust-lang/rust/pull/35707
7036 [35728]: https://github.com/rust-lang/rust/pull/35728
7037 [35734]: https://github.com/rust-lang/rust/pull/35734
7038 [35755]: https://github.com/rust-lang/rust/pull/35755
7039 [35761]: https://github.com/rust-lang/rust/pull/35761
7040 [35764]: https://github.com/rust-lang/rust/pull/35764
7041 [35814]: https://github.com/rust-lang/rust/pull/35814
7042 [35854]: https://github.com/rust-lang/rust/pull/35854
7043 [35871]: https://github.com/rust-lang/rust/pull/35871
7044 [35884]: https://github.com/rust-lang/rust/pull/35884
7045 [35911]: https://github.com/rust-lang/rust/pull/35911
7046 [35969]: https://github.com/rust-lang/rust/pull/35969
7047 [35975]: https://github.com/rust-lang/rust/pull/35975
7048 [36004]: https://github.com/rust-lang/rust/pull/36004
7049 [36008]: https://github.com/rust-lang/rust/pull/36008
7050 [36014]: https://github.com/rust-lang/rust/pull/36014
7051 [36029]: https://github.com/rust-lang/rust/pull/36029
7052 [36059]: https://github.com/rust-lang/rust/pull/36059
7053 [36072]: https://github.com/rust-lang/rust/pull/36072
7054 [36101]: https://github.com/rust-lang/rust/pull/36101
7055 [36104]: https://github.com/rust-lang/rust/pull/36104
7056 [36171]: https://github.com/rust-lang/rust/pull/36171
7057 [36173]: https://github.com/rust-lang/rust/pull/36173
7058 [36178]: https://github.com/rust-lang/rust/pull/36178
7059 [36213]: https://github.com/rust-lang/rust/pull/36213
7060 [36214]: https://github.com/rust-lang/rust/pull/36214
7061 [36264]: https://github.com/rust-lang/rust/pull/36264
7062 [36266]: https://github.com/rust-lang/rust/pull/36266
7063 [36289]: https://github.com/rust-lang/rust/pull/36289
7064 [36338]: https://github.com/rust-lang/rust/pull/36338
7065 [36351]: https://github.com/rust-lang/rust/pull/36351
7066 [36355]: https://github.com/rust-lang/rust/pull/36355
7067 [36369]: https://github.com/rust-lang/rust/pull/36369
7068 [36372]: https://github.com/rust-lang/rust/pull/36372
7069 [36423]: https://github.com/rust-lang/rust/pull/36423
7070 [36482]: https://github.com/rust-lang/rust/pull/36482
7071 [36505]: https://github.com/rust-lang/rust/pull/36505
7072 [36524]: https://github.com/rust-lang/rust/pull/36524
7073 [36527]: https://github.com/rust-lang/rust/pull/36527
7074 [36551]: https://github.com/rust-lang/rust/pull/36551
7075 [36574]: https://github.com/rust-lang/rust/pull/36574
7076 [36586]: https://github.com/rust-lang/rust/pull/36586
7077 [36592]: https://github.com/rust-lang/rust/pull/36592
7078 [36631]: https://github.com/rust-lang/rust/pull/36631
7079 [36639]: https://github.com/rust-lang/rust/pull/36639
7080 [36721]: https://github.com/rust-lang/rust/pull/36721
7081 [36727]: https://github.com/rust-lang/rust/pull/36727
7082 [36730]: https://github.com/rust-lang/rust/pull/36730
7083 [36734]: https://github.com/rust-lang/rust/pull/36734
7084 [36754]: https://github.com/rust-lang/rust/pull/36754
7085 [36995]: https://github.com/rust-lang/rust/pull/36995
7086 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
7087 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
7088 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
7089 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
7090 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
7091 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
7092 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
7093 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
7094 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
7095 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
7096 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
7097 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
7098 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
7099 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
7100 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
7101 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
7102 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
7103 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
7104 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
7105 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
7106 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
7107 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
7108 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
7109 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
7110 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
7111 [rustup]: https://www.rustup.rs
7112 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
7113 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
7114 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
7115 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
7116 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
7117 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
7118 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
7119
7120
7121 Version 1.12.1 (2016-10-20)
7122 ===========================
7123
7124 Regression Fixes
7125 ----------------
7126
7127 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
7128 * [Confusion with double negation and booleans][36856]
7129 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
7130 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
7131 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
7132 * [Corrupted memory after updated to 1.12][36936]
7133 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
7134 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
7135 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
7136
7137 [36381]: https://github.com/rust-lang/rust/issues/36381
7138 [36856]: https://github.com/rust-lang/rust/issues/36856
7139 [36875]: https://github.com/rust-lang/rust/issues/36875
7140 [36924]: https://github.com/rust-lang/rust/issues/36924
7141 [36926]: https://github.com/rust-lang/rust/issues/36926
7142 [36936]: https://github.com/rust-lang/rust/issues/36936
7143 [37026]: https://github.com/rust-lang/rust/issues/37026
7144 [37112]: https://github.com/rust-lang/rust/issues/37112
7145 [37153]: https://github.com/rust-lang/rust/issues/37153
7146
7147
7148 Version 1.12.0 (2016-09-29)
7149 ===========================
7150
7151 Highlights
7152 ----------
7153
7154 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
7155   This translation pass is far simpler than the previous AST->LLVM pass, and
7156   creates opportunities to perform new optimizations directly on the MIR. It
7157   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
7158 * [`rustc` presents a new, more readable error format, along with
7159   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
7160   Most common editors supporting Rust have been updated to work with it. It was
7161   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
7162
7163 Compiler
7164 --------
7165
7166 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
7167   This translation pass is far simpler than the previous AST->LLVM pass, and
7168   creates opportunities to perform new optimizations directly on the MIR. It
7169   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
7170 * [Print the Rust target name, not the LLVM target name, with
7171   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
7172 * [The computation of `TypeId` is correct in some cases where it was previously
7173   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
7174 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
7175 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
7176   `--print relocation-models`, and `--print code-models` print the available
7177   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
7178   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
7179 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
7180   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
7181   These targets produce statically-linked binaries. There are no binary release
7182   builds yet though.
7183
7184 Diagnostics
7185 -----------
7186
7187 * [`rustc` presents a new, more readable error format, along with
7188   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
7189   Most common editors supporting Rust have been updated to work with it. It was
7190   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
7191 * [In error descriptions, references are now described in plain English,
7192   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
7193 * [In error type descriptions, unknown numeric types are named `{integer}` or
7194   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
7195 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
7196
7197 Language
7198 --------
7199
7200 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
7201 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
7202 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
7203   useful](https://github.com/rust-lang/rust/pull/34908)
7204 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
7205   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
7206 * [Semicolons are properly required as statement delimiters inside
7207   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
7208 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
7209
7210 Stabilized APIs
7211 ---------------
7212
7213 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
7214 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
7215 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
7216 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
7217 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
7218 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
7219 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
7220 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
7221 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
7222 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
7223   Both on Unix and Windows.
7224 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
7225 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
7226 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
7227 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
7228 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
7229 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
7230 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
7231 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
7232
7233 Libraries
7234 ---------
7235
7236 * [The `format!` macro and friends now allow a single argument to be formatted
7237   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
7238 * [The lifetime bounds on `[T]::binary_search_by` and
7239   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
7240 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
7241 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
7242 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
7243 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
7244 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
7245 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
7246 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
7247 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
7248   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
7249 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
7250   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
7251 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
7252 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
7253   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
7254 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
7255 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
7256 * [`mpsc::sync_channel` `Receiver`s return any available message before
7257   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
7258 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
7259 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
7260
7261 Cargo
7262 -----
7263
7264 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
7265 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
7266 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
7267 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
7268 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
7269 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
7270 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
7271 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
7272 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
7273 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
7274 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
7275 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
7276 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
7277 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
7278 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
7279 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
7280
7281 Performance
7282 -----------
7283
7284 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
7285 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
7286
7287 Tooling
7288 -------
7289
7290 * [Test binaries now support a `--test-threads` argument to specify the number
7291   of threads used to run tests, and which acts the same as the
7292   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
7293 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
7294 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
7295 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7296 * [Rust releases now come with source packages that can be installed by rustup
7297   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
7298   The resulting source code can be used by tools and IDES, located in the
7299   sysroot under `lib/rustlib/src`.
7300
7301 Misc
7302 ----
7303
7304 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
7305 * Many minor improvements to the documentation.
7306 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
7307
7308 Compatibility Notes
7309 -------------------
7310
7311 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
7312   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
7313 * [When formatting strings, if "precision" is specified, the "fill",
7314   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
7315 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
7316
7317
7318 Version 1.11.0 (2016-08-18)
7319 ===========================
7320
7321 Language
7322 --------
7323
7324 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
7325 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
7326 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
7327 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
7328
7329 Stabilized APIs
7330 ---------------
7331
7332 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
7333 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
7334 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
7335 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
7336 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
7337 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
7338   (in libcore - previously stabilized in libstd)
7339 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
7340   (in libcore - previously stabilized in libstd)
7341 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
7342   (in libcore - previously stabilized in libstd)
7343 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
7344   (in libcore - previously stabilized in libstd)
7345 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7346 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7347 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
7348 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
7349
7350 Libraries
7351 ---------
7352
7353 * [The `thread_local!` macro supports multiple definitions in a single
7354    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
7355 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
7356 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
7357   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
7358 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
7359 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
7360 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
7361 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
7362
7363 Cargo
7364 -----
7365
7366 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
7367 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
7368 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
7369 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
7370 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
7371   and `-vv` prints warnings for all crates.
7372 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
7373 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
7374   This provides room for expansion by arbitrary tools.
7375 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
7376 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
7377 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
7378 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
7379 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
7380 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
7381 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
7382
7383 Performance
7384 -----------
7385
7386 * [Caching projections speeds up type check dramatically for some
7387   workloads](https://github.com/rust-lang/rust/pull/33816)
7388 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
7389   This hasher is faster, but is believed to provide sufficient
7390   protection from collision attacks.
7391 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
7392
7393 Rustdoc
7394 -------
7395
7396 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
7397 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
7398 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
7399 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
7400 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
7401
7402 Tooling
7403 -------
7404
7405 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
7406 * [When emitting debug info, rustc emits frame pointers for closures,
7407   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
7408 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7409 * Many more errors have been given error codes and extended
7410   explanations
7411 * API documentation continues to be improved, with many new examples
7412
7413 Misc
7414 ----
7415
7416 * [rustc no longer hangs when dependencies recursively re-export
7417   submodules](https://github.com/rust-lang/rust/pull/34542)
7418 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
7419 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
7420   rewritten](https://github.com/rust-lang/rust/pull/33895)
7421 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
7422   No targets use this yet, but it works toward AVR support.
7423
7424 Compatibility Notes
7425 -------------------
7426
7427 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
7428 * [The new follow-set rules that place restrictions on `macro_rules!`
7429   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
7430   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
7431   and has been a warning since 1.10.
7432 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
7433   This causes breakage in some corner cases.
7434
7435
7436 Version 1.10.0 (2016-07-07)
7437 ===========================
7438
7439 Language
7440 --------
7441
7442 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
7443   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
7444 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
7445 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
7446 * [`panic!` can be converted to a runtime abort with the
7447   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
7448   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7449 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
7450   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
7451   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
7452   Note that Cargo does not yet directly support cdylibs.
7453
7454 Stabilized APIs
7455 ---------------
7456
7457 * `os::windows::fs::OpenOptionsExt::access_mode`
7458 * `os::windows::fs::OpenOptionsExt::share_mode`
7459 * `os::windows::fs::OpenOptionsExt::custom_flags`
7460 * `os::windows::fs::OpenOptionsExt::attributes`
7461 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
7462 * `os::unix::fs::OpenOptionsExt::custom_flags`
7463 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
7464 * `Default for sync::Weak`
7465 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
7466 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
7467 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
7468 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
7469 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
7470 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
7471 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
7472 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
7473 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
7474 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
7475 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
7476 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
7477 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
7478 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
7479 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
7480 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
7481 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
7482 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
7483 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
7484 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
7485 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
7486 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
7487 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
7488 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
7489 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
7490 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7491 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7492 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7493 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7494 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
7495 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
7496 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
7497 * Read/Write/RawFd impls for `UnixStream`
7498 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
7499 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
7500 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
7501 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
7502 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
7503 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
7504 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
7505 * RawFd impls for `UnixListener`
7506 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
7507 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
7508 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
7509 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
7510 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
7511 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
7512 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
7513 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
7514 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
7515 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
7516 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
7517 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
7518 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
7519 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
7520 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
7521 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
7522 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
7523 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
7524 * RawFd impls for `UnixDatagram`
7525 * `{BTree,Hash}Map::values_mut`
7526 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
7527
7528 Libraries
7529 ---------
7530
7531 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
7532   The semantics of this minor method are subtle and probably not what
7533   most people want.
7534 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
7535 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
7536   will fall back to `/dev/urandom` temporarily to avoid blocking
7537   during early boot](https://github.com/rust-lang/rust/pull/33086).
7538 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
7539 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
7540 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
7541 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
7542 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
7543 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
7544   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
7545
7546 Cargo
7547 -----
7548 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
7549   This controls the runtime behavior of the `panic!` macro
7550   and can be either "unwind" (the default), or "abort".
7551   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7552 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
7553 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
7554 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
7555   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
7556 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
7557 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
7558 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
7559   By default they are retried twice, which can be customized with the
7560   `net.retry` value in `.cargo/config`.
7561 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
7562 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
7563 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
7564 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
7565   Makes it possible to install multiple crates in parallel.
7566 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
7567 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
7568 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
7569 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
7570 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
7571 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
7572
7573 Performance
7574 -----------
7575
7576 * [rustc memory usage was reduced by refactoring the context used for
7577   type checking](https://github.com/rust-lang/rust/pull/33425).
7578 * [Speed up creation of `HashMap`s by caching the random keys used
7579   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
7580 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
7581 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
7582 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
7583   10x faster than the previous lookup tables.
7584 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
7585
7586 Usability
7587 ---------
7588
7589 * Many incremental improvements to documentation and rustdoc.
7590 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
7591 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
7592 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
7593 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
7594 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
7595 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
7596 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
7597
7598 Misc
7599 ----
7600
7601 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
7602 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
7603 * [`std` no longer prints backtraces on platforms where the running
7604   module must be loaded with `env::current_exe`, which can't be relied
7605   on](https://github.com/rust-lang/rust/pull/33554).
7606 * This release includes std binaries for the i586-unknown-linux-gnu,
7607   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
7608   i586 target is for old x86 hardware without SSE2, and the armv7
7609   target is for Android running on modern ARM architectures.
7610 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
7611   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
7612 * [On Unix the runtime aborts by calling `libc::abort` instead of
7613   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
7614 * [Rust is now bootstrapped from the previous release of Rust,
7615   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
7616
7617 Compatibility Notes
7618 -------------------
7619
7620 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
7621 * [`target_env` for Linux ARM targets is just `gnu`, not
7622   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
7623 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
7624 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
7625 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
7626   Affects how macros are parsed.
7627 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
7628 * [Feature-gated attributes on macro-generated macro invocations are
7629   now rejected](https://github.com/rust-lang/rust/pull/32791).
7630 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
7631   This caused some minor changes to type inference.
7632
7633
7634 Version 1.9.0 (2016-05-26)
7635 ==========================
7636
7637 Language
7638 --------
7639
7640 * The `#[deprecated]` attribute when applied to an API will generate
7641   warnings when used. The warnings may be suppressed with
7642   `#[allow(deprecated)]`. [RFC 1270].
7643 * [`fn` item types are zero sized, and each `fn` names a unique
7644   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7645   `transmute` on a `fn` type will generate a warning for a few cycles,
7646   then will be converted to an error.
7647 * [Field and method resolution understand visibility, so private
7648   fields and methods cannot prevent the proper use of public fields
7649   and methods][1.9fv].
7650 * [The parser considers unicode codepoints in the
7651   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
7652
7653 Stabilized APIs
7654 ---------------
7655
7656 * [`std::panic`]
7657 * [`std::panic::catch_unwind`] (renamed from `recover`)
7658 * [`std::panic::resume_unwind`] (renamed from `propagate`)
7659 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
7660 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
7661 * [`str::is_char_boundary`]
7662 * [`<*const T>::as_ref`]
7663 * [`<*mut T>::as_ref`]
7664 * [`<*mut T>::as_mut`]
7665 * [`AsciiExt::make_ascii_uppercase`]
7666 * [`AsciiExt::make_ascii_lowercase`]
7667 * [`char::decode_utf16`]
7668 * [`char::DecodeUtf16`]
7669 * [`char::DecodeUtf16Error`]
7670 * [`char::DecodeUtf16Error::unpaired_surrogate`]
7671 * [`BTreeSet::take`]
7672 * [`BTreeSet::replace`]
7673 * [`BTreeSet::get`]
7674 * [`HashSet::take`]
7675 * [`HashSet::replace`]
7676 * [`HashSet::get`]
7677 * [`OsString::with_capacity`]
7678 * [`OsString::clear`]
7679 * [`OsString::capacity`]
7680 * [`OsString::reserve`]
7681 * [`OsString::reserve_exact`]
7682 * [`OsStr::is_empty`]
7683 * [`OsStr::len`]
7684 * [`std::os::unix::thread`]
7685 * [`RawPthread`]
7686 * [`JoinHandleExt`]
7687 * [`JoinHandleExt::as_pthread_t`]
7688 * [`JoinHandleExt::into_pthread_t`]
7689 * [`HashSet::hasher`]
7690 * [`HashMap::hasher`]
7691 * [`CommandExt::exec`]
7692 * [`File::try_clone`]
7693 * [`SocketAddr::set_ip`]
7694 * [`SocketAddr::set_port`]
7695 * [`SocketAddrV4::set_ip`]
7696 * [`SocketAddrV4::set_port`]
7697 * [`SocketAddrV6::set_ip`]
7698 * [`SocketAddrV6::set_port`]
7699 * [`SocketAddrV6::set_flowinfo`]
7700 * [`SocketAddrV6::set_scope_id`]
7701 * [`slice::copy_from_slice`]
7702 * [`ptr::read_volatile`]
7703 * [`ptr::write_volatile`]
7704 * [`OpenOptions::create_new`]
7705 * [`TcpStream::set_nodelay`]
7706 * [`TcpStream::nodelay`]
7707 * [`TcpStream::set_ttl`]
7708 * [`TcpStream::ttl`]
7709 * [`TcpStream::set_only_v6`]
7710 * [`TcpStream::only_v6`]
7711 * [`TcpStream::take_error`]
7712 * [`TcpStream::set_nonblocking`]
7713 * [`TcpListener::set_ttl`]
7714 * [`TcpListener::ttl`]
7715 * [`TcpListener::set_only_v6`]
7716 * [`TcpListener::only_v6`]
7717 * [`TcpListener::take_error`]
7718 * [`TcpListener::set_nonblocking`]
7719 * [`UdpSocket::set_broadcast`]
7720 * [`UdpSocket::broadcast`]
7721 * [`UdpSocket::set_multicast_loop_v4`]
7722 * [`UdpSocket::multicast_loop_v4`]
7723 * [`UdpSocket::set_multicast_ttl_v4`]
7724 * [`UdpSocket::multicast_ttl_v4`]
7725 * [`UdpSocket::set_multicast_loop_v6`]
7726 * [`UdpSocket::multicast_loop_v6`]
7727 * [`UdpSocket::set_multicast_ttl_v6`]
7728 * [`UdpSocket::multicast_ttl_v6`]
7729 * [`UdpSocket::set_ttl`]
7730 * [`UdpSocket::ttl`]
7731 * [`UdpSocket::set_only_v6`]
7732 * [`UdpSocket::only_v6`]
7733 * [`UdpSocket::join_multicast_v4`]
7734 * [`UdpSocket::join_multicast_v6`]
7735 * [`UdpSocket::leave_multicast_v4`]
7736 * [`UdpSocket::leave_multicast_v6`]
7737 * [`UdpSocket::take_error`]
7738 * [`UdpSocket::connect`]
7739 * [`UdpSocket::send`]
7740 * [`UdpSocket::recv`]
7741 * [`UdpSocket::set_nonblocking`]
7742
7743 Libraries
7744 ---------
7745
7746 * [`std::sync::Once` is poisoned if its initialization function
7747   fails][1.9o].
7748 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
7749 * [Most types implement `fmt::Debug`][1.9db].
7750 * [The default buffer size used by `BufReader` and `BufWriter` was
7751   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
7752   used by other languages.
7753 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
7754   `Duration` additionally implements `*=` and `/=`][1.9ta].
7755 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
7756 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
7757 * [`Chain` implements `BufRead`][1.9ch].
7758 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
7759
7760 Cargo
7761 -----
7762
7763 * [Cargo can now run concurrently][1.9cc].
7764 * [Top-level overrides allow specific revisions of crates to be
7765   overridden through the entire crate graph][1.9ct].  This is intended
7766   to make upgrades easier for large projects, by allowing crates to be
7767   forked temporarily until they've been upgraded and republished.
7768 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
7769 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
7770   on the commandline][1.9cf]. `rustc` arguments can also be specified
7771   in the `build.rustflags` configuration key.
7772
7773 Performance
7774 -----------
7775
7776 * [The time complexity of comparing variables for equivalence during type
7777   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
7778   to major compilation time improvement in some scenarios.
7779 * [`ToString` is specialized for `str`, giving it the same performance
7780   as `to_owned`][1.9ts].
7781 * [Spawning processes with `Command::output` no longer creates extra
7782   threads][1.9sp].
7783 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
7784   for C-like enums][1.9cl].
7785
7786 Misc
7787 ----
7788
7789 * [Passing the `--quiet` flag to a test runner will produce
7790   much-abbreviated output][1.9q].
7791 * The Rust Project now publishes std binaries for the
7792   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
7793   `i586-pc-windows-msvc` targets.
7794
7795 Compatibility Notes
7796 -------------------
7797
7798 * [`std::sync::Once` is poisoned if its initialization function
7799   fails][1.9o].
7800 * [It is illegal to define methods with the same name in overlapping
7801   inherent `impl` blocks][1.9sn].
7802 * [`fn` item types are zero sized, and each `fn` names a unique
7803   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7804   `transmute` on a `fn` type will generate a warning for a few cycles,
7805   then will be converted to an error.
7806 * [Improvements to const evaluation may trigger new errors when integer
7807   literals are out of range][1.9ce].
7808
7809
7810 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
7811 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
7812 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
7813 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
7814 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
7815 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
7816 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
7817 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
7818 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
7819 [1.9db]: https://github.com/rust-lang/rust/pull/32054
7820 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
7821 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
7822 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
7823 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
7824 [1.9o]: https://github.com/rust-lang/rust/pull/32325
7825 [1.9q]: https://github.com/rust-lang/rust/pull/31887
7826 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
7827 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
7828 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
7829 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
7830 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
7831 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
7832 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
7833 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
7834 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7835 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
7836 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7837 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
7838 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
7839 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
7840 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
7841 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
7842 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
7843 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
7844 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
7845 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
7846 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
7847 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
7848 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
7849 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
7850 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
7851 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
7852 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
7853 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
7854 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
7855 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
7856 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
7857 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
7858 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
7859 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
7860 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
7861 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
7862 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
7863 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
7864 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
7865 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
7866 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
7867 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
7868 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
7869 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
7870 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7871 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7872 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7873 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7874 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7875 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7876 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
7877 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7878 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
7879 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7880 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7881 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7882 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7883 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7884 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
7885 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
7886 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
7887 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
7888 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
7889 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
7890 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
7891 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
7892 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
7893 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
7894 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
7895 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
7896 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
7897 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
7898 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
7899 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
7900 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
7901 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
7902 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
7903 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
7904 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
7905 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
7906 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
7907 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
7908 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
7909 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
7910 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
7911 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
7912 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
7913 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
7914 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
7915 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
7916 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
7917 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
7918 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
7919 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
7920
7921
7922 Version 1.8.0 (2016-04-14)
7923 ==========================
7924
7925 Language
7926 --------
7927
7928 * Rust supports overloading of compound assignment statements like
7929   `+=` by implementing the [`AddAssign`], [`SubAssign`],
7930   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
7931   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
7932   traits. [RFC 953].
7933 * Empty structs can be defined with braces, as in `struct Foo { }`, in
7934   addition to the non-braced form, `struct Foo;`. [RFC 218].
7935
7936 Libraries
7937 ---------
7938
7939 * Stabilized APIs:
7940   * [`str::encode_utf16`] (renamed from `utf16_units`)
7941   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
7942   * [`Ref::map`]
7943   * [`RefMut::map`]
7944   * [`ptr::drop_in_place`]
7945   * [`time::Instant`]
7946   * [`time::SystemTime`]
7947   * [`Instant::now`]
7948   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
7949   * [`Instant::elapsed`]
7950   * [`SystemTime::now`]
7951   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
7952   * [`SystemTime::elapsed`]
7953   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
7954   * [`SystemTimeError`]
7955   * [`SystemTimeError::duration`]
7956   * Various impls for `SystemTimeError`
7957   * [`UNIX_EPOCH`]
7958   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
7959     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
7960     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
7961 * [The `write!` and `writeln!` macros correctly emit errors if any of
7962   their arguments can't be formatted][1.8w].
7963 * [Various I/O functions support large files on 32-bit Linux][1.8l].
7964 * [The Unix-specific `raw` modules, which contain a number of
7965   redefined C types are deprecated][1.8r], including `os::raw::unix`,
7966   `os::raw::macos`, and `os::raw::linux`. These modules defined types
7967   such as `ino_t` and `dev_t`. The inconsistency of these definitions
7968   across platforms was making it difficult to implement `std`
7969   correctly. Those that need these definitions should use the `libc`
7970   crate. [RFC 1415].
7971 * The Unix-specific `MetadataExt` traits, including
7972   `os::unix::fs::MetadataExt`, which expose values such as inode
7973   numbers [no longer return platform-specific types][1.8r], but
7974   instead return widened integers. [RFC 1415].
7975 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
7976 * [Atomic loads and stores are not volatile][1.8a].
7977 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
7978
7979 Performance
7980 -----------
7981
7982 * [Inlining hash functions lead to a 3% compile-time improvement in
7983   some workloads][1.8h].
7984 * When using jemalloc, its symbols are [unprefixed so that it
7985   overrides the libc malloc implementation][1.8h]. This means that for
7986   rustc, LLVM is now using jemalloc, which results in a 6%
7987   compile-time improvement on a specific workload.
7988 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
7989
7990 Misc
7991 ----
7992
7993 * [32-bit MSVC builds finally implement unwinding][1.8ms].
7994   i686-pc-windows-msvc is now considered a tier-1 platform.
7995 * [The `--print targets` flag prints a list of supported targets][1.8t].
7996 * [The `--print cfg` flag prints the `cfg`s defined for the current
7997   target][1.8cf].
7998 * [`rustc` can be built with an new Cargo-based build system, written
7999   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
8000   build system. To enable it configure with `configure --rustbuild`.
8001 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
8002   variants while also indicating the total number of missing variants
8003   if more than 3][1.8m].
8004 * [Executable stacks are disabled on Linux and BSD][1.8nx].
8005 * The Rust Project now publishes binary releases of the standard
8006   library for a number of tier-2 targets:
8007   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
8008   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
8009   `x86_64-rumprun-netbsd`. These can be installed with
8010   tools such as [multirust][1.8mr].
8011
8012 Cargo
8013 -----
8014
8015 * [`cargo init` creates a new Cargo project in the current
8016   directory][1.8ci].  It is otherwise like `cargo new`.
8017 * [Cargo has configuration keys for `-v` and
8018   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
8019   `[term]` section of `.cargo/config`.
8020 * [Configuration keys that evaluate to strings or integers can be set
8021   via environment variables][1.8ce]. For example the `build.jobs` key
8022   can be set via `CARGO_BUILD_JOBS`. Environment variables take
8023   precedence over config files.
8024 * [Target-specific dependencies support Rust `cfg` syntax for
8025   describing targets][1.8cfg] so that dependencies for multiple
8026   targets can be specified together. [RFC 1361].
8027 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
8028   `RUSTDOC` take precedence over the `build.target-dir`,
8029   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
8030 * [The child process tree is killed on Windows when Cargo is
8031   killed][1.8ck].
8032 * [The `build.target` configuration value sets the target platform,
8033   like `--target`][1.8ct].
8034
8035 Compatibility Notes
8036 -------------------
8037
8038 * [Unstable compiler flags have been further restricted][1.8u]. Since
8039   1.0 `-Z` flags have been considered unstable, and other flags that
8040   were considered unstable additionally required passing `-Z
8041   unstable-options` to access. Unlike unstable language and library
8042   features though, these options have been accessible on the stable
8043   release channel. Going forward, *new unstable flags will not be
8044   available on the stable release channel*, and old unstable flags
8045   will warn about their usage. In the future, all unstable flags will
8046   be unavailable on the stable release channel.
8047 * [It is no longer possible to `match` on empty enum variants using
8048   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
8049 * The Unix-specific `MetadataExt` traits, including
8050   `os::unix::fs::MetadataExt`, which expose values such as inode
8051   numbers [no longer return platform-specific types][1.8r], but
8052   instead return widened integers. [RFC 1415].
8053 * [Modules sourced from the filesystem cannot appear within arbitrary
8054   blocks, but only within other modules][1.8mf].
8055 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
8056 * On Unix, [stack overflow triggers a runtime abort instead of a
8057   SIGSEGV][1.8so].
8058 * [`Command::spawn` and its equivalents return an error if any of
8059   its command-line arguments contain interior `NUL`s][1.8n].
8060 * [Tuple and unit enum variants from other crates are in the type
8061   namespace][1.8tn].
8062 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
8063   type instead of `.a` files][1.8st]. Additionally, for the MSVC
8064   toolchain, `rustc` emits import libraries named `foo.dll.lib`
8065   instead of `foo.lib`.
8066
8067
8068 [1.8a]: https://github.com/rust-lang/rust/pull/30962
8069 [1.8b]: https://github.com/rust-lang/rust/pull/31123
8070 [1.8c]: https://github.com/rust-lang/rust/pull/31530
8071 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
8072 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
8073 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
8074 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
8075 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
8076 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
8077 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
8078 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
8079 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
8080 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
8081 [1.8h]: https://github.com/rust-lang/rust/pull/31460
8082 [1.8l]: https://github.com/rust-lang/rust/pull/31668
8083 [1.8m]: https://github.com/rust-lang/rust/pull/31020
8084 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
8085 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
8086 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
8087 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
8088 [1.8n]: https://github.com/rust-lang/rust/pull/31056
8089 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
8090 [1.8r]: https://github.com/rust-lang/rust/pull/31551
8091 [1.8so]: https://github.com/rust-lang/rust/pull/31333
8092 [1.8st]: https://github.com/rust-lang/rust/pull/29520
8093 [1.8t]: https://github.com/rust-lang/rust/pull/31358
8094 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
8095 [1.8u]: https://github.com/rust-lang/rust/pull/31793
8096 [1.8v]: https://github.com/rust-lang/rust/pull/31757
8097 [1.8w]: https://github.com/rust-lang/rust/pull/31904
8098 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
8099 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
8100 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
8101 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
8102 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
8103 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
8104 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
8105 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
8106 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
8107 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
8108 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
8109 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
8110 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
8111 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
8112 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
8113 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
8114 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
8115 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
8116 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
8117 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
8118 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
8119 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
8120 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
8121 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
8122 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
8123 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
8124 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
8125 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
8126 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
8127 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
8128
8129
8130 Version 1.7.0 (2016-03-03)
8131 ==========================
8132
8133 Libraries
8134 ---------
8135
8136 * Stabilized APIs
8137   * `Path`
8138     * [`Path::strip_prefix`] (renamed from relative_from)
8139     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
8140   * `Ipv4Addr`
8141     * [`Ipv4Addr::is_loopback`]
8142     * [`Ipv4Addr::is_private`]
8143     * [`Ipv4Addr::is_link_local`]
8144     * [`Ipv4Addr::is_multicast`]
8145     * [`Ipv4Addr::is_broadcast`]
8146     * [`Ipv4Addr::is_documentation`]
8147   * `Ipv6Addr`
8148     * [`Ipv6Addr::is_unspecified`]
8149     * [`Ipv6Addr::is_loopback`]
8150     * [`Ipv6Addr::is_multicast`]
8151   * `Vec`
8152     * [`Vec::as_slice`]
8153     * [`Vec::as_mut_slice`]
8154   * `String`
8155     * [`String::as_str`]
8156     * [`String::as_mut_str`]
8157   * Slices
8158     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
8159     be the same length
8160     * `<[T]>::`[`sort_by_key`]
8161   * checked, saturated, and overflowing operations
8162     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
8163     * [`i32::saturating_mul`]
8164     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
8165     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
8166     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
8167     * [`u32::saturating_mul`]
8168     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
8169     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
8170     * and checked, saturated, and overflowing operations for other primitive types
8171   * FFI
8172     * [`ffi::IntoStringError`]
8173     * [`CString::into_string`]
8174     * [`CString::into_bytes`]
8175     * [`CString::into_bytes_with_nul`]
8176     * `From<CString> for Vec<u8>`
8177   * `IntoStringError`
8178     * [`IntoStringError::into_cstring`]
8179     * [`IntoStringError::utf8_error`]
8180     * `Error for IntoStringError`
8181   * Hashing
8182     * [`std::hash::BuildHasher`]
8183     * [`BuildHasher::Hasher`]
8184     * [`BuildHasher::build_hasher`]
8185     * [`std::hash::BuildHasherDefault`]
8186     * [`HashMap::with_hasher`]
8187     * [`HashMap::with_capacity_and_hasher`]
8188     * [`HashSet::with_hasher`]
8189     * [`HashSet::with_capacity_and_hasher`]
8190     * [`std::collections::hash_map::RandomState`]
8191     * [`RandomState::new`]
8192 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
8193   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
8194   from bytes is faster.
8195 * [The performance of `LineWriter` (and thus `io::stdout`) was
8196   improved by using `memchr` to search for newlines][1.7m].
8197 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
8198   `f64` variants were stabilized previously.
8199 * [`BTreeMap` was rewritten to use less memory and improve the performance
8200   of insertion and iteration, the latter by as much as 5x][1.7bm].
8201 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
8202   covariant over their contained type][1.7bt].
8203 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
8204   over their contained type][1.7ll].
8205 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
8206   searching methods.
8207 * [`Any` is implemented for unsized types][1.7a].
8208 * [`Hash` is implemented for `Duration`][1.7h].
8209
8210 Misc
8211 ----
8212
8213 * [When running tests with `--test`, rustdoc will pass `--cfg`
8214   arguments to the compiler][1.7dt].
8215 * [The compiler is built with RPATH information by default][1.7rpa].
8216   This means that it will be possible to run `rustc` when installed in
8217   unusual configurations without configuring the dynamic linker search
8218   path explicitly.
8219 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
8220   any RPATH entries (emitted with `-C rpath`) *not* take precedence
8221   over `LD_LIBRARY_PATH`.
8222
8223 Cargo
8224 -----
8225
8226 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
8227   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
8228 * [The `rerun-if-changed` build script directive no longer causes the
8229   build script to incorrectly run twice in certain scenarios][1.7rr].
8230
8231 Compatibility Notes
8232 -------------------
8233
8234 * Soundness fixes to the interactions between associated types and
8235   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
8236   code that violates the new rules. This is a significant change that
8237   is known to break existing code, so it has emitted warnings for the
8238   new error cases since 1.4 to give crate authors time to adapt. The
8239   details of what is changing are subtle; read the RFC for more.
8240 * [Several bugs in the compiler's visibility calculations were
8241   fixed][1.7v]. Since this was found to break significant amounts of
8242   code, the new errors will be emitted as warnings for several release
8243   cycles, under the `private_in_public` lint.
8244 * Defaulted type parameters were accidentally accepted in positions
8245   that were not intended. In this release, [defaulted type parameters
8246   appearing outside of type definitions will generate a
8247   warning][1.7d], which will become an error in future releases.
8248 * [Parsing "." as a float results in an error instead of 0][1.7p].
8249   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
8250 * [Borrows of closure parameters may not outlive the closure][1.7bc].
8251
8252 [1.7a]: https://github.com/rust-lang/rust/pull/30928
8253 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
8254 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
8255 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
8256 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
8257 [1.7d]: https://github.com/rust-lang/rust/pull/30724
8258 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
8259 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
8260 [1.7f]: https://github.com/rust-lang/rust/pull/30672
8261 [1.7h]: https://github.com/rust-lang/rust/pull/30818
8262 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
8263 [1.7m]: https://github.com/rust-lang/rust/pull/30381
8264 [1.7p]: https://github.com/rust-lang/rust/pull/30681
8265 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
8266 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
8267 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
8268 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
8269 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
8270 [1.7v]: https://github.com/rust-lang/rust/pull/29973
8271 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8272 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8273 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
8274 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
8275 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
8276 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
8277 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
8278 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
8279 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
8280 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
8281 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
8282 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
8283 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
8284 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
8285 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
8286 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
8287 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
8288 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
8289 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
8290 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
8291 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
8292 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
8293 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
8294 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
8295 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
8296 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
8297 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
8298 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
8299 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
8300 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
8301 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
8302 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
8303 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
8304 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
8305 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
8306 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
8307 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
8308 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
8309 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
8310 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
8311 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
8312 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
8313 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
8314 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
8315 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
8316 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
8317 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
8318 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8319 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
8320 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8321 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
8322 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
8323 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
8324 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
8325 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
8326 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
8327 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
8328 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
8329 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
8330 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
8331
8332
8333 Version 1.6.0 (2016-01-21)
8334 ==========================
8335
8336 Language
8337 --------
8338
8339 * The `#![no_std]` attribute causes a crate to not be linked to the
8340   standard library, but only the [core library][1.6co], as described
8341   in [RFC 1184]. The core library defines common types and traits but
8342   has no platform dependencies whatsoever, and is the basis for Rust
8343   software in environments that cannot support a full port of the
8344   standard library, such as operating systems. Most of the core
8345   library is now stable.
8346
8347 Libraries
8348 ---------
8349
8350 * Stabilized APIs:
8351   [`Read::read_exact`],
8352   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
8353   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
8354   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
8355   [`os::unix::fs::DirBuilderExt`],
8356   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
8357   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
8358   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
8359   [`collections::hash_map::Drain`],
8360   [`collections::hash_map::HashMap::drain`],
8361   [`collections::hash_set::Drain`],
8362   [`collections::hash_set::HashSet::drain`],
8363   [`collections::binary_heap::Drain`],
8364   [`collections::binary_heap::BinaryHeap::drain`],
8365   [`Vec::extend_from_slice`] (renamed from `push_all`),
8366   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
8367   [`RwLock::into_inner`],
8368   [`Iterator::min_by_key`] (renamed from `min_by`),
8369   [`Iterator::max_by_key`] (renamed from `max_by`).
8370 * The [core library][1.6co] is stable, as are most of its APIs.
8371 * [The `assert_eq!` macro supports arguments that don't implement
8372   `Sized`][1.6ae], such as arrays. In this way it behaves more like
8373   `assert!`.
8374 * Several timer functions that take duration in milliseconds [are
8375   deprecated in favor of those that take `Duration`][1.6ms]. These
8376   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
8377   `thread::park_timeout_ms`.
8378 * The algorithm by which `Vec` reserves additional elements was
8379   [tweaked to not allocate excessive space][1.6a] while still growing
8380   exponentially.
8381 * `From` conversions are [implemented from integers to floats][1.6f]
8382   in cases where the conversion is lossless. Thus they are not
8383   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
8384   or `f64`. They are also not implemented for `isize` and `usize`
8385   because the implementations would be platform-specific. `From` is
8386   also implemented from `f32` to `f64`.
8387 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
8388 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
8389 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
8390 * [`BinaryHeap` was refactored][1.6bh] for modest performance
8391   improvements.
8392 * Sorting slices that are already sorted [is 50% faster in some
8393   cases][1.6s].
8394
8395 Cargo
8396 -----
8397
8398 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
8399 * Cargo build scripts can specify their dependencies by emitting the
8400   [`rerun-if-changed`][1.6rr] key.
8401 * crates.io will reject publication of crates with dependencies that
8402   have a wildcard version constraint. Crates with wildcard
8403   dependencies were seen to cause a variety of problems, as described
8404   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
8405   warning.
8406 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
8407   release folder.  A variety of artifacts that Cargo failed to clean
8408   are now correctly deleted.
8409
8410 Misc
8411 ----
8412
8413 * The `unreachable_code` lint [warns when a function call's argument
8414   diverges][1.6dv].
8415 * The parser indicates [failures that may be caused by
8416   confusingly-similar Unicode characters][1.6uc]
8417 * Certain macro errors [are reported at definition time][1.6m], not
8418   expansion.
8419
8420 Compatibility Notes
8421 -------------------
8422
8423 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
8424   environment variable when locating crates. This was a pre-cargo
8425   feature for integrating with the package manager that was
8426   accidentally never removed.
8427 * [A number of bugs were fixed in the privacy checker][1.6p] that
8428   could cause previously-accepted code to break.
8429 * [Modules and unit/tuple structs may not share the same name][1.6ts].
8430 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
8431   struct pattern syntax (`Foo(..)`) can no longer be used to match
8432   unit structs. This is a warning now, but will become an error in
8433   future releases. Patterns that share the same name as a const are
8434   now an error.
8435 * A bug was fixed that causes [rustc not to apply default type
8436   parameters][1.6xc] when resolving certain method implementations of
8437   traits defined in other crates.
8438
8439 [1.6a]: https://github.com/rust-lang/rust/pull/29454
8440 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
8441 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
8442 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
8443 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
8444 [1.6co]: http://doc.rust-lang.org/core/index.html
8445 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
8446 [1.6f]: https://github.com/rust-lang/rust/pull/29129
8447 [1.6m]: https://github.com/rust-lang/rust/pull/29828
8448 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
8449 [1.6p]: https://github.com/rust-lang/rust/pull/29726
8450 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
8451 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
8452 [1.6s]: https://github.com/rust-lang/rust/pull/29675
8453 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
8454 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
8455 [1.6us]: https://github.com/rust-lang/rust/pull/29383
8456 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
8457 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
8458 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8459 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
8460 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
8461 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
8462 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
8463 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
8464 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
8465 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
8466 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
8467 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
8468 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
8469 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
8470 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
8471 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
8472 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
8473 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
8474 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
8475 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
8476 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
8477 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
8478 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
8479 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
8480 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
8481 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
8482 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
8483 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
8484 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
8485 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
8486
8487
8488 Version 1.5.0 (2015-12-10)
8489 ==========================
8490
8491 * ~700 changes, numerous bugfixes
8492
8493 Highlights
8494 ----------
8495
8496 * Stabilized APIs:
8497   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
8498   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
8499   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
8500   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
8501   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
8502   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
8503   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
8504   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
8505   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
8506   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
8507   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
8508   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
8509   [`Path::read_link`], [`Path::symlink_metadata`],
8510   [`Utf8Error::valid_up_to`], [`Vec::resize`],
8511   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
8512   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
8513   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
8514   [`slice::split_first_mut`], [`slice::split_first`],
8515   [`slice::split_last_mut`], [`slice::split_last`],
8516   [`char::from_u32_unchecked`], [`fs::canonicalize`],
8517   [`str::MatchIndices`], [`str::RMatchIndices`],
8518   [`str::match_indices`], [`str::rmatch_indices`],
8519   [`str::slice_mut_unchecked`], [`string::ParseError`].
8520 * Rust applications hosted on crates.io can be installed locally to
8521   `~/.cargo/bin` with the [`cargo install`] command. Among other
8522   things this makes it easier to augment Cargo with new subcommands:
8523   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
8524   invoked as `cargo foo`.
8525 * Crates with wildcard (`*`) dependencies will [emit warnings when
8526   published][1.5w]. In 1.6 it will no longer be possible to publish
8527   crates with wildcard dependencies.
8528
8529 Breaking Changes
8530 ----------------
8531
8532 * The rules determining when a particular lifetime must outlive
8533   a particular value (known as '[dropck]') have been [modified
8534   to not rely on parametricity][1.5p].
8535 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
8536   and `Arc`][1.5a]. Because these smart pointer types implement
8537   `Deref`, this causes breakage in cases where the interior type
8538   contains methods of the same name.
8539 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
8540   that they could drop their content. Soundness fix.
8541 * All method invocations are [properly checked][1.5wf1] for
8542   [well-formedness][1.5wf2]. Soundness fix.
8543 * Traits whose supertraits contain `Self` are [not object
8544   safe][1.5o]. Soundness fix.
8545 * Target specifications support a [`no_default_libraries`][1.5nd]
8546   setting that controls whether `-nodefaultlibs` is passed to the
8547   linker, and in turn the `is_like_windows` setting no longer affects
8548   the `-nodefaultlibs` flag.
8549 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
8550 * The `#[inline]` and `#[repr]` attributes [can only appear
8551   in valid locations][1.5at].
8552 * Native libraries linked from the local crate are [passed to
8553   the linker before native libraries from upstream crates][1.5nl].
8554 * Two rarely-used attributes, `#[no_debug]` and
8555   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
8556 * Negation of unsigned integers, which has been a warning for
8557   several releases, [is now behind a feature gate and will
8558   generate errors][1.5nu].
8559 * The parser accidentally accepted visibility modifiers on
8560   enum variants, a bug [which has been fixed][1.5ev].
8561 * [A bug was fixed that allowed `use` statements to import unstable
8562   features][1.5use].
8563
8564 Language
8565 --------
8566
8567 * When evaluating expressions at compile-time that are not
8568   compile-time constants (const-evaluating expressions in non-const
8569   contexts), incorrect code such as overlong bitshifts and arithmetic
8570   overflow will [generate a warning instead of an error][1.5ce],
8571   delaying the error until runtime. This will allow the
8572   const-evaluator to be expanded in the future backwards-compatibly.
8573 * The `improper_ctypes` lint [no longer warns about using `isize` and
8574   `usize` in FFI][1.5ict].
8575
8576 Libraries
8577 ---------
8578
8579 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
8580   invariant][1.5c].
8581 * `Default` is [implemented for mutable slices][1.5d].
8582 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
8583 * There are now `From` conversions [between floating point
8584   types][1.5f] where the conversions are lossless.
8585 * There are now `From` conversions [between integer types][1.5i] where
8586   the conversions are lossless.
8587 * [`fs::Metadata` implements `Clone`][1.5fs].
8588 * The `parse` method [accepts a leading "+" when parsing
8589   integers][1.5pi].
8590 * [`AsMut` is implemented for `Vec`][1.5am].
8591 * The `clone_from` implementations for `String` and `BinaryHeap` [have
8592   been optimized][1.5cf] and no longer rely on the default impl.
8593 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
8594   `unsafe extern "C"` function types now [implement `Clone`,
8595   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
8596   `fmt::Debug` for up to 12 arguments][1.5fp].
8597 * [Dropping `Vec`s is much faster in unoptimized builds when the
8598   element types don't implement `Drop`][1.5dv].
8599 * A bug that caused in incorrect behavior when [combining `VecDeque`
8600   with zero-sized types][1.5vdz] was resolved.
8601 * [`PartialOrd` for slices is faster][1.5po].
8602
8603 Miscellaneous
8604 -------------
8605
8606 * [Crate metadata size was reduced by 20%][1.5md].
8607 * [Improvements to code generation reduced the size of libcore by 3.3
8608   MB and rustc's memory usage by 18MB][1.5m].
8609 * [Improvements to deref translation increased performance in
8610   unoptimized builds][1.5dr].
8611 * Various errors in trait resolution [are deduplicated to only be
8612   reported once][1.5te].
8613 * Rust has preliminary [support for rumprun kernels][1.5rr].
8614 * Rust has preliminary [support for NetBSD on amd64][1.5na].
8615
8616 [1.5use]: https://github.com/rust-lang/rust/pull/28364
8617 [1.5po]: https://github.com/rust-lang/rust/pull/28436
8618 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
8619 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
8620 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
8621 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
8622 [1.5md]: https://github.com/rust-lang/rust/pull/28521
8623 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
8624 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
8625 [1.5na]: https://github.com/rust-lang/rust/pull/28543
8626 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
8627 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
8628 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
8629 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
8630 [1.5te]: https://github.com/rust-lang/rust/pull/28645
8631 [1.5at]: https://github.com/rust-lang/rust/pull/28650
8632 [1.5am]: https://github.com/rust-lang/rust/pull/28663
8633 [1.5m]: https://github.com/rust-lang/rust/pull/28778
8634 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
8635 [1.5a]: https://github.com/rust-lang/rust/pull/28811
8636 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
8637 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
8638 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
8639 [1.5i]: https://github.com/rust-lang/rust/pull/28921
8640 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
8641 [1.5f]: https://github.com/rust-lang/rust/pull/29129
8642 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
8643 [1.5s]: https://github.com/rust-lang/rust/pull/29190
8644 [1.5d]: https://github.com/rust-lang/rust/pull/29245
8645 [1.5o]: https://github.com/rust-lang/rust/pull/29259
8646 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
8647 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8648 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
8649 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
8650 [1.5c]: https://github.com/rust-lang/rust/pull/29110
8651 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8652 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
8653 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
8654 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
8655 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
8656 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
8657 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
8658 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
8659 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
8660 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
8661 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
8662 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
8663 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
8664 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
8665 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
8666 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
8667 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
8668 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
8669 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
8670 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
8671 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
8672 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
8673 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
8674 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
8675 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
8676 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
8677 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
8678 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
8679 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
8680 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
8681 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
8682 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
8683 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
8684 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
8685 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
8686 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
8687 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
8688 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
8689 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
8690 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
8691 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
8692 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
8693 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
8694 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
8695 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
8696 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
8697 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
8698 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
8699 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
8700 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
8701 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
8702 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
8703 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
8704 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
8705
8706 Version 1.4.0 (2015-10-29)
8707 ==========================
8708
8709 * ~1200 changes, numerous bugfixes
8710
8711 Highlights
8712 ----------
8713
8714 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
8715   GNU) are now supported and recommended for use.
8716
8717 Breaking Changes
8718 ----------------
8719
8720 * [Several changes have been made to fix type soundness and improve
8721   the behavior of associated types][sound]. See [RFC 1214]. Although
8722   we have mostly introduced these changes as warnings this release, to
8723   become errors next release, there are still some scenarios that will
8724   see immediate breakage.
8725 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
8726   line breaks in addition to `\n`][crlf].
8727 * [Loans of `'static` lifetime extend to the end of a function][stat].
8728 * [`str::parse` no longer introduces avoidable rounding error when
8729   parsing floating point numbers. Together with earlier changes to
8730   float formatting/output, "round trips" like f.to_string().parse()
8731   now preserve the value of f exactly. Additionally, leading plus
8732   signs are now accepted][fp3].
8733
8734
8735 Language
8736 --------
8737
8738 * `use` statements that import multiple items [can now rename
8739   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
8740 * [Binops work correctly on fat pointers][binfat].
8741 * `pub extern crate`, which does not behave as expected, [issues a
8742   warning][pec] until a better solution is found.
8743
8744 Libraries
8745 ---------
8746
8747 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
8748   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
8749   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
8750   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
8751   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
8752   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
8753   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
8754   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
8755   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
8756   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
8757   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
8758   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
8759   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
8760   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
8761   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
8762   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
8763   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
8764   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
8765   [`thread::sleep`].
8766 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
8767   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
8768   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
8769   `f64::from_str_radix`.
8770 * [Reverse-searching strings is faster with the 'two-way'
8771   algorithm][s].
8772 * [`std::io::copy` allows `?Sized` arguments][cc].
8773 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
8774   [override `count`, `nth` and `last` with an *O*(1)
8775   implementation][it].
8776 * [`Default` is implemented for arrays up to `[T; 32]`][d].
8777 * [`IntoRawFd` has been added to the Unix-specific prelude,
8778   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
8779   prelude][pr].
8780 * [`Extend<String>` and `FromIterator<String` are both implemented for
8781   `String`][es].
8782 * [`IntoIterator` is implemented for references to `Option` and
8783   `Result`][into2].
8784 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
8785   Copy`][ext] as part of [RFC 839]. This will cause type inference
8786   breakage in rare situations.
8787 * [`BinaryHeap` implements `Debug`][bh2].
8788 * [`Borrow` and `BorrowMut` are implemented for fixed-size
8789   arrays][bm].
8790 * [`extern fn`s with the "Rust" and "C" ABIs implement common
8791   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
8792 * [String comparison is faster][faststr].
8793 * `&mut T` where `T: std::fmt::Write` [also implements
8794   `std::fmt::Write`][mutw].
8795 * [A stable regression in `VecDeque::push_back` and other
8796   capacity-altering methods that caused panics for zero-sized types
8797   was fixed][vd].
8798 * [Function pointers implement traits for up to 12 parameters][fp2].
8799
8800 Miscellaneous
8801 -------------
8802
8803 * The compiler [no longer uses the 'morestack' feature to prevent
8804   stack overflow][mm]. Instead it uses guard pages and stack
8805   probes (though stack probes are not yet implemented on any platform
8806   but Windows).
8807 * [The compiler matches traits faster when projections are involved][p].
8808 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
8809   `usize`][ffi].
8810 * [Cargo now displays useful information about what its doing during
8811   `cargo update`][cu].
8812
8813 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
8814 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
8815 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
8816 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
8817 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
8818 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
8819 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
8820 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
8821 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
8822 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
8823 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
8824 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
8825 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
8826 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
8827 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
8828 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
8829 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
8830 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
8831 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8832 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8833 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8834 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8835 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8836 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8837 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8838 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8839 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
8840 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
8841 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
8842 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
8843 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
8844 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
8845 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
8846 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
8847 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
8848 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
8849 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
8850 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
8851 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
8852 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
8853 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
8854 [bh2]: https://github.com/rust-lang/rust/pull/28156
8855 [binfat]: https://github.com/rust-lang/rust/pull/28270
8856 [bm]: https://github.com/rust-lang/rust/pull/28197
8857 [cc]: https://github.com/rust-lang/rust/pull/27531
8858 [crlf]: https://github.com/rust-lang/rust/pull/28034
8859 [cu]: https://github.com/rust-lang/cargo/pull/1931
8860 [d]: https://github.com/rust-lang/rust/pull/27825
8861 [dep]: https://github.com/rust-lang/rust/pull/28339
8862 [es]: https://github.com/rust-lang/rust/pull/27956
8863 [ext]: https://github.com/rust-lang/rust/pull/28094
8864 [faststr]: https://github.com/rust-lang/rust/pull/28338
8865 [ffi]: https://github.com/rust-lang/rust/pull/28779
8866 [fp]: https://github.com/rust-lang/rust/pull/28268
8867 [fp2]: https://github.com/rust-lang/rust/pull/28560
8868 [fp3]: https://github.com/rust-lang/rust/pull/27307
8869 [i]: https://github.com/rust-lang/rust/pull/27451
8870 [into2]: https://github.com/rust-lang/rust/pull/28039
8871 [it]: https://github.com/rust-lang/rust/pull/27652
8872 [mm]: https://github.com/rust-lang/rust/pull/27338
8873 [mutw]: https://github.com/rust-lang/rust/pull/28368
8874 [sound]: https://github.com/rust-lang/rust/pull/27641
8875 [p]: https://github.com/rust-lang/rust/pull/27866
8876 [pec]: https://github.com/rust-lang/rust/pull/28486
8877 [pr]: https://github.com/rust-lang/rust/pull/27896
8878 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8879 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8880 [s]: https://github.com/rust-lang/rust/pull/27474
8881 [stab]: https://github.com/rust-lang/rust/pull/28339
8882 [stat]: https://github.com/rust-lang/rust/pull/28321
8883 [vd]: https://github.com/rust-lang/rust/pull/28494
8884
8885 Version 1.3.0 (2015-09-17)
8886 ==============================
8887
8888 * ~900 changes, numerous bugfixes
8889
8890 Highlights
8891 ----------
8892
8893 * The [new object lifetime defaults][nold] have been [turned
8894   on][nold2] after a cycle of warnings about the change. Now types
8895   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
8896   being interpreted as `&'a Box<Trait+'a>` to `&'a
8897   Box<Trait+'static>`.
8898 * [The Rustonomicon][nom] is a new book in the official documentation
8899   that dives into writing unsafe Rust.
8900 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
8901   timekeeping is employed by other std APIs, as well as out-of-tree
8902   time crates.
8903
8904 Breaking Changes
8905 ----------------
8906
8907 * The [new object lifetime defaults][nold] have been [turned
8908   on][nold2] after a cycle of warnings about the change.
8909 * There is a known [regression][lr] in how object lifetime elision is
8910   interpreted, the proper solution for which is undetermined.
8911 * The `#[prelude_import]` attribute, an internal implementation
8912   detail, was accidentally stabilized previously. [It has been put
8913   behind the `prelude_import` feature gate][pi]. This change is
8914   believed to break no existing code.
8915 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8916   [more sane for dynamically sized types][dst3]. Code that relied on
8917   the previous behavior is thought to be broken.
8918 * The `dropck` rules, which checks that destructors can't access
8919   destroyed values, [have been updated][dropck] to match the
8920   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
8921   cause some previously-compiling code to no longer build.
8922
8923 Language
8924 --------
8925
8926 * The [new object lifetime defaults][nold] have been [turned
8927   on][nold2] after a cycle of warnings about the change.
8928 * Semicolons may [now follow types and paths in
8929   macros](https://github.com/rust-lang/rust/pull/27000).
8930 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8931   [more sane for dynamically sized types][dst3]. Code that relied on
8932   the previous behavior is not known to exist, and suspected to be
8933   broken.
8934 * `'static` variables [may now be recursive][st].
8935 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
8936   implementations correctly.
8937 * The `dropck` rules, which checks that destructors can't access
8938   destroyed values, [have been updated][dropck] to match the
8939   [RFC][dropckrfc].
8940
8941 Libraries
8942 ---------
8943
8944 * The [`Duration`] API, [has been stabilized][ds], as well as the
8945   `std::time` module, which presently contains only `Duration`.
8946 * `Box<str>` and `Box<[T]>` both implement `Clone`.
8947 * The owned C string, [`CString`], implements [`Borrow`] and the
8948   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
8949   these allow C strings to be borrowed and cloned in generic code.
8950 * [`CStr`] implements [`Debug`].
8951 * [`AtomicPtr`] implements [`Debug`].
8952 * [`Error`] trait objects [can be downcast to their concrete types][e]
8953   in many common configurations, using the [`is`], [`downcast`],
8954   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
8955   [`Any`] trait.
8956 * Searching for substrings now [employs the two-way algorithm][search]
8957   instead of doing a naive search. This gives major speedups to a
8958   number of methods, including [`contains`][sc], [`find`][sf],
8959   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
8960   [`ends_with`][sew] are also faster.
8961 * The performance of `PartialEq` for slices is [much faster][ps].
8962 * The [`Hash`] trait offers the default method, [`hash_slice`], which
8963   is overridden and optimized by the implementations for scalars.
8964 * The [`Hasher`] trait now has a number of specialized `write_*`
8965   methods for primitive types, for efficiency.
8966 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
8967   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
8968   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
8969   of [`std::error::Error::cause`][iec] also delegates to the inner
8970   error.
8971 * [`process::Child`][pc] gained the [`id`] method, which returns a
8972   `u32` representing the platform-specific process identifier.
8973 * The [`connect`] method on slices is deprecated, replaced by the new
8974   [`join`] method (note that both of these are on the *unstable*
8975   [`SliceConcatExt`] trait, but through the magic of the prelude are
8976   available to stable code anyway).
8977 * The [`Div`] operator is implemented for [`Wrapping`] types.
8978 * [`DerefMut` is implemented for `String`][dms].
8979 * Performance of SipHash (the default hasher for `HashMap`) is
8980   [better for long data][sh].
8981 * [`AtomicPtr`] implements [`Send`].
8982 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
8983   are now [specialized to use uninitialized buffers for increased
8984   performance][rte].
8985 * Lifetime parameters of foreign functions [are now resolved
8986   properly][f].
8987
8988 Misc
8989 ----
8990
8991 * Rust can now, with some coercion, [produce programs that run on
8992   Windows XP][xp], though XP is not considered a supported platform.
8993 * Porting Rust on Windows from the GNU toolchain to MSVC continues
8994   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
8995   recommended for use in 1.3, though should be fully-functional
8996   in the [64-bit 1.4 beta][b14].
8997 * On Fedora-based systems installation will [properly configure the
8998   dynamic linker][fl].
8999 * The compiler gained many new extended error descriptions, which can
9000   be accessed with the `--explain` flag.
9001 * The `dropck` pass, which checks that destructors can't access
9002   destroyed values, [has been rewritten][dropck]. This fixes some
9003   soundness holes, and as such will cause some previously-compiling
9004   code to no longer build.
9005 * `rustc` now uses [LLVM to write archive files where possible][ar].
9006   Eventually this will eliminate the compiler's dependency on the ar
9007   utility.
9008 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
9009   supported FreeBSD on x86_64).
9010 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
9011   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
9012   more strict.
9013 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
9014   will kill the process instead of leaking][nlp].
9015
9016 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
9017 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
9018 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
9019 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
9020 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
9021 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
9022 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
9023 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
9024 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
9025 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
9026 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
9027 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
9028 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
9029 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
9030 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
9031 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
9032 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
9033 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
9034 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
9035 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
9036 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
9037 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
9038 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
9039 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
9040 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
9041 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
9042 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
9043 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
9044 [ar]: https://github.com/rust-lang/rust/pull/26926
9045 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
9046 [dms]: https://github.com/rust-lang/rust/pull/26241
9047 [dropck]: https://github.com/rust-lang/rust/pull/27261
9048 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
9049 [ds]: https://github.com/rust-lang/rust/pull/26818
9050 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
9051 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
9052 [dst3]: https://github.com/rust-lang/rust/pull/27351
9053 [e]: https://github.com/rust-lang/rust/pull/24793
9054 [f]: https://github.com/rust-lang/rust/pull/26588
9055 [fb]: https://github.com/rust-lang/rust/pull/26959
9056 [fl]: https://github.com/rust-lang/rust-installer/pull/41
9057 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
9058 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
9059 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
9060 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
9061 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
9062 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
9063 [lic]: https://github.com/rust-lang/rust/pull/26583
9064 [lnu]: https://github.com/rust-lang/rust/pull/27026
9065 [lr]: https://github.com/rust-lang/rust/issues/27248
9066 [lum]: https://github.com/rust-lang/rust/pull/26378
9067 [lur]: https://github.com/rust-lang/rust/pull/26783
9068 [nlp]: https://github.com/rust-lang/rust/pull/27176
9069 [nold2]: https://github.com/rust-lang/rust/pull/27045
9070 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
9071 [nom]: http://doc.rust-lang.org/nightly/nomicon/
9072 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
9073 [pi]: https://github.com/rust-lang/rust/pull/26699
9074 [ps]: https://github.com/rust-lang/rust/pull/26884
9075 [rte]: https://github.com/rust-lang/rust/pull/26950
9076 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
9077 [search]: https://github.com/rust-lang/rust/pull/26327
9078 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
9079 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
9080 [sh]: https://github.com/rust-lang/rust/pull/27280
9081 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
9082 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
9083 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
9084 [st]: https://github.com/rust-lang/rust/pull/26630
9085 [win1]: https://github.com/rust-lang/rust/pull/26569
9086 [win2]: https://github.com/rust-lang/rust/pull/26741
9087 [win3]: https://github.com/rust-lang/rust/pull/26741
9088 [win4]: https://github.com/rust-lang/rust/pull/27210
9089 [xp]: https://github.com/rust-lang/rust/pull/26569
9090
9091 Version 1.2.0 (2015-08-07)
9092 ==========================
9093
9094 * ~1200 changes, numerous bugfixes
9095
9096 Highlights
9097 ----------
9098
9099 * [Dynamically-sized-type coercions][dst] allow smart pointer types
9100   like `Rc` to contain types without a fixed size, arrays and trait
9101   objects, finally enabling use of `Rc<[T]>` and completing the
9102   implementation of DST.
9103 * [Parallel codegen][parcodegen] is now working again, which can
9104   substantially speed up large builds in debug mode; It also gets
9105   another ~33% speedup when bootstrapping on a 4 core machine (using 8
9106   jobs). It's not enabled by default, but will be "in the near
9107   future". It can be activated with the `-C codegen-units=N` flag to
9108   `rustc`.
9109 * This is the first release with [experimental support for linking
9110   with the MSVC linker and lib C on Windows (instead of using the GNU
9111   variants via MinGW)][win]. It is yet recommended only for the most
9112   intrepid Rustaceans.
9113 * Benchmark compilations are showing a 30% improvement in
9114   bootstrapping over 1.1.
9115
9116 Breaking Changes
9117 ----------------
9118
9119 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
9120   unicode case mapping, which is a previously-planned change in
9121   behavior and considered a bugfix.
9122 * [`mem::align_of`] now specifies [the *minimum alignment* for
9123   T][align], which is usually the alignment programs are interested
9124   in, and the same value reported by clang's
9125   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
9126   break real code.
9127 * [The `#[packed]` attribute is no longer silently accepted by the
9128   compiler][packed]. This attribute did nothing and code that
9129   mentioned it likely did not work as intended.
9130 * Associated type defaults are [now behind the
9131   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
9132   defaults *did not work*, but could be mentioned syntactically. As
9133   such this breakage has minimal impact.
9134
9135 Language
9136 --------
9137
9138 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
9139   matching against dereferenceable values.
9140
9141 Libraries
9142 ---------
9143
9144 * The [`Extend`] trait, which grows a collection from an iterator, is
9145   implemented over iterators of references, for `String`, `Vec`,
9146   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
9147   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
9148 * The [`iter::once`] function returns an iterator that yields a single
9149   element, and [`iter::empty`] returns an iterator that yields no
9150   elements.
9151 * The [`matches`] and [`rmatches`] methods on `str` return iterators
9152   over substring matches.
9153 * [`Cell`] and [`RefCell`] both implement `Eq`.
9154 * A number of methods for wrapping arithmetic are added to the
9155   integral types, [`wrapping_div`], [`wrapping_rem`],
9156   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
9157   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
9158   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
9159   type.. It is illegal for the default arithmetic operations in Rust
9160   to overflow; the desire to wrap must be explicit.
9161 * The `{:#?}` formatting specifier [displays the alternate,
9162   pretty-printed][debugfmt] form of the `Debug` formatter. This
9163   feature was actually introduced prior to 1.0 with little
9164   fanfare.
9165 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
9166   for writing data to formatted strings, similar to [`io::Write`].
9167 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
9168   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
9169   are used by code generators to emit implementations of [`Debug`].
9170 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
9171   methods that convert case, following Unicode case mapping.
9172 * It is now easier to handle poisoned locks. The [`PoisonError`]
9173   type, returned by failing lock operations, exposes `into_inner`,
9174   `get_ref`, and `get_mut`, which all give access to the inner lock
9175   guard, and allow the poisoned lock to continue to operate. The
9176   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
9177   poisoned lock without attempting to take the lock.
9178 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
9179   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
9180   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
9181   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
9182   `ChildStderr`.
9183 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
9184   malformed input.
9185
9186 Misc
9187 ----
9188
9189 * `rustc` employs smarter heuristics for guessing at [typos].
9190 * `rustc` emits more efficient code for [no-op conversions between
9191   unsafe pointers][nop].
9192 * Fat pointers are now [passed in pairs of immediate arguments][fat],
9193   resulting in faster compile times and smaller code.
9194
9195 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
9196 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
9197 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
9198 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
9199 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
9200 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
9201 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
9202 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
9203 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
9204 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
9205 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
9206 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
9207 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
9208 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
9209 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
9210 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
9211 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
9212 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
9213 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
9214 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
9215 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
9216 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
9217 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
9218 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
9219 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
9220 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
9221 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
9222 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
9223 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
9224 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
9225 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
9226 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
9227 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
9228 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9229 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9230 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
9231 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
9232 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
9233 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
9234 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
9235 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
9236 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
9237 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
9238 [align]: https://github.com/rust-lang/rust/pull/25646
9239 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
9240 [typos]: https://github.com/rust-lang/rust/pull/26087
9241 [nop]: https://github.com/rust-lang/rust/pull/26336
9242 [fat]: https://github.com/rust-lang/rust/pull/26411
9243 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
9244 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
9245 [packed]: https://github.com/rust-lang/rust/pull/25541
9246 [ad]: https://github.com/rust-lang/rust/pull/27382
9247 [win]: https://github.com/rust-lang/rust/pull/25350
9248
9249 Version 1.1.0 (2015-06-25)
9250 =========================
9251
9252 * ~850 changes, numerous bugfixes
9253
9254 Highlights
9255 ----------
9256
9257 * The [`std::fs` module has been expanded][fs] to expand the set of
9258   functionality exposed:
9259   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
9260     don't incur a syscall on some platforms.
9261   * A `symlink_metadata` function has been added.
9262   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
9263     access to all underlying information.
9264 * The compiler now contains extended explanations of many errors. When an error
9265   with an explanation occurs the compiler suggests using the `--explain` flag
9266   to read the explanation. Error explanations are also [available online][err-index].
9267 * Thanks to multiple [improvements][sk] to [type checking][pre], as
9268   well as other work, the time to bootstrap the compiler decreased by
9269   32%.
9270
9271 Libraries
9272 ---------
9273
9274 * The [`str::split_whitespace`] method splits a string on unicode
9275   whitespace boundaries.
9276 * On both Windows and Unix, new extension traits provide conversion of
9277   I/O types to and from the underlying system handles. On Unix, these
9278   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
9279   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
9280   `TcpListener`, and `UpdSocket`. Further implementations for
9281   `std::process` will be stabilized later.
9282 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
9283   Windows, symlinks can be created with
9284   `std::os::windows::symlink_dir` and
9285   `std::os::windows::symlink_file`.
9286 * The `mpsc::Receiver` type can now be converted into an iterator with
9287   `into_iter` on the [`IntoIterator`] trait.
9288 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
9289   implementation of the [`From`] trait.
9290 * The `Debug` implementation for `RangeFull` [creates output that is
9291   more consistent with other implementations][rf].
9292 * [`Debug` is implemented for `File`][file].
9293 * The `Default` implementation for `Arc` [no longer requires `Sync +
9294   Send`][arc].
9295 * [The `Iterator` methods `count`, `nth`, and `last` have been
9296   overridden for slices to have *O*(1) performance instead of *O*(*n*)][si].
9297 * Incorrect handling of paths on Windows has been improved in both the
9298   compiler and the standard library.
9299 * [`AtomicPtr` gained a `Default` implementation][ap].
9300 * In accordance with Rust's policy on arithmetic overflow `abs` now
9301   [panics on overflow when debug assertions are enabled][abs].
9302 * The [`Cloned`] iterator, which was accidentally left unstable for
9303   1.0 [has been stabilized][c].
9304 * The [`Incoming`] iterator, which iterates over incoming TCP
9305   connections, and which was accidentally unnamable in 1.0, [is now
9306   properly exported][inc].
9307 * [`BinaryHeap`] no longer corrupts itself [when functions called by
9308   `sift_up` or `sift_down` panic][bh].
9309 * The [`split_off`] method of `LinkedList` [no longer corrupts
9310   the list in certain scenarios][ll].
9311
9312 Misc
9313 ----
9314
9315 * Type checking performance [has improved notably][sk] with
9316   [multiple improvements][pre].
9317 * The compiler [suggests code changes][ch] for more errors.
9318 * rustc and it's build system have experimental support for [building
9319   toolchains against MUSL][m] instead of glibc on Linux.
9320 * The compiler defines the `target_env` cfg value, which is used for
9321   distinguishing toolchains that are otherwise for the same
9322   platform. Presently this is set to `gnu` for common GNU Linux
9323   targets and for MinGW targets, and `musl` for MUSL Linux targets.
9324 * The [`cargo rustc`][crc] command invokes a build with custom flags
9325   to rustc.
9326 * [Android executables are always position independent][pie].
9327 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
9328   with `Drop`][drop].
9329
9330 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
9331 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9332 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9333 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
9334 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
9335 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
9336 [rf]: https://github.com/rust-lang/rust/pull/24491
9337 [err-index]: https://doc.rust-lang.org/error-index.html
9338 [sk]: https://github.com/rust-lang/rust/pull/24615
9339 [pre]: https://github.com/rust-lang/rust/pull/25323
9340 [file]: https://github.com/rust-lang/rust/pull/24598
9341 [ch]: https://github.com/rust-lang/rust/pull/24683
9342 [arc]: https://github.com/rust-lang/rust/pull/24695
9343 [si]: https://github.com/rust-lang/rust/pull/24701
9344 [ap]: https://github.com/rust-lang/rust/pull/24834
9345 [m]: https://github.com/rust-lang/rust/pull/24777
9346 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
9347 [crc]: https://github.com/rust-lang/cargo/pull/1568
9348 [pie]: https://github.com/rust-lang/rust/pull/24953
9349 [abs]: https://github.com/rust-lang/rust/pull/25441
9350 [c]: https://github.com/rust-lang/rust/pull/25496
9351 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
9352 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
9353 [inc]: https://github.com/rust-lang/rust/pull/25522
9354 [bh]: https://github.com/rust-lang/rust/pull/25856
9355 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
9356 [ll]: https://github.com/rust-lang/rust/pull/26022
9357 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
9358 [drop]: https://github.com/rust-lang/rust/pull/24935
9359
9360 Version 1.0.0 (2015-05-15)
9361 ========================
9362
9363 * ~1500 changes, numerous bugfixes
9364
9365 Highlights
9366 ----------
9367
9368 * The vast majority of the standard library is now `#[stable]`. It is
9369   no longer possible to use unstable features with a stable build of
9370   the compiler.
9371 * Many popular crates on [crates.io] now work on the stable release
9372   channel.
9373 * Arithmetic on basic integer types now [checks for overflow in debug
9374   builds][overflow].
9375
9376 Language
9377 --------
9378
9379 * Several [restrictions have been added to trait coherence][coh] in
9380   order to make it easier for upstream authors to change traits
9381   without breaking downstream code.
9382 * Digits of binary and octal literals are [lexed more eagerly][lex] to
9383   improve error messages and macro behavior. For example, `0b1234` is
9384   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
9385 * Trait bounds [are always invariant][inv], eliminating the need for
9386   the `PhantomFn` and `MarkerTrait` lang items, which have been
9387   removed.
9388 * ["-" is no longer a valid character in crate names][cr], the `extern crate
9389   "foo" as bar` syntax has been replaced with `extern crate foo as
9390   bar`, and Cargo now automatically translates "-" in *package* names
9391   to underscore for the crate name.
9392 * [Lifetime shadowing is an error][lt].
9393 * [`Send` no longer implies `'static`][send-rfc].
9394 * [UFCS now supports trait-less associated paths][moar-ufcs] like
9395   `MyType::default()`.
9396 * Primitive types [now have inherent methods][prim-inherent],
9397   obviating the need for extension traits like `SliceExt`.
9398 * Methods with `Self: Sized` in their `where` clause are [considered
9399   object-safe][self-sized], allowing many extension traits like
9400   `IteratorExt` to be merged into the traits they extended.
9401 * You can now [refer to associated types][assoc-where] whose
9402   corresponding trait bounds appear only in a `where` clause.
9403 * The final bits of [OIBIT landed][oibit-final], meaning that traits
9404   like `Send` and `Sync` are now library-defined.
9405 * A [Reflect trait][reflect] was introduced, which means that
9406   downcasting via the `Any` trait is effectively limited to concrete
9407   types. This helps retain the potentially-important "parametricity"
9408   property: generic code cannot behave differently for different type
9409   arguments except in minor ways.
9410 * The `unsafe_destructor` feature is now deprecated in favor of the
9411   [new `dropck`][dropck]. This change is a major reduction in unsafe
9412   code.
9413
9414 Libraries
9415 ---------
9416
9417 * The `thread_local` module [has been renamed to `std::thread`][th].
9418 * The methods of `IteratorExt` [have been moved to the `Iterator`
9419   trait itself][ie].
9420 * Several traits that implement Rust's conventions for type
9421   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
9422   [centralized in the `std::convert` module][con].
9423 * The `FromError` trait [was removed in favor of `From`][fe].
9424 * The basic sleep function [has moved to
9425   `std::thread::sleep_ms`][slp].
9426 * The `splitn` function now takes an `n` parameter that represents the
9427   number of items yielded by the returned iterator [instead of the
9428   number of 'splits'][spl].
9429 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
9430 * [Derived implementations of `PartialOrd` now order enums according
9431   to their explicitly-assigned discriminants][po].
9432 * [Methods for searching strings are generic over `Pattern`s][pat],
9433   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
9434   some others.
9435 * [In method resolution, object methods are resolved before inherent
9436   methods][meth].
9437 * [`String::from_str` has been deprecated in favor of the `From` impl,
9438   `String::from`][sf].
9439 * [`io::Error` implements `Sync`][ios].
9440 * [The `words` method on `&str` has been replaced with
9441   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
9442   a word?'
9443 * The new path and IO modules are complete and `#[stable]`. This
9444   was the major library focus for this cycle.
9445 * The path API was [revised][path-normalize] to normalize `.`,
9446   adjusting the tradeoffs in favor of the most common usage.
9447 * A large number of remaining APIs in `std` were also stabilized
9448   during this cycle; about 75% of the non-deprecated API surface
9449   is now stable.
9450 * The new [string pattern API][string-pattern] landed, which makes
9451   the string slice API much more internally consistent and flexible.
9452 * A new set of [generic conversion traits][conversion] replaced
9453   many existing ad hoc traits.
9454 * Generic numeric traits were [completely removed][num-traits]. This
9455   was made possible thanks to inherent methods for primitive types,
9456   and the removal gives maximal flexibility for designing a numeric
9457   hierarchy in the future.
9458 * The `Fn` traits are now related via [inheritance][fn-inherit]
9459   and provide ergonomic [blanket implementations][fn-blanket].
9460 * The `Index` and `IndexMut` traits were changed to
9461   [take the index by value][index-value], enabling code like
9462   `hash_map["string"]` to work.
9463 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
9464   `Copy` data is known to be `Clone` as well.
9465
9466 Misc
9467 ----
9468
9469 * Many errors now have extended explanations that can be accessed with
9470   the `--explain` flag to `rustc`.
9471 * Many new examples have been added to the standard library
9472   documentation.
9473 * rustdoc has received a number of improvements focused on completion
9474   and polish.
9475 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
9476 * Much headway was made on ecosystem-wide CI, making it possible
9477   to [compare builds for breakage][ci-compare].
9478
9479
9480 [crates.io]: http://crates.io
9481 [clo]: https://github.com/rust-lang/rust/pull/24034
9482 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
9483 [con]: https://github.com/rust-lang/rust/pull/23875
9484 [cr]: https://github.com/rust-lang/rust/pull/23419
9485 [fe]: https://github.com/rust-lang/rust/pull/23879
9486 [ie]: https://github.com/rust-lang/rust/pull/23300
9487 [inv]: https://github.com/rust-lang/rust/pull/23938
9488 [ios]: https://github.com/rust-lang/rust/pull/24133
9489 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
9490 [lt]: https://github.com/rust-lang/rust/pull/24057
9491 [meth]: https://github.com/rust-lang/rust/pull/24056
9492 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
9493 [po]: https://github.com/rust-lang/rust/pull/24270
9494 [sf]: https://github.com/rust-lang/rust/pull/24517
9495 [slp]: https://github.com/rust-lang/rust/pull/23949
9496 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
9497 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
9498 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
9499 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
9500 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
9501 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
9502 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
9503 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
9504 [self-sized]: https://github.com/rust-lang/rust/pull/22301
9505 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
9506 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
9507 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
9508 [reflect]: https://github.com/rust-lang/rust/pull/23712
9509 [conversion]: https://github.com/rust-lang/rfcs/pull/529
9510 [num-traits]: https://github.com/rust-lang/rust/pull/23549
9511 [index-value]: https://github.com/rust-lang/rust/pull/23601
9512 [dropck]: https://github.com/rust-lang/rfcs/pull/769
9513 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
9514 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
9515 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
9516 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
9517 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
9518
9519
9520 Version 1.0.0-alpha.2 (2015-02-20)
9521 =====================================
9522
9523 * ~1300 changes, numerous bugfixes
9524
9525 * Highlights
9526
9527     * The various I/O modules were [overhauled][io-rfc] to reduce
9528       unnecessary abstractions and provide better interoperation with
9529       the underlying platform. The old `io` module remains temporarily
9530       at `std::old_io`.
9531     * The standard library now [participates in feature gating][feat],
9532       so use of unstable libraries now requires a `#![feature(...)]`
9533       attribute. The impact of this change is [described on the
9534       forum][feat-forum]. [RFC][feat-rfc].
9535
9536 * Language
9537
9538     * `for` loops [now operate on the `IntoIterator` trait][into],
9539       which eliminates the need to call `.iter()`, etc. to iterate
9540       over collections. There are some new subtleties to remember
9541       though regarding what sort of iterators various types yield, in
9542       particular that `for foo in bar { }` yields values from a move
9543       iterator, destroying the original collection. [RFC][into-rfc].
9544     * Objects now have [default lifetime bounds][obj], so you don't
9545       have to write `Box<Trait+'static>` when you don't care about
9546       storing references. [RFC][obj-rfc].
9547     * In types that implement `Drop`, [lifetimes must outlive the
9548       value][drop]. This will soon make it possible to safely
9549       implement `Drop` for types where `#[unsafe_destructor]` is now
9550       required. Read the [gorgeous RFC][drop-rfc] for details.
9551     * The fully qualified <T as Trait>::X syntax lets you set the Self
9552       type for a trait method or associated type. [RFC][ufcs-rfc].
9553     * References to types that implement `Deref<U>` now [automatically
9554       coerce to references][deref] to the dereferenced type `U`,
9555       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
9556       should eliminate many unsightly uses of `&*`, as when converting
9557       from references to vectors into references to
9558       slices. [RFC][deref-rfc].
9559     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
9560       `|:|`) is obsolete and closure kind is inferred from context.
9561     * [`Self` is a keyword][Self].
9562
9563 * Libraries
9564
9565     * The `Show` and `String` formatting traits [have been
9566       renamed][fmt] to `Debug` and `Display` to more clearly reflect
9567       their related purposes. Automatically getting a string
9568       conversion to use with `format!("{:?}", something_to_debug)` is
9569       now written `#[derive(Debug)]`.
9570     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
9571       OsStr}`, provide strings in platform-specific encodings for easier
9572       interop with system APIs. [RFC][osstr-rfc].
9573     * The `boxed::into_raw` and `Box::from_raw` functions [convert
9574       between `Box<T>` and `*mut T`][boxraw], a common pattern for
9575       creating raw pointers.
9576
9577 * Tooling
9578
9579     * Certain long error messages of the form 'expected foo found bar'
9580       are now [split neatly across multiple
9581       lines][multiline]. Examples in the PR.
9582     * On Unix Rust can be [uninstalled][un] by running
9583       `/usr/local/lib/rustlib/uninstall.sh`.
9584     * The `#[rustc_on_unimplemented]` attribute, requiring the
9585       'on_unimplemented' feature, lets rustc [display custom error
9586       messages when a trait is expected to be implemented for a type
9587       but is not][onun].
9588
9589 * Misc
9590
9591     * Rust is tested against a [LALR grammar][lalr], which parses
9592       almost all the Rust files that rustc does.
9593
9594 [boxraw]: https://github.com/rust-lang/rust/pull/21318
9595 [close]: https://github.com/rust-lang/rust/pull/21843
9596 [deref]: https://github.com/rust-lang/rust/pull/21351
9597 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
9598 [drop]: https://github.com/rust-lang/rust/pull/21972
9599 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
9600 [feat]: https://github.com/rust-lang/rust/pull/21248
9601 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
9602 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
9603 [fmt]: https://github.com/rust-lang/rust/pull/21457
9604 [into]: https://github.com/rust-lang/rust/pull/20790
9605 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
9606 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9607 [lalr]: https://github.com/rust-lang/rust/pull/21452
9608 [multiline]: https://github.com/rust-lang/rust/pull/19870
9609 [obj]: https://github.com/rust-lang/rust/pull/22230
9610 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
9611 [onun]: https://github.com/rust-lang/rust/pull/20889
9612 [osstr]: https://github.com/rust-lang/rust/pull/21488
9613 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9614 [Self]: https://github.com/rust-lang/rust/pull/22158
9615 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
9616 [un]: https://github.com/rust-lang/rust/pull/22256
9617
9618
9619 Version 1.0.0-alpha (2015-01-09)
9620 ==================================
9621
9622   * ~2400 changes, numerous bugfixes
9623
9624   * Highlights
9625
9626     * The language itself is considered feature complete for 1.0,
9627       though there will be many usability improvements and bugfixes
9628       before the final release.
9629     * Nearly 50% of the public API surface of the standard library has
9630       been declared 'stable'. Those interfaces are unlikely to change
9631       before 1.0.
9632     * The long-running debate over integer types has been
9633       [settled][ints]: Rust will ship with types named `isize` and
9634       `usize`, rather than `int` and `uint`, for pointer-sized
9635       integers. Guidelines will be rolled out during the alpha cycle.
9636     * Most crates that are not `std` have been moved out of the Rust
9637       distribution into the Cargo ecosystem so they can evolve
9638       separately and don't need to be stabilized as quickly, including
9639       'time', 'getopts', 'num', 'regex', and 'term'.
9640     * Documentation continues to be expanded with more API coverage, more
9641       examples, and more in-depth explanations. The guides have been
9642       consolidated into [The Rust Programming Language][trpl].
9643     * "[Rust By Example][rbe]" is now maintained by the Rust team.
9644     * All official Rust binary installers now come with [Cargo], the
9645       Rust package manager.
9646
9647 * Language
9648
9649     * Closures have been [completely redesigned][unboxed] to be
9650       implemented in terms of traits, can now be used as generic type
9651       bounds and thus monomorphized and inlined, or via an opaque
9652       pointer (boxed) as in the old system. The new system is often
9653       referred to as 'unboxed' closures.
9654     * Traits now support [associated types][assoc], allowing families
9655       of related types to be defined together and used generically in
9656       powerful ways.
9657     * Enum variants are [namespaced by their type names][enum].
9658     * [`where` clauses][where] provide a more versatile and attractive
9659       syntax for specifying generic bounds, though the previous syntax
9660       remains valid.
9661     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
9662       numeric types.
9663     * Rust [no longer has a runtime][rt] of any description, and only
9664       supports OS threads, not green threads.
9665     * At long last, Rust has been overhauled for 'dynamically-sized
9666       types' ([DST]), which integrates 'fat pointers' (object types,
9667       arrays, and `str`) more deeply into the type system, making it
9668       more consistent.
9669     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
9670       `..j` that produce range types and which, when combined with the
9671       `Index` operator and multidispatch, leads to a convenient slice
9672       notation, `[i..j]`.
9673     * The new range syntax revealed an ambiguity in the fixed-length
9674       array syntax, so now fixed length arrays [are written `[T;
9675       N]`][arrays].
9676     * The `Copy` trait is no longer implemented automatically. Unsafe
9677       pointers no longer implement `Sync` and `Send` so types
9678       containing them don't automatically either. `Sync` and `Send`
9679       are now 'unsafe traits' so one can "forcibly" implement them via
9680       `unsafe impl` if a type confirms to the requirements for them
9681       even though the internals do not (e.g. structs containing unsafe
9682       pointers like `Arc`). These changes are intended to prevent some
9683       footguns and are collectively known as [opt-in built-in
9684       traits][oibit] (though `Sync` and `Send` will soon become pure
9685       library types unknown to the compiler).
9686     * Operator traits now take their operands [by value][ops], and
9687       comparison traits can use multidispatch to compare one type
9688       against multiple other types, allowing e.g. `String` to be
9689       compared with `&str`.
9690     * `if let` and `while let` are no longer feature-gated.
9691     * Rust has adopted a more [uniform syntax for escaping unicode
9692       characters][unicode].
9693     * `macro_rules!` [has been declared stable][mac]. Though it is a
9694       flawed system it is sufficiently popular that it must be usable
9695       for 1.0. Effort has gone into [future-proofing][mac-future] it
9696       in ways that will allow other macro systems to be developed in
9697       parallel, and won't otherwise impact the evolution of the
9698       language.
9699     * The prelude has been [pared back significantly][prelude] such
9700       that it is the minimum necessary to support the most pervasive
9701       code patterns, and through [generalized where clauses][where]
9702       many of the prelude extension traits have been consolidated.
9703     * Rust's rudimentary reflection [has been removed][refl], as it
9704       incurred too much code generation for little benefit.
9705     * [Struct variants][structvars] are no longer feature-gated.
9706     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
9707       known as 'higher-ranked trait bounds', this crucially allows
9708       unboxed closures to work.
9709     * Macros invocations surrounded by parens or square brackets and
9710       not terminated by a semicolon are [parsed as
9711       expressions][macros], which makes expressions like `vec![1i32,
9712       2, 3].len()` work as expected.
9713     * Trait objects now implement their traits automatically, and
9714       traits that can be coerced to objects now must be [object
9715       safe][objsafe].
9716     * Automatically deriving traits is now done with `#[derive(...)]`
9717       not `#[deriving(...)]` for [consistency with other naming
9718       conventions][derive].
9719     * Importing the containing module or enum at the same time as
9720       items or variants they contain is [now done with `self` instead
9721       of `mod`][self], as in use `foo::{self, bar}`
9722     * Glob imports are no longer feature-gated.
9723     * The `box` operator and `box` patterns have been feature-gated
9724       pending a redesign. For now unique boxes should be allocated
9725       like other containers, with `Box::new`.
9726
9727 * Libraries
9728
9729     * A [series][coll1] of [efforts][coll2] to establish
9730       [conventions][coll3] for collections types has resulted in API
9731       improvements throughout the standard library.
9732     * New [APIs for error handling][err] provide ergonomic interop
9733       between error types, and [new conventions][err-conv] describe
9734       more clearly the recommended error handling strategies in Rust.
9735     * The `fail!` macro has been renamed to [`panic!`][panic] so that
9736       it is easier to discuss failure in the context of error handling
9737       without making clarifications as to whether you are referring to
9738       the 'fail' macro or failure more generally.
9739     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
9740       syscall when available.
9741     * The 'serialize' crate has been renamed 'rustc-serialize' and
9742       moved out of the distribution to Cargo. Although it is widely
9743       used now, it is expected to be superseded in the near future.
9744     * The `Show` formatter, typically implemented with
9745       `#[derive(Show)]` is [now requested with the `{:?}`
9746       specifier][show] and is intended for use by all types, for uses
9747       such as `println!` debugging. The new `String` formatter must be
9748       implemented by hand, uses the `{}` specifier, and is intended
9749       for full-fidelity conversions of things that can logically be
9750       represented as strings.
9751
9752 * Tooling
9753
9754     * [Flexible target specification][flex] allows rustc's code
9755       generation to be configured to support otherwise-unsupported
9756       platforms.
9757     * Rust comes with rust-gdb and rust-lldb scripts that launch their
9758       respective debuggers with Rust-appropriate pretty-printing.
9759     * The Windows installation of Rust is distributed with the
9760       MinGW components currently required to link binaries on that
9761       platform.
9762
9763 * Misc
9764
9765     * Nullable enum optimizations have been extended to more types so
9766       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
9767       space than the inner types themselves.
9768     * Work has begun on supporting AArch64.
9769
9770 [Cargo]: https://crates.io
9771 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
9772 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
9773 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
9774 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
9775 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
9776 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
9777 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
9778 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
9779 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
9780 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
9781 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
9782 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
9783 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
9784 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
9785 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
9786 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
9787 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
9788 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
9789 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
9790 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
9791 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
9792 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
9793 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
9794 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
9795 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
9796 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
9797 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
9798 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
9799 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
9800 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
9801 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
9802 [trpl]: https://doc.rust-lang.org/book/index.html
9803 [rbe]: http://rustbyexample.com/
9804
9805
9806 Version 0.12.0 (2014-10-09)
9807 =============================
9808
9809   * ~1900 changes, numerous bugfixes
9810
9811   * Highlights
9812
9813     * The introductory documentation (now called The Rust Guide) has
9814       been completely rewritten, as have a number of supplementary
9815       guides.
9816     * Rust's package manager, Cargo, continues to improve and is
9817       sometimes considered to be quite awesome.
9818     * Many API's in `std` have been reviewed and updated for
9819       consistency with the in-development Rust coding
9820       guidelines. The standard library documentation tracks
9821       stabilization progress.
9822     * Minor libraries have been moved out-of-tree to the rust-lang org
9823       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
9824       be installed with Cargo.
9825     * Lifetime elision allows lifetime annotations to be left off of
9826       function declarations in many common scenarios.
9827     * Rust now works on 64-bit Windows.
9828
9829   * Language
9830     * Indexing can be overloaded with the `Index` and `IndexMut`
9831       traits.
9832     * The `if let` construct takes a branch only if the `let` pattern
9833       matches, currently behind the 'if_let' feature gate.
9834     * 'where clauses', a more flexible syntax for specifying trait
9835       bounds that is more aesthetic, have been added for traits and
9836       free functions. Where clauses will in the future make it
9837       possible to constrain associated types, which would be
9838       impossible with the existing syntax.
9839     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
9840       the 'slicing_syntax' feature gate, and can be overloaded with
9841       the `Slice` or `SliceMut` traits.
9842     * The syntax for matching of sub-slices has been changed to use a
9843       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
9844       consistency with other uses of `..` and to future-proof
9845       potential additional uses of the syntax.
9846     * The syntax for matching inclusive ranges in patterns has changed
9847       from `0..3` to `0...4` to be consistent with the exclusive range
9848       syntax for slicing.
9849     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
9850       c]`) has been put behind the 'advanced_slice_patterns' feature
9851       gate and may be removed in the future.
9852     * Components of tuples and tuple structs can be extracted using
9853       the `value.0` syntax, currently behind the `tuple_indexing`
9854       feature gate.
9855     * The `#[crate_id]` attribute is no longer supported; versioning
9856       is handled by the package manager.
9857     * Renaming crate imports are now written `extern crate foo as bar`
9858       instead of `extern crate bar = foo`.
9859     * Renaming use statements are now written `use foo as bar` instead
9860       of `use bar = foo`.
9861     * `let` and `match` bindings and argument names in macros are now
9862       hygienic.
9863     * The new, more efficient, closure types ('unboxed closures') have
9864       been added under a feature gate, 'unboxed_closures'. These will
9865       soon replace the existing closure types, once higher-ranked
9866       trait lifetimes are added to the language.
9867     * `move` has been added as a keyword, for indicating closures
9868       that capture by value.
9869     * Mutation and assignment is no longer allowed in pattern guards.
9870     * Generic structs and enums can now have trait bounds.
9871     * The `Share` trait is now called `Sync` to free up the term
9872       'shared' to refer to 'shared reference' (the default reference
9873       type.
9874     * Dynamically-sized types have been mostly implemented,
9875       unifying the behavior of fat-pointer types with the rest of the
9876       type system.
9877     * As part of dynamically-sized types, the `Sized` trait has been
9878       introduced, which qualifying types implement by default, and
9879       which type parameters expect by default. To specify that a type
9880       parameter does not need to be sized, write `<Sized? T>`. Most
9881       types are `Sized`, notable exceptions being unsized arrays
9882       (`[T]`) and trait types.
9883     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
9884     * Lifetime bounds can now be applied to type parameters and object
9885       types.
9886     * The old, reference counted GC type, `Gc<T>` which was once
9887       denoted by the `@` sigil, has finally been removed. GC will be
9888       revisited in the future.
9889
9890   * Libraries
9891     * Library documentation has been improved for a number of modules.
9892     * Bit-vectors, collections::bitv has been modernized.
9893     * The url crate is deprecated in favor of
9894       http://github.com/servo/rust-url, which can be installed with
9895       Cargo.
9896     * Most I/O stream types can be cloned and subsequently closed from
9897       a different thread.
9898     * A `std::time::Duration` type has been added for use in I/O
9899       methods that rely on timers, as well as in the 'time' crate's
9900       `Timespec` arithmetic.
9901     * The runtime I/O abstraction layer that enabled the green thread
9902       scheduler to do non-thread-blocking I/O has been removed, along
9903       with the libuv-based implementation employed by the green thread
9904       scheduler. This will greatly simplify the future I/O work.
9905     * `collections::btree` has been rewritten to have a more
9906       idiomatic and efficient design.
9907
9908   * Tooling
9909     * rustdoc output now indicates the stability levels of API's.
9910     * The `--crate-name` flag can specify the name of the crate
9911       being compiled, like `#[crate_name]`.
9912     * The `-C metadata` specifies additional metadata to hash into
9913       symbol names, and `-C extra-filename` specifies additional
9914       information to put into the output filename, for use by the
9915       package manager for versioning.
9916     * debug info generation has continued to improve and should be
9917       more reliable under both gdb and lldb.
9918     * rustc has experimental support for compiling in parallel
9919       using the `-C codegen-units` flag.
9920     * rustc no longer encodes rpath information into binaries by
9921       default.
9922
9923   * Misc
9924     * Stack usage has been optimized with LLVM lifetime annotations.
9925     * Official Rust binaries on Linux are more compatible with older
9926       kernels and distributions, built on CentOS 5.10.
9927
9928
9929 Version 0.11.0 (2014-07-02)
9930 ==========================
9931
9932   * ~1700 changes, numerous bugfixes
9933
9934   * Language
9935     * ~[T] has been removed from the language. This type is superseded by
9936       the Vec<T> type.
9937     * ~str has been removed from the language. This type is superseded by
9938       the String type.
9939     * ~T has been removed from the language. This type is superseded by the
9940       Box<T> type.
9941     * @T has been removed from the language. This type is superseded by the
9942       standard library's std::gc::Gc<T> type.
9943     * Struct fields are now all private by default.
9944     * Vector indices and shift amounts are both required to be a `uint`
9945       instead of any integral type.
9946     * Byte character, byte string, and raw byte string literals are now all
9947       supported by prefixing the normal literal with a `b`.
9948     * Multiple ABIs are no longer allowed in an ABI string
9949     * The syntax for lifetimes on closures/procedures has been tweaked
9950       slightly: `<'a>|A, B|: 'b + K -> T`
9951     * Floating point modulus has been removed from the language; however it
9952       is still provided by a library implementation.
9953     * Private enum variants are now disallowed.
9954     * The `priv` keyword has been removed from the language.
9955     * A closure can no longer be invoked through a &-pointer.
9956     * The `use foo, bar, baz;` syntax has been removed from the language.
9957     * The transmute intrinsic no longer works on type parameters.
9958     * Statics now allow blocks/items in their definition.
9959     * Trait bounds are separated from objects with + instead of : now.
9960     * Objects can no longer be read while they are mutably borrowed.
9961     * The address of a static is now marked as insignificant unless the
9962       #[inline(never)] attribute is placed it.
9963     * The #[unsafe_destructor] attribute is now behind a feature gate.
9964     * Struct literals are no longer allowed in ambiguous positions such as
9965       if, while, match, and for..in.
9966     * Declaration of lang items and intrinsics are now feature-gated by
9967       default.
9968     * Integral literals no longer default to `int`, and floating point
9969       literals no longer default to `f64`. Literals must be suffixed with an
9970       appropriate type if inference cannot determine the type of the
9971       literal.
9972     * The Box<T> type is no longer implicitly borrowed to &mut T.
9973     * Procedures are now required to not capture borrowed references.
9974
9975   * Libraries
9976     * The standard library is now a "facade" over a number of underlying
9977       libraries. This means that development on the standard library should
9978       be speedier due to smaller crates, as well as a clearer line between
9979       all dependencies.
9980     * A new library, libcore, lives under the standard library's facade
9981       which is Rust's "0-assumption" library, suitable for embedded and
9982       kernel development for example.
9983     * A regex crate has been added to the standard distribution. This crate
9984       includes statically compiled regular expressions.
9985     * The unwrap/unwrap_err methods on Result require a Show bound for
9986       better error messages.
9987     * The return types of the std::comm primitives have been centralized
9988       around the Result type.
9989     * A number of I/O primitives have gained the ability to time out their
9990       operations.
9991     * A number of I/O primitives have gained the ability to close their
9992       reading/writing halves to cancel pending operations.
9993     * Reverse iterator methods have been removed in favor of `rev()` on
9994       their forward-iteration counterparts.
9995     * A bitflags! macro has been added to enable easy interop with C and
9996       management of bit flags.
9997     * A debug_assert! macro is now provided which is disabled when
9998       `--cfg ndebug` is passed to the compiler.
9999     * A graphviz crate has been added for creating .dot files.
10000     * The std::cast module has been migrated into std::mem.
10001     * The std::local_data api has been migrated from freestanding functions
10002       to being based on methods.
10003     * The Pod trait has been renamed to Copy.
10004     * jemalloc has been added as the default allocator for types.
10005     * The API for allocating memory has been changed to use proper alignment
10006       and sized deallocation
10007     * Connecting a TcpStream or binding a TcpListener is now based on a
10008       string address and a u16 port. This allows connecting to a hostname as
10009       opposed to an IP.
10010     * The Reader trait now contains a core method, read_at_least(), which
10011       correctly handles many repeated 0-length reads.
10012     * The process-spawning API is now centered around a builder-style
10013       Command struct.
10014     * The :? printing qualifier has been moved from the standard library to
10015       an external libdebug crate.
10016     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
10017       have been renamed to Eq/Ord.
10018     * The select/plural methods have been removed from format!. The escapes
10019       for { and } have also changed from \{ and \} to {{ and }},
10020       respectively.
10021     * The TaskBuilder API has been re-worked to be a true builder, and
10022       extension traits for spawning native/green tasks have been added.
10023
10024   * Tooling
10025     * All breaking changes to the language or libraries now have their
10026       commit message annotated with `[breaking-change]` to allow for easy
10027       discovery of breaking changes.
10028     * The compiler will now try to suggest how to annotate lifetimes if a
10029       lifetime-related error occurs.
10030     * Debug info continues to be improved greatly with general bug fixes and
10031       better support for situations like link time optimization (LTO).
10032     * Usage of syntax extensions when cross-compiling has been fixed.
10033     * Functionality equivalent to GCC & Clang's -ffunction-sections,
10034       -fdata-sections and --gc-sections has been enabled by default
10035     * The compiler is now stricter about where it will load module files
10036       from when a module is declared via `mod foo;`.
10037     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
10038       Syntax extensions are now discovered via a "plugin registrar" type
10039       which will be extended in the future to other various plugins.
10040     * Lints have been restructured to allow for dynamically loadable lints.
10041     * A number of rustdoc improvements:
10042       * The HTML output has been visually redesigned.
10043       * Markdown is now powered by hoedown instead of sundown.
10044       * Searching heuristics have been greatly improved.
10045       * The search index has been reduced in size by a great amount.
10046       * Cross-crate documentation via `pub use` has been greatly improved.
10047       * Primitive types are now hyperlinked and documented.
10048     * Documentation has been moved from static.rust-lang.org/doc to
10049       doc.rust-lang.org
10050     * A new sandbox, play.rust-lang.org, is available for running and
10051       sharing rust code examples on-line.
10052     * Unused attributes are now more robustly warned about.
10053     * The dead_code lint now warns about unused struct fields.
10054     * Cross-compiling to iOS is now supported.
10055     * Cross-compiling to mipsel is now supported.
10056     * Stability attributes are now inherited by default and no longer apply
10057       to intra-crate usage, only inter-crate usage.
10058     * Error message related to non-exhaustive match expressions have been
10059       greatly improved.
10060
10061
10062 Version 0.10 (2014-04-03)
10063 =========================
10064
10065   * ~1500 changes, numerous bugfixes
10066
10067   * Language
10068     * A new RFC process is now in place for modifying the language.
10069     * Patterns with `@`-pointers have been removed from the language.
10070     * Patterns with unique vectors (`~[T]`) have been removed from the
10071       language.
10072     * Patterns with unique strings (`~str`) have been removed from the
10073       language.
10074     * `@str` has been removed from the language.
10075     * `@[T]` has been removed from the language.
10076     * `@self` has been removed from the language.
10077     * `@Trait` has been removed from the language.
10078     * Headers on `~` allocations which contain `@` boxes inside the type for
10079       reference counting have been removed.
10080     * The semantics around the lifetimes of temporary expressions have changed,
10081       see #3511 and #11585 for more information.
10082     * Cross-crate syntax extensions are now possible, but feature gated. See
10083       #11151 for more information. This includes both `macro_rules!` macros as
10084       well as syntax extensions such as `format!`.
10085     * New lint modes have been added, and older ones have been turned on to be
10086       warn-by-default.
10087       * Unnecessary parentheses
10088       * Uppercase statics
10089       * Camel Case types
10090       * Uppercase variables
10091       * Publicly visible private types
10092       * `#[deriving]` with raw pointers
10093     * Unsafe functions can no longer be coerced to closures.
10094     * Various obscure macros such as `log_syntax!` are now behind feature gates.
10095     * The `#[simd]` attribute is now behind a feature gate.
10096     * Visibility is no longer allowed on `extern crate` statements, and
10097       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
10098     * Trailing commas are now allowed in argument lists and tuple patterns.
10099     * The `do` keyword has been removed, it is now a reserved keyword.
10100     * Default type parameters have been implemented, but are feature gated.
10101     * Borrowed variables through captures in closures are now considered soundly.
10102     * `extern mod` is now `extern crate`
10103     * The `Freeze` trait has been removed.
10104     * The `Share` trait has been added for types that can be shared among
10105       threads.
10106     * Labels in macros are now hygienic.
10107     * Expression/statement macro invocations can be delimited with `{}` now.
10108     * Treatment of types allowed in `static mut` locations has been tweaked.
10109     * The `*` and `.` operators are now overloadable through the `Deref` and
10110       `DerefMut` traits.
10111     * `~Trait` and `proc` no longer have `Send` bounds by default.
10112     * Partial type hints are now supported with the `_` type marker.
10113     * An `Unsafe` type was introduced for interior mutability. It is now
10114       considered undefined to transmute from `&T` to `&mut T` without using the
10115       `Unsafe` type.
10116     * The #[linkage] attribute was implemented for extern statics/functions.
10117     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
10118     * `Pod` was renamed to `Copy`.
10119
10120   * Libraries
10121     * The `libextra` library has been removed. It has now been decomposed into
10122       component libraries with smaller and more focused nuggets of
10123       functionality. The full list of libraries can be found on the
10124       documentation index page.
10125     * std: `std::condition` has been removed. All I/O errors are now propagated
10126       through the `Result` type. In order to assist with error handling, a
10127       `try!` macro for unwrapping errors with an early return and a lint for
10128       unused results has been added. See #12039 for more information.
10129     * std: The `vec` module has been renamed to `slice`.
10130     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
10131       This will become the only growable vector in the future.
10132     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
10133       are now found at `std::io::BufferedReader` instead of
10134       `std::io::buffered::BufferedReader`.
10135     * std: `print` and `println` are no longer in the prelude, the `print!` and
10136       `println!` macros are intended to be used instead.
10137     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
10138       attempts to statically prevent cycles.
10139     * std: The standard distribution is adopting the policy of pushing failure
10140       to the user rather than failing in libraries. Many functions (such as
10141       `slice::last()`) now return `Option<T>` instead of `T` + failing.
10142     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
10143       deriving mode: `#[deriving(Show)]`.
10144     * std: `ToStr` is now implemented for all types implementing `Show`.
10145     * std: The formatting trait methods now take `&self` instead of `&T`
10146     * std: The `invert()` method on iterators has been renamed to `rev()`
10147     * std: `std::num` has seen a reduction in the genericity of its traits,
10148       consolidating functionality into a few core traits.
10149     * std: Backtraces are now printed on task failure if the environment
10150       variable `RUST_BACKTRACE` is present.
10151     * std: Naming conventions for iterators have been standardized. More details
10152       can be found on the wiki's style guide.
10153     * std: `eof()` has been removed from the `Reader` trait. Specific types may
10154       still implement the function.
10155     * std: Networking types are now cloneable to allow simultaneous reads/writes.
10156     * std: `assert_approx_eq!` has been removed
10157     * std: The `e` and `E` formatting specifiers for floats have been added to
10158       print them in exponential notation.
10159     * std: The `Times` trait has been removed
10160     * std: Indications of variance and opting out of builtin bounds is done
10161       through marker types in `std::kinds::marker` now
10162     * std: `hash` has been rewritten, `IterBytes` has been removed, and
10163       `#[deriving(Hash)]` is now possible.
10164     * std: `SharedChan` has been removed, `Sender` is now cloneable.
10165     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
10166     * std: `Chan::new` is now `channel()`.
10167     * std: A new synchronous channel type has been implemented.
10168     * std: A `select!` macro is now provided for selecting over `Receiver`s.
10169     * std: `hashmap` and `trie` have been moved to `libcollections`
10170     * std: `run` has been rolled into `io::process`
10171     * std: `assert_eq!` now uses `{}` instead of `{:?}`
10172     * std: The equality and comparison traits have seen some reorganization.
10173     * std: `rand` has moved to `librand`.
10174     * std: `to_{lower,upper}case` has been implemented for `char`.
10175     * std: Logging has been moved to `liblog`.
10176     * collections: `HashMap` has been rewritten for higher performance and less
10177       memory usage.
10178     * native: The default runtime is now `libnative`. If `libgreen` is desired,
10179       it can be booted manually. The runtime guide has more information and
10180       examples.
10181     * native: All I/O functionality except signals has been implemented.
10182     * green: Task spawning with `libgreen` has been optimized with stack caching
10183       and various trimming of code.
10184     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
10185     * sync: The `extra::sync` module has been updated to modern rust (and moved
10186       to the `sync` library), tweaking and improving various interfaces while
10187       dropping redundant functionality.
10188     * sync: A new `Barrier` type has been added to the `sync` library.
10189     * sync: An efficient mutex for native and green tasks has been implemented.
10190     * serialize: The `base64` module has seen some improvement. It treats
10191       newlines better, has non-string error values, and has seen general
10192       cleanup.
10193     * fourcc: A `fourcc!` macro was introduced
10194     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
10195       hexadecimal literal.
10196
10197   * Tooling
10198     * `rustpkg` has been deprecated and removed from the main repository. Its
10199       replacement, `cargo`, is under development.
10200     * Nightly builds of rust are now available
10201     * The memory usage of rustc has been improved many times throughout this
10202       release cycle.
10203     * The build process supports disabling rpath support for the rustc binary
10204       itself.
10205     * Code generation has improved in some cases, giving more information to the
10206       LLVM optimization passes to enable more extensive optimizations.
10207     * Debuginfo compatibility with lldb on OSX has been restored.
10208     * The master branch is now gated on an android bot, making building for
10209       android much more reliable.
10210     * Output flags have been centralized into one `--emit` flag.
10211     * Crate type flags have been centralized into one `--crate-type` flag.
10212     * Codegen flags have been consolidated behind a `-C` flag.
10213     * Linking against outdated crates now has improved error messages.
10214     * Error messages with lifetimes will often suggest how to annotate the
10215       function to fix the error.
10216     * Many more types are documented in the standard library, and new guides
10217       were written.
10218     * Many `rustdoc` improvements:
10219       * code blocks are syntax highlighted.
10220       * render standalone markdown files.
10221       * the --test flag tests all code blocks by default.
10222       * exported macros are displayed.
10223       * re-exported types have their documentation inlined at the location of the
10224         first re-export.
10225       * search works across crates that have been rendered to the same output
10226         directory.
10227
10228
10229 Version 0.9 (2014-01-09)
10230 ==========================
10231
10232    * ~1800 changes, numerous bugfixes
10233
10234    * Language
10235       * The `float` type has been removed. Use `f32` or `f64` instead.
10236       * A new facility for enabling experimental features (feature gating) has
10237         been added, using the crate-level `#[feature(foo)]` attribute.
10238       * Managed boxes (@) are now behind a feature gate
10239         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
10240         standard library's `Gc` or `Rc` types instead.
10241       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
10242       * Jumping back to the top of a loop is now done with `continue` instead of
10243         `loop`.
10244       * Strings can no longer be mutated through index assignment.
10245       * Raw strings can be created via the basic `r"foo"` syntax or with matched
10246         hash delimiters, as in `r###"foo"###`.
10247       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
10248         called once.
10249       * The `&fn` type is now written `|args| -> ret` to match the literal form.
10250       * `@fn`s have been removed.
10251       * `do` only works with procs in order to make it obvious what the cost
10252         of `do` is.
10253       * Single-element tuple-like structs can no longer be dereferenced to
10254         obtain the inner value. A more comprehensive solution for overloading
10255         the dereference operator will be provided in the future.
10256       * The `#[link(...)]` attribute has been replaced with
10257         `#[crate_id = "name#vers"]`.
10258       * Empty `impl`s must be terminated with empty braces and may not be
10259         terminated with a semicolon.
10260       * Keywords are no longer allowed as lifetime names; the `self` lifetime
10261         no longer has any special meaning.
10262       * The old `fmt!` string formatting macro has been removed.
10263       * `printf!` and `printfln!` (old-style formatting) removed in favor of
10264         `print!` and `println!`.
10265       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
10266       * The `extern mod foo (name = "bar")` syntax has been removed. Use
10267         `extern mod foo = "bar"` instead.
10268       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
10269       * Macros can have attributes.
10270       * Macros can expand to items with attributes.
10271       * Macros can expand to multiple items.
10272       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
10273       * Comments may be nested.
10274       * Values automatically coerce to trait objects they implement, without
10275         an explicit `as`.
10276       * Enum discriminants are no longer an entire word but as small as needed to
10277         contain all the variants. The `repr` attribute can be used to override
10278         the discriminant size, as in `#[repr(int)]` for integer-sized, and
10279         `#[repr(C)]` to match C enums.
10280       * Non-string literals are not allowed in attributes (they never worked).
10281       * The FFI now supports variadic functions.
10282       * Octal numeric literals, as in `0o7777`.
10283       * The `concat!` syntax extension performs compile-time string concatenation.
10284       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
10285         removed as Rust no longer uses segmented stacks.
10286       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
10287       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
10288         not `*`; ignoring remaining fields of a struct is also done with `..`,
10289         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
10290       * `rustc` supports the "win64" calling convention via `extern "win64"`.
10291       * `rustc` supports the "system" calling convention, which defaults to the
10292         preferred convention for the target platform, "stdcall" on 32-bit Windows,
10293         "C" elsewhere.
10294       * The `type_overflow` lint (default: warn) checks literals for overflow.
10295       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
10296       * The `attribute_usage` lint (default: warn) warns about unknown
10297         attributes.
10298       * The `unknown_features` lint (default: warn) warns about unknown
10299         feature gates.
10300       * The `dead_code` lint (default: warn) checks for dead code.
10301       * Rust libraries can be linked statically to one another
10302       * `#[link_args]` is behind the `link_args` feature gate.
10303       * Native libraries are now linked with `#[link(name = "foo")]`
10304       * Native libraries can be statically linked to a rust crate
10305         (`#[link(name = "foo", kind = "static")]`).
10306       * Native OS X frameworks are now officially supported
10307         (`#[link(name = "foo", kind = "framework")]`).
10308       * The `#[thread_local]` attribute creates thread-local (not task-local)
10309         variables. Currently behind the `thread_local` feature gate.
10310       * The `return` keyword may be used in closures.
10311       * Types that can be copied via a memcpy implement the `Pod` kind.
10312       * The `cfg` attribute can now be used on struct fields and enum variants.
10313
10314    * Libraries
10315       * std: The `option` and `result` API's have been overhauled to make them
10316         simpler, more consistent, and more composable.
10317       * std: The entire `std::io` module has been replaced with one that is
10318         more comprehensive and that properly interfaces with the underlying
10319         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
10320         implemented.
10321       * std: `io::util` contains a number of useful implementations of
10322         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
10323         `ZeroReader`, `TeeReader`.
10324       * std: The reference counted pointer type `extra::rc` moved into std.
10325       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
10326         just a wrapper around it).
10327       * std: The `Either` type has been removed.
10328       * std: `fmt::Default` can be implemented for any type to provide default
10329         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
10330       * std: The `rand` API continues to be tweaked.
10331       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
10332         on failure in gdb, is now named `rust_fail`.
10333       * std: The `each_key` and `each_value` methods on `HashMap` have been
10334         replaced by the `keys` and `values` iterators.
10335       * std: Functions dealing with type size and alignment have moved from the
10336         `sys` module to the `mem` module.
10337       * std: The `path` module was written and API changed.
10338       * std: `str::from_utf8` has been changed to cast instead of allocate.
10339       * std: `starts_with` and `ends_with` methods added to vectors via the
10340         `ImmutableEqVector` trait, which is in the prelude.
10341       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
10342         if the index is out of bounds.
10343       * std: Task failure no longer propagates between tasks, as the model was
10344         complex, expensive, and incompatible with thread-based tasks.
10345       * std: The `Any` type can be used for dynamic typing.
10346       * std: `~Any` can be passed to the `fail!` macro and retrieved via
10347         `task::try`.
10348       * std: Methods that produce iterators generally do not have an `_iter`
10349         suffix now.
10350       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
10351         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
10352       * std: `util::ignore` renamed to `prelude::drop`.
10353       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
10354         trait.
10355       * std: `vec::raw` has seen a lot of cleanup and API changes.
10356       * std: The standard library no longer includes any C++ code, and very
10357         minimal C, eliminating the dependency on libstdc++.
10358       * std: Runtime scheduling and I/O functionality has been factored out into
10359         extensible interfaces and is now implemented by two different crates:
10360         libnative, for native threading and I/O; and libgreen, for green threading
10361         and I/O. This paves the way for using the standard library in more limited
10362         embedded environments.
10363       * std: The `comm` module has been rewritten to be much faster, have a
10364         simpler, more consistent API, and to work for both native and green
10365         threading.
10366       * std: All libuv dependencies have been moved into the rustuv crate.
10367       * native: New implementations of runtime scheduling on top of OS threads.
10368       * native: New native implementations of TCP, UDP, file I/O, process spawning,
10369         and other I/O.
10370       * green: The green thread scheduler and message passing types are almost
10371         entirely lock-free.
10372       * extra: The `flatpipes` module had bitrotted and was removed.
10373       * extra: All crypto functions have been removed and Rust now has a policy of
10374         not reimplementing crypto in the standard library. In the future crypto
10375         will be provided by external crates with bindings to established libraries.
10376       * extra: `c_vec` has been modernized.
10377       * extra: The `sort` module has been removed. Use the `sort` method on
10378         mutable slices.
10379
10380    * Tooling
10381       * The `rust` and `rusti` commands have been removed, due to lack of
10382         maintenance.
10383       * `rustdoc` was completely rewritten.
10384       * `rustdoc` can test code examples in documentation.
10385       * `rustpkg` can test packages with the argument, 'test'.
10386       * `rustpkg` supports arbitrary dependencies, including C libraries.
10387       * `rustc`'s support for generating debug info is improved again.
10388       * `rustc` has better error reporting for unbalanced delimiters.
10389       * `rustc`'s JIT support was removed due to bitrot.
10390       * Executables and static libraries can be built with LTO (-Z lto)
10391       * `rustc` adds a `--dep-info` flag for communicating dependencies to
10392         build tools.
10393
10394
10395 Version 0.8 (2013-09-26)
10396 ============================
10397
10398    * ~2200 changes, numerous bugfixes
10399
10400    * Language
10401       * The `for` loop syntax has changed to work with the `Iterator` trait.
10402       * At long last, unwinding works on Windows.
10403       * Default methods are ready for use.
10404       * Many trait inheritance bugs fixed.
10405       * Owned and borrowed trait objects work more reliably.
10406       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
10407       * rustc can omit emission of code for the `debug!` macro if it is passed
10408         `--cfg ndebug`
10409       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
10410         for foo.rs, then foo/mod.rs, and will generate an error when both are
10411         present.
10412       * Strings no longer contain trailing nulls. The new `std::c_str` module
10413         provides new mechanisms for converting to C strings.
10414       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
10415       * The FFI has been overhauled such that foreign functions are called directly,
10416         instead of through a stack-switching wrapper.
10417       * Calling a foreign function must be done through a Rust function with the
10418         `#[fixed_stack_segment]` attribute.
10419       * The `externfn!` macro can be used to declare both a foreign function and
10420         a `#[fixed_stack_segment]` wrapper at once.
10421       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
10422       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
10423       * `priv` is disallowed everywhere except for struct fields and enum variants.
10424       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
10425       * `ref` bindings in irrefutable patterns work correctly now.
10426       * `char` is now prevented from containing invalid code points.
10427       * Casting to `bool` is no longer allowed.
10428       * `\0` is now accepted as an escape in chars and strings.
10429       * `yield` is a reserved keyword.
10430       * `typeof` is a reserved keyword.
10431       * Crates may be imported by URL with `extern mod foo = "url";`.
10432       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
10433       * Static vectors can be initialized with repeating elements,
10434         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
10435       * Static structs can be initialized with functional record update,
10436         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
10437       * `cfg!` can be used to conditionally execute code based on the crate
10438         configuration, similarly to `#[cfg(...)]`.
10439       * The `unnecessary_qualification` lint detects unneeded module
10440         prefixes (default: allow).
10441       * Arithmetic operations have been implemented on the SIMD types in
10442         `std::unstable::simd`.
10443       * Exchange allocation headers were removed, reducing memory usage.
10444       * `format!` implements a completely new, extensible, and higher-performance
10445         string formatting system. It will replace `fmt!`.
10446       * `print!` and `println!` write formatted strings (using the `format!`
10447         extension) to stdout.
10448       * `write!` and `writeln!` write formatted strings (using the `format!`
10449         extension) to the new Writers in `std::rt::io`.
10450       * The library section in which a function or static is placed may
10451         be specified with `#[link_section = "..."]`.
10452       * The `proto!` syntax extension for defining bounded message protocols
10453         was removed.
10454       * `macro_rules!` is hygienic for `let` declarations.
10455       * The `#[export_name]` attribute specifies the name of a symbol.
10456       * `unreachable!` can be used to indicate unreachable code, and fails
10457         if executed.
10458
10459    * Libraries
10460       * std: Transitioned to the new runtime, written in Rust.
10461       * std: Added an experimental I/O library, `rt::io`, based on the new
10462         runtime.
10463       * std: A new generic `range` function was added to the prelude, replacing
10464         `uint::range` and friends.
10465       * std: `range_rev` no longer exists. Since range is an iterator it can be
10466         reversed with `range(lo, hi).invert()`.
10467       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
10468         renamed to `unwrap_or`.
10469       * std: The `iterator` module was renamed to `iter`.
10470       * std: Integral types now support the `checked_add`, `checked_sub`, and
10471         `checked_mul` operations for detecting overflow.
10472       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
10473         consistency.
10474       * std: Methods are standardizing on conventions for casting methods:
10475         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
10476         and cheap casts.
10477       * std: The `CString` type in `c_str` provides new ways to convert to and
10478         from C strings.
10479       * std: `DoubleEndedIterator` can yield elements in two directions.
10480       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
10481         two splices.
10482       * std: `str::from_bytes` renamed to `str::from_utf8`.
10483       * std: `pop_opt` and `shift_opt` methods added to vectors.
10484       * std: The task-local data interface no longer uses @, and keys are
10485         no longer function pointers.
10486       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
10487       * std: Added `SharedPort` to `comm`.
10488       * std: `Eq` has a default method for `ne`; only `eq` is required
10489         in implementations.
10490       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
10491         is required in implementations.
10492       * std: `is_utf8` performance is improved, impacting many string functions.
10493       * std: `os::MemoryMap` provides cross-platform mmap.
10494       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
10495         are not 'in-bounds' are considered undefined.
10496       * std: Many freestanding functions in `vec` removed in favor of methods.
10497       * std: Many freestanding functions on scalar types removed in favor of
10498         methods.
10499       * std: Many options to task builders were removed since they don't make
10500         sense in the new scheduler design.
10501       * std: More containers implement `FromIterator` so can be created by the
10502         `collect` method.
10503       * std: More complete atomic types in `unstable::atomics`.
10504       * std: `comm::PortSet` removed.
10505       * std: Mutating methods in the `Set` and `Map` traits have been moved into
10506         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
10507         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
10508         default implementations.
10509       * std: Various `from_str` functions were removed in favor of a generic
10510         `from_str` which is available in the prelude.
10511       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
10512       * extra: `dlist`, the doubly-linked list was modernized.
10513       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
10514       * extra: Added `glob` module, replacing `std::os::glob`.
10515       * extra: `rope` was removed.
10516       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
10517       * extra: `net`, and `timer` were removed. The experimental replacements
10518         are `std::rt::io::net` and `std::rt::io::timer`.
10519       * extra: Iterators implemented for `SmallIntMap`.
10520       * extra: Iterators implemented for `Bitv` and `BitvSet`.
10521       * extra: `SmallIntSet` removed. Use `BitvSet`.
10522       * extra: Performance of JSON parsing greatly improved.
10523       * extra: `semver` updated to SemVer 2.0.0.
10524       * extra: `term` handles more terminals correctly.
10525       * extra: `dbg` module removed.
10526       * extra: `par` module removed.
10527       * extra: `future` was cleaned up, with some method renames.
10528       * extra: Most free functions in `getopts` were converted to methods.
10529
10530    * Other
10531       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
10532       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
10533         similarly to gcc's `--march` flag.
10534       * rustc's performance compiling small crates is much better.
10535       * rustpkg has received many improvements.
10536       * rustpkg supports git tags as package IDs.
10537       * rustpkg builds into target-specific directories so it can be used for
10538         cross-compiling.
10539       * The number of concurrent test tasks is controlled by the environment
10540         variable RUST_TEST_TASKS.
10541       * The test harness can now report metrics for benchmarks.
10542       * All tools have man pages.
10543       * Programs compiled with `--test` now support the `-h` and `--help` flags.
10544       * The runtime uses jemalloc for allocations.
10545       * Segmented stacks are temporarily disabled as part of the transition to
10546         the new runtime. Stack overflows are possible!
10547       * A new documentation backend, rustdoc_ng, is available for use. It is
10548         still invoked through the normal `rustdoc` command.
10549
10550
10551 Version 0.7 (2013-07-03)
10552 =======================
10553
10554    * ~2000 changes, numerous bugfixes
10555
10556    * Language
10557       * `impl`s no longer accept a visibility qualifier. Put them on methods
10558         instead.
10559       * The borrow checker has been rewritten with flow-sensitivity, fixing
10560         many bugs and inconveniences.
10561       * The `self` parameter no longer implicitly means `&'self self`,
10562         and can be explicitly marked with a lifetime.
10563       * Overloadable compound operators (`+=`, etc.) have been temporarily
10564         removed due to bugs.
10565       * The `for` loop protocol now requires `for`-iterators to return `bool`
10566         so they compose better.
10567       * The `Durable` trait is replaced with the `'static` bounds.
10568       * Trait default methods work more often.
10569       * Structs with the `#[packed]` attribute have byte alignment and
10570         no padding between fields.
10571       * Type parameters bound by `Copy` must now be copied explicitly with
10572         the `copy` keyword.
10573       * It is now illegal to move out of a dereferenced unsafe pointer.
10574       * `Option<~T>` is now represented as a nullable pointer.
10575       * `@mut` does dynamic borrow checks correctly.
10576       * The `main` function is only detected at the topmost level of the crate.
10577         The `#[main]` attribute is still valid anywhere.
10578       * Struct fields may no longer be mutable. Use inherited mutability.
10579       * The `#[no_send]` attribute makes a type that would otherwise be
10580         `Send`, not.
10581       * The `#[no_freeze]` attribute makes a type that would otherwise be
10582         `Freeze`, not.
10583       * Unbounded recursion will abort the process after reaching the limit
10584         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
10585       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
10586         are never implicitly copyable.
10587       * `#[static_assert]` makes compile-time assertions about static bools.
10588       * At long last, 'argument modes' no longer exist.
10589       * The rarely used `use mod` statement no longer exists.
10590
10591    * Syntax extensions
10592       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
10593         argument list.
10594       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
10595         `Rand`, `Zero` and `ToStr` can all be automatically derived with
10596         `#[deriving(...)]`.
10597       * The `bytes!` macro returns a vector of bytes for string, u8, char,
10598         and unsuffixed integer literals.
10599
10600    * Libraries
10601       * The `core` crate was renamed to `std`.
10602       * The `std` crate was renamed to `extra`.
10603       * More and improved documentation.
10604       * std: `iterator` module for external iterator objects.
10605       * Many old-style (internal, higher-order function) iterators replaced by
10606         implementations of `Iterator`.
10607       * std: Many old internal vector and string iterators,
10608         incl. `any`, `all`. removed.
10609       * std: The `finalize` method of `Drop` renamed to `drop`.
10610       * std: The `drop` method now takes `&mut self` instead of `&self`.
10611       * std: The prelude no longer re-exports any modules, only types and traits.
10612       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
10613         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
10614       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
10615         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
10616       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
10617         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
10618       * std: Many types implement `Clone`.
10619       * std: `path` type renamed to `Path`.
10620       * std: `mut` module and `Mut` type removed.
10621       * std: Many standalone functions removed in favor of methods and iterators
10622         in `vec`, `str`. In the future methods will also work as functions.
10623       * std: `reinterpret_cast` removed. Use `transmute`.
10624       * std: ascii string handling in `std::ascii`.
10625       * std: `Rand` is implemented for ~/@.
10626       * std: `run` module for spawning processes overhauled.
10627       * std: Various atomic types added to `unstable::atomic`.
10628       * std: Various types implement `Zero`.
10629       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
10630       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
10631       * std: Added `os::mkdir_recursive`.
10632       * std: Added `os::glob` function performs filesystems globs.
10633       * std: `FuzzyEq` renamed to `ApproxEq`.
10634       * std: `Map` now defines `pop` and `swap` methods.
10635       * std: `Cell` constructors converted to static methods.
10636       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
10637       * extra: `flate` module moved from `std` to `extra`.
10638       * extra: `fileinput` module for iterating over a series of files.
10639       * extra: `Complex` number type and `complex` module.
10640       * extra: `Rational` number type and `rational` module.
10641       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
10642       * extra: `term` uses terminfo now, is more correct.
10643       * extra: `arc` functions converted to methods.
10644       * extra: Implementation of fixed output size variations of SHA-2.
10645
10646    * Tooling
10647       * `unused_variables` lint mode for unused variables (default: warn).
10648       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
10649         (default: warn).
10650       * `unused_mut` lint mode for identifying unused `mut` qualifiers
10651         (default: warn).
10652       * `dead_assignment` lint mode for unread variables (default: warn).
10653       * `unnecessary_allocation` lint mode detects some heap allocations that are
10654         immediately borrowed so could be written without allocating (default: warn).
10655       * `missing_doc` lint mode (default: allow).
10656       * `unreachable_code` lint mode (default: warn).
10657       * The `rusti` command has been rewritten and a number of bugs addressed.
10658       * rustc outputs in color on more terminals.
10659       * rustc accepts a `--link-args` flag to pass arguments to the linker.
10660       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
10661       * Compiling with `-g` will make the binary record information about
10662         dynamic borrowcheck failures for debugging.
10663       * rustdoc has a nicer stylesheet.
10664       * Various improvements to rustdoc.
10665       * Improvements to rustpkg (see the detailed release notes).
10666
10667
10668 Version 0.6 (2013-04-03)
10669 ========================
10670
10671    * ~2100 changes, numerous bugfixes
10672
10673    * Syntax changes
10674       * The self type parameter in traits is now spelled `Self`
10675       * The `self` parameter in trait and impl methods must now be explicitly
10676         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
10677       * Static methods no longer require the `static` keyword and instead
10678         are distinguished by the lack of a `self` parameter
10679       * Replaced the `Durable` trait with the `'static` lifetime
10680       * The old closure type syntax with the trailing sigil has been
10681         removed in favor of the more consistent leading sigil
10682       * `super` is a keyword, and may be prefixed to paths
10683       * Trait bounds are separated with `+` instead of whitespace
10684       * Traits are implemented with `impl Trait for Type`
10685         instead of `impl Type: Trait`
10686       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
10687       * The `export` keyword has finally been removed
10688       * The `move` keyword has been removed (see "Semantic changes")
10689       * The interior mutability qualifier on vectors, `[mut T]`, has been
10690         removed. Use `&mut [T]`, etc.
10691       * `mut` is no longer valid in `~mut T`. Use inherited mutability
10692       * `fail` is no longer a keyword. Use `fail!()`
10693       * `assert` is no longer a keyword. Use `assert!()`
10694       * `log` is no longer a keyword. use `debug!`, etc.
10695       * 1-tuples may be represented as `(T,)`
10696       * Struct fields may no longer be `mut`. Use inherited mutability,
10697         `@mut T`, `core::mut` or `core::cell`
10698       * `extern mod { ... }` is no longer valid syntax for foreign
10699         function modules. Use extern blocks: `extern { ... }`
10700       * Newtype enums removed. Use tuple-structs.
10701       * Trait implementations no longer support visibility modifiers
10702       * Pattern matching over vectors improved and expanded
10703       * `const` renamed to `static` to correspond to lifetime name,
10704         and make room for future `static mut` unsafe mutable globals.
10705       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
10706       * `Clone` implementations can be automatically generated with
10707         `#[deriving(Clone)]`
10708       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
10709         instead of `foo as Bar`.
10710       * Fixed length vector types are now written as `[int, .. 3]`
10711         instead of `[int * 3]`.
10712       * Fixed length vector types can express the length as a constant
10713         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
10714
10715    * Semantic changes
10716       * Types with owned pointers or custom destructors move by default,
10717         eliminating the `move` keyword
10718       * All foreign functions are considered unsafe
10719       * &mut is now unaliasable
10720       * Writes to borrowed @mut pointers are prevented dynamically
10721       * () has size 0
10722       * The name of the main function can be customized using #[main]
10723       * The default type of an inferred closure is &fn instead of @fn
10724       * `use` statements may no longer be "chained" - they cannot import
10725         identifiers imported by previous `use` statements
10726       * `use` statements are crate relative, importing from the "top"
10727         of the crate by default. Paths may be prefixed with `super::`
10728         or `self::` to change the search behavior.
10729       * Method visibility is inherited from the implementation declaration
10730       * Structural records have been removed
10731       * Many more types can be used in static items, including enums
10732         'static-lifetime pointers and vectors
10733       * Pattern matching over vectors improved and expanded
10734       * Typechecking of closure types has been overhauled to
10735         improve inference and eliminate unsoundness
10736       * Macros leave scope at the end of modules, unless that module is
10737         tagged with #[macro_escape]
10738
10739    * Libraries
10740       * Added big integers to `std::bigint`
10741       * Removed `core::oldcomm` module
10742       * Added pipe-based `core::comm` module
10743       * Numeric traits have been reorganized under `core::num`
10744       * `vec::slice` finally returns a slice
10745       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
10746       * Containers reorganized around traits in `core::container`
10747       * `core::dvec` removed, `~[T]` is a drop-in replacement
10748       * `core::send_map` renamed to `core::hashmap`
10749       * `std::map` removed; replaced with `core::hashmap`
10750       * `std::treemap` reimplemented as an owned balanced tree
10751       * `std::deque` and `std::smallintmap` reimplemented as owned containers
10752       * `core::trie` added as a fast ordered map for integer keys
10753       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
10754       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
10755         overload the comparison operators, whereas `TotalOrd` is used
10756         by certain container types
10757
10758    * Other
10759       * Replaced the 'cargo' package manager with 'rustpkg'
10760       * Added all-purpose 'rust' tool
10761       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
10762       * rustc now *attempts* to offer spelling suggestions
10763       * Improved support for ARM and Android
10764       * Preliminary MIPS backend
10765       * Improved foreign function ABI implementation for x86, x86_64
10766       * Various memory usage improvements
10767       * Rust code may be embedded in foreign code under limited circumstances
10768       * Inline assembler supported by new asm!() syntax extension.
10769
10770
10771 Version 0.5 (2012-12-21)
10772 ===========================
10773
10774    * ~900 changes, numerous bugfixes
10775
10776    * Syntax changes
10777       * Removed `<-` move operator
10778       * Completed the transition from the `#fmt` extension syntax to `fmt!`
10779       * Removed old fixed length vector syntax - `[T]/N`
10780       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
10781       * Macros may now expand to items and statements
10782       * `a.b()` is always parsed as a method call, never as a field projection
10783       * `Eq` and `IterBytes` implementations can be automatically generated
10784         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
10785       * Removed the special crate language for `.rc` files
10786       * Function arguments may consist of any irrefutable pattern
10787
10788    * Semantic changes
10789       * `&` and `~` pointers may point to objects
10790       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
10791       * Enum variants may be structs
10792       * Destructors can be added to all nominal types with the Drop trait
10793       * Structs and nullary enum variants may be constants
10794       * Values that cannot be implicitly copied are now automatically moved
10795         without writing `move` explicitly
10796       * `&T` may now be coerced to `*T`
10797       * Coercions happen in `let` statements as well as function calls
10798       * `use` statements now take crate-relative paths
10799       * The module and type namespaces have been merged so that static
10800         method names can be resolved under the trait in which they are
10801         declared
10802
10803    * Improved support for language features
10804       * Trait inheritance works in many scenarios
10805       * More support for explicit self arguments in methods - `self`, `&self`
10806         `@self`, and `~self` all generally work as expected
10807       * Static methods work in more situations
10808       * Experimental: Traits may declare default methods for the implementations
10809         to use
10810
10811    * Libraries
10812       * New condition handling system in `core::condition`
10813       * Timsort added to `std::sort`
10814       * New priority queue, `std::priority_queue`
10815       * Pipes for serializable types, `std::flatpipes'
10816       * Serialization overhauled to be trait-based
10817       * Expanded `getopts` definitions
10818       * Moved futures to `std`
10819       * More functions are pure now
10820       * `core::comm` renamed to `oldcomm`. Still deprecated
10821       * `rustdoc` and `cargo` are libraries now
10822
10823    * Misc
10824       * Added a preliminary REPL, `rusti`
10825       * License changed from MIT to dual MIT/APL2
10826
10827
10828 Version 0.4 (2012-10-15)
10829 ==========================
10830
10831    * ~2000 changes, numerous bugfixes
10832
10833    * Syntax
10834       * All keywords are now strict and may not be used as identifiers anywhere
10835       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
10836         'of', 'with', 'to', 'class'.
10837       * Classes are replaced with simpler structs
10838       * Explicit method self types
10839       * `ret` became `return` and `alt` became `match`
10840       * `import` is now `use`; `use is now `extern mod`
10841       * `extern mod { ... }` is now `extern { ... }`
10842       * `use mod` is the recommended way to import modules
10843       * `pub` and `priv` replace deprecated export lists
10844       * The syntax of `match` pattern arms now uses fat arrow (=>)
10845       * `main` no longer accepts an args vector; use `os::args` instead
10846
10847    * Semantics
10848       * Trait implementations are now coherent, ala Haskell typeclasses
10849       * Trait methods may be static
10850       * Argument modes are deprecated
10851       * Borrowed pointers are much more mature and recommended for use
10852       * Strings and vectors in the static region are stored in constant memory
10853       * Typestate was removed
10854       * Resolution rewritten to be more reliable
10855       * Support for 'dual-mode' data structures (freezing and thawing)
10856
10857    * Libraries
10858       * Most binary operators can now be overloaded via the traits in
10859         `core::ops'
10860       * `std::net::url` for representing URLs
10861       * Sendable hash maps in `core::send_map`
10862       * `core::task' gained a (currently unsafe) task-local storage API
10863
10864    * Concurrency
10865       * An efficient new intertask communication primitive called the pipe,
10866         along with a number of higher-level channel types, in `core::pipes`
10867       * `std::arc`, an atomically reference counted, immutable, shared memory
10868         type
10869       * `std::sync`, various exotic synchronization tools based on arcs and pipes
10870       * Futures are now based on pipes and sendable
10871       * More robust linked task failure
10872       * Improved task builder API
10873
10874    * Other
10875       * Improved error reporting
10876       * Preliminary JIT support
10877       * Preliminary work on precise GC
10878       * Extensive architectural improvements to rustc
10879       * Begun a transition away from buggy C++-based reflection (shape) code to
10880         Rust-based (visitor) code
10881       * All hash functions and tables converted to secure, randomized SipHash
10882
10883
10884 Version 0.3  (2012-07-12)
10885 ========================
10886
10887    * ~1900 changes, numerous bugfixes
10888
10889    * New coding conveniences
10890       * Integer-literal suffix inference
10891       * Per-item control over warnings, errors
10892       * #[cfg(windows)] and #[cfg(unix)] attributes
10893       * Documentation comments
10894       * More compact closure syntax
10895       * 'do' expressions for treating higher-order functions as
10896         control structures
10897       * *-patterns (wildcard extended to all constructor fields)
10898
10899    * Semantic cleanup
10900       * Name resolution pass and exhaustiveness checker rewritten
10901       * Region pointers and borrow checking supersede alias
10902         analysis
10903       * Init-ness checking is now provided by a region-based liveness
10904         pass instead of the typestate pass; same for last-use analysis
10905       * Extensive work on region pointers
10906
10907    * Experimental new language features
10908       * Slices and fixed-size, interior-allocated vectors
10909       * #!-comments for lang versioning, shell execution
10910       * Destructors and iface implementation for classes;
10911         type-parameterized classes and class methods
10912       * 'const' type kind for types that can be used to implement
10913         shared-memory concurrency patterns
10914
10915    * Type reflection
10916
10917    * Removal of various obsolete features
10918       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
10919                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
10920
10921       * Constructs: do-while loops ('do' repurposed), fn binding,
10922                     resources (replaced by destructors)
10923
10924    * Compiler reorganization
10925       * Syntax-layer of compiler split into separate crate
10926       * Clang (from LLVM project) integrated into build
10927       * Typechecker split into sub-modules
10928
10929    * New library code
10930       * New time functions
10931       * Extension methods for many built-in types
10932       * Arc: atomic-refcount read-only / exclusive-use shared cells
10933       * Par: parallel map and search routines
10934       * Extensive work on libuv interface
10935       * Much vector code moved to libraries
10936       * Syntax extensions: #line, #col, #file, #mod, #stringify,
10937         #include, #include_str, #include_bin
10938
10939    * Tool improvements
10940       * Cargo automatically resolves dependencies
10941
10942
10943 Version 0.2  (2012-03-29)
10944 =========================
10945
10946    * >1500 changes, numerous bugfixes
10947
10948    * New docs and doc tooling
10949
10950    * New port: FreeBSD x86_64
10951
10952    * Compilation model enhancements
10953       * Generics now specialized, multiply instantiated
10954       * Functions now inlined across separate crates
10955
10956    * Scheduling, stack and threading fixes
10957       * Noticeably improved message-passing performance
10958       * Explicit schedulers
10959       * Callbacks from C
10960       * Helgrind clean
10961
10962    * Experimental new language features
10963       * Operator overloading
10964       * Region pointers
10965       * Classes
10966
10967    * Various language extensions
10968       * C-callback function types: 'crust fn ...'
10969       * Infinite-loop construct: 'loop { ... }'
10970       * Shorten 'mutable' to 'mut'
10971       * Required mutable-local qualifier: 'let mut ...'
10972       * Basic glob-exporting: 'export foo::*;'
10973       * Alt now exhaustive, 'alt check' for runtime-checked
10974       * Block-function form of 'for' loop, with 'break' and 'ret'.
10975
10976    * New library code
10977       * AST quasi-quote syntax extension
10978       * Revived libuv interface
10979       * New modules: core::{future, iter}, std::arena
10980       * Merged per-platform std::{os*, fs*} to core::{libc, os}
10981       * Extensive cleanup, regularization in libstd, libcore
10982
10983
10984 Version 0.1  (2012-01-20)
10985 ===============================
10986
10987    * Most language features work, including:
10988       * Unique pointers, unique closures, move semantics
10989       * Interface-constrained generics
10990       * Static interface dispatch
10991       * Stack growth
10992       * Multithread task scheduling
10993       * Typestate predicates
10994       * Failure unwinding, destructors
10995       * Pattern matching and destructuring assignment
10996       * Lightweight block-lambda syntax
10997       * Preliminary macro-by-example
10998
10999    * Compiler works with the following configurations:
11000       * Linux: x86 and x86_64 hosts and targets
11001       * macOS: x86 and x86_64 hosts and targets
11002       * Windows: x86 hosts and targets
11003
11004    * Cross compilation / multi-target configuration supported.
11005
11006    * Preliminary API-documentation and package-management tools included.
11007
11008 Known issues:
11009
11010    * Documentation is incomplete.
11011
11012    * Performance is below intended target.
11013
11014    * Standard library APIs are subject to extensive change, reorganization.
11015
11016    * Language-level versioning is not yet operational - future code will
11017      break unexpectedly.