RELEASES.md

   1 Version 1.58.0 (2022-01-13)
   2 ==========================
   3
   4 Language
   5 --------
   6
   7 - [Format strings can now capture arguments simply by writing `{ident}` in the string.][90473] This works in all macros accepting format strings. Support for this in `panic!` (`panic!("{ident}")`) requires the 2021 edition; panic invocations in previous editions that appear to be trying to use this will result in a warning lint about not having the intended effect.
   8 - [`*const T` pointers can now be dereferenced in const contexts.][89551]
   9 - [The rules for when a generic struct implements `Unsize` have been relaxed.][90417]
  10
  11 Compiler
  12 --------
  13
  14 - [Add LLVM CFI support to the Rust compiler][89652]
  15 - [Stabilize -Z strip as -C strip][90058]. Note that while release builds already don't add debug symbols for the code you compile, the compiled standard library that ships with Rust includes debug symbols, so you may want to use the `strip` option to remove these symbols to produce smaller release binaries. Note that this release only includes support in rustc, not directly in cargo.
  16 - [Add support for LLVM coverage mapping format versions 5 and 6][91207]
  17 - [Emit LLVM optimization remarks when enabled with `-Cremark`][90833]
  18 - [Update the minimum external LLVM to 12][90175]
  19 - [Add `x86_64-unknown-none` at Tier 3*][89062]
  20 - [Build musl dist artifacts with debuginfo enabled][90733]. When building release binaries using musl, you may want to use the newly stabilized strip option to remove these debug symbols, reducing the size of your binaries.
  21 - [Don't abort compilation after giving a lint error][87337]
  22 - [Error messages point at the source of trait bound obligations in more places][89580]
  23
  24 \* Refer to Rust's [platform support page][platform-support-doc] for more
  25    information on Rust's tiered platform support.
  26
  27 Libraries
  28 ---------
  29
  30 - [All remaining functions in the standard library have `#[must_use]` annotations where appropriate][89692], producing a warning when ignoring their return value. This helps catch mistakes such as expecting a function to mutate a value in place rather than return a new value.
  31 - [Paths are automatically canonicalized on Windows for operations that support it][89174]
  32 - [Re-enable debug checks for `copy` and `copy_nonoverlapping`][90041]
  33 - [Implement `RefUnwindSafe` for `Rc<T>`][87467]
  34 - [Make RSplit<T, P>: Clone not require T: Clone][90117]
  35 - [Implement `Termination` for `Result<Infallible, E>`][88601]. This allows writing `fn main() -> Result<Infallible, ErrorType>`, for a program whose successful exits never involve returning from `main` (for instance, a program that calls `exit`, or that uses `exec` to run another program).
  36
  37 Stabilized APIs
  38 ---------------
  39
  40 - [`Metadata::is_symlink`]
  41 - [`Path::is_symlink`]
  42 - [`{integer}::saturating_div`]
  43 - [`Option::unwrap_unchecked`]
  44 - [`Result::unwrap_unchecked`]
  45 - [`Result::unwrap_err_unchecked`]
  46 - [`NonZero{unsigned}::is_power_of_two`]
  47
  48 These APIs are now usable in const contexts:
  49
  50 - [`Duration::new`]
  51 - [`Duration::checked_add`]
  52 - [`Duration::saturating_add`]
  53 - [`Duration::checked_sub`]
  54 - [`Duration::saturating_sub`]
  55 - [`Duration::checked_mul`]
  56 - [`Duration::saturating_mul`]
  57 - [`Duration::checked_div`]
  58 - [`MaybeUninit::as_ptr`]
  59 - [`MaybeUninit::as_mut_ptr`]
  60 - [`MaybeUninit::assume_init`]
  61 - [`MaybeUninit::assume_init_ref`]
  62
  63 Cargo
  64 -----
  65
  66 - [Add --message-format for install command][cargo/10107]
  67 - [Warn when alias shadows external subcommand][cargo/10082]
  68
  69 Rustdoc
  70 -------
  71
  72 - [Show all Deref implementations recursively in rustdoc][90183]
  73 - [Use computed visibility in rustdoc][88447]
  74
  75 Compatibility Notes
  76 -------------------
  77
  78 - [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.
  79 - Windows: [`std::process::Command` will no longer search the current directory for executables.][87704]
  80 - [All proc-macro backward-compatibility lints are now deny-by-default.][88041]
  81 - [proc_macro: Append .0 to unsuffixed float if it would otherwise become int token][90297]
  82 - [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.
  83 - [rustdoc now rejects some unexpected semicolons in doctests][91026]
  84
  85 Internal Changes
  86 ----------------
  87
  88 These changes provide no direct user facing benefits, but represent significant
  89 improvements to the internals and overall performance of rustc
  90 and related tools.
  91
  92 - [Implement coherence checks for negative trait impls][90104]
  93 - [Add rustc lint, warning when iterating over hashmaps][89558]
  94 - [Optimize live point computation][90491]
  95 - [Enable verification for 1/32nd of queries loaded from disk][90361]
  96 - [Implement version of normalize_erasing_regions that allows for normalization failure][91255]
  97
  98 [87337]: https://github.com/rust-lang/rust/pull/87337/
  99 [87467]: https://github.com/rust-lang/rust/pull/87467/
 100 [87704]: https://github.com/rust-lang/rust/pull/87704/
 101 [88041]: https://github.com/rust-lang/rust/pull/88041/
 102 [88300]: https://github.com/rust-lang/rust/pull/88300/
 103 [88447]: https://github.com/rust-lang/rust/pull/88447/
 104 [88601]: https://github.com/rust-lang/rust/pull/88601/
 105 [88624]: https://github.com/rust-lang/rust/pull/88624/
 106 [89062]: https://github.com/rust-lang/rust/pull/89062/
 107 [89174]: https://github.com/rust-lang/rust/pull/89174/
 108 [89542]: https://github.com/rust-lang/rust/pull/89542/
 109 [89551]: https://github.com/rust-lang/rust/pull/89551/
 110 [89558]: https://github.com/rust-lang/rust/pull/89558/
 111 [89580]: https://github.com/rust-lang/rust/pull/89580/
 112 [89652]: https://github.com/rust-lang/rust/pull/89652/
 113 [89677]: https://github.com/rust-lang/rust/pull/89677/
 114 [89951]: https://github.com/rust-lang/rust/pull/89951/
 115 [90041]: https://github.com/rust-lang/rust/pull/90041/
 116 [90058]: https://github.com/rust-lang/rust/pull/90058/
 117 [90104]: https://github.com/rust-lang/rust/pull/90104/
 118 [90117]: https://github.com/rust-lang/rust/pull/90117/
 119 [90175]: https://github.com/rust-lang/rust/pull/90175/
 120 [90183]: https://github.com/rust-lang/rust/pull/90183/
 121 [90297]: https://github.com/rust-lang/rust/pull/90297/
 122 [90329]: https://github.com/rust-lang/rust/pull/90329/
 123 [90361]: https://github.com/rust-lang/rust/pull/90361/
 124 [90417]: https://github.com/rust-lang/rust/pull/90417/
 125 [90473]: https://github.com/rust-lang/rust/pull/90473/
 126 [90491]: https://github.com/rust-lang/rust/pull/90491/
 127 [90733]: https://github.com/rust-lang/rust/pull/90733/
 128 [90833]: https://github.com/rust-lang/rust/pull/90833/
 129 [90846]: https://github.com/rust-lang/rust/pull/90846/
 130 [90896]: https://github.com/rust-lang/rust/pull/90896/
 131 [91026]: https://github.com/rust-lang/rust/pull/91026/
 132 [91207]: https://github.com/rust-lang/rust/pull/91207/
 133 [91255]: https://github.com/rust-lang/rust/pull/91255/
 134 [91301]: https://github.com/rust-lang/rust/pull/91301/
 135 [cargo/10082]: https://github.com/rust-lang/cargo/pull/10082/
 136 [cargo/10107]: https://github.com/rust-lang/cargo/pull/10107/
 137 [`Metadata::is_symlink`]: https://doc.rust-lang.org/stable/std/fs/struct.Metadata.html#method.is_symlink
 138 [`Path::is_symlink`]: https://doc.rust-lang.org/stable/std/path/struct.Path.html#method.is_symlink
 139 [`{integer}::saturating_div`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.saturating_div
 140 [`Option::unwrap_unchecked`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.unwrap_unchecked
 141 [`Result::unwrap_unchecked`]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.unwrap_unchecked
 142 [`Result::unwrap_err_unchecked`]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.unwrap_err_unchecked
 143 [`NonZero{unsigned}::is_power_of_two`]: https://doc.rust-lang.org/stable/std/num/struct.NonZeroU8.html#method.is_power_of_two
 144 [`unix::process::ExitStatusExt::core_dumped`]: https://doc.rust-lang.org/stable/std/os/unix/process/trait.ExitStatusExt.html#tymethod.core_dumped
 145 [`unix::process::ExitStatusExt::stopped_signal`]: https://doc.rust-lang.org/stable/std/os/unix/process/trait.ExitStatusExt.html#tymethod.stopped_signal
 146 [`unix::process::ExitStatusExt::continued`]: https://doc.rust-lang.org/stable/std/os/unix/process/trait.ExitStatusExt.html#tymethod.continued
 147 [`unix::process::ExitStatusExt::into_raw`]: https://doc.rust-lang.org/stable/std/os/unix/process/trait.ExitStatusExt.html#tymethod.into_raw
 148 [`Duration::new`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.new
 149 [`Duration::checked_add`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.checked_add
 150 [`Duration::saturating_add`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.saturating_add
 151 [`Duration::checked_sub`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.checked_sub
 152 [`Duration::saturating_sub`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.saturating_sub
 153 [`Duration::checked_mul`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.checked_mul
 154 [`Duration::saturating_mul`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.saturating_mul
 155 [`Duration::checked_div`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.checked_div
 156 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.as_secs_f64
 157 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.as_secs_f32
 158 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.from_secs_f64
 159 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.from_secs_f32
 160 [`Duration::mul_f64`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.mul_f64
 161 [`Duration::mul_f32`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.mul_f32
 162 [`Duration::div_f64`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.div_f64
 163 [`Duration::div_f32`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.div_f32
 164 [`Duration::div_duration_f64`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.div_duration_f64
 165 [`Duration::div_duration_f32`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.div_duration_f32
 166 [`MaybeUninit::as_ptr`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.as_ptr
 167 [`MaybeUninit::as_mut_ptr`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.as_mut_ptr
 168 [`MaybeUninit::assume_init`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init
 169 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
 170
 171 Version 1.57.0 (2021-12-02)
 172 ==========================
 173
 174 Language
 175 --------
 176
 177 - [Macro attributes may follow `#[derive]` and will see the original (pre-`cfg`) input.][87220]
 178 - [Accept curly-brace macros in expressions, like `m!{ .. }.method()` and `m!{ .. }?`.][88690]
 179 - [Allow panicking in constant evaluation.][89508]
 180
 181 Compiler
 182 --------
 183
 184 - [Create more accurate debuginfo for vtables.][89597]
 185 - [Add `armv6k-nintendo-3ds` at Tier 3\*.][88529]
 186 - [Add `armv7-unknown-linux-uclibceabihf` at Tier 3\*.][88952]
 187 - [Add `m68k-unknown-linux-gnu` at Tier 3\*.][88321]
 188 - [Add SOLID targets at Tier 3\*:][86191] `aarch64-kmc-solid_asp3`, `armv7a-kmc-solid_asp3-eabi`, `armv7a-kmc-solid_asp3-eabihf`
 189
 190 \* Refer to Rust's [platform support page][platform-support-doc] for more
 191    information on Rust's tiered platform support.
 192
 193 Libraries
 194 ---------
 195
 196 - [Avoid allocations and copying in `Vec::leak`][89337]
 197 - [Add `#[repr(i8)]` to `Ordering`][89507]
 198 - [Optimize `File::read_to_end` and `read_to_string`][89582]
 199 - [Update to Unicode 14.0][89614]
 200 - [Many more functions are marked `#[must_use]`][89692], producing a warning
 201   when ignoring their return value. This helps catch mistakes such as expecting
 202   a function to mutate a value in place rather than return a new value.
 203
 204 Stabilised APIs
 205 ---------------
 206
 207 - [`[T; N]::as_mut_slice`][`array::as_mut_slice`]
 208 - [`[T; N]::as_slice`][`array::as_slice`]
 209 - [`collections::TryReserveError`]
 210 - [`HashMap::try_reserve`]
 211 - [`HashSet::try_reserve`]
 212 - [`String::try_reserve`]
 213 - [`String::try_reserve_exact`]
 214 - [`Vec::try_reserve`]
 215 - [`Vec::try_reserve_exact`]
 216 - [`VecDeque::try_reserve`]
 217 - [`VecDeque::try_reserve_exact`]
 218 - [`Iterator::map_while`]
 219 - [`iter::MapWhile`]
 220 - [`proc_macro::is_available`]
 221 - [`Command::get_program`]
 222 - [`Command::get_args`]
 223 - [`Command::get_envs`]
 224 - [`Command::get_current_dir`]
 225 - [`CommandArgs`]
 226 - [`CommandEnvs`]
 227
 228 These APIs are now usable in const contexts:
 229
 230 - [`hint::unreachable_unchecked`]
 231
 232 Cargo
 233 -----
 234
 235 - [Stabilize custom profiles][cargo/9943]
 236
 237 Compatibility notes
 238 -------------------
 239
 240 Internal changes
 241 ----------------
 242 These changes provide no direct user facing benefits, but represent significant
 243 improvements to the internals and overall performance of rustc
 244 and related tools.
 245
 246 - [Added an experimental backend for codegen with `libgccjit`.][87260]
 247
 248 [86191]: https://github.com/rust-lang/rust/pull/86191/
 249 [87220]: https://github.com/rust-lang/rust/pull/87220/
 250 [87260]: https://github.com/rust-lang/rust/pull/87260/
 251 [88243]: https://github.com/rust-lang/rust/pull/88243/
 252 [88321]: https://github.com/rust-lang/rust/pull/88321/
 253 [88529]: https://github.com/rust-lang/rust/pull/88529/
 254 [88690]: https://github.com/rust-lang/rust/pull/88690/
 255 [88952]: https://github.com/rust-lang/rust/pull/88952/
 256 [89337]: https://github.com/rust-lang/rust/pull/89337/
 257 [89507]: https://github.com/rust-lang/rust/pull/89507/
 258 [89508]: https://github.com/rust-lang/rust/pull/89508/
 259 [89582]: https://github.com/rust-lang/rust/pull/89582/
 260 [89597]: https://github.com/rust-lang/rust/pull/89597/
 261 [89614]: https://github.com/rust-lang/rust/pull/89614/
 262 [89692]: https://github.com/rust-lang/rust/issues/89692/
 263 [cargo/9943]: https://github.com/rust-lang/cargo/pull/9943/
 264 [`array::as_mut_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_mut_slice
 265 [`array::as_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_slice
 266 [`collections::TryReserveError`]: https://doc.rust-lang.org/std/collections/struct.TryReserveError.html
 267 [`HashMap::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_map/struct.HashMap.html#method.try_reserve
 268 [`HashSet::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_set/struct.HashSet.html#method.try_reserve
 269 [`String::try_reserve`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve
 270 [`String::try_reserve_exact`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve_exact
 271 [`Vec::try_reserve`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve
 272 [`Vec::try_reserve_exact`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve_exact
 273 [`VecDeque::try_reserve`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve
 274 [`VecDeque::try_reserve_exact`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve_exact
 275 [`Iterator::map_while`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.map_while
 276 [`iter::MapWhile`]: https://doc.rust-lang.org/std/iter/struct.MapWhile.html
 277 [`proc_macro::is_available`]: https://doc.rust-lang.org/proc_macro/fn.is_available.html
 278 [`Command::get_program`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_program
 279 [`Command::get_args`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_args
 280 [`Command::get_envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_envs
 281 [`Command::get_current_dir`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_current_dir
 282 [`CommandArgs`]: https://doc.rust-lang.org/std/process/struct.CommandArgs.html
 283 [`CommandEnvs`]: https://doc.rust-lang.org/std/process/struct.CommandEnvs.html
 284
 285 Version 1.56.1 (2021-11-01)
 286 ===========================
 287
 288 - New lints to detect the presence of bidirectional-override Unicode
 289   codepoints in the compiled source code ([CVE-2021-42574])
 290
 291 [CVE-2021-42574]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-42574
 292
 293 Version 1.56.0 (2021-10-21)
 294 ========================
 295
 296 Language
 297 --------
 298
 299 - [The 2021 Edition is now stable.][rust#88100]
 300   See [the edition guide][rust-2021-edition-guide] for more details.
 301 - [The pattern in `binding @ pattern` can now also introduce new bindings.][rust#85305]
 302 - [Union field access is permitted in `const fn`.][rust#85769]
 303
 304 [rust-2021-edition-guide]: https://doc.rust-lang.org/nightly/edition-guide/rust-2021/index.html
 305
 306 Compiler
 307 --------
 308
 309 - [Upgrade to LLVM 13.][rust#87570]
 310 - [Support memory, address, and thread sanitizers on aarch64-unknown-freebsd.][rust#88023]
 311 - [Allow specifying a deployment target version for all iOS targets][rust#87699]
 312 - [Warnings can be forced on with `--force-warn`.][rust#87472]
 313   This feature is primarily intended for usage by `cargo fix`, rather than end users.
 314 - [Promote `aarch64-apple-ios-sim` to Tier 2\*.][rust#87760]
 315 - [Add `powerpc-unknown-freebsd` at Tier 3\*.][rust#87370]
 316 - [Add `riscv32imc-esp-espidf` at Tier 3\*.][rust#87666]
 317
 318 \* Refer to Rust's [platform support page][platform-support-doc] for more
 319 information on Rust's tiered platform support.
 320
 321 Libraries
 322 ---------
 323
 324 - [Allow writing of incomplete UTF-8 sequences via stdout/stderr on Windows.][rust#83342]
 325   The Windows console still requires valid Unicode, but this change allows
 326   splitting a UTF-8 character across multiple write calls. This allows, for
 327   instance, programs that just read and write data buffers (e.g. copying a file
 328   to stdout) without regard for Unicode or character boundaries.
 329 - [Prefer `AtomicU{64,128}` over Mutex for Instant backsliding protection.][rust#83093]
 330   For this use case, atomics scale much better under contention.
 331 - [Implement `Extend<(A, B)>` for `(Extend<A>, Extend<B>)`][rust#85835]
 332 - [impl Default, Copy, Clone for std::io::Sink and std::io::Empty][rust#86744]
 333 - [`impl From<[(K, V); N]>` for all collections.][rust#84111]
 334 - [Remove `P: Unpin` bound on impl Future for Pin.][rust#81363]
 335 - [Treat invalid environment variable names as non-existent.][rust#86183]
 336   Previously, the environment functions would panic if given a variable name
 337   with an internal null character or equal sign (`=`). Now, these functions will
 338   just treat such names as non-existent variables, since the OS cannot represent
 339   the existence of a variable with such a name.
 340
 341 Stabilised APIs
 342 ---------------
 343
 344 - [`std::os::unix::fs::chroot`]
 345 - [`UnsafeCell::raw_get`]
 346 - [`BufWriter::into_parts`]
 347 - [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]
 348   These APIs were previously stable in `std`, but are now also available in `core`.
 349 - [`Vec::shrink_to`]
 350 - [`String::shrink_to`]
 351 - [`OsString::shrink_to`]
 352 - [`PathBuf::shrink_to`]
 353 - [`BinaryHeap::shrink_to`]
 354 - [`VecDeque::shrink_to`]
 355 - [`HashMap::shrink_to`]
 356 - [`HashSet::shrink_to`]
 357
 358 These APIs are now usable in const contexts:
 359
 360 - [`std::mem::transmute`]
 361 - [`[T]::first`][`slice::first`]
 362 - [`[T]::split_first`][`slice::split_first`]
 363 - [`[T]::last`][`slice::last`]
 364 - [`[T]::split_last`][`slice::split_last`]
 365
 366 Cargo
 367 -----
 368
 369 - [Cargo supports specifying a minimum supported Rust version in Cargo.toml.][`rust-version`]
 370   This has no effect at present on dependency version selection.
 371   We encourage crates to specify their minimum supported Rust version, and we encourage CI systems
 372   that support Rust code to include a crate's specified minimum version in the test matrix for that
 373   crate by default.
 374
 375 Compatibility notes
 376 -------------------
 377
 378 - [Update to new argument parsing rules on Windows.][rust#87580]
 379   This adjusts Rust's standard library to match the behavior of the standard
 380   libraries for C/C++. The rules have changed slightly over time, and this PR
 381   brings us to the latest set of rules (changed in 2008).
 382 - [Disallow the aapcs calling convention on aarch64][rust#88399]
 383   This was already not supported by LLVM; this change surfaces this lack of
 384   support with a better error message.
 385 - [Make `SEMICOLON_IN_EXPRESSIONS_FROM_MACROS` warn by default][rust#87385]
 386 - [Warn when an escaped newline skips multiple lines.][rust#87671]
 387 - [Calls to `libc::getpid` / `std::process::id` from `Command::pre_exec`
 388    may return different values on glibc <= 2.24.][rust#81825]
 389    Rust now invokes the `clone3` system call directly, when available, to use new functionality
 390    available via that system call. Older versions of glibc cache the result of `getpid`, and only
 391    update that cache when calling glibc's clone/fork functions, so a direct system call bypasses
 392    that cache update. glibc 2.25 and newer no longer cache `getpid` for exactly this reason.
 393
 394 Internal changes
 395 ----------------
 396 These changes provide no direct user facing benefits, but represent significant
 397 improvements to the internals and overall performance of rustc
 398 and related tools.
 399
 400 - [LLVM is compiled with PGO in published x86_64-unknown-linux-gnu artifacts.][rust#88069]
 401   This improves the performance of most Rust builds.
 402 - [Unify representation of macros in internal data structures.][rust#88019]
 403   This change fixes a host of bugs with the handling of macros by the compiler,
 404   as well as rustdoc.
 405
 406 [`std::os::unix::fs::chroot`]: https://doc.rust-lang.org/stable/std/os/unix/fs/fn.chroot.html
 407 [`Iterator::intersperse`]: https://doc.rust-lang.org/stable/std/iter/trait.Iterator.html#method.intersperse
 408 [`Iterator::intersperse_with`]: https://doc.rust-lang.org/stable/std/iter/trait.Iterator.html#method.intersperse
 409 [`UnsafeCell::raw_get`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.raw_get
 410 [`BufWriter::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.BufWriter.html#method.into_parts
 411 [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]: https://github.com/rust-lang/rust/pull/84662
 412 [`Vec::shrink_to`]: https://doc.rust-lang.org/stable/std/vec/struct.Vec.html#method.shrink_to
 413 [`String::shrink_to`]: https://doc.rust-lang.org/stable/std/string/struct.String.html#method.shrink_to
 414 [`OsString::shrink_to`]: https://doc.rust-lang.org/stable/std/ffi/struct.OsString.html#method.shrink_to
 415 [`PathBuf::shrink_to`]: https://doc.rust-lang.org/stable/std/path/struct.PathBuf.html#method.shrink_to
 416 [`BinaryHeap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.BinaryHeap.html#method.shrink_to
 417 [`VecDeque::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.VecDeque.html#method.shrink_to
 418 [`HashMap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_map/struct.HashMap.html#method.shrink_to
 419 [`HashSet::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_set/struct.HashSet.html#method.shrink_to
 420 [`std::mem::transmute`]: https://doc.rust-lang.org/stable/std/mem/fn.transmute.html
 421 [`slice::first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.first
 422 [`slice::split_first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_first
 423 [`slice::last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.last
 424 [`slice::split_last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_last
 425 [`rust-version`]: https://doc.rust-lang.org/nightly/cargo/reference/manifest.html#the-rust-version-field
 426 [rust#87671]: https://github.com/rust-lang/rust/pull/87671
 427 [rust#86183]: https://github.com/rust-lang/rust/pull/86183
 428 [rust#87385]: https://github.com/rust-lang/rust/pull/87385
 429 [rust#88100]: https://github.com/rust-lang/rust/pull/88100
 430 [rust#86860]: https://github.com/rust-lang/rust/pull/86860
 431 [rust#84039]: https://github.com/rust-lang/rust/pull/84039
 432 [rust#86492]: https://github.com/rust-lang/rust/pull/86492
 433 [rust#88363]: https://github.com/rust-lang/rust/pull/88363
 434 [rust#85305]: https://github.com/rust-lang/rust/pull/85305
 435 [rust#87832]: https://github.com/rust-lang/rust/pull/87832
 436 [rust#88069]: https://github.com/rust-lang/rust/pull/88069
 437 [rust#87472]: https://github.com/rust-lang/rust/pull/87472
 438 [rust#87699]: https://github.com/rust-lang/rust/pull/87699
 439 [rust#87570]: https://github.com/rust-lang/rust/pull/87570
 440 [rust#88023]: https://github.com/rust-lang/rust/pull/88023
 441 [rust#87760]: https://github.com/rust-lang/rust/pull/87760
 442 [rust#87370]: https://github.com/rust-lang/rust/pull/87370
 443 [rust#87580]: https://github.com/rust-lang/rust/pull/87580
 444 [rust#83342]: https://github.com/rust-lang/rust/pull/83342
 445 [rust#83093]: https://github.com/rust-lang/rust/pull/83093
 446 [rust#88177]: https://github.com/rust-lang/rust/pull/88177
 447 [rust#88548]: https://github.com/rust-lang/rust/pull/88548
 448 [rust#88551]: https://github.com/rust-lang/rust/pull/88551
 449 [rust#88299]: https://github.com/rust-lang/rust/pull/88299
 450 [rust#88220]: https://github.com/rust-lang/rust/pull/88220
 451 [rust#85835]: https://github.com/rust-lang/rust/pull/85835
 452 [rust#86879]: https://github.com/rust-lang/rust/pull/86879
 453 [rust#86744]: https://github.com/rust-lang/rust/pull/86744
 454 [rust#84662]: https://github.com/rust-lang/rust/pull/84662
 455 [rust#86593]: https://github.com/rust-lang/rust/pull/86593
 456 [rust#81050]: https://github.com/rust-lang/rust/pull/81050
 457 [rust#81363]: https://github.com/rust-lang/rust/pull/81363
 458 [rust#84111]: https://github.com/rust-lang/rust/pull/84111
 459 [rust#85769]: https://github.com/rust-lang/rust/pull/85769#issuecomment-854363720
 460 [rust#88490]: https://github.com/rust-lang/rust/pull/88490
 461 [rust#88269]: https://github.com/rust-lang/rust/pull/88269
 462 [rust#84176]: https://github.com/rust-lang/rust/pull/84176
 463 [rust#88399]: https://github.com/rust-lang/rust/pull/88399
 464 [rust#88227]: https://github.com/rust-lang/rust/pull/88227
 465 [rust#88200]: https://github.com/rust-lang/rust/pull/88200
 466 [rust#82776]: https://github.com/rust-lang/rust/pull/82776
 467 [rust#88077]: https://github.com/rust-lang/rust/pull/88077
 468 [rust#87728]: https://github.com/rust-lang/rust/pull/87728
 469 [rust#87050]: https://github.com/rust-lang/rust/pull/87050
 470 [rust#87619]: https://github.com/rust-lang/rust/pull/87619
 471 [rust#81825]: https://github.com/rust-lang/rust/pull/81825#issuecomment-808406918
 472 [rust#88019]: https://github.com/rust-lang/rust/pull/88019
 473 [rust#87666]: https://github.com/rust-lang/rust/pull/87666
 474
 475 Version 1.55.0 (2021-09-09)
 476 ============================
 477
 478 Language
 479 --------
 480 - [You can now write open "from" range patterns (`X..`), which will start at `X` and
 481   will end at the maximum value of the integer.][83918]
 482 - [You can now explicitly import the prelude of different editions
 483   through `std::prelude` (e.g. `use std::prelude::rust_2021::*;`).][86294]
 484
 485 Compiler
 486 --------
 487 - [Added tier 3\* support for `powerpc64le-unknown-freebsd`.][83572]
 488
 489 \* Refer to Rust's [platform support page][platform-support-doc] for more
 490    information on Rust's tiered platform support.
 491
 492 Libraries
 493 ---------
 494
 495 - [Updated std's float parsing to use the Eisel-Lemire algorithm.][86761]
 496   These improvements should in general provide faster string parsing of floats,
 497   no longer reject certain valid floating point values, and reduce
 498   the produced code size for non-stripped artifacts.
 499 - [`string::Drain` now implements `AsRef<str>` and `AsRef<[u8]>`.][86858]
 500
 501 Stabilised APIs
 502 ---------------
 503
 504 - [`Bound::cloned`]
 505 - [`Drain::as_str`]
 506 - [`IntoInnerError::into_error`]
 507 - [`IntoInnerError::into_parts`]
 508 - [`MaybeUninit::assume_init_mut`]
 509 - [`MaybeUninit::assume_init_ref`]
 510 - [`MaybeUninit::write`]
 511 - [`array::map`]
 512 - [`ops::ControlFlow`]
 513 - [`x86::_bittest`]
 514 - [`x86::_bittestandcomplement`]
 515 - [`x86::_bittestandreset`]
 516 - [`x86::_bittestandset`]
 517 - [`x86_64::_bittest64`]
 518 - [`x86_64::_bittestandcomplement64`]
 519 - [`x86_64::_bittestandreset64`]
 520 - [`x86_64::_bittestandset64`]
 521
 522 The following previously stable functions are now `const`.
 523
 524 - [`str::from_utf8_unchecked`]
 525
 526
 527 Cargo
 528 -----
 529 - [Cargo will now deduplicate compiler diagnostics to the terminal when invoking
 530   rustc in parallel such as when using `cargo test`.][cargo/9675]
 531 - [The package definition in `cargo metadata` now includes the `"default_run"`
 532   field from the manifest.][cargo/9550]
 533 - [Added `cargo d` as an alias for `cargo doc`.][cargo/9680]
 534 - [Added `{lib}` as formatting option for `cargo tree` to print the `"lib_name"`
 535   of packages.][cargo/9663]
 536
 537 Rustdoc
 538 -------
 539 - [Added "Go to item on exact match" search option.][85876]
 540 - [The "Implementors" section on traits no longer shows redundant
 541   method definitions.][85970]
 542 - [Trait implementations are toggled open by default.][86260] This should make the
 543   implementations more searchable by tools like `CTRL+F` in your browser.
 544 - [Intra-doc links should now correctly resolve associated items (e.g. methods)
 545   through type aliases.][86334]
 546 - [Traits which are marked with `#[doc(hidden)]` will no longer appear in the
 547   "Trait Implementations" section.][86513]
 548
 549
 550 Compatibility Notes
 551 -------------------
 552 - [std functions that return an `io::Error` will no longer use the
 553   `ErrorKind::Other` variant.][85746] This is to better reflect that these
 554   kinds of errors could be categorised [into newer more specific `ErrorKind`
 555   variants][79965], and that they do not represent a user error.
 556 - [Using environment variable names with `process::Command` on Windows now
 557   behaves as expected.][85270] Previously using envionment variables with
 558   `Command` would cause them to be ASCII-uppercased.
 559 - [Rustdoc will now warn on using rustdoc lints that aren't prefixed
 560   with `rustdoc::`][86849]
 561 - `RUSTFLAGS` is no longer set for build scripts. Build scripts
 562   should use `CARGO_ENCODED_RUSTFLAGS` instead. See the
 563   [documentation](https://doc.rust-lang.org/nightly/cargo/reference/environment-variables.html#environment-variables-cargo-sets-for-build-scripts)
 564   for more details.
 565
 566 [86849]: https://github.com/rust-lang/rust/pull/86849
 567 [86513]: https://github.com/rust-lang/rust/pull/86513
 568 [86334]: https://github.com/rust-lang/rust/pull/86334
 569 [86260]: https://github.com/rust-lang/rust/pull/86260
 570 [85970]: https://github.com/rust-lang/rust/pull/85970
 571 [85876]: https://github.com/rust-lang/rust/pull/85876
 572 [83572]: https://github.com/rust-lang/rust/pull/83572
 573 [86294]: https://github.com/rust-lang/rust/pull/86294
 574 [86858]: https://github.com/rust-lang/rust/pull/86858
 575 [86761]: https://github.com/rust-lang/rust/pull/86761
 576 [85769]: https://github.com/rust-lang/rust/pull/85769
 577 [85746]: https://github.com/rust-lang/rust/pull/85746
 578 [85305]: https://github.com/rust-lang/rust/pull/85305
 579 [85270]: https://github.com/rust-lang/rust/pull/85270
 580 [84111]: https://github.com/rust-lang/rust/pull/84111
 581 [83918]: https://github.com/rust-lang/rust/pull/83918
 582 [79965]: https://github.com/rust-lang/rust/pull/79965
 583 [87370]: https://github.com/rust-lang/rust/pull/87370
 584 [87298]: https://github.com/rust-lang/rust/pull/87298
 585 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
 586 [cargo/9675]: https://github.com/rust-lang/cargo/pull/9675
 587 [cargo/9550]: https://github.com/rust-lang/cargo/pull/9550
 588 [cargo/9680]: https://github.com/rust-lang/cargo/pull/9680
 589 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
 590 [`array::map`]: https://doc.rust-lang.org/stable/std/primitive.array.html#method.map
 591 [`Bound::cloned`]: https://doc.rust-lang.org/stable/std/ops/enum.Bound.html#method.cloned
 592 [`Drain::as_str`]: https://doc.rust-lang.org/stable/std/string/struct.Drain.html#method.as_str
 593 [`IntoInnerError::into_error`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_error
 594 [`IntoInnerError::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_parts
 595 [`MaybeUninit::assume_init_mut`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_mut
 596 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
 597 [`MaybeUninit::write`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.write
 598 [`Seek::rewind`]: https://doc.rust-lang.org/stable/std/io/trait.Seek.html#method.rewind
 599 [`ops::ControlFlow`]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html
 600 [`str::from_utf8_unchecked`]: https://doc.rust-lang.org/stable/std/str/fn.from_utf8_unchecked.html
 601 [`x86::_bittest`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittest.html
 602 [`x86::_bittestandcomplement`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandcomplement.html
 603 [`x86::_bittestandreset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandreset.html
 604 [`x86::_bittestandset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandset.html
 605 [`x86_64::_bittest64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittest64.html
 606 [`x86_64::_bittestandcomplement64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandcomplement64.html
 607 [`x86_64::_bittestandreset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandreset64.html
 608 [`x86_64::_bittestandset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandset64.html
 609
 610
 611 Version 1.54.0 (2021-07-29)
 612 ============================
 613
 614 Language
 615 -----------------------
 616
 617 - [You can now use macros for values in some built-in attributes.][83366]
 618   This primarily allows you to call macros within the `#[doc]` attribute. For
 619   example, to include external documentation in your crate, you can now write
 620   the following:
 621   ```rust
 622   #![doc = include_str!("README.md")]
 623   ```
 624
 625 - [You can now cast between unsized slice types (and types which contain
 626   unsized slices) in `const fn`.][85078]
 627 - [You can now use multiple generic lifetimes with `impl Trait` where the
 628    lifetimes don't explicitly outlive another.][84701] In code this means
 629    that you can now have `impl Trait<'a, 'b>` where as before you could
 630    only have `impl Trait<'a, 'b> where 'b: 'a`.
 631
 632 Compiler
 633 -----------------------
 634
 635 - [Rustc will now search for custom JSON targets in
 636   `/lib/rustlib/<target-triple>/target.json` where `/` is the "sysroot"
 637   directory.][83800] You can find your sysroot directory by running
 638   `rustc --print sysroot`.
 639 - [Added `wasm` as a `target_family` for WebAssembly platforms.][84072]
 640 - [You can now use `#[target_feature]` on safe functions when targeting
 641   WebAssembly platforms.][84988]
 642 - [Improved debugger output for enums on Windows MSVC platforms.][85292]
 643 - [Added tier 3\* support for `bpfel-unknown-none`
 644    and `bpfeb-unknown-none`.][79608]
 645 - [`-Zmutable-noalias=yes`][82834] is enabled by default when using LLVM 12 or above.
 646
 647 \* Refer to Rust's [platform support page][platform-support-doc] for more
 648    information on Rust's tiered platform support.
 649
 650 Libraries
 651 -----------------------
 652
 653 - [`panic::panic_any` will now `#[track_caller]`.][85745]
 654 - [Added `OutOfMemory` as a variant of `io::ErrorKind`.][84744]
 655 - [ `proc_macro::Literal` now implements `FromStr`.][84717]
 656 - [The implementations of vendor intrinsics in core::arch have been
 657    significantly refactored.][83278] The main user-visible changes are
 658    a 50% reduction in the size of libcore.rlib and stricter validation
 659    of constant operands passed to intrinsics. The latter is technically
 660    a breaking change, but allows Rust to more closely match the C vendor
 661    intrinsics API.
 662
 663 Stabilized APIs
 664 ---------------
 665
 666 - [`BTreeMap::into_keys`]
 667 - [`BTreeMap::into_values`]
 668 - [`HashMap::into_keys`]
 669 - [`HashMap::into_values`]
 670 - [`arch::wasm32`]
 671 - [`VecDeque::binary_search`]
 672 - [`VecDeque::binary_search_by`]
 673 - [`VecDeque::binary_search_by_key`]
 674 - [`VecDeque::partition_point`]
 675
 676 Cargo
 677 -----
 678
 679 - [Added the `--prune <spec>` option to `cargo-tree` to remove a package from
 680   the dependency graph.][cargo/9520]
 681 - [Added the `--depth` option to `cargo-tree` to print only to a certain depth
 682   in the tree ][cargo/9499]
 683 - [Added the `no-proc-macro` value to `cargo-tree --edges` to hide procedural
 684   macro dependencies.][cargo/9488]
 685 - [A new environment variable named `CARGO_TARGET_TMPDIR` is available.][cargo/9375]
 686   This variable points to a directory that integration tests and benches
 687   can use as a "scratchpad" for testing filesystem operations.
 688
 689 Compatibility Notes
 690 -------------------
 691 - [Mixing Option and Result via `?` is no longer permitted in closures for inferred types.][86831]
 692 - [Previously unsound code is no longer permitted where different constructors in branches
 693   could require different lifetimes.][85574]
 694 - As previously mentioned the [`std::arch` instrinsics now uses stricter const checking][83278]
 695   than before and may reject some previously accepted code.
 696 - [`i128` multiplication on Cortex M0+ platforms currently unconditionally causes overflow
 697    when compiled with `codegen-units = 1`.][86063]
 698
 699 [85574]: https://github.com/rust-lang/rust/issues/85574
 700 [86831]: https://github.com/rust-lang/rust/issues/86831
 701 [86063]: https://github.com/rust-lang/rust/issues/86063
 702 [86831]: https://github.com/rust-lang/rust/issues/86831
 703 [79608]: https://github.com/rust-lang/rust/pull/79608
 704 [84988]: https://github.com/rust-lang/rust/pull/84988
 705 [84701]: https://github.com/rust-lang/rust/pull/84701
 706 [84072]: https://github.com/rust-lang/rust/pull/84072
 707 [85745]: https://github.com/rust-lang/rust/pull/85745
 708 [84744]: https://github.com/rust-lang/rust/pull/84744
 709 [85078]: https://github.com/rust-lang/rust/pull/85078
 710 [84717]: https://github.com/rust-lang/rust/pull/84717
 711 [83800]: https://github.com/rust-lang/rust/pull/83800
 712 [83366]: https://github.com/rust-lang/rust/pull/83366
 713 [83278]: https://github.com/rust-lang/rust/pull/83278
 714 [85292]: https://github.com/rust-lang/rust/pull/85292
 715 [82834]: https://github.com/rust-lang/rust/pull/82834
 716 [cargo/9520]: https://github.com/rust-lang/cargo/pull/9520
 717 [cargo/9499]: https://github.com/rust-lang/cargo/pull/9499
 718 [cargo/9488]: https://github.com/rust-lang/cargo/pull/9488
 719 [cargo/9375]: https://github.com/rust-lang/cargo/pull/9375
 720 [`BTreeMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_keys
 721 [`BTreeMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_values
 722 [`HashMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_keys
 723 [`HashMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_values
 724 [`arch::wasm32`]: https://doc.rust-lang.org/core/arch/wasm32/index.html
 725 [`VecDeque::binary_search`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search
 726 [`VecDeque::binary_search_by`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by
 727
 728 [`VecDeque::binary_search_by_key`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by_key
 729
 730 [`VecDeque::partition_point`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.partition_point
 731
 732 Version 1.53.0 (2021-06-17)
 733 ============================
 734
 735 Language
 736 -----------------------
 737 - [You can now use unicode for identifiers.][83799] This allows multilingual
 738   identifiers but still doesn't allow glyphs that are not considered characters
 739   such as `◆` or `🦀`. More specifically you can now use any identifier that
 740   matches the UAX #31 "Unicode Identifier and Pattern Syntax" standard. This
 741   is the same standard as languages like Python, however Rust uses NFC
 742   normalization which may be different from other languages.
 743 - [You can now specify "or patterns" inside pattern matches.][79278]
 744   Previously you could only use `|` (OR) on complete patterns. E.g.
 745   ```rust
 746   let x = Some(2u8);
 747   // Before
 748   matches!(x, Some(1) | Some(2));
 749   // Now
 750   matches!(x, Some(1 | 2));
 751   ```
 752 - [Added the `:pat_param` `macro_rules!` matcher.][83386] This matcher
 753   has the same semantics as the `:pat` matcher. This is to allow `:pat`
 754   to change semantics to being a pattern fragment in a future edition.
 755
 756 Compiler
 757 -----------------------
 758 - [Updated the minimum external LLVM version to LLVM 10.][83387]
 759 - [Added Tier 3\* support for the `wasm64-unknown-unknown` target.][80525]
 760 - [Improved debuginfo for closures and async functions on Windows MSVC.][83941]
 761
 762 \* Refer to Rust's [platform support page][platform-support-doc] for more
 763 information on Rust's tiered platform support.
 764
 765 Libraries
 766 -----------------------
 767 - [Abort messages will now forward to `android_set_abort_message` on
 768   Android platforms when available.][81469]
 769 - [`slice::IterMut<'_, T>` now implements `AsRef<[T]>`][82771]
 770 - [Arrays of any length now implement `IntoIterator`.][84147]
 771   Currently calling `.into_iter()` as a method on an array will
 772   return `impl Iterator<Item=&T>`, but this may change in a
 773   future edition to change `Item` to `T`. Calling `IntoIterator::into_iter`
 774   directly on arrays will provide `impl Iterator<Item=T>` as expected.
 775 - [`leading_zeros`, and `trailing_zeros` are now available on all
 776   `NonZero` integer types.][84082]
 777 - [`{f32, f64}::from_str` now parse and print special values
 778   (`NaN`, `-0`) according to IEEE 754.][78618]
 779 - [You can now index into slices using `(Bound<usize>, Bound<usize>)`.][77704]
 780 - [Add the `BITS` associated constant to all numeric types.][82565]
 781
 782 Stabilised APIs
 783 ---------------
 784 - [`AtomicBool::fetch_update`]
 785 - [`AtomicPtr::fetch_update`]
 786 - [`BTreeMap::retain`]
 787 - [`BTreeSet::retain`]
 788 - [`BufReader::seek_relative`]
 789 - [`DebugStruct::non_exhaustive`]
 790 - [`Duration::MAX`]
 791 - [`Duration::ZERO`]
 792 - [`Duration::is_zero`]
 793 - [`Duration::saturating_add`]
 794 - [`Duration::saturating_mul`]
 795 - [`Duration::saturating_sub`]
 796 - [`ErrorKind::Unsupported`]
 797 - [`Option::insert`]
 798 - [`Ordering::is_eq`]
 799 - [`Ordering::is_ge`]
 800 - [`Ordering::is_gt`]
 801 - [`Ordering::is_le`]
 802 - [`Ordering::is_lt`]
 803 - [`Ordering::is_ne`]
 804 - [`OsStr::is_ascii`]
 805 - [`OsStr::make_ascii_lowercase`]
 806 - [`OsStr::make_ascii_uppercase`]
 807 - [`OsStr::to_ascii_lowercase`]
 808 - [`OsStr::to_ascii_uppercase`]
 809 - [`Peekable::peek_mut`]
 810 - [`Rc::decrement_strong_count`]
 811 - [`Rc::increment_strong_count`]
 812 - [`Vec::extend_from_within`]
 813 - [`array::from_mut`]
 814 - [`array::from_ref`]
 815 - [`cmp::max_by_key`]
 816 - [`cmp::max_by`]
 817 - [`cmp::min_by_key`]
 818 - [`cmp::min_by`]
 819 - [`f32::is_subnormal`]
 820 - [`f64::is_subnormal`]
 821
 822 Cargo
 823 -----------------------
 824 - [Cargo now supports git repositories where the default `HEAD` branch is not
 825   "master".][cargo/9392] This also includes a switch to the version 3 `Cargo.lock` format
 826   which can handle default branches correctly.
 827 - [macOS targets now default to `unpacked` split-debuginfo.][cargo/9298]
 828 - [The `authors` field is no longer included in `Cargo.toml` for new
 829   projects.][cargo/9282]
 830
 831 Rustdoc
 832 -----------------------
 833 - [Added the `rustdoc::bare_urls` lint that warns when you have URLs
 834   without hyperlinks.][81764]
 835
 836 Compatibility Notes
 837 -------------------
 838 - [Implement token-based handling of attributes during expansion][82608]
 839 - [`Ipv4::from_str` will now reject octal format IP addresses in addition
 840   to rejecting hexadecimal IP addresses.][83652] The octal format can lead
 841   to confusion and potential security vulnerabilities and [is no
 842   longer recommended][ietf6943].
 843 - [The added `BITS` constant may conflict with external definitions.][85667]
 844   In particular, this was known to be a problem in the `lexical-core` crate,
 845   but they have published fixes for semantic versions 0.4 through 0.7. To
 846   update this dependency alone, use `cargo update -p lexical-core`.
 847 - Incremental compilation remains off by default, unless one uses the `RUSTC_FORCE_INCREMENTAL=1` environment variable added in 1.52.1.
 848
 849 Internal Only
 850 -------------
 851 These changes provide no direct user facing benefits, but represent significant
 852 improvements to the internals and overall performance of rustc and
 853 related tools.
 854
 855 - [Rework the `std::sys::windows::alloc` implementation.][83065]
 856 - [rustdoc: Don't enter an infer_ctxt in get_blanket_impls for impls that aren't blanket impls.][82864]
 857 - [rustdoc: Only look at blanket impls in `get_blanket_impls`][83681]
 858 - [Rework rustdoc const type][82873]
 859
 860 [85667]: https://github.com/rust-lang/rust/pull/85667
 861 [83386]: https://github.com/rust-lang/rust/pull/83386
 862 [82771]: https://github.com/rust-lang/rust/pull/82771
 863 [84147]: https://github.com/rust-lang/rust/pull/84147
 864 [84082]: https://github.com/rust-lang/rust/pull/84082
 865 [83799]: https://github.com/rust-lang/rust/pull/83799
 866 [83681]: https://github.com/rust-lang/rust/pull/83681
 867 [83652]: https://github.com/rust-lang/rust/pull/83652
 868 [83387]: https://github.com/rust-lang/rust/pull/83387
 869 [82873]: https://github.com/rust-lang/rust/pull/82873
 870 [82864]: https://github.com/rust-lang/rust/pull/82864
 871 [82608]: https://github.com/rust-lang/rust/pull/82608
 872 [82565]: https://github.com/rust-lang/rust/pull/82565
 873 [80525]: https://github.com/rust-lang/rust/pull/80525
 874 [79278]: https://github.com/rust-lang/rust/pull/79278
 875 [78618]: https://github.com/rust-lang/rust/pull/78618
 876 [77704]: https://github.com/rust-lang/rust/pull/77704
 877 [83941]: https://github.com/rust-lang/rust/pull/83941
 878 [83065]: https://github.com/rust-lang/rust/pull/83065
 879 [81764]: https://github.com/rust-lang/rust/pull/81764
 880 [81469]: https://github.com/rust-lang/rust/pull/81469
 881 [cargo/9298]: https://github.com/rust-lang/cargo/pull/9298
 882 [cargo/9282]: https://github.com/rust-lang/cargo/pull/9282
 883 [cargo/9392]: https://github.com/rust-lang/cargo/pull/9392
 884 [`AtomicBool::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicBool.html#method.fetch_update
 885 [`AtomicPtr::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicPtr.html#method.fetch_update
 886 [`BTreeMap::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.retain
 887 [`BTreeSet::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeSet.html#method.retain
 888 [`BufReader::seek_relative`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.seek_relative
 889 [`DebugStruct::non_exhaustive`]: https://doc.rust-lang.org/std/fmt/struct.DebugStruct.html#method.finish_non_exhaustive
 890 [`Duration::MAX`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
 891 [`Duration::ZERO`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.ZERO
 892 [`Duration::is_zero`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.is_zero
 893 [`Duration::saturating_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_add
 894 [`Duration::saturating_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_mul
 895 [`Duration::saturating_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_sub
 896 [`ErrorKind::Unsupported`]: https://doc.rust-lang.org/std/io/enum.ErrorKind.html#variant.Unsupported
 897 [`Option::insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.insert
 898 [`Ordering::is_eq`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_eq
 899 [`Ordering::is_ge`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ge
 900 [`Ordering::is_gt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_gt
 901 [`Ordering::is_le`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_le
 902 [`Ordering::is_lt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_lt
 903 [`Ordering::is_ne`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ne
 904 [`OsStr::eq_ignore_ascii_case`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.eq_ignore_ascii_case
 905 [`OsStr::is_ascii`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.is_ascii
 906 [`OsStr::make_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_lowercase
 907 [`OsStr::make_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_uppercase
 908 [`OsStr::to_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_lowercase
 909 [`OsStr::to_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_uppercase
 910 [`Peekable::peek_mut`]: https://doc.rust-lang.org/std/iter/struct.Peekable.html#method.peek_mut
 911 [`Rc::decrement_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
 912 [`Rc::increment_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
 913 [`Vec::extend_from_within`]: https://doc.rust-lang.org/beta/std/vec/struct.Vec.html#method.extend_from_within
 914 [`array::from_mut`]: https://doc.rust-lang.org/beta/std/array/fn.from_mut.html
 915 [`array::from_ref`]: https://doc.rust-lang.org/beta/std/array/fn.from_ref.html
 916 [`cmp::max_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by_key.html
 917 [`cmp::max_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by.html
 918 [`cmp::min_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by_key.html
 919 [`cmp::min_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by.html
 920 [`f32::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
 921 [`f64::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
 922 [ietf6943]: https://datatracker.ietf.org/doc/html/rfc6943#section-3.1.1
 923
 924
 925 Version 1.52.1 (2021-05-10)
 926 ============================
 927
 928 This release disables incremental compilation, unless the user has explicitly
 929 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
 930
 931 This is due to the widespread, and frequently occuring, breakage encountered by
 932 Rust users due to newly enabled incremental verification in 1.52.0. Notably,
 933 Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
 934 newly added incremental verification are still present in past stable versions,
 935 and are not yet fixed on any channel. These bugs can lead to miscompilation of
 936 Rust binaries.
 937
 938 These problems only affect incremental builds, so release builds with Cargo
 939 should not be affected unless the user has explicitly opted into incremental.
 940 Debug and check builds are affected.
 941
 942 See [84970] for more details.
 943
 944 [84970]: https://github.com/rust-lang/rust/issues/84970
 945
 946 Version 1.52.0 (2021-05-06)
 947 ============================
 948
 949 Language
 950 --------
 951 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
 952   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
 953   is allowed by default, and may become a warning or hard error in a
 954   future edition.
 955 - [You can now cast mutable references to arrays to a pointer of the same type as
 956   the element.][81479]
 957
 958 Compiler
 959 --------
 960 - [Upgraded the default LLVM to LLVM 12.][81451]
 961
 962 Added tier 3\* support for the following targets.
 963
 964 - [`s390x-unknown-linux-musl`][82166]
 965 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
 966 - [`powerpc-unknown-openbsd`][82733]
 967
 968 \* Refer to Rust's [platform support page][platform-support-doc] for more
 969 information on Rust's tiered platform support.
 970
 971 Libraries
 972 ---------
 973 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
 974 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
 975 - [`Arc<impl Error>` now implements `error::Error`.][80553]
 976 - [All integer division and remainder operations are now `const`.][80962]
 977
 978 Stabilised APIs
 979 -------------
 980 - [`Arguments::as_str`]
 981 - [`char::MAX`]
 982 - [`char::REPLACEMENT_CHARACTER`]
 983 - [`char::UNICODE_VERSION`]
 984 - [`char::decode_utf16`]
 985 - [`char::from_digit`]
 986 - [`char::from_u32_unchecked`]
 987 - [`char::from_u32`]
 988 - [`slice::partition_point`]
 989 - [`str::rsplit_once`]
 990 - [`str::split_once`]
 991
 992 The following previously stable APIs are now `const`.
 993
 994 - [`char::len_utf8`]
 995 - [`char::len_utf16`]
 996 - [`char::to_ascii_uppercase`]
 997 - [`char::to_ascii_lowercase`]
 998 - [`char::eq_ignore_ascii_case`]
 999 - [`u8::to_ascii_uppercase`]
1000 - [`u8::to_ascii_lowercase`]
1001 - [`u8::eq_ignore_ascii_case`]
1002
1003 Rustdoc
1004 -------
1005 - [Rustdoc lints are now treated as a tool lint, meaning that
1006   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
1007   Using the old style is still allowed, and will become a warning in
1008   a future release.
1009 - [Rustdoc now supports argument files.][82261]
1010 - [Rustdoc now generates smart punctuation for documentation.][79423]
1011 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
1012   ```markdown
1013   - [x] Complete
1014   - [ ] Todo
1015   ```
1016
1017 Misc
1018 ----
1019 - [You can now pass multiple filters to tests.][81356] E.g.
1020   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
1021 - [Rustup now distributes PDB symbols for the `std` library on Windows,
1022   allowing you to see `std` symbols when debugging.][82218]
1023
1024 Internal Only
1025 -------------
1026 These changes provide no direct user facing benefits, but represent significant
1027 improvements to the internals and overall performance of rustc and
1028 related tools.
1029
1030 - [Check the result cache before the DepGraph when ensuring queries][81855]
1031 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
1032 - [Only store a LocalDefId in some HIR nodes][81611]
1033 - [Store HIR attributes in a side table][79519]
1034
1035 Compatibility Notes
1036 -------------------
1037 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
1038 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
1039 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
1040 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
1041   languages in code blocks.][78429]
1042 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
1043 - [Changes in how proc macros handle whitespace may lead to panics when used
1044   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
1045 - [Turn `#[derive]` into a regular macro attribute][79078]
1046
1047 [84136]: https://github.com/rust-lang/rust/issues/84136
1048 [80763]: https://github.com/rust-lang/rust/pull/80763
1049 [82166]: https://github.com/rust-lang/rust/pull/82166
1050 [82121]: https://github.com/rust-lang/rust/pull/82121
1051 [81879]: https://github.com/rust-lang/rust/pull/81879
1052 [82261]: https://github.com/rust-lang/rust/pull/82261
1053 [82218]: https://github.com/rust-lang/rust/pull/82218
1054 [82216]: https://github.com/rust-lang/rust/pull/82216
1055 [82202]: https://github.com/rust-lang/rust/pull/82202
1056 [81855]: https://github.com/rust-lang/rust/pull/81855
1057 [81766]: https://github.com/rust-lang/rust/pull/81766
1058 [81744]: https://github.com/rust-lang/rust/pull/81744
1059 [81611]: https://github.com/rust-lang/rust/pull/81611
1060 [81479]: https://github.com/rust-lang/rust/pull/81479
1061 [81451]: https://github.com/rust-lang/rust/pull/81451
1062 [81356]: https://github.com/rust-lang/rust/pull/81356
1063 [80962]: https://github.com/rust-lang/rust/pull/80962
1064 [80553]: https://github.com/rust-lang/rust/pull/80553
1065 [80527]: https://github.com/rust-lang/rust/pull/80527
1066 [79519]: https://github.com/rust-lang/rust/pull/79519
1067 [79423]: https://github.com/rust-lang/rust/pull/79423
1068 [79208]: https://github.com/rust-lang/rust/pull/79208
1069 [78429]: https://github.com/rust-lang/rust/pull/78429
1070 [82733]: https://github.com/rust-lang/rust/pull/82733
1071 [82594]: https://github.com/rust-lang/rust/pull/82594
1072 [79078]: https://github.com/rust-lang/rust/pull/79078
1073 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
1074 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
1075 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
1076 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
1077 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
1078 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
1079 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
1080 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
1081 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
1082 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
1083 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
1084 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
1085 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
1086 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
1087 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
1088 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
1089 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
1090 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
1091 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
1092 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
1093 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
1094 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
1095
1096 Version 1.51.0 (2021-03-25)
1097 ============================
1098
1099 Language
1100 --------
1101 - [You can now parameterize items such as functions, traits, and `struct`s by constant
1102   values in addition to by types and lifetimes.][79135] Also known as "const generics"
1103   E.g. you can now write the following. Note: Only values of primitive integers,
1104   `bool`, or `char` types are currently permitted.
1105   ```rust
1106   struct GenericArray<T, const LENGTH: usize> {
1107       inner: [T; LENGTH]
1108   }
1109
1110   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
1111       const fn last(&self) -> Option<&T> {
1112           if LENGTH == 0 {
1113               None
1114           } else {
1115               Some(&self.inner[LENGTH - 1])
1116           }
1117       }
1118   }
1119   ```
1120
1121
1122 Compiler
1123 --------
1124
1125 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
1126   This option controls whether debug information is split across multiple files
1127   or packed into a single file. **Note** This option is unstable on other platforms.
1128 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
1129   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
1130 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
1131 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
1132
1133 \* Refer to Rust's [platform support page][platform-support-doc] for more
1134 information on Rust's tiered platform support.
1135
1136 Libraries
1137 ---------
1138
1139 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
1140 - [`str` now implements `AsMut<str>`.][80279]
1141 - [`u64` and `u128` now implement `From<char>`.][79502]
1142 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
1143 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
1144 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
1145 - [`io::Empty` now implements `io::Seek`.][78044]
1146 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
1147   `T: ?Sized` types.][80764]
1148 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
1149
1150
1151 Stabilized APIs
1152 ---------------
1153
1154 - [`Arc::decrement_strong_count`]
1155 - [`Arc::increment_strong_count`]
1156 - [`Once::call_once_force`]
1157 - [`Peekable::next_if_eq`]
1158 - [`Peekable::next_if`]
1159 - [`Seek::stream_position`]
1160 - [`array::IntoIter`]
1161 - [`panic::panic_any`]
1162 - [`ptr::addr_of!`]
1163 - [`ptr::addr_of_mut!`]
1164 - [`slice::fill_with`]
1165 - [`slice::split_inclusive_mut`]
1166 - [`slice::split_inclusive`]
1167 - [`slice::strip_prefix`]
1168 - [`slice::strip_suffix`]
1169 - [`str::split_inclusive`]
1170 - [`sync::OnceState`]
1171 - [`task::Wake`]
1172 - [`VecDeque::range`]
1173 - [`VecDeque::range_mut`]
1174
1175 Cargo
1176 -----
1177 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
1178   codegen option.][cargo/9112]
1179 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
1180   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
1181   to avoid unifying features of dependencies where that unification could be unwanted.
1182   Such as using the same dependency with a `std` feature in a build scripts and
1183   proc-macros, while using the `no-std` feature in the final binary. See the
1184   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
1185
1186 Rustdoc
1187 -------
1188
1189 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
1190 - [You can now provide a `--default-theme` flag which sets the default theme to use for
1191   documentation.][79642]
1192
1193 Various improvements to intra-doc links:
1194
1195 - [You can link to non-path primitives such as `slice`.][80181]
1196 - [You can link to associated items.][74489]
1197 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
1198
1199 Misc
1200 ----
1201 - [You can now pass `--include-ignored` to tests (e.g. with
1202   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
1203
1204 Compatibility Notes
1205 -------------------
1206
1207 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
1208 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
1209   could fail.][80579]
1210 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
1211   for the distributed artifacts.][81521]
1212     - `armv5te-unknown-linux-gnueabi`
1213     - `sparc64-unknown-linux-gnu`
1214     - `thumbv7neon-unknown-linux-gnueabihf`
1215     - `armv7-unknown-linux-gnueabi`
1216     - `x86_64-unknown-linux-gnux32`
1217 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
1218
1219 Internal Only
1220 -------------
1221
1222 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
1223
1224 [79135]: https://github.com/rust-lang/rust/pull/79135
1225 [74489]: https://github.com/rust-lang/rust/pull/74489
1226 [76934]: https://github.com/rust-lang/rust/pull/76934
1227 [79570]: https://github.com/rust-lang/rust/pull/79570
1228 [80181]: https://github.com/rust-lang/rust/pull/80181
1229 [79642]: https://github.com/rust-lang/rust/pull/79642
1230 [80945]: https://github.com/rust-lang/rust/pull/80945
1231 [80279]: https://github.com/rust-lang/rust/pull/80279
1232 [80053]: https://github.com/rust-lang/rust/pull/80053
1233 [79502]: https://github.com/rust-lang/rust/pull/79502
1234 [75180]: https://github.com/rust-lang/rust/pull/75180
1235 [79135]: https://github.com/rust-lang/rust/pull/79135
1236 [81521]: https://github.com/rust-lang/rust/pull/81521
1237 [80968]: https://github.com/rust-lang/rust/pull/80968
1238 [80959]: https://github.com/rust-lang/rust/pull/80959
1239 [80718]: https://github.com/rust-lang/rust/pull/80718
1240 [80653]: https://github.com/rust-lang/rust/pull/80653
1241 [80579]: https://github.com/rust-lang/rust/pull/80579
1242 [79998]: https://github.com/rust-lang/rust/pull/79998
1243 [78044]: https://github.com/rust-lang/rust/pull/78044
1244 [81455]: https://github.com/rust-lang/rust/pull/81455
1245 [80764]: https://github.com/rust-lang/rust/pull/80764
1246 [80749]: https://github.com/rust-lang/rust/pull/80749
1247 [80662]: https://github.com/rust-lang/rust/pull/80662
1248 [79134]: https://github.com/rust-lang/rust/pull/79134
1249 [80966]: https://github.com/rust-lang/rust/pull/80966
1250 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
1251 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
1252 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
1253 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
1254 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
1255 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
1256 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
1257 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
1258 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
1259 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
1260 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
1261 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
1262 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
1263 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
1264 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
1265 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
1266 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
1267 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
1268 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
1269 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
1270 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
1271 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
1272 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
1273
1274 Version 1.50.0 (2021-02-11)
1275 ============================
1276
1277 Language
1278 -----------------------
1279 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
1280   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
1281 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
1282
1283 Compiler
1284 -----------------------
1285 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
1286 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
1287 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
1288 - [Dropped support for all cloudabi targets.][78439]
1289
1290 \* Refer to Rust's [platform support page][platform-support-doc] for more
1291 information on Rust's tiered platform support.
1292
1293 Libraries
1294 -----------------------
1295
1296 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
1297 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
1298 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
1299   This value cannot be a valid file descriptor, and now means `Option<File>` takes
1300   up the same amount of space as `File`.
1301
1302 Stabilized APIs
1303 ---------------
1304
1305 - [`bool::then`]
1306 - [`btree_map::Entry::or_insert_with_key`]
1307 - [`f32::clamp`]
1308 - [`f64::clamp`]
1309 - [`hash_map::Entry::or_insert_with_key`]
1310 - [`Ord::clamp`]
1311 - [`RefCell::take`]
1312 - [`slice::fill`]
1313 - [`UnsafeCell::get_mut`]
1314
1315 The following previously stable methods are now `const`.
1316
1317 - [`IpAddr::is_ipv4`]
1318 - [`IpAddr::is_ipv6`]
1319 - [`IpAddr::is_unspecified`]
1320 - [`IpAddr::is_loopback`]
1321 - [`IpAddr::is_multicast`]
1322 - [`Ipv4Addr::octets`]
1323 - [`Ipv4Addr::is_loopback`]
1324 - [`Ipv4Addr::is_private`]
1325 - [`Ipv4Addr::is_link_local`]
1326 - [`Ipv4Addr::is_multicast`]
1327 - [`Ipv4Addr::is_broadcast`]
1328 - [`Ipv4Addr::is_documentation`]
1329 - [`Ipv4Addr::to_ipv6_compatible`]
1330 - [`Ipv4Addr::to_ipv6_mapped`]
1331 - [`Ipv6Addr::segments`]
1332 - [`Ipv6Addr::is_unspecified`]
1333 - [`Ipv6Addr::is_loopback`]
1334 - [`Ipv6Addr::is_multicast`]
1335 - [`Ipv6Addr::to_ipv4`]
1336 - [`Layout::size`]
1337 - [`Layout::align`]
1338 - [`Layout::from_size_align`]
1339 - `pow` for all integer types.
1340 - `checked_pow` for all integer types.
1341 - `saturating_pow` for all integer types.
1342 - `wrapping_pow` for all integer types.
1343 - `next_power_of_two` for all unsigned integer types.
1344 - `checked_next_power_of_two` for all unsigned integer types.
1345
1346 Cargo
1347 -----------------------
1348
1349 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
1350   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
1351 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
1352   contents of that directory for changes.][cargo/8973]
1353 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
1354
1355 Misc
1356 ----
1357
1358 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
1359 - [Running tests will now print the total time taken to execute.][75752]
1360
1361 Compatibility Notes
1362 -------------------
1363
1364 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
1365   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
1366 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
1367   unhygenic `macro_rules!` macros.][79472]
1368 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
1369   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
1370 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
1371 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
1372   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
1373 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
1374
1375 [74989]: https://github.com/rust-lang/rust/pull/74989
1376 [79261]: https://github.com/rust-lang/rust/pull/79261
1377 [79896]: https://github.com/rust-lang/rust/pull/79896
1378 [79484]: https://github.com/rust-lang/rust/pull/79484
1379 [79472]: https://github.com/rust-lang/rust/pull/79472
1380 [79270]: https://github.com/rust-lang/rust/pull/79270
1381 [79003]: https://github.com/rust-lang/rust/pull/79003
1382 [78864]: https://github.com/rust-lang/rust/pull/78864
1383 [78636]: https://github.com/rust-lang/rust/pull/78636
1384 [78439]: https://github.com/rust-lang/rust/pull/78439
1385 [78343]: https://github.com/rust-lang/rust/pull/78343
1386 [78296]: https://github.com/rust-lang/rust/pull/78296
1387 [78068]: https://github.com/rust-lang/rust/pull/78068
1388 [75752]: https://github.com/rust-lang/rust/pull/75752
1389 [74699]: https://github.com/rust-lang/rust/pull/74699
1390 [78142]: https://github.com/rust-lang/rust/pull/78142
1391 [77484]: https://github.com/rust-lang/rust/pull/77484
1392 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
1393 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
1394 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
1395 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
1396 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
1397 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
1398 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
1399 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
1400 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
1401 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
1402 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
1403 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
1404 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
1405 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
1406 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
1407 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
1408 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
1409 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
1410 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
1411 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
1412 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
1413 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
1414 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
1415 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
1416 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
1417 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
1418 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
1419 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
1420 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
1421 [`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
1422 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
1423 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
1424 [`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
1425 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
1426
1427
1428 Version 1.49.0 (2020-12-31)
1429 ============================
1430
1431 Language
1432 -----------------------
1433
1434 - [Unions can now implement `Drop`, and you can now have a field in a union
1435   with `ManuallyDrop<T>`.][77547]
1436 - [You can now cast uninhabited enums to integers.][76199]
1437 - [You can now bind by reference and by move in patterns.][76119] This
1438   allows you to selectively borrow individual components of a type. E.g.
1439   ```rust
1440   #[derive(Debug)]
1441   struct Person {
1442       name: String,
1443       age: u8,
1444   }
1445
1446   let person = Person {
1447       name: String::from("Alice"),
1448       age: 20,
1449   };
1450
1451   // `name` is moved out of person, but `age` is referenced.
1452   let Person { name, ref age } = person;
1453   println!("{} {}", name, age);
1454   ```
1455
1456 Compiler
1457 -----------------------
1458
1459 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
1460 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
1461 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
1462 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
1463 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
1464 - [Output from threads spawned in tests is now captured.][78227]
1465 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
1466
1467 \* Refer to Rust's [platform support page][platform-support-doc] for more
1468 information on Rust's tiered platform support.
1469
1470 Libraries
1471 -----------------------
1472
1473 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
1474 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
1475
1476 Stabilized APIs
1477 ---------------
1478
1479 - [`slice::select_nth_unstable`]
1480 - [`slice::select_nth_unstable_by`]
1481 - [`slice::select_nth_unstable_by_key`]
1482
1483 The following previously stable methods are now `const`.
1484
1485 - [`Poll::is_ready`]
1486 - [`Poll::is_pending`]
1487
1488 Cargo
1489 -----------------------
1490 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
1491 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
1492 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
1493   variable will be set if the crate being built is one the user selected to build, either
1494   with `-p` or through defaults.
1495 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
1496
1497
1498 Compatibility Notes
1499 -------------------
1500
1501 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
1502 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
1503 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
1504   Previously such invalid or unused attributes could be ignored.
1505 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
1506   read [this post about the changes][rustdoc-ws-post] for more details.
1507 - [Trait bounds are no longer inferred for associated types.][79904]
1508
1509 Internal Only
1510 -------------
1511 These changes provide no direct user facing benefits, but represent significant
1512 improvements to the internals and overall performance of rustc and
1513 related tools.
1514
1515 - [rustc's internal crates are now compiled using the `initial-exec` Thread
1516   Local Storage model.][78201]
1517 - [Calculate visibilities once in resolve.][78077]
1518 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
1519 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
1520
1521
1522 [75991]: https://github.com/rust-lang/rust/pull/75991
1523 [78951]: https://github.com/rust-lang/rust/pull/78951
1524 [78848]: https://github.com/rust-lang/rust/pull/78848
1525 [78746]: https://github.com/rust-lang/rust/pull/78746
1526 [78376]: https://github.com/rust-lang/rust/pull/78376
1527 [78228]: https://github.com/rust-lang/rust/pull/78228
1528 [78227]: https://github.com/rust-lang/rust/pull/78227
1529 [78201]: https://github.com/rust-lang/rust/pull/78201
1530 [78109]: https://github.com/rust-lang/rust/pull/78109
1531 [78077]: https://github.com/rust-lang/rust/pull/78077
1532 [77997]: https://github.com/rust-lang/rust/pull/77997
1533 [77703]: https://github.com/rust-lang/rust/pull/77703
1534 [77547]: https://github.com/rust-lang/rust/pull/77547
1535 [77015]: https://github.com/rust-lang/rust/pull/77015
1536 [76199]: https://github.com/rust-lang/rust/pull/76199
1537 [76119]: https://github.com/rust-lang/rust/pull/76119
1538 [75914]: https://github.com/rust-lang/rust/pull/75914
1539 [79004]: https://github.com/rust-lang/rust/pull/79004
1540 [78676]: https://github.com/rust-lang/rust/pull/78676
1541 [79904]: https://github.com/rust-lang/rust/issues/79904
1542 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
1543 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
1544 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
1545 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
1546 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
1547 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
1548 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
1549 [`hint::spin_loop`]: https://doc.rust-lang.org/stable/std/hint/fn.spin_loop.html
1550 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
1551 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
1552 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
1553
1554 Version 1.48.0 (2020-11-19)
1555 ==========================
1556
1557 Language
1558 --------
1559
1560 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
1561   is still rejected *semantically*, but can now be parsed by procedural macros.
1562
1563 Compiler
1564 --------
1565 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
1566   `rustc` whether to link its own C runtime and libraries or to rely on a external
1567   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
1568 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
1569   Note: If you're using cargo you must explicitly pass the `--target` flag.
1570 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
1571
1572 \* Refer to Rust's [platform support page][platform-support-doc] for more
1573 information on Rust's tiered platform support.
1574
1575 Libraries
1576 ---------
1577 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
1578   and `&Stderr`.][76275]
1579 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
1580 - [The `matches!` macro now supports having a trailing comma.][74880]
1581 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
1582 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
1583
1584 Stabilized APIs
1585 ---------------
1586 - [`slice::as_ptr_range`]
1587 - [`slice::as_mut_ptr_range`]
1588 - [`VecDeque::make_contiguous`]
1589 - [`future::pending`]
1590 - [`future::ready`]
1591
1592 The following previously stable methods are now `const fn`'s:
1593
1594 - [`Option::is_some`]
1595 - [`Option::is_none`]
1596 - [`Option::as_ref`]
1597 - [`Result::is_ok`]
1598 - [`Result::is_err`]
1599 - [`Result::as_ref`]
1600 - [`Ordering::reverse`]
1601 - [`Ordering::then`]
1602
1603 Cargo
1604 -----
1605
1606 Rustdoc
1607 -------
1608 - [You can now link to items in `rustdoc` using the intra-doc link
1609   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
1610   a link to `std::future`'s documentation. See ["Linking to items by
1611   name"][intradoc-links] for more information.
1612 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
1613   when searching through `rustdoc`'s UI.][75740]
1614
1615 Compatibility Notes
1616 -------------------
1617 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
1618   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
1619   promoted to `'static` lifetime any more inside `const fn`s.
1620 - [Associated type bindings on trait objects are now verified to meet the bounds
1621   declared on the trait when checking that they implement the trait.][27675]
1622 - [When trait bounds on associated types or opaque types are ambiguous, the
1623   compiler no longer makes an arbitrary choice on which bound to use.][54121]
1624 - [Fixed recursive nonterminals not being expanded in macros during
1625   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
1626   correctly handling recursive nonterminal tokens.
1627 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
1628 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
1629   in places where they have no effect.][73461]
1630 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
1631   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
1632 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
1633   disallow zero-initialization.][71274]
1634 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
1635 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
1636   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
1637   see the [`catch_unwind`] documentation for further information.
1638
1639
1640
1641 Internal Only
1642 -------------
1643 These changes provide no direct user facing benefits, but represent significant
1644 improvements to the internals and overall performance of rustc and
1645 related tools.
1646
1647 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
1648   You can continue building with `make` by setting `ninja=false` in
1649   your `config.toml`.
1650 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
1651 - [Made `ensure_sufficient_stack()` non-generic][76680]
1652
1653 [78143]: https://github.com/rust-lang/rust/issues/78143
1654 [76680]: https://github.com/rust-lang/rust/pull/76680/
1655 [76030]: https://github.com/rust-lang/rust/pull/76030/
1656 [70212]: https://github.com/rust-lang/rust/pull/70212/
1657 [27675]: https://github.com/rust-lang/rust/issues/27675/
1658 [54121]: https://github.com/rust-lang/rust/issues/54121/
1659 [71274]: https://github.com/rust-lang/rust/pull/71274/
1660 [77386]: https://github.com/rust-lang/rust/pull/77386/
1661 [77153]: https://github.com/rust-lang/rust/pull/77153/
1662 [77055]: https://github.com/rust-lang/rust/pull/77055/
1663 [76275]: https://github.com/rust-lang/rust/pull/76275/
1664 [76310]: https://github.com/rust-lang/rust/pull/76310/
1665 [76420]: https://github.com/rust-lang/rust/pull/76420/
1666 [76158]: https://github.com/rust-lang/rust/pull/76158/
1667 [75857]: https://github.com/rust-lang/rust/pull/75857/
1668 [75585]: https://github.com/rust-lang/rust/pull/75585/
1669 [75740]: https://github.com/rust-lang/rust/pull/75740/
1670 [75502]: https://github.com/rust-lang/rust/pull/75502/
1671 [74880]: https://github.com/rust-lang/rust/pull/74880/
1672 [74922]: https://github.com/rust-lang/rust/pull/74922/
1673 [74430]: https://github.com/rust-lang/rust/pull/74430/
1674 [74194]: https://github.com/rust-lang/rust/pull/74194/
1675 [73461]: https://github.com/rust-lang/rust/pull/73461/
1676 [73166]: https://github.com/rust-lang/rust/pull/73166/
1677 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
1678 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
1679 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
1680 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
1681 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
1682 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
1683 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
1684 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
1685 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
1686 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
1687 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
1688 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
1689 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
1690 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
1691 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
1692
1693
1694 Version 1.47.0 (2020-10-08)
1695 ==========================
1696
1697 Language
1698 --------
1699 - [Closures will now warn when not used.][74869]
1700
1701 Compiler
1702 --------
1703 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
1704   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
1705   platforms.
1706 - [Upgraded to LLVM 11.][73526]
1707 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
1708 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
1709 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
1710
1711 \* Refer to Rust's [platform support page][platform-support-doc] for more
1712 information on Rust's tiered platform support.
1713
1714 Libraries
1715 ---------
1716 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
1717 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
1718   those of length less than 33.][74060]
1719 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
1720 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
1721   `PartialEq`, and `PartialOrd`.][73583]
1722
1723 Stabilized APIs
1724 ---------------
1725 - [`Ident::new_raw`]
1726 - [`Range::is_empty`]
1727 - [`RangeInclusive::is_empty`]
1728 - [`Result::as_deref`]
1729 - [`Result::as_deref_mut`]
1730 - [`Vec::leak`]
1731 - [`pointer::offset_from`]
1732 - [`f32::TAU`]
1733 - [`f64::TAU`]
1734
1735 The following previously stable APIs have now been made const.
1736
1737 - [The `new` method for all `NonZero` integers.][73858]
1738 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
1739   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
1740   methods for all integers.][73858]
1741 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
1742   signed integers.][73858]
1743 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
1744   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
1745   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
1746   `is_ascii_control` methods for `char` and `u8`.][73858]
1747
1748 Cargo
1749 -----
1750 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
1751   You can override this by setting the following in your `Cargo.toml`.
1752   ```toml
1753   [profile.release.build-override]
1754   opt-level = 3
1755   ```
1756 - [`cargo-help` will now display man pages for commands rather just the
1757   `--help` text.][cargo/8456]
1758 - [`cargo-metadata` now emits a `test` field indicating if a target has
1759   tests enabled.][cargo/8478]
1760 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
1761 - [`cargo-publish` will now use an alternative registry by default if it's the
1762   only registry specified in `package.publish`.][cargo/8571]
1763
1764 Misc
1765 ----
1766 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
1767   type based search.][75366]
1768 - [Added the Ayu theme to rustdoc.][71237]
1769
1770 Compatibility Notes
1771 -------------------
1772 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
1773 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
1774 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
1775   help to preserve more span information.][73084] These changes may cause
1776   compiliation errors if your macro was unhygenic or didn't correctly handle
1777   `Delimiter::None`.
1778 - [Moved support for the CloudABI target to tier 3.][75568]
1779 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
1780 - [Added the `rustc-docs` component.][75560] This allows you to install
1781   and read the documentation for the compiler internal APIs. (Currently only
1782   available for `x86_64-unknown-linux-gnu`.)
1783
1784 Internal Only
1785 --------
1786
1787 - [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.
1788
1789 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
1790 [75048]: https://github.com/rust-lang/rust/pull/75048/
1791 [74163]: https://github.com/rust-lang/rust/pull/74163/
1792 [71237]: https://github.com/rust-lang/rust/pull/71237/
1793 [74869]: https://github.com/rust-lang/rust/pull/74869/
1794 [73858]: https://github.com/rust-lang/rust/pull/73858/
1795 [75716]: https://github.com/rust-lang/rust/pull/75716/
1796 [75908]: https://github.com/rust-lang/rust/pull/75908/
1797 [75516]: https://github.com/rust-lang/rust/pull/75516/
1798 [75560]: https://github.com/rust-lang/rust/pull/75560/
1799 [75568]: https://github.com/rust-lang/rust/pull/75568/
1800 [75366]: https://github.com/rust-lang/rust/pull/75366/
1801 [75204]: https://github.com/rust-lang/rust/pull/75204/
1802 [74650]: https://github.com/rust-lang/rust/pull/74650/
1803 [74419]: https://github.com/rust-lang/rust/pull/74419/
1804 [73964]: https://github.com/rust-lang/rust/pull/73964/
1805 [74021]: https://github.com/rust-lang/rust/pull/74021/
1806 [74060]: https://github.com/rust-lang/rust/pull/74060/
1807 [73893]: https://github.com/rust-lang/rust/pull/73893/
1808 [73526]: https://github.com/rust-lang/rust/pull/73526/
1809 [73583]: https://github.com/rust-lang/rust/pull/73583/
1810 [73084]: https://github.com/rust-lang/rust/pull/73084/
1811 [73197]: https://github.com/rust-lang/rust/pull/73197/
1812 [72488]: https://github.com/rust-lang/rust/pull/72488/
1813 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
1814 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
1815 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
1816 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
1817 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
1818 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
1819 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
1820 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
1821 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
1822 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
1823 [`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
1824 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
1825 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
1826 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
1827 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
1828
1829
1830 Version 1.46.0 (2020-08-27)
1831 ==========================
1832
1833 Language
1834 --------
1835 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
1836 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
1837   const functions.][73862]
1838 - [The `#[track_caller]` attribute can now be added to functions to use the
1839   function's caller's location information for panic messages.][72445]
1840 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
1841   `x.0.0` over `(x.0).0`.
1842 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
1843   You currently can't use `mem::transmute` in constant functions.
1844
1845 Compiler
1846 --------
1847 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
1848 - [Enabled static "Position Independent Executables" by default
1849   for `x86_64-unknown-linux-musl`.][70740]
1850
1851 Libraries
1852 ---------
1853 - [`mem::forget` is now a `const fn`.][73887]
1854 - [`String` now implements `From<char>`.][73466]
1855 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
1856   integer types.][73032]
1857 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
1858 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
1859   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
1860 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
1861 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
1862 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
1863
1864 Stabilized APIs
1865 ---------------
1866 - [`Option::zip`]
1867 - [`vec::Drain::as_slice`]
1868
1869 Cargo
1870 -----
1871 Added a number of new environment variables that are now available when
1872 compiling your crate.
1873
1874 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
1875   the specific binary being compiled and the name of the crate.
1876 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
1877 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
1878
1879 Compatibility Notes
1880 -------------------
1881 - [The target configuration option `abi_blacklist` has been renamed
1882   to `unsupported_abis`.][74150] The old name will still continue to work.
1883 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
1884   This was previously accepted but will become a hard error in a future release.
1885 - [Rustc will fail to compile if you have a struct with
1886   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
1887   allowed on `enum`s.
1888 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
1889   ensure that spans have the correct information, and may cause breakage if you
1890   were relying on receiving spans with dummy information.
1891 - [The InnoSetup installer for Windows is no longer available.][72569] This was
1892   a legacy installer that was replaced by a MSI installer a few years ago but
1893   was still being built.
1894 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
1895 - [Rustc will no longer accept overlapping trait implementations that only
1896   differ in how the lifetime was bound.][72493]
1897 - [Rustc now correctly relates the lifetime of an existential associated
1898   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
1899   you to pass a shorter lifetime than expected.
1900 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
1901   The library will need to be installed for `rustc` to work, even though we
1902   expect it to be already available on most systems.
1903 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
1904   under QEMU.][74820]
1905 - [Pretty printing of some tokens in procedural macros changed.][75453] The
1906   exact output returned by rustc's pretty printing is an unstable
1907   implementation detail: we recommend any macro relying on it to switch to a
1908   more robust parsing system.
1909
1910 [75453]: https://github.com/rust-lang/rust/issues/75453/
1911 [74820]: https://github.com/rust-lang/rust/issues/74820/
1912 [74420]: https://github.com/rust-lang/rust/issues/74420/
1913 [74109]: https://github.com/rust-lang/rust/pull/74109/
1914 [74150]: https://github.com/rust-lang/rust/pull/74150/
1915 [73862]: https://github.com/rust-lang/rust/pull/73862/
1916 [73887]: https://github.com/rust-lang/rust/pull/73887/
1917 [73466]: https://github.com/rust-lang/rust/pull/73466/
1918 [73516]: https://github.com/rust-lang/rust/pull/73516/
1919 [73293]: https://github.com/rust-lang/rust/pull/73293/
1920 [73007]: https://github.com/rust-lang/rust/pull/73007/
1921 [73032]: https://github.com/rust-lang/rust/pull/73032/
1922 [72920]: https://github.com/rust-lang/rust/pull/72920/
1923 [72569]: https://github.com/rust-lang/rust/pull/72569/
1924 [72583]: https://github.com/rust-lang/rust/pull/72583/
1925 [72584]: https://github.com/rust-lang/rust/pull/72584/
1926 [72717]: https://github.com/rust-lang/rust/pull/72717/
1927 [72437]: https://github.com/rust-lang/rust/pull/72437/
1928 [72445]: https://github.com/rust-lang/rust/pull/72445/
1929 [72486]: https://github.com/rust-lang/rust/pull/72486/
1930 [72493]: https://github.com/rust-lang/rust/pull/72493/
1931 [72331]: https://github.com/rust-lang/rust/pull/72331/
1932 [71896]: https://github.com/rust-lang/rust/pull/71896/
1933 [71660]: https://github.com/rust-lang/rust/pull/71660/
1934 [71322]: https://github.com/rust-lang/rust/pull/71322/
1935 [70740]: https://github.com/rust-lang/rust/pull/70740/
1936 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
1937 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
1938 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
1939 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
1940 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
1941
1942
1943 Version 1.45.2 (2020-08-03)
1944 ==========================
1945
1946 * [Fix bindings in tuple struct patterns][74954]
1947 * [Fix track_caller integration with trait objects][74784]
1948
1949 [74954]: https://github.com/rust-lang/rust/issues/74954
1950 [74784]: https://github.com/rust-lang/rust/issues/74784
1951
1952
1953 Version 1.45.1 (2020-07-30)
1954 ==========================
1955
1956 * [Fix const propagation with references.][73613]
1957 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1958 * [Avoid spurious implicit region bound.][74509]
1959 * [Install clippy on x.py install][74457]
1960
1961 [73613]: https://github.com/rust-lang/rust/pull/73613
1962 [73078]: https://github.com/rust-lang/rust/issues/73078
1963 [74509]: https://github.com/rust-lang/rust/pull/74509
1964 [74457]: https://github.com/rust-lang/rust/pull/74457
1965
1966
1967 Version 1.45.0 (2020-07-16)
1968 ==========================
1969
1970 Language
1971 --------
1972 - [Out of range float to int conversions using `as` has been defined as a saturating
1973   conversion.][71269] This was previously undefined behaviour, but you can use the
1974    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
1975    may be desirable in rare performance sensitive situations.
1976 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
1977   using `u64`.][70705]
1978 - [Function like procedural macros can now be used in expression, pattern, and  statement
1979   positions.][68717] This means you can now use a function-like procedural macro
1980   anywhere you can use a declarative (`macro_rules!`) macro.
1981
1982 Compiler
1983 --------
1984 - [You can now override individual target features through the `target-feature`
1985   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
1986   equivalent to `-C target-feature=+avx2,+fma`.
1987 - [Added the `force-unwind-tables` flag.][69984] This option allows
1988   rustc to always generate unwind tables regardless of panic strategy.
1989 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
1990   to include LLVM bitcode into generated `rlib`s (this is on by default).
1991 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
1992 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
1993 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
1994 - [Upgraded to LLVM 10.][67759]
1995
1996 \* Refer to Rust's [platform support page][platform-support-doc] for more
1997 information on Rust's tiered platform support.
1998
1999
2000 Libraries
2001 ---------
2002 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
2003   and `Ord`.][72239]
2004 - [`proc_macro::TokenStream` now implements `Default`.][72234]
2005 - [You can now use `char` with
2006   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
2007   a range of codepoints.][72413] E.g.
2008   you can now write the following;
2009   ```rust
2010   for ch in 'a'..='z' {
2011       print!("{}", ch);
2012   }
2013   println!();
2014   // Prints "abcdefghijklmnopqrstuvwxyz"
2015   ```
2016 - [`OsString` now implements `FromStr`.][71662]
2017 - [The `saturating_neg` method has been added to all signed integer primitive
2018   types, and the `saturating_abs` method has been added for all integer
2019   primitive types.][71886]
2020 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
2021   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
2022   or `Path`.][71447]
2023 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
2024 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
2025   integer types.][69813]
2026 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
2027   integer types.][72324]
2028 - [The `fetch_update` method has been added to all atomic integer types.][71843]
2029
2030 Stabilized APIs
2031 ---------------
2032 - [`Arc::as_ptr`]
2033 - [`BTreeMap::remove_entry`]
2034 - [`Rc::as_ptr`]
2035 - [`rc::Weak::as_ptr`]
2036 - [`rc::Weak::from_raw`]
2037 - [`rc::Weak::into_raw`]
2038 - [`str::strip_prefix`]
2039 - [`str::strip_suffix`]
2040 - [`sync::Weak::as_ptr`]
2041 - [`sync::Weak::from_raw`]
2042 - [`sync::Weak::into_raw`]
2043 - [`char::UNICODE_VERSION`]
2044 - [`Span::resolved_at`]
2045 - [`Span::located_at`]
2046 - [`Span::mixed_site`]
2047 - [`unix::process::CommandExt::arg0`]
2048
2049 Cargo
2050 -----
2051
2052 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
2053   time.][cargo/8066]
2054
2055 Misc
2056 ----
2057 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
2058   `~~outdated information~~` becomes "~~outdated information~~".
2059 - [Added an emoji to Rustdoc's deprecated API message.][72014]
2060
2061 Compatibility Notes
2062 -------------------
2063 - [Trying to self initialize a static value (that is creating a value using
2064   itself) is unsound and now causes a compile error.][71140]
2065 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
2066   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
2067 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
2068   previously undocumented and not intended for public use. Rustdoc still provides
2069   a non-zero exit code on errors.
2070 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
2071   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
2072   flags while cargo is adding `embed-bitcode` itself. The recommended way to
2073   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
2074   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
2075
2076 Internals Only
2077 --------------
2078 - [Make clippy a git subtree instead of a git submodule][70655]
2079 - [Unify the undo log of all snapshot types][69464]
2080
2081 [71848]: https://github.com/rust-lang/rust/issues/71848/
2082 [73420]: https://github.com/rust-lang/rust/issues/73420/
2083 [72324]: https://github.com/rust-lang/rust/pull/72324/
2084 [71843]: https://github.com/rust-lang/rust/pull/71843/
2085 [71886]: https://github.com/rust-lang/rust/pull/71886/
2086 [72234]: https://github.com/rust-lang/rust/pull/72234/
2087 [72239]: https://github.com/rust-lang/rust/pull/72239/
2088 [72397]: https://github.com/rust-lang/rust/pull/72397/
2089 [72413]: https://github.com/rust-lang/rust/pull/72413/
2090 [72014]: https://github.com/rust-lang/rust/pull/72014/
2091 [72062]: https://github.com/rust-lang/rust/pull/72062/
2092 [72094]: https://github.com/rust-lang/rust/pull/72094/
2093 [72133]: https://github.com/rust-lang/rust/pull/72133/
2094 [67759]: https://github.com/rust-lang/rust/pull/67759/
2095 [71900]: https://github.com/rust-lang/rust/pull/71900/
2096 [71928]: https://github.com/rust-lang/rust/pull/71928/
2097 [71662]: https://github.com/rust-lang/rust/pull/71662/
2098 [71716]: https://github.com/rust-lang/rust/pull/71716/
2099 [71447]: https://github.com/rust-lang/rust/pull/71447/
2100 [71269]: https://github.com/rust-lang/rust/pull/71269/
2101 [71095]: https://github.com/rust-lang/rust/pull/71095/
2102 [71140]: https://github.com/rust-lang/rust/pull/71140/
2103 [70655]: https://github.com/rust-lang/rust/pull/70655/
2104 [70705]: https://github.com/rust-lang/rust/pull/70705/
2105 [69984]: https://github.com/rust-lang/rust/pull/69984/
2106 [69813]: https://github.com/rust-lang/rust/pull/69813/
2107 [69464]: https://github.com/rust-lang/rust/pull/69464/
2108 [68717]: https://github.com/rust-lang/rust/pull/68717/
2109 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
2110 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
2111 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
2112 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
2113 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
2114 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
2115 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
2116 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
2117 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
2118 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
2119 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
2120 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
2121 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
2122 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
2123 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
2124 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
2125 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
2126
2127
2128 Version 1.44.1 (2020-06-18)
2129 ===========================
2130
2131 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
2132 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
2133 * [Fix crashes when finding backtrace on macOS.][71397]
2134 * [Clippy applies lint levels into different files.][clippy/5356]
2135
2136 [71397]: https://github.com/rust-lang/rust/issues/71397
2137 [73078]: https://github.com/rust-lang/rust/issues/73078
2138 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
2139 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
2140
2141
2142 Version 1.44.0 (2020-06-04)
2143 ==========================
2144
2145 Language
2146 --------
2147 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
2148 - [Added the `unused_braces` lint.][70081]
2149
2150 **Syntax-only changes**
2151
2152 - [Expansion-driven outline module parsing][69838]
2153 ```rust
2154 #[cfg(FALSE)]
2155 mod foo {
2156     mod bar {
2157         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
2158     }
2159 }
2160 ```
2161
2162 These are still rejected semantically, so you will likely receive an error but
2163 these changes can be seen and parsed by macros and conditional compilation.
2164
2165 Compiler
2166 --------
2167 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
2168   Additionally when in incremental mode rustc defaults to 256 codegen units.
2169 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
2170   a panic is thrown.][67502]
2171 - [Added tier 3\* support for the `aarch64-unknown-none` and
2172   `aarch64-unknown-none-softfloat` targets.][68334]
2173 - [Added tier 3 support for `arm64-apple-tvos` and
2174   `x86_64-apple-tvos` targets.][68191]
2175
2176
2177 Libraries
2178 ---------
2179 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
2180   `vec![]` to be able to be used in `const` contexts.
2181 - [`convert::Infallible` now implements `Hash`.][70281]
2182 - [`OsString` now implements `DerefMut` and `IndexMut` returning
2183   a `&mut OsStr`.][70048]
2184 - [Unicode 13 is now supported.][69929]
2185 - [`String` now implements `From<&mut str>`.][69661]
2186 - [`IoSlice` now implements `Copy`.][69403]
2187 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
2188 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
2189 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
2190   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
2191   integer types.][69373]
2192
2193 Stabilized APIs
2194 ---------------
2195 - [`PathBuf::with_capacity`]
2196 - [`PathBuf::capacity`]
2197 - [`PathBuf::clear`]
2198 - [`PathBuf::reserve`]
2199 - [`PathBuf::reserve_exact`]
2200 - [`PathBuf::shrink_to_fit`]
2201 - [`f32::to_int_unchecked`]
2202 - [`f64::to_int_unchecked`]
2203 - [`Layout::align_to`]
2204 - [`Layout::pad_to_align`]
2205 - [`Layout::array`]
2206 - [`Layout::extend`]
2207
2208 Cargo
2209 -----
2210 - [Added the `cargo tree` command which will print a tree graph of
2211   your dependencies.][cargo/8062] E.g.
2212   ```
2213     mdbook v0.3.2 (/Users/src/rust/mdbook)
2214   ├── ammonia v3.0.0
2215   │   ├── html5ever v0.24.0
2216   │   │   ├── log v0.4.8
2217   │   │   │   └── cfg-if v0.1.9
2218   │   │   ├── mac v0.1.1
2219   │   │   └── markup5ever v0.9.0
2220   │   │       ├── log v0.4.8 (*)
2221   │   │       ├── phf v0.7.24
2222   │   │       │   └── phf_shared v0.7.24
2223   │   │       │       ├── siphasher v0.2.3
2224   │   │       │       └── unicase v1.4.2
2225   │   │       │           [build-dependencies]
2226   │   │       │           └── version_check v0.1.5
2227   ...
2228   ```
2229   You can also display dependencies on multiple versions of the same crate with
2230   `cargo tree -d` (short for `cargo tree --duplicates`).
2231
2232 Misc
2233 ----
2234 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
2235   the version in the sidebar.][69494]
2236
2237 Compatibility Notes
2238 -------------------
2239 - [Rustc now correctly generates static libraries on Windows GNU targets with
2240   the `.a` extension, rather than the previous `.lib`.][70937]
2241 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
2242 - [The `file_name` property in JSON output of macro errors now points the actual
2243   source file rather than the previous format of `<NAME macros>`.][70969]
2244   **Note:** this may not point to a file that actually exists on the user's system.
2245 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
2246 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
2247   not allow zero initialization such as `NonZeroU8`.][66059] This was
2248   previously a warning.
2249 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
2250   operator has been defined as a saturating operation.][71269] This was previously
2251   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
2252   continue using the current behaviour, which may be desirable in rare performance
2253   sensitive situations.
2254
2255 Internal Only
2256 -------------
2257 These changes provide no direct user facing benefits, but represent significant
2258 improvements to the internals and overall performance of rustc and
2259 related tools.
2260
2261 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
2262 - [Replace big JS dict with JSON parsing.][71250]
2263
2264 [69373]: https://github.com/rust-lang/rust/pull/69373/
2265 [66059]: https://github.com/rust-lang/rust/pull/66059/
2266 [68191]: https://github.com/rust-lang/rust/pull/68191/
2267 [68899]: https://github.com/rust-lang/rust/pull/68899/
2268 [71147]: https://github.com/rust-lang/rust/pull/71147/
2269 [71250]: https://github.com/rust-lang/rust/pull/71250/
2270 [70937]: https://github.com/rust-lang/rust/pull/70937/
2271 [70969]: https://github.com/rust-lang/rust/pull/70969/
2272 [70632]: https://github.com/rust-lang/rust/pull/70632/
2273 [70281]: https://github.com/rust-lang/rust/pull/70281/
2274 [70345]: https://github.com/rust-lang/rust/pull/70345/
2275 [70048]: https://github.com/rust-lang/rust/pull/70048/
2276 [70081]: https://github.com/rust-lang/rust/pull/70081/
2277 [70156]: https://github.com/rust-lang/rust/pull/70156/
2278 [71269]: https://github.com/rust-lang/rust/pull/71269/
2279 [69838]: https://github.com/rust-lang/rust/pull/69838/
2280 [69929]: https://github.com/rust-lang/rust/pull/69929/
2281 [69661]: https://github.com/rust-lang/rust/pull/69661/
2282 [69778]: https://github.com/rust-lang/rust/pull/69778/
2283 [69494]: https://github.com/rust-lang/rust/pull/69494/
2284 [69403]: https://github.com/rust-lang/rust/pull/69403/
2285 [69033]: https://github.com/rust-lang/rust/pull/69033/
2286 [68692]: https://github.com/rust-lang/rust/pull/68692/
2287 [68334]: https://github.com/rust-lang/rust/pull/68334/
2288 [67502]: https://github.com/rust-lang/rust/pull/67502/
2289 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
2290 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
2291 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
2292 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
2293 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
2294 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
2295 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
2296 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
2297 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
2298 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
2299 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
2300 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
2301 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
2302
2303
2304 Version 1.43.1 (2020-05-07)
2305 ===========================
2306
2307 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
2308 * [Fixed the stabilization of AVX-512 features.][71473]
2309 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
2310
2311 [71430]: https://github.com/rust-lang/rust/pull/71430
2312 [71473]: https://github.com/rust-lang/rust/issues/71473
2313 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
2314
2315
2316 Version 1.43.0 (2020-04-23)
2317 ==========================
2318
2319 Language
2320 --------
2321 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
2322   the type inferred correctly.][68129]
2323 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
2324
2325 **Syntax only changes**
2326 - [Allow `type Foo: Ord` syntactically.][69361]
2327 - [Fuse associated and extern items up to defaultness.][69194]
2328 - [Syntactically allow `self` in all `fn` contexts.][68764]
2329 - [Merge `fn` syntax + cleanup item parsing.][68728]
2330 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
2331   For example, you may now write:
2332   ```rust
2333   macro_rules! mac_trait {
2334       ($i:item) => {
2335           trait T { $i }
2336       }
2337   }
2338   mac_trait! {
2339       fn foo() {}
2340   }
2341   ```
2342
2343 These are still rejected *semantically*, so you will likely receive an error but
2344 these changes can be seen and parsed by macros and
2345 conditional compilation.
2346
2347
2348 Compiler
2349 --------
2350 - [You can now pass multiple lint flags to rustc to override the previous
2351   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
2352   everything in the `unused` lint group except `unused-variables` which
2353   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
2354   everything in the `unused` lint group **including** `unused-variables` since
2355   the allow flag is specified before the deny flag (and therefore overridden).
2356 - [rustc will now prefer your system MinGW libraries over its bundled libraries
2357   if they are available on `windows-gnu`.][67429]
2358 - [rustc now buffers errors/warnings printed in JSON.][69227]
2359
2360 Libraries
2361 ---------
2362 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
2363   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
2364   respectively.][69538] **Note** These conversions are only available when `N`
2365   is `0..=32`.
2366 - [You can now use associated constants on floats and integers directly, rather
2367   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
2368   `f32::NAN` with no imports.
2369 - [`u8::is_ascii` is now `const`.][68984]
2370 - [`String` now implements `AsMut<str>`.][68742]
2371 - [Added the `primitive` module to `std` and `core`.][67637] This module
2372   reexports Rust's primitive types. This is mainly useful in macros
2373   where you want avoid these types being shadowed.
2374 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
2375 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
2376
2377 Stabilized APIs
2378 ---------------
2379 - [`Once::is_completed`]
2380 - [`f32::LOG10_2`]
2381 - [`f32::LOG2_10`]
2382 - [`f64::LOG10_2`]
2383 - [`f64::LOG2_10`]
2384 - [`iter::once_with`]
2385
2386 Cargo
2387 -----
2388 - [You can now set config `[profile]`s in your `.cargo/config`, or through
2389   your environment.][cargo/7823]
2390 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
2391   executable path when running integration tests or benchmarks.][cargo/7697]
2392   `<name>` is the name of your binary as-is e.g. If you wanted the executable
2393   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
2394
2395 Misc
2396 ----
2397 - [Certain checks in the `const_err` lint were deemed unrelated to const
2398   evaluation][69185], and have been moved to the `unconditional_panic` and
2399   `arithmetic_overflow` lints.
2400
2401 Compatibility Notes
2402 -------------------
2403
2404 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
2405   has been a warning since 1.36.0.
2406 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
2407   led to some instances being accepted, and now correctly emits a hard error.
2408
2409 [69340]: https://github.com/rust-lang/rust/pull/69340
2410
2411 Internal Only
2412 -------------
2413 These changes provide no direct user facing benefits, but represent significant
2414 improvements to the internals and overall performance of `rustc` and
2415 related tools.
2416
2417 - [All components are now built with `opt-level=3` instead of `2`.][67878]
2418 - [Improved how rustc generates drop code.][67332]
2419 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
2420 - [traits: preallocate 2 Vecs of known initial size][69022]
2421 - [Avoid exponential behaviour when relating types][68772]
2422 - [Skip `Drop` terminators for enum variants without drop glue][68943]
2423 - [Improve performance of coherence checks][68966]
2424 - [Deduplicate types in the generator witness][68672]
2425 - [Invert control in struct_lint_level.][68725]
2426
2427 [67332]: https://github.com/rust-lang/rust/pull/67332/
2428 [67429]: https://github.com/rust-lang/rust/pull/67429/
2429 [67637]: https://github.com/rust-lang/rust/pull/67637/
2430 [67642]: https://github.com/rust-lang/rust/pull/67642/
2431 [67878]: https://github.com/rust-lang/rust/pull/67878/
2432 [67885]: https://github.com/rust-lang/rust/pull/67885/
2433 [68129]: https://github.com/rust-lang/rust/pull/68129/
2434 [68672]: https://github.com/rust-lang/rust/pull/68672/
2435 [68725]: https://github.com/rust-lang/rust/pull/68725/
2436 [68728]: https://github.com/rust-lang/rust/pull/68728/
2437 [68738]: https://github.com/rust-lang/rust/pull/68738/
2438 [68742]: https://github.com/rust-lang/rust/pull/68742/
2439 [68764]: https://github.com/rust-lang/rust/pull/68764/
2440 [68772]: https://github.com/rust-lang/rust/pull/68772/
2441 [68943]: https://github.com/rust-lang/rust/pull/68943/
2442 [68952]: https://github.com/rust-lang/rust/pull/68952/
2443 [68966]: https://github.com/rust-lang/rust/pull/68966/
2444 [68984]: https://github.com/rust-lang/rust/pull/68984/
2445 [69022]: https://github.com/rust-lang/rust/pull/69022/
2446 [69185]: https://github.com/rust-lang/rust/pull/69185/
2447 [69194]: https://github.com/rust-lang/rust/pull/69194/
2448 [69201]: https://github.com/rust-lang/rust/pull/69201/
2449 [69227]: https://github.com/rust-lang/rust/pull/69227/
2450 [69548]: https://github.com/rust-lang/rust/pull/69548/
2451 [69256]: https://github.com/rust-lang/rust/pull/69256/
2452 [69361]: https://github.com/rust-lang/rust/pull/69361/
2453 [69366]: https://github.com/rust-lang/rust/pull/69366/
2454 [69538]: https://github.com/rust-lang/rust/pull/69538/
2455 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
2456 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
2457 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
2458 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
2459 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
2460 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
2461 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
2462 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
2463
2464
2465 Version 1.42.0 (2020-03-12)
2466 ==========================
2467
2468 Language
2469 --------
2470 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
2471   ```rust
2472   fn foo(words: &[&str]) {
2473       match words {
2474           ["Hello", "World", "!", ..] => println!("Hello World!"),
2475           ["Foo", "Bar", ..] => println!("Baz"),
2476           rest => println!("{:?}", rest),
2477       }
2478   }
2479   ```
2480 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
2481   that you can create an enum that has the exact layout and ABI of the type
2482   it contains.
2483 - [You can now use outer attribute procedural macros on inline modules.][64273]
2484 - [There are some *syntax-only* changes:][67131]
2485    - `default` is syntactically allowed before items in `trait` definitions.
2486    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
2487      leave out their bodies in favor of `;`.
2488    - Bounds on associated types in `impl`s are now syntactically allowed
2489      (e.g. `type Foo: Ord;`).
2490    - `...` (the C-variadic type) may occur syntactically directly as the type of
2491       any function parameter.
2492
2493   These are still rejected *semantically*, so you will likely receive an error
2494   but these changes can be seen and parsed by procedural macros and
2495   conditional compilation.
2496
2497 Compiler
2498 --------
2499 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
2500 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
2501 - [`Option::{expect,unwrap}` and
2502    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
2503    pointing to the location where they were called, rather than
2504    `core`'s internals. ][67887]
2505
2506 \* Refer to Rust's [platform support page][platform-support-doc] for more
2507 information on Rust's tiered platform support.
2508
2509 Libraries
2510 ---------
2511 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
2512 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
2513    to implement `Sized`.][67935]
2514 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
2515 - [`Layout::new` is now `const`.][66254]
2516 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
2517
2518
2519 Stabilized APIs
2520 ---------------
2521 - [`CondVar::wait_while`]
2522 - [`CondVar::wait_timeout_while`]
2523 - [`DebugMap::key`]
2524 - [`DebugMap::value`]
2525 - [`ManuallyDrop::take`]
2526 - [`matches!`]
2527 - [`ptr::slice_from_raw_parts_mut`]
2528 - [`ptr::slice_from_raw_parts`]
2529
2530 Cargo
2531 -----
2532 - [You no longer need to include `extern crate proc_macro;` to be able to
2533   `use proc_macro;` in the `2018` edition.][cargo/7700]
2534
2535 Compatibility Notes
2536 -------------------
2537 - [`Error::description` has been deprecated, and its use will now produce a
2538   warning.][66919] It's recommended to use `Display`/`to_string` instead.
2539
2540 [68253]: https://github.com/rust-lang/rust/pull/68253/
2541 [68348]: https://github.com/rust-lang/rust/pull/68348/
2542 [67935]: https://github.com/rust-lang/rust/pull/67935/
2543 [68339]: https://github.com/rust-lang/rust/pull/68339/
2544 [68122]: https://github.com/rust-lang/rust/pull/68122/
2545 [64273]: https://github.com/rust-lang/rust/pull/64273/
2546 [67712]: https://github.com/rust-lang/rust/pull/67712/
2547 [67887]: https://github.com/rust-lang/rust/pull/67887/
2548 [67131]: https://github.com/rust-lang/rust/pull/67131/
2549 [67233]: https://github.com/rust-lang/rust/pull/67233/
2550 [66899]: https://github.com/rust-lang/rust/pull/66899/
2551 [66919]: https://github.com/rust-lang/rust/pull/66919/
2552 [66254]: https://github.com/rust-lang/rust/pull/66254/
2553 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
2554 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
2555 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
2556 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
2557 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
2558 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
2559 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
2560 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
2561 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
2562
2563
2564 Version 1.41.1 (2020-02-27)
2565 ===========================
2566
2567 * [Always check types of static items][69145]
2568 * [Always check lifetime bounds of `Copy` impls][69145]
2569 * [Fix miscompilation in callers of `Layout::repeat`][69225]
2570
2571 [69225]: https://github.com/rust-lang/rust/issues/69225
2572 [69145]: https://github.com/rust-lang/rust/pull/69145
2573
2574
2575 Version 1.41.0 (2020-01-30)
2576 ===========================
2577
2578 Language
2579 --------
2580
2581 - [You can now pass type parameters to foreign items when implementing
2582   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
2583 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
2584   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
2585   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
2586 - [You can now use any valid identifier in a `format_args` macro.][66847]
2587   Previously identifiers starting with an underscore were not allowed.
2588 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
2589   enum variants.][66183] These are still rejected semantically, but
2590   can be seen and parsed by procedural macros and conditional compilation.
2591
2592 Compiler
2593 --------
2594
2595 - [Rustc will now warn if you have unused loop `'label`s.][66325]
2596 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
2597 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
2598 - [You can now pass an arguments file passing the `@path` syntax
2599   to rustc.][66172] Note that the format differs somewhat from what is
2600   found in other tooling; please see [the documentation][argfile-docs] for
2601   more information.
2602 - [You can now provide `--extern` flag without a path, indicating that it is
2603   available from the search path or specified with an `-L` flag.][64882]
2604
2605 \* Refer to Rust's [platform support page][platform-support-doc] for more
2606 information on Rust's tiered platform support.
2607
2608 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
2609
2610 Libraries
2611 ---------
2612
2613 - [The `core::panic` module is now stable.][66771] It was already stable
2614   through `std`.
2615 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
2616   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
2617 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
2618
2619 Stabilized APIs
2620 ---------------
2621
2622 - [`Result::map_or`]
2623 - [`Result::map_or_else`]
2624 - [`std::rc::Weak::weak_count`]
2625 - [`std::rc::Weak::strong_count`]
2626 - [`std::sync::Weak::weak_count`]
2627 - [`std::sync::Weak::strong_count`]
2628
2629 Cargo
2630 -----
2631
2632 - [Cargo will now document all the private items for binary crates
2633   by default.][cargo/7593]
2634 - [`cargo-install` will now reinstall the package if it detects that it is out
2635   of date.][cargo/7560]
2636 - [Cargo.lock now uses a more git friendly format that should help to reduce
2637   merge conflicts.][cargo/7579]
2638 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
2639   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
2640   optimisation level to `2` for debug builds. You can also use
2641   `[profile.<profile>.build-override]` to override build scripts and
2642   their dependencies.
2643
2644 Misc
2645 ----
2646
2647 - [You can now specify `edition` in documentation code blocks to compile the block
2648   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
2649   should be compiled the 2018 edition of Rust.
2650 - [You can now provide custom themes to rustdoc with `--theme`, and check the
2651   current theme with `--check-theme`.][54733]
2652 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
2653
2654 Compatibility Notes
2655 -------------------
2656
2657 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
2658   Apple targets.][apple-32bit-drop] This means that the source code is still
2659   available to build, but the targets are no longer being tested and release
2660   binaries for those platforms will no longer be distributed by the Rust project.
2661   Please refer to the linked blog post for more information.
2662
2663 [54733]: https://github.com/rust-lang/rust/pull/54733/
2664 [61351]: https://github.com/rust-lang/rust/pull/61351/
2665 [67255]: https://github.com/rust-lang/rust/pull/67255/
2666 [66661]: https://github.com/rust-lang/rust/pull/66661/
2667 [66771]: https://github.com/rust-lang/rust/pull/66771/
2668 [66847]: https://github.com/rust-lang/rust/pull/66847/
2669 [66238]: https://github.com/rust-lang/rust/pull/66238/
2670 [66277]: https://github.com/rust-lang/rust/pull/66277/
2671 [66325]: https://github.com/rust-lang/rust/pull/66325/
2672 [66172]: https://github.com/rust-lang/rust/pull/66172/
2673 [66183]: https://github.com/rust-lang/rust/pull/66183/
2674 [65879]: https://github.com/rust-lang/rust/pull/65879/
2675 [65013]: https://github.com/rust-lang/rust/pull/65013/
2676 [64882]: https://github.com/rust-lang/rust/pull/64882/
2677 [64325]: https://github.com/rust-lang/rust/pull/64325/
2678 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
2679 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
2680 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
2681 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
2682 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
2683 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
2684 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
2685 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
2686 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
2687 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
2688 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
2689
2690 Version 1.40.0 (2019-12-19)
2691 ===========================
2692
2693 Language
2694 --------
2695 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
2696   `const` contexts.][65188] e.g.
2697
2698   ```rust
2699   pub struct Point(i32, i32);
2700
2701   const ORIGIN: Point = {
2702       let constructor = Point;
2703
2704       constructor(0, 0)
2705   };
2706   ```
2707
2708 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
2709   indicate that there may be variants or fields added in the future.][64639]
2710   For example this requires adding a wild-card branch (`_ => {}`) to any match
2711   statements on a non-exhaustive `enum`. [(RFC 2008)]
2712 - [You can now use function-like procedural macros in `extern` blocks and in
2713   type positions.][63931] e.g. `type Generated = macro!();`
2714 - [Function-like and attribute procedural macros can now emit
2715   `macro_rules!` items, so you can now have your macros generate macros.][64035]
2716 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
2717   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
2718   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
2719
2720 Compiler
2721 --------
2722 - [Added tier 3 support\* for the
2723   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
2724 - [Added tier 3 support for the
2725   `aarch64-unknown-none-softfloat` target.][64589]
2726 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
2727   `mips64el-unknown-linux-muslabi64` targets.][65843]
2728
2729 \* Refer to Rust's [platform support page][platform-support-doc] for more
2730   information on Rust's tiered platform support.
2731
2732 Libraries
2733 ---------
2734 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
2735
2736 Stabilized APIs
2737 ---------------
2738 - [`BTreeMap::get_key_value`]
2739 - [`HashMap::get_key_value`]
2740 - [`Option::as_deref_mut`]
2741 - [`Option::as_deref`]
2742 - [`Option::flatten`]
2743 - [`UdpSocket::peer_addr`]
2744 - [`f32::to_be_bytes`]
2745 - [`f32::to_le_bytes`]
2746 - [`f32::to_ne_bytes`]
2747 - [`f64::to_be_bytes`]
2748 - [`f64::to_le_bytes`]
2749 - [`f64::to_ne_bytes`]
2750 - [`f32::from_be_bytes`]
2751 - [`f32::from_le_bytes`]
2752 - [`f32::from_ne_bytes`]
2753 - [`f64::from_be_bytes`]
2754 - [`f64::from_le_bytes`]
2755 - [`f64::from_ne_bytes`]
2756 - [`mem::take`]
2757 - [`slice::repeat`]
2758 - [`todo!`]
2759
2760 Cargo
2761 -----
2762 - [Cargo will now always display warnings, rather than only on
2763   fresh builds.][cargo/7450]
2764 - [Feature flags (except `--all-features`) passed to a virtual workspace will
2765   now produce an error.][cargo/7507] Previously these flags were ignored.
2766 - [You can now publish `dev-dependencies` without including
2767   a `version`.][cargo/7333]
2768
2769 Misc
2770 ----
2771 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
2772   when running documentation tests with `rustdoc`.][63803]
2773
2774 Compatibility Notes
2775 -------------------
2776 - [As previously announced, any previous NLL warnings in the 2015 edition are
2777   now hard errors.][64221]
2778 - [The `include!` macro will now warn if it failed to include the
2779   entire file.][64284] The `include!` macro unintentionally only includes the
2780   first _expression_ in a file, and this can be unintuitive. This will become
2781   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
2782 - [Using `#[inline]` on function prototypes and consts now emits a warning under
2783   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
2784   or `extern` blocks now correctly emits a hard error.
2785
2786 [65294]: https://github.com/rust-lang/rust/pull/65294/
2787 [66103]: https://github.com/rust-lang/rust/pull/66103/
2788 [65843]: https://github.com/rust-lang/rust/pull/65843/
2789 [65188]: https://github.com/rust-lang/rust/pull/65188/
2790 [65092]: https://github.com/rust-lang/rust/pull/65092/
2791 [64589]: https://github.com/rust-lang/rust/pull/64589/
2792 [64639]: https://github.com/rust-lang/rust/pull/64639/
2793 [64221]: https://github.com/rust-lang/rust/pull/64221/
2794 [64284]: https://github.com/rust-lang/rust/pull/64284/
2795 [63931]: https://github.com/rust-lang/rust/pull/63931/
2796 [64035]: https://github.com/rust-lang/rust/pull/64035/
2797 [63674]: https://github.com/rust-lang/rust/pull/63674/
2798 [63803]: https://github.com/rust-lang/rust/pull/63803/
2799 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
2800 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
2801 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
2802 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
2803 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
2804 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
2805 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
2806 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
2807 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
2808 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
2809 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
2810 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
2811 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
2812 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
2813 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
2814 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
2815 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
2816 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
2817 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
2818 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
2819 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
2820 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
2821 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
2822 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
2823 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
2824 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
2825
2826
2827 Version 1.39.0 (2019-11-07)
2828 ===========================
2829
2830 Language
2831 --------
2832 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
2833   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
2834 - [You can now use certain attributes on function, closure, and function pointer
2835   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
2836   `deny`, `forbid` as well as inert helper attributes used by procedural macro
2837   attributes applied to items. e.g.
2838   ```rust
2839   fn len(
2840       #[cfg(windows)] slice: &[u16],
2841       #[cfg(not(windows))] slice: &[u8],
2842   ) -> usize {
2843       slice.len()
2844   }
2845   ```
2846 - [You can now take shared references to bind-by-move patterns in the `if` guards
2847   of `match` arms.][63118] e.g.
2848   ```rust
2849   fn main() {
2850       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
2851
2852       match array {
2853           nums
2854   //      ---- `nums` is bound by move.
2855               if nums.iter().sum::<u8>() == 10
2856   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
2857           => {
2858               drop(nums);
2859   //          ----------- Legal as `nums` was bound by move and so we have ownership.
2860           }
2861           _ => unreachable!(),
2862       }
2863   }
2864   ```
2865
2866
2867
2868 Compiler
2869 --------
2870 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
2871 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
2872 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
2873   **Note** Cargo currently doesn't use this feature. Refer to
2874   [cargo#7315][cargo/7315] to track this feature's progress.
2875 - [You can now pass `--show-output` argument to test binaries to print the
2876   output of successful tests.][62600]
2877
2878
2879 \* Refer to Rust's [platform support page][platform-support-doc] for more
2880 information on Rust's tiered platform support.
2881
2882 Libraries
2883 ---------
2884 - [`Vec::new` and `String::new` are now `const` functions.][64028]
2885 - [`LinkedList::new` is now a `const` function.][63684]
2886 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
2887 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
2888   now `const`.][63786]
2889
2890 Stabilized APIs
2891 ---------------
2892 - [`Pin::into_inner`]
2893 - [`Instant::checked_duration_since`]
2894 - [`Instant::saturating_duration_since`]
2895
2896 Cargo
2897 -----
2898 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
2899 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
2900   `--all` is now deprecated.
2901
2902 Misc
2903 ----
2904 - [You can now pass `-Clinker` to rustdoc to control the linker used
2905   for compiling doctests.][63834]
2906
2907 Compatibility Notes
2908 -------------------
2909 - [Code that was previously accepted by the old borrow checker, but rejected by
2910   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
2911   previously a warning, and will also become a hard error in the Rust 2015
2912   edition in the 1.40.0 release.
2913 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
2914   run tests.][63827] This should improve performance when running a large
2915   amount of doctests.
2916 - [The `try!` macro will now issue a deprecation warning.][62672] It is
2917   recommended to use the `?` operator instead.
2918 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
2919   returned `0.0`.
2920
2921 [62600]: https://github.com/rust-lang/rust/pull/62600/
2922 [62672]: https://github.com/rust-lang/rust/pull/62672/
2923 [63118]: https://github.com/rust-lang/rust/pull/63118/
2924 [63209]: https://github.com/rust-lang/rust/pull/63209/
2925 [63402]: https://github.com/rust-lang/rust/pull/63402/
2926 [63565]: https://github.com/rust-lang/rust/pull/63565/
2927 [63595]: https://github.com/rust-lang/rust/pull/63595/
2928 [63684]: https://github.com/rust-lang/rust/pull/63684/
2929 [63698]: https://github.com/rust-lang/rust/pull/63698/
2930 [63770]: https://github.com/rust-lang/rust/pull/63770/
2931 [63786]: https://github.com/rust-lang/rust/pull/63786/
2932 [63827]: https://github.com/rust-lang/rust/pull/63827/
2933 [63834]: https://github.com/rust-lang/rust/pull/63834/
2934 [63927]: https://github.com/rust-lang/rust/pull/63927/
2935 [63933]: https://github.com/rust-lang/rust/pull/63933/
2936 [63934]: https://github.com/rust-lang/rust/pull/63934/
2937 [63938]: https://github.com/rust-lang/rust/pull/63938/
2938 [63940]: https://github.com/rust-lang/rust/pull/63940/
2939 [63941]: https://github.com/rust-lang/rust/pull/63941/
2940 [63945]: https://github.com/rust-lang/rust/pull/63945/
2941 [64010]: https://github.com/rust-lang/rust/pull/64010/
2942 [64028]: https://github.com/rust-lang/rust/pull/64028/
2943 [64334]: https://github.com/rust-lang/rust/pull/64334/
2944 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
2945 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
2946 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
2947 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
2948 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
2949 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
2950
2951 Version 1.38.0 (2019-09-26)
2952 ==========================
2953
2954 Language
2955 --------
2956 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
2957 - [The `#[deprecated]` attribute can now be used on macros.][62042]
2958
2959 Compiler
2960 --------
2961 - [Added pipelined compilation support to `rustc`.][62766] This will
2962   improve compilation times in some cases. For further information please refer
2963   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
2964 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
2965   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
2966   `x86_64-uwp-windows-msvc` targets.][60260]
2967 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
2968   `armv7-unknown-linux-musleabi` targets.][63107]
2969 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
2970 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
2971 - [Upgraded to LLVM 9.][62592]
2972
2973 \* Refer to Rust's [platform support page][platform-support-doc] for more
2974 information on Rust's tiered platform support.
2975
2976 Libraries
2977 ---------
2978 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
2979 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
2980   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
2981   is available at `std::clone::Clone`). This also makes all built-in macros
2982   available in `std`/`core` root. e.g. `std::include_bytes!`.
2983 - [`str::Chars` now implements `Debug`.][63000]
2984 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
2985 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
2986 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
2987 - [Added euclidean remainder and division operations (`div_euclid`,
2988   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
2989   `overflowing`, and `wrapping` versions are available for all
2990   integer primitives.
2991 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
2992   `PartialEq`.][61491]
2993 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
2994
2995 Stabilized APIs
2996 ---------------
2997 - [`<*const T>::cast`]
2998 - [`<*mut T>::cast`]
2999 - [`Duration::as_secs_f32`]
3000 - [`Duration::as_secs_f64`]
3001 - [`Duration::div_f32`]
3002 - [`Duration::div_f64`]
3003 - [`Duration::from_secs_f32`]
3004 - [`Duration::from_secs_f64`]
3005 - [`Duration::mul_f32`]
3006 - [`Duration::mul_f64`]
3007 - [`any::type_name`]
3008
3009 Cargo
3010 -----
3011 - [Added pipelined compilation support to `cargo`.][cargo/7143]
3012 - [You can now pass the `--features` option multiple times to enable
3013   multiple features.][cargo/7084]
3014
3015 Rustdoc
3016 -------
3017
3018 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
3019
3020 Misc
3021 ----
3022 - [`rustc` will now warn about some incorrect uses of
3023   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
3024
3025 Compatibility Notes
3026 -------------------
3027 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
3028   1.38.0.
3029 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
3030   issues][62896] with certain crates such as libc.
3031
3032 [60260]: https://github.com/rust-lang/rust/pull/60260/
3033 [61457]: https://github.com/rust-lang/rust/pull/61457/
3034 [61491]: https://github.com/rust-lang/rust/pull/61491/
3035 [61884]: https://github.com/rust-lang/rust/pull/61884/
3036 [61953]: https://github.com/rust-lang/rust/pull/61953/
3037 [62042]: https://github.com/rust-lang/rust/pull/62042/
3038 [62528]: https://github.com/rust-lang/rust/pull/62528/
3039 [62583]: https://github.com/rust-lang/rust/pull/62583/
3040 [62735]: https://github.com/rust-lang/rust/pull/62735/
3041 [62766]: https://github.com/rust-lang/rust/pull/62766/
3042 [62784]: https://github.com/rust-lang/rust/pull/62784/
3043 [62592]: https://github.com/rust-lang/rust/pull/62592/
3044 [62785]: https://github.com/rust-lang/rust/issues/62785/
3045 [62814]: https://github.com/rust-lang/rust/pull/62814/
3046 [62896]: https://github.com/rust-lang/rust/issues/62896/
3047 [63000]: https://github.com/rust-lang/rust/pull/63000/
3048 [63056]: https://github.com/rust-lang/rust/pull/63056/
3049 [63107]: https://github.com/rust-lang/rust/pull/63107/
3050 [63346]: https://github.com/rust-lang/rust/pull/63346/
3051 [63421]: https://github.com/rust-lang/rust/pull/63421/
3052 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
3053 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
3054 [63048]: https://github.com/rust-lang/rust/pull/63048
3055 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
3056 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
3057 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
3058 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
3059 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
3060 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
3061 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
3062 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
3063 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
3064 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
3065 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
3066 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
3067 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
3068
3069 Version 1.37.0 (2019-08-15)
3070 ==========================
3071
3072 Language
3073 --------
3074 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
3075   [`Box`][62228], or an [array][62235] and unused.
3076 - [You can now use the `cfg` and `cfg_attr` attributes on
3077   generic parameters.][61547]
3078 - [You can now use enum variants through type alias.][61682] e.g. You can
3079   write the following:
3080   ```rust
3081   type MyOption = Option<u8>;
3082
3083   fn increment_or_zero(x: MyOption) -> u8 {
3084       match x {
3085           MyOption::Some(y) => y + 1,
3086           MyOption::None => 0,
3087       }
3088   }
3089   ```
3090 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
3091   `const _: u32 = 5;`.
3092 - [You can now use `#[repr(align(X)]` on enums.][61229]
3093 - [The  `?` Kleene macro operator is now available in the
3094   2015 edition.][60932]
3095
3096 Compiler
3097 --------
3098 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
3099   and `-C profile-use` flags.][61268] For more information on how to use profile
3100   guided optimization, please refer to the [rustc book][rustc-book-pgo].
3101 - [The `rust-lldb` wrapper script should now work again.][61827]
3102
3103 Libraries
3104 ---------
3105 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
3106
3107 Stabilized APIs
3108 ---------------
3109 - [`BufReader::buffer`]
3110 - [`BufWriter::buffer`]
3111 - [`Cell::from_mut`]
3112 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
3113 - [`DoubleEndedIterator::nth_back`]
3114 - [`Option::xor`]
3115 - [`Wrapping::reverse_bits`]
3116 - [`i128::reverse_bits`]
3117 - [`i16::reverse_bits`]
3118 - [`i32::reverse_bits`]
3119 - [`i64::reverse_bits`]
3120 - [`i8::reverse_bits`]
3121 - [`isize::reverse_bits`]
3122 - [`slice::copy_within`]
3123 - [`u128::reverse_bits`]
3124 - [`u16::reverse_bits`]
3125 - [`u32::reverse_bits`]
3126 - [`u64::reverse_bits`]
3127 - [`u8::reverse_bits`]
3128 - [`usize::reverse_bits`]
3129
3130 Cargo
3131 -----
3132 - [`Cargo.lock` files are now included by default when publishing executable crates
3133   with executables.][cargo/7026]
3134 - [You can now specify `default-run="foo"` in `[package]` to specify the
3135   default executable to use for `cargo run`.][cargo/7056]
3136
3137 Misc
3138 ----
3139
3140 Compatibility Notes
3141 -------------------
3142 - [Using `...` for inclusive range patterns will now warn by default.][61342]
3143   Please transition your code to using the `..=` syntax for inclusive
3144   ranges instead.
3145 - [Using a trait object without the `dyn` will now warn by default.][61203]
3146   Please transition your code to use `dyn Trait` for trait objects instead.
3147
3148 [62228]: https://github.com/rust-lang/rust/pull/62228/
3149 [62235]: https://github.com/rust-lang/rust/pull/62235/
3150 [61802]: https://github.com/rust-lang/rust/pull/61802/
3151 [61827]: https://github.com/rust-lang/rust/pull/61827/
3152 [61547]: https://github.com/rust-lang/rust/pull/61547/
3153 [61682]: https://github.com/rust-lang/rust/pull/61682/
3154 [61268]: https://github.com/rust-lang/rust/pull/61268/
3155 [61342]: https://github.com/rust-lang/rust/pull/61342/
3156 [61347]: https://github.com/rust-lang/rust/pull/61347/
3157 [61100]: https://github.com/rust-lang/rust/pull/61100/
3158 [61203]: https://github.com/rust-lang/rust/pull/61203/
3159 [61229]: https://github.com/rust-lang/rust/pull/61229/
3160 [60932]: https://github.com/rust-lang/rust/pull/60932/
3161 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
3162 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
3163 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
3164 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
3165 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
3166 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
3167 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
3168 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
3169 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
3170 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
3171 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
3172 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
3173 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
3174 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
3175 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
3176 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
3177 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
3178 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
3179 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
3180 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
3181 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
3182 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
3183 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
3184 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
3185
3186
3187 Version 1.36.0 (2019-07-04)
3188 ==========================
3189
3190 Language
3191 --------
3192 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
3193 - [The order of traits in trait objects no longer affects the semantics of that
3194   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
3195   `dyn fmt::Debug + Send`, where this was previously not the case.
3196
3197 Libraries
3198 ---------
3199 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
3200 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
3201 - [`mem::needs_drop` is now available as a const fn.][60364]
3202 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
3203 - [`String` now implements `BorrowMut<str>`.][60404]
3204 - [`io::Cursor` now implements `Default`.][60234]
3205 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
3206 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
3207   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
3208   environment has access to heap memory allocation.
3209 - [`String` now implements `From<&String>`.][59825]
3210 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
3211   return a tuple of each argument when there is multiple arguments.
3212 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
3213   not used.][59648]
3214
3215 Stabilized APIs
3216 ---------------
3217 - [`VecDeque::rotate_left`]
3218 - [`VecDeque::rotate_right`]
3219 - [`Iterator::copied`]
3220 - [`io::IoSlice`]
3221 - [`io::IoSliceMut`]
3222 - [`Read::read_vectored`]
3223 - [`Write::write_vectored`]
3224 - [`str::as_mut_ptr`]
3225 - [`mem::MaybeUninit`]
3226 - [`pointer::align_offset`]
3227 - [`future::Future`]
3228 - [`task::Context`]
3229 - [`task::RawWaker`]
3230 - [`task::RawWakerVTable`]
3231 - [`task::Waker`]
3232 - [`task::Poll`]
3233
3234 Cargo
3235 -----
3236 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
3237 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
3238
3239 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
3240
3241 Clippy
3242 ------
3243 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
3244
3245 Misc
3246 ----
3247
3248 Compatibility Notes
3249 -------------------
3250 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
3251   longer recommended, and will be deprecated in 1.39.0.
3252
3253 [60318]: https://github.com/rust-lang/rust/pull/60318/
3254 [60364]: https://github.com/rust-lang/rust/pull/60364/
3255 [60370]: https://github.com/rust-lang/rust/pull/60370/
3256 [60404]: https://github.com/rust-lang/rust/pull/60404/
3257 [60234]: https://github.com/rust-lang/rust/pull/60234/
3258 [60244]: https://github.com/rust-lang/rust/pull/60244/
3259 [58623]: https://github.com/rust-lang/rust/pull/58623/
3260 [59648]: https://github.com/rust-lang/rust/pull/59648/
3261 [59675]: https://github.com/rust-lang/rust/pull/59675/
3262 [59825]: https://github.com/rust-lang/rust/pull/59825/
3263 [59826]: https://github.com/rust-lang/rust/pull/59826/
3264 [59445]: https://github.com/rust-lang/rust/pull/59445/
3265 [59114]: https://github.com/rust-lang/rust/pull/59114/
3266 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
3267 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
3268 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
3269 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
3270 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
3271 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
3272 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
3273 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
3274 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
3275 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
3276 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
3277 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
3278 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
3279 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
3280 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
3281 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
3282 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
3283 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
3284 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
3285 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
3286
3287
3288 Version 1.35.0 (2019-05-23)
3289 ==========================
3290
3291 Language
3292 --------
3293 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
3294   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
3295 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
3296   ```rust
3297   unsafe fn call_unsafe(func: unsafe fn()) {
3298       func()
3299   }
3300
3301   pub fn main() {
3302       unsafe { call_unsafe(|| {}); }
3303   }
3304   ```
3305
3306
3307 Compiler
3308 --------
3309 - [Added the `armv6-unknown-freebsd-gnueabihf` and
3310   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
3311 - [Added the `wasm32-unknown-wasi` target.][59464]
3312
3313
3314 Libraries
3315 ---------
3316 - [`Thread` will now show its ID in `Debug` output.][59460]
3317 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
3318 - [`alloc::System` now implements `Default`.][59451]
3319 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
3320   last field.][59076]
3321 - [`char::{ToLowercase, ToUppercase}` now
3322   implement `ExactSizeIterator`.][58778]
3323 - [All `NonZero` numeric types now implement `FromStr`.][58717]
3324 - [Removed the `Read` trait bounds
3325   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
3326 - [You can now call the `dbg!` macro without any parameters to print the file
3327   and line where it is called.][57847]
3328 - [In place ASCII case conversions are now up to 4× faster.][59283]
3329   e.g. `str::make_ascii_lowercase`
3330 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
3331   and `Send`.][58369]
3332
3333 Stabilized APIs
3334 ---------------
3335 - [`f32::copysign`]
3336 - [`f64::copysign`]
3337 - [`RefCell::replace_with`]
3338 - [`RefCell::map_split`]
3339 - [`ptr::hash`]
3340 - [`Range::contains`]
3341 - [`RangeFrom::contains`]
3342 - [`RangeTo::contains`]
3343 - [`RangeInclusive::contains`]
3344 - [`RangeToInclusive::contains`]
3345 - [`Option::copied`]
3346
3347 Cargo
3348 -----
3349 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
3350   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
3351   platform specific.
3352
3353 Misc
3354 ----
3355 - [The Rust toolchain is now available natively for musl based distros.][58575]
3356
3357 [59460]: https://github.com/rust-lang/rust/pull/59460/
3358 [59464]: https://github.com/rust-lang/rust/pull/59464/
3359 [59500]: https://github.com/rust-lang/rust/pull/59500/
3360 [59512]: https://github.com/rust-lang/rust/pull/59512/
3361 [59580]: https://github.com/rust-lang/rust/pull/59580/
3362 [59283]: https://github.com/rust-lang/rust/pull/59283/
3363 [59451]: https://github.com/rust-lang/rust/pull/59451/
3364 [59076]: https://github.com/rust-lang/rust/pull/59076/
3365 [58778]: https://github.com/rust-lang/rust/pull/58778/
3366 [58717]: https://github.com/rust-lang/rust/pull/58717/
3367 [58369]: https://github.com/rust-lang/rust/pull/58369/
3368 [58423]: https://github.com/rust-lang/rust/pull/58423/
3369 [58080]: https://github.com/rust-lang/rust/pull/58080/
3370 [57847]: https://github.com/rust-lang/rust/pull/57847/
3371 [58575]: https://github.com/rust-lang/rust/pull/58575
3372 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
3373 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
3374 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
3375 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
3376 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
3377 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
3378 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
3379 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
3380 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
3381 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
3382 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
3383 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
3384
3385 Version 1.34.2 (2019-05-14)
3386 ===========================
3387
3388 * [Destabilize the `Error::type_id` function due to a security
3389    vulnerability][60785] ([CVE-2019-12083])
3390
3391 [60785]: https://github.com/rust-lang/rust/pull/60785
3392 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
3393
3394 Version 1.34.1 (2019-04-25)
3395 ===========================
3396
3397 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
3398 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
3399 * [Fix Clippy panic when checking some macros][clippy/3805]
3400
3401 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
3402 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
3403 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
3404
3405 Version 1.34.0 (2019-04-11)
3406 ==========================
3407
3408 Language
3409 --------
3410 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
3411   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
3412   but had no effect.
3413 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
3414   `#[attr{}]` procedural macros.][57367]
3415 - [You can now write `extern crate self as foo;`][57407] to import your
3416   crate's root into the extern prelude.
3417
3418
3419 Compiler
3420 --------
3421 - [You can now target `riscv64imac-unknown-none-elf` and
3422   `riscv64gc-unknown-none-elf`.][58406]
3423 - [You can now enable linker plugin LTO optimisations with
3424   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
3425   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
3426   boundaries.
3427 - [You can now target `powerpc64-unknown-freebsd`.][57809]
3428
3429
3430 Libraries
3431 ---------
3432 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
3433   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
3434   the `Hash` trait to create an iterator.
3435 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
3436   methods.][58421] Most notably you no longer require the `Ord` trait to create
3437   an iterator.
3438 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
3439   for all numeric types.][58044]
3440 - [Indexing a `str` is now generic over all types that
3441   implement `SliceIndex<str>`.][57604]
3442 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
3443   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
3444   produce a warning if their returning type is unused.
3445 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
3446   `overflowing_pow` are now available for all numeric types.][57873] These are
3447   equivalent to methods such as `wrapping_add` for the `pow` operation.
3448
3449
3450 Stabilized APIs
3451 ---------------
3452
3453 #### std & core
3454 * [`Any::type_id`]
3455 * [`Error::type_id`]
3456 * [`atomic::AtomicI16`]
3457 * [`atomic::AtomicI32`]
3458 * [`atomic::AtomicI64`]
3459 * [`atomic::AtomicI8`]
3460 * [`atomic::AtomicU16`]
3461 * [`atomic::AtomicU32`]
3462 * [`atomic::AtomicU64`]
3463 * [`atomic::AtomicU8`]
3464 * [`convert::Infallible`]
3465 * [`convert::TryFrom`]
3466 * [`convert::TryInto`]
3467 * [`iter::from_fn`]
3468 * [`iter::successors`]
3469 * [`num::NonZeroI128`]
3470 * [`num::NonZeroI16`]
3471 * [`num::NonZeroI32`]
3472 * [`num::NonZeroI64`]
3473 * [`num::NonZeroI8`]
3474 * [`num::NonZeroIsize`]
3475 * [`slice::sort_by_cached_key`]
3476 * [`str::escape_debug`]
3477 * [`str::escape_default`]
3478 * [`str::escape_unicode`]
3479 * [`str::split_ascii_whitespace`]
3480
3481 #### std
3482 * [`Instant::checked_add`]
3483 * [`Instant::checked_sub`]
3484 * [`SystemTime::checked_add`]
3485 * [`SystemTime::checked_sub`]
3486
3487 Cargo
3488 -----
3489 - [You can now use alternative registries to crates.io.][cargo/6654]
3490
3491 Misc
3492 ----
3493 - [You can now use the `?` operator in your documentation tests without manually
3494   adding `fn main() -> Result<(), _> {}`.][56470]
3495
3496 Compatibility Notes
3497 -------------------
3498 - [`Command::before_exec` is being replaced by the unsafe method
3499   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
3500 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
3501   can now use `const` functions in `static` variables.
3502
3503 [58370]: https://github.com/rust-lang/rust/pull/58370/
3504 [58406]: https://github.com/rust-lang/rust/pull/58406/
3505 [58421]: https://github.com/rust-lang/rust/pull/58421/
3506 [58166]: https://github.com/rust-lang/rust/pull/58166/
3507 [58044]: https://github.com/rust-lang/rust/pull/58044/
3508 [58057]: https://github.com/rust-lang/rust/pull/58057/
3509 [58059]: https://github.com/rust-lang/rust/pull/58059/
3510 [57809]: https://github.com/rust-lang/rust/pull/57809/
3511 [57873]: https://github.com/rust-lang/rust/pull/57873/
3512 [57604]: https://github.com/rust-lang/rust/pull/57604/
3513 [57367]: https://github.com/rust-lang/rust/pull/57367/
3514 [57407]: https://github.com/rust-lang/rust/pull/57407/
3515 [57425]: https://github.com/rust-lang/rust/pull/57425/
3516 [57106]: https://github.com/rust-lang/rust/pull/57106/
3517 [56470]: https://github.com/rust-lang/rust/pull/56470/
3518 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
3519 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
3520 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
3521 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
3522 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
3523 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
3524 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
3525 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
3526 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
3527 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
3528 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
3529 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
3530 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
3531 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
3532 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
3533 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
3534 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
3535 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
3536 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
3537 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
3538 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
3539 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
3540 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
3541 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
3542 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
3543 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
3544 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
3545 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
3546 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
3547 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
3548 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
3549
3550
3551 Version 1.33.0 (2019-02-28)
3552 ==========================
3553
3554 Language
3555 --------
3556 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
3557   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
3558 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
3559   E.g. You can have match statement on a `u8` that covers `0..=255` and
3560   you would no longer be required to have a `_ => unreachable!()` case.
3561 - [You can now have multiple patterns in `if let` and `while let`
3562   expressions.][57532] You can do this with the same syntax as a `match`
3563   expression. E.g.
3564   ```rust
3565   enum Creature {
3566       Crab(String),
3567       Lobster(String),
3568       Person(String),
3569   }
3570
3571   fn main() {
3572       let state = Creature::Crab("Ferris");
3573
3574       if let Creature::Crab(name) | Creature::Person(name) = state {
3575           println!("This creature's name is: {}", name);
3576       }
3577   }
3578   ```
3579 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
3580   this feature will by default produce a warning as this behaviour can be
3581   unintuitive. E.g. `if let _ = 5 {}`
3582 - [You can now use `let` bindings, assignments, expression statements,
3583   and irrefutable pattern destructuring in const functions.][57175]
3584 - [You can now call unsafe const functions.][57067] E.g.
3585   ```rust
3586   const unsafe fn foo() -> i32 { 5 }
3587   const fn bar() -> i32 {
3588       unsafe { foo() }
3589   }
3590   ```
3591 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
3592   E.g. `#[cfg_attr(all(), must_use, optimize)]`
3593 - [You can now specify a specific alignment with the `#[repr(packed)]`
3594   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
3595   with an alignment of 2 bytes and a size of 6 bytes.
3596 - [You can now import an item from a module as an `_`.][56303] This allows you to
3597   import a trait's impls, and not have the name in the namespace. E.g.
3598   ```rust
3599   use std::io::Read as _;
3600
3601   // Allowed as there is only one `Read` in the module.
3602   pub trait Read {}
3603   ```
3604 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
3605
3606 Compiler
3607 --------
3608 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
3609   command line argument.][56351]
3610 - [The minimum required LLVM version has been bumped to 6.0.][56642]
3611 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
3612 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
3613   tier 2 support.][57130] Visit the [platform support][platform-support] page for
3614   information on Rust's platform support.
3615 - [Added support for the `thumbv7neon-linux-androideabi` and
3616   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
3617 - [Added support for the `x86_64-unknown-uefi` target.][56769]
3618
3619 Libraries
3620 ---------
3621 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
3622   functions for all numeric types.][57566]
3623 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
3624   are now `const` functions for all numeric types.][57105]
3625 - [The methods `is_positive` and `is_negative` are now `const` functions for
3626   all signed numeric types.][57105]
3627 - [The `get` method for all `NonZero` types is now `const`.][57167]
3628 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
3629   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
3630   numeric types.][57234]
3631 - [`Ipv4Addr::new` is now a `const` function][57234]
3632
3633 Stabilized APIs
3634 ---------------
3635 - [`unix::FileExt::read_exact_at`]
3636 - [`unix::FileExt::write_all_at`]
3637 - [`Option::transpose`]
3638 - [`Result::transpose`]
3639 - [`convert::identity`]
3640 - [`pin::Pin`]
3641 - [`marker::Unpin`]
3642 - [`marker::PhantomPinned`]
3643 - [`Vec::resize_with`]
3644 - [`VecDeque::resize_with`]
3645 - [`Duration::as_millis`]
3646 - [`Duration::as_micros`]
3647 - [`Duration::as_nanos`]
3648
3649
3650 Cargo
3651 -----
3652 - [You can now publish crates that require a feature flag to compile with
3653   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
3654 - [Cargo should now rebuild a crate if a file was modified during the initial
3655   build.][cargo/6484]
3656
3657 Compatibility Notes
3658 -------------------
3659 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
3660   are now deprecated in the standard library, and their usage will now produce a warning.
3661   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
3662   methods instead.
3663 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
3664   downcasting.
3665 - [Libtest no longer creates a new thread for each test when
3666   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
3667
3668 [55982]: https://github.com/rust-lang/rust/pull/55982/
3669 [56243]: https://github.com/rust-lang/rust/pull/56243
3670 [56303]: https://github.com/rust-lang/rust/pull/56303/
3671 [56351]: https://github.com/rust-lang/rust/pull/56351/
3672 [56362]: https://github.com/rust-lang/rust/pull/56362
3673 [56642]: https://github.com/rust-lang/rust/pull/56642/
3674 [56769]: https://github.com/rust-lang/rust/pull/56769/
3675 [56805]: https://github.com/rust-lang/rust/pull/56805
3676 [56947]: https://github.com/rust-lang/rust/pull/56947/
3677 [57049]: https://github.com/rust-lang/rust/pull/57049/
3678 [57067]: https://github.com/rust-lang/rust/pull/57067/
3679 [57105]: https://github.com/rust-lang/rust/pull/57105
3680 [57130]: https://github.com/rust-lang/rust/pull/57130/
3681 [57167]: https://github.com/rust-lang/rust/pull/57167/
3682 [57175]: https://github.com/rust-lang/rust/pull/57175/
3683 [57234]: https://github.com/rust-lang/rust/pull/57234/
3684 [57332]: https://github.com/rust-lang/rust/pull/57332/
3685 [57465]: https://github.com/rust-lang/rust/pull/57465/
3686 [57532]: https://github.com/rust-lang/rust/pull/57532/
3687 [57535]: https://github.com/rust-lang/rust/pull/57535/
3688 [57566]: https://github.com/rust-lang/rust/pull/57566/
3689 [57615]: https://github.com/rust-lang/rust/pull/57615/
3690 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
3691 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
3692 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
3693 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
3694 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
3695 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
3696 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
3697 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
3698 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
3699 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
3700 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
3701 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
3702 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
3703 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
3704 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
3705 [platform-support]: https://forge.rust-lang.org/platform-support.html
3706
3707 Version 1.32.0 (2019-01-17)
3708 ==========================
3709
3710 Language
3711 --------
3712 #### 2018 edition
3713 - [You can now use the `?` operator in macro definitions.][56245] The `?`
3714   operator allows you to specify zero or one repetitions similar to the `*` and
3715   `+` operators.
3716 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
3717   now always resolve to the item (`enum`, `struct`, etc.) available in the
3718   module if present, before resolving to a external crate or an item the prelude.][56759]
3719   E.g.
3720   ```rust
3721   enum Color { Red, Green, Blue }
3722
3723   use Color::*;
3724   ```
3725
3726 #### All editions
3727 - [You can now match against `PhantomData<T>` types.][55837]
3728 - [You can now match against literals in macros with the `literal`
3729   specifier.][56072] This will match against a literal of any type.
3730   E.g. `1`, `'A'`, `"Hello World"`
3731 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
3732   ```rust
3733   struct Point(i32, i32);
3734
3735   impl Point {
3736       pub fn new(x: i32, y: i32) -> Self {
3737           Self(x, y)
3738       }
3739
3740       pub fn is_origin(&self) -> bool {
3741           match self {
3742               Self(0, 0) => true,
3743               _ => false,
3744           }
3745       }
3746   }
3747   ```
3748 - [Self can also now be used in type definitions.][56366] E.g.
3749   ```rust
3750   enum List<T>
3751   where
3752       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
3753   {
3754       Nil,
3755       Cons(T, Box<Self>) // likewise here
3756   }
3757   ```
3758 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
3759   a `impl Trait` or `dyn Trait` is returned and unused in the program.
3760
3761 Compiler
3762 --------
3763 - [The default allocator has changed from jemalloc to the default allocator on
3764   your system.][55238] The compiler itself on Linux & macOS will still use
3765   jemalloc, but programs compiled with it will use the system allocator.
3766 - [Added the `aarch64-pc-windows-msvc` target.][55702]
3767
3768 Libraries
3769 ---------
3770 - [`PathBuf` now implements `FromStr`.][55148]
3771 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
3772 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
3773   easily debug expressions in your rust program. E.g.
3774   ```rust
3775   let a = 2;
3776   let b = dbg!(a * 2) + 1;
3777   //      ^-- prints: [src/main.rs:4] a * 2 = 4
3778   assert_eq!(b, 5);
3779   ```
3780
3781 The following APIs are now `const` functions and can be used in a
3782 `const` context.
3783
3784 - [`Cell::as_ptr`]
3785 - [`UnsafeCell::get`]
3786 - [`char::is_ascii`]
3787 - [`iter::empty`]
3788 - [`ManuallyDrop::new`]
3789 - [`ManuallyDrop::into_inner`]
3790 - [`RangeInclusive::start`]
3791 - [`RangeInclusive::end`]
3792 - [`NonNull::as_ptr`]
3793 - [`slice::as_ptr`]
3794 - [`str::as_ptr`]
3795 - [`Duration::as_secs`]
3796 - [`Duration::subsec_millis`]
3797 - [`Duration::subsec_micros`]
3798 - [`Duration::subsec_nanos`]
3799 - [`CStr::as_ptr`]
3800 - [`Ipv4Addr::is_unspecified`]
3801 - [`Ipv6Addr::new`]
3802 - [`Ipv6Addr::octets`]
3803
3804 Stabilized APIs
3805 ---------------
3806 - [`i8::to_be_bytes`]
3807 - [`i8::to_le_bytes`]
3808 - [`i8::to_ne_bytes`]
3809 - [`i8::from_be_bytes`]
3810 - [`i8::from_le_bytes`]
3811 - [`i8::from_ne_bytes`]
3812 - [`i16::to_be_bytes`]
3813 - [`i16::to_le_bytes`]
3814 - [`i16::to_ne_bytes`]
3815 - [`i16::from_be_bytes`]
3816 - [`i16::from_le_bytes`]
3817 - [`i16::from_ne_bytes`]
3818 - [`i32::to_be_bytes`]
3819 - [`i32::to_le_bytes`]
3820 - [`i32::to_ne_bytes`]
3821 - [`i32::from_be_bytes`]
3822 - [`i32::from_le_bytes`]
3823 - [`i32::from_ne_bytes`]
3824 - [`i64::to_be_bytes`]
3825 - [`i64::to_le_bytes`]
3826 - [`i64::to_ne_bytes`]
3827 - [`i64::from_be_bytes`]
3828 - [`i64::from_le_bytes`]
3829 - [`i64::from_ne_bytes`]
3830 - [`i128::to_be_bytes`]
3831 - [`i128::to_le_bytes`]
3832 - [`i128::to_ne_bytes`]
3833 - [`i128::from_be_bytes`]
3834 - [`i128::from_le_bytes`]
3835 - [`i128::from_ne_bytes`]
3836 - [`isize::to_be_bytes`]
3837 - [`isize::to_le_bytes`]
3838 - [`isize::to_ne_bytes`]
3839 - [`isize::from_be_bytes`]
3840 - [`isize::from_le_bytes`]
3841 - [`isize::from_ne_bytes`]
3842 - [`u8::to_be_bytes`]
3843 - [`u8::to_le_bytes`]
3844 - [`u8::to_ne_bytes`]
3845 - [`u8::from_be_bytes`]
3846 - [`u8::from_le_bytes`]
3847 - [`u8::from_ne_bytes`]
3848 - [`u16::to_be_bytes`]
3849 - [`u16::to_le_bytes`]
3850 - [`u16::to_ne_bytes`]
3851 - [`u16::from_be_bytes`]
3852 - [`u16::from_le_bytes`]
3853 - [`u16::from_ne_bytes`]
3854 - [`u32::to_be_bytes`]
3855 - [`u32::to_le_bytes`]
3856 - [`u32::to_ne_bytes`]
3857 - [`u32::from_be_bytes`]
3858 - [`u32::from_le_bytes`]
3859 - [`u32::from_ne_bytes`]
3860 - [`u64::to_be_bytes`]
3861 - [`u64::to_le_bytes`]
3862 - [`u64::to_ne_bytes`]
3863 - [`u64::from_be_bytes`]
3864 - [`u64::from_le_bytes`]
3865 - [`u64::from_ne_bytes`]
3866 - [`u128::to_be_bytes`]
3867 - [`u128::to_le_bytes`]
3868 - [`u128::to_ne_bytes`]
3869 - [`u128::from_be_bytes`]
3870 - [`u128::from_le_bytes`]
3871 - [`u128::from_ne_bytes`]
3872 - [`usize::to_be_bytes`]
3873 - [`usize::to_le_bytes`]
3874 - [`usize::to_ne_bytes`]
3875 - [`usize::from_be_bytes`]
3876 - [`usize::from_le_bytes`]
3877 - [`usize::from_ne_bytes`]
3878
3879 Cargo
3880 -----
3881 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
3882 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
3883
3884 Misc
3885 ----
3886 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
3887
3888 Compatibility Notes
3889 -------------------
3890 - [The argument types for AVX's
3891   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
3892   been changed from `*const` to `*mut` as the previous implementation
3893   was unsound.
3894
3895
3896 [55148]: https://github.com/rust-lang/rust/pull/55148/
3897 [55238]: https://github.com/rust-lang/rust/pull/55238/
3898 [55280]: https://github.com/rust-lang/rust/pull/55280/
3899 [55610]: https://github.com/rust-lang/rust/pull/55610/
3900 [55663]: https://github.com/rust-lang/rust/pull/55663/
3901 [55702]: https://github.com/rust-lang/rust/pull/55702/
3902 [55837]: https://github.com/rust-lang/rust/pull/55837/
3903 [55843]: https://github.com/rust-lang/rust/pull/55843/
3904 [56072]: https://github.com/rust-lang/rust/pull/56072/
3905 [56245]: https://github.com/rust-lang/rust/pull/56245/
3906 [56365]: https://github.com/rust-lang/rust/pull/56365/
3907 [56366]: https://github.com/rust-lang/rust/pull/56366/
3908 [56395]: https://github.com/rust-lang/rust/pull/56395/
3909 [56759]: https://github.com/rust-lang/rust/pull/56759/
3910 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
3911 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
3912 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
3913 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
3914 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
3915 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3916 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3917 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
3918 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
3919 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
3920 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
3921 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
3922 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
3923 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
3924 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
3925 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
3926 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
3927 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
3928 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
3929 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
3930 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
3931 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
3932 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
3933 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
3934 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
3935 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
3936 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
3937 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
3938 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
3939 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
3940 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
3941 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
3942 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
3943 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
3944 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
3945 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
3946 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
3947 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
3948 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
3949 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
3950 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
3951 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
3952 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
3953 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
3954 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
3955 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
3956 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
3957 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
3958 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
3959 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
3960 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
3961 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
3962 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
3963 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
3964 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
3965 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
3966 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
3967 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
3968 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
3969 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
3970 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
3971 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
3972 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
3973 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
3974 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
3975 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
3976 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
3977 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
3978 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
3979 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
3980 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
3981 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
3982 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
3983 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
3984 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
3985 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
3986 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
3987 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
3988 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
3989 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
3990 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
3991 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
3992 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
3993 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
3994 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
3995 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
3996 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
3997 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
3998 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
3999 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
4000 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
4001 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
4002 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
4003
4004
4005 Version 1.31.1 (2018-12-20)
4006 ===========================
4007
4008 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
4009 - [Fix broken go-to-definition in RLS][rls/1171]
4010 - [Fix infinite loop on hover in RLS][rls/1170]
4011
4012 [56562]: https://github.com/rust-lang/rust/pull/56562
4013 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
4014 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
4015
4016 Version 1.31.0 (2018-12-06)
4017 ==========================
4018
4019 Language
4020 --------
4021 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
4022 - [New lifetime elision rules now allow for eliding lifetimes in functions and
4023   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
4024   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
4025   in structs.
4026 - [You can now define and use `const` functions.][54835] These are currently
4027   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
4028   [language reference][const-reference] for what exactly is available.
4029 - [You can now use tool lints, which allow you to scope lints from external
4030   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
4031 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
4032   a crate, not just in exported functions.][54451]
4033 - [You can now use parentheses in pattern matches.][54497]
4034
4035 Compiler
4036 --------
4037 - [Updated musl to 1.1.20][54430]
4038
4039 Libraries
4040 ---------
4041 - [You can now convert `num::NonZero*` types to their raw equivalents using the
4042   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
4043 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
4044   into `Option<&mut T>` using the `From` trait.][53218]
4045 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
4046
4047
4048 Stabilized APIs
4049 ---------------
4050 - [`slice::align_to`]
4051 - [`slice::align_to_mut`]
4052 - [`slice::chunks_exact`]
4053 - [`slice::chunks_exact_mut`]
4054 - [`slice::rchunks`]
4055 - [`slice::rchunks_mut`]
4056 - [`slice::rchunks_exact`]
4057 - [`slice::rchunks_exact_mut`]
4058 - [`Option::replace`]
4059
4060 Cargo
4061 -----
4062 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
4063 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
4064   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
4065
4066 [52813]: https://github.com/rust-lang/rust/pull/52813/
4067 [53218]: https://github.com/rust-lang/rust/pull/53218/
4068 [53555]: https://github.com/rust-lang/rust/issues/53555/
4069 [54057]: https://github.com/rust-lang/rust/pull/54057/
4070 [54240]: https://github.com/rust-lang/rust/pull/54240/
4071 [54430]: https://github.com/rust-lang/rust/pull/54430/
4072 [54451]: https://github.com/rust-lang/rust/pull/54451/
4073 [54497]: https://github.com/rust-lang/rust/pull/54497/
4074 [54778]: https://github.com/rust-lang/rust/pull/54778/
4075 [54835]: https://github.com/rust-lang/rust/pull/54835/
4076 [54870]: https://github.com/rust-lang/rust/pull/54870/
4077 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
4078 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
4079 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
4080 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
4081 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
4082 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
4083 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
4084 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
4085 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
4086 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
4087 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
4088 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
4089 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
4090 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
4091
4092 Version 1.30.1 (2018-11-08)
4093 ===========================
4094
4095 - [Fixed overflow ICE in rustdoc][54199]
4096 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
4097
4098 [54199]: https://github.com/rust-lang/rust/pull/54199
4099 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
4100
4101 Version 1.30.0 (2018-10-25)
4102 ==========================
4103
4104 Language
4105 --------
4106 - [Procedural macros are now available.][52081] These kinds of macros allow for
4107   more powerful code generation. There is a [new chapter available][proc-macros]
4108   in the Rust Programming Language book that goes further in depth.
4109 - [You can now use keywords as identifiers using the raw identifiers
4110   syntax (`r#`),][53236] e.g. `let r#for = true;`
4111 - [Using anonymous parameters in traits is now deprecated with a warning and
4112   will be a hard error in the 2018 edition.][53272]
4113 - [You can now use `crate` in paths.][54404] This allows you to refer to the
4114   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
4115 - [Using a external crate no longer requires being prefixed with `::`.][54404]
4116   Previously, using a external crate in a module without a use statement
4117   required `let json = ::serde_json::from_str(foo);` but can now be written
4118   as `let json = serde_json::from_str(foo);`.
4119 - [You can now apply the `#[used]` attribute to static items to prevent the
4120   compiler from optimising them away, even if they appear to be unused,][51363]
4121   e.g. `#[used] static FOO: u32 = 1;`
4122 - [You can now import and reexport macros from other crates with the `use`
4123   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
4124   the root module of the crate. If your macro relies on calling other local
4125   macros, it is recommended to export with the
4126   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
4127   those macros.
4128 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
4129   using the `vis` specifier.][53370]
4130 - [Non-macro attributes now allow all forms of literals, not just
4131   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
4132   write `#[attr(true)]`.
4133 - [You can now specify a function to handle a panic in the Rust runtime with the
4134   `#[panic_handler]` attribute.][51366]
4135
4136 Compiler
4137 --------
4138 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
4139 - [Added the `aarch64-unknown-netbsd` target][53165]
4140 - [Upgraded to LLVM 8.][53611]
4141
4142 Libraries
4143 ---------
4144 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
4145
4146 Stabilized APIs
4147 ---------------
4148 - [`Ipv4Addr::BROADCAST`]
4149 - [`Ipv4Addr::LOCALHOST`]
4150 - [`Ipv4Addr::UNSPECIFIED`]
4151 - [`Ipv6Addr::LOCALHOST`]
4152 - [`Ipv6Addr::UNSPECIFIED`]
4153 - [`Iterator::find_map`]
4154
4155   The following methods are replacement methods for `trim_left`, `trim_right`,
4156   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
4157   in 1.33.0:
4158 - [`str::trim_end_matches`]
4159 - [`str::trim_end`]
4160 - [`str::trim_start_matches`]
4161 - [`str::trim_start`]
4162
4163 Cargo
4164 ----
4165 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
4166 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
4167   equivalent to calling `rustdoc --error-format=json`.
4168 - [Cargo will now provide a progress bar for builds.][cargo/5995]
4169
4170 Misc
4171 ----
4172 - [`rustdoc` allows you to specify what edition to treat your code as with the
4173   `--edition` option.][54057]
4174 - [`rustdoc` now has the `--color` (specify whether to output color) and
4175   `--error-format` (specify error format, e.g. `json`) options.][53003]
4176 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
4177   debug symbols.][53774]
4178 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
4179   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
4180
4181 [50911]: https://github.com/rust-lang/rust/pull/50911/
4182 [51363]: https://github.com/rust-lang/rust/pull/51363/
4183 [51366]: https://github.com/rust-lang/rust/pull/51366/
4184 [52081]: https://github.com/rust-lang/rust/pull/52081/
4185 [53003]: https://github.com/rust-lang/rust/pull/53003/
4186 [53033]: https://github.com/rust-lang/rust/pull/53033/
4187 [53044]: https://github.com/rust-lang/rust/pull/53044/
4188 [53165]: https://github.com/rust-lang/rust/pull/53165/
4189 [53611]: https://github.com/rust-lang/rust/pull/53611/
4190 [53213]: https://github.com/rust-lang/rust/pull/53213/
4191 [53236]: https://github.com/rust-lang/rust/pull/53236/
4192 [53272]: https://github.com/rust-lang/rust/pull/53272/
4193 [53370]: https://github.com/rust-lang/rust/pull/53370/
4194 [53459]: https://github.com/rust-lang/rust/pull/53459/
4195 [53774]: https://github.com/rust-lang/rust/pull/53774/
4196 [53822]: https://github.com/rust-lang/rust/pull/53822/
4197 [54057]: https://github.com/rust-lang/rust/pull/54057/
4198 [54146]: https://github.com/rust-lang/rust/pull/54146/
4199 [54404]: https://github.com/rust-lang/rust/pull/54404/
4200 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
4201 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
4202 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
4203 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
4204
4205 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
4206 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
4207 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
4208 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
4209 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
4210 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
4211 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
4212 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
4213 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
4214 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
4215
4216
4217 Version 1.29.2 (2018-10-11)
4218 ===========================
4219
4220 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
4221 - The `rls-preview` component on the windows-gnu targets has been restored.
4222
4223 [54639]: https://github.com/rust-lang/rust/pull/54639
4224
4225
4226 Version 1.29.1 (2018-09-25)
4227 ===========================
4228
4229 Security Notes
4230 --------------
4231
4232 - The standard library's `str::repeat` function contained an out of bounds write
4233   caused by an integer overflow. This has been fixed by deterministically
4234   panicking when an overflow happens.
4235
4236   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
4237   us.
4238
4239
4240 Version 1.29.0 (2018-09-13)
4241 ==========================
4242
4243 Compiler
4244 --------
4245 - [Bumped minimum LLVM version to 5.0.][51899]
4246 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
4247 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
4248 - [Upgraded to LLVM 7.][51966]
4249
4250 Libraries
4251 ---------
4252 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
4253 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
4254 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
4255 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
4256   for `&str`.][51178]
4257 - [`Cell<T>` now allows `T` to be unsized.][50494]
4258 - [`SocketAddr` is now stable on Redox.][52656]
4259
4260 Stabilized APIs
4261 ---------------
4262 - [`Arc::downcast`]
4263 - [`Iterator::flatten`]
4264 - [`Rc::downcast`]
4265
4266 Cargo
4267 -----
4268 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
4269   `--locked` to disable this behavior.
4270 - [`cargo-install` will now allow you to cross compile an install
4271   using `--target`.][cargo/5614]
4272 - [Added the `cargo-fix` subcommand to automatically move project code from
4273   2015 edition to 2018.][cargo/5723]
4274 - [`cargo doc` can now optionally document private types using the
4275   `--document-private-items` flag.][cargo/5543]
4276
4277 Misc
4278 ----
4279 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
4280   the specified level to that level.][52354] For example `--cap-lints warn`
4281   will demote `deny` and `forbid` lints to `warn`.
4282 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
4283   fails and `101` if there is a panic.][52197]
4284 - [A preview of clippy has been made available through rustup.][51122]
4285   You can install the preview with `rustup component add clippy-preview`.
4286
4287 Compatibility Notes
4288 -------------------
4289 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
4290   Use `str::get_unchecked(begin..end)` instead.
4291 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
4292   Consider using the `home_dir` function from
4293   https://crates.io/crates/dirs instead.
4294 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
4295 - [`cfg` attributes and `--cfg` command line flags are now more
4296   strictly validated.][53893]
4297
4298 [53893]: https://github.com/rust-lang/rust/pull/53893/
4299 [52861]: https://github.com/rust-lang/rust/pull/52861/
4300 [51966]: https://github.com/rust-lang/rust/pull/51966/
4301 [52656]: https://github.com/rust-lang/rust/pull/52656/
4302 [52239]: https://github.com/rust-lang/rust/pull/52239/
4303 [52330]: https://github.com/rust-lang/rust/pull/52330/
4304 [52354]: https://github.com/rust-lang/rust/pull/52354/
4305 [52402]: https://github.com/rust-lang/rust/pull/52402/
4306 [52103]: https://github.com/rust-lang/rust/pull/52103/
4307 [52197]: https://github.com/rust-lang/rust/pull/52197/
4308 [51807]: https://github.com/rust-lang/rust/pull/51807/
4309 [51899]: https://github.com/rust-lang/rust/pull/51899/
4310 [51912]: https://github.com/rust-lang/rust/pull/51912/
4311 [51511]: https://github.com/rust-lang/rust/pull/51511/
4312 [51619]: https://github.com/rust-lang/rust/pull/51619/
4313 [51656]: https://github.com/rust-lang/rust/pull/51656/
4314 [51178]: https://github.com/rust-lang/rust/pull/51178/
4315 [51122]: https://github.com/rust-lang/rust/pull/51122
4316 [50494]: https://github.com/rust-lang/rust/pull/50494/
4317 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
4318 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
4319 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
4320 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
4321 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
4322 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
4323 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
4324
4325
4326 Version 1.28.0 (2018-08-02)
4327 ===========================
4328
4329 Language
4330 --------
4331 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
4332   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
4333   the inner type across Foreign Function Interface (FFI) boundaries.
4334 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
4335   and can now be used as identifiers.][51196]
4336 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
4337   stable.][51241] This will allow users to specify a global allocator for
4338   their program.
4339 - [Unit test functions marked with the `#[test]` attribute can now return
4340   `Result<(), E: Debug>` in addition to `()`.][51298]
4341 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
4342   allows macros to easily target lifetimes.
4343
4344 Compiler
4345 --------
4346 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
4347   prioritise making smaller binary sizes. `z` is the same as `s` with the
4348   exception that it does not vectorise loops, which typically results in an even
4349   smaller binary.
4350 - [The short error format is now stable.][49546] Specified with
4351   `--error-format=short` this option will provide a more compressed output of
4352   rust error messages.
4353 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
4354 - [Reduced the number of allocations in the macro parser.][50855] This can
4355   improve compile times of macro heavy crates on average by 5%.
4356
4357 Libraries
4358 ---------
4359 - [Implemented `Default` for `&mut str`.][51306]
4360 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
4361 - [Implemented `Extend` for `()`.][50234]
4362 - [The `Debug` implementation of `time::Duration` should now be more easily
4363   human readable.][50364] Previously a `Duration` of one second would printed as
4364   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
4365 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
4366   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
4367   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
4368   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
4369   for `PathBuf`.][50170]
4370 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
4371   and `Wrapping<i128>`.][50465]
4372 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
4373   possible.][51050] This can provide up to a 40% speed increase.
4374 - [Improved error messages when using `format!`.][50610]
4375
4376 Stabilized APIs
4377 ---------------
4378 - [`Iterator::step_by`]
4379 - [`Path::ancestors`]
4380 - [`SystemTime::UNIX_EPOCH`]
4381 - [`alloc::GlobalAlloc`]
4382 - [`alloc::Layout`]
4383 - [`alloc::LayoutErr`]
4384 - [`alloc::System`]
4385 - [`alloc::alloc`]
4386 - [`alloc::alloc_zeroed`]
4387 - [`alloc::dealloc`]
4388 - [`alloc::realloc`]
4389 - [`alloc::handle_alloc_error`]
4390 - [`btree_map::Entry::or_default`]
4391 - [`fmt::Alignment`]
4392 - [`hash_map::Entry::or_default`]
4393 - [`iter::repeat_with`]
4394 - [`num::NonZeroUsize`]
4395 - [`num::NonZeroU128`]
4396 - [`num::NonZeroU16`]
4397 - [`num::NonZeroU32`]
4398 - [`num::NonZeroU64`]
4399 - [`num::NonZeroU8`]
4400 - [`ops::RangeBounds`]
4401 - [`slice::SliceIndex`]
4402 - [`slice::from_mut`]
4403 - [`slice::from_ref`]
4404 - [`{Any + Send + Sync}::downcast_mut`]
4405 - [`{Any + Send + Sync}::downcast_ref`]
4406 - [`{Any + Send + Sync}::is`]
4407
4408 Cargo
4409 -----
4410 - [Cargo will now no longer allow you to publish crates with build scripts that
4411   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
4412   considered to be immutable.
4413
4414 Misc
4415 ----
4416 - [The `suggestion_applicability` field in `rustc`'s json output is now
4417   stable.][50486] This will allow dev tools to check whether a code suggestion
4418   would apply to them.
4419
4420 Compatibility Notes
4421 -------------------
4422 - [Rust will consider trait objects with duplicated constraints to be the same
4423   type as without the duplicated constraint.][51276] For example the below code will
4424   now fail to compile.
4425   ```rust
4426   trait Trait {}
4427
4428   impl Trait + Send {
4429       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
4430   }
4431
4432   impl Trait + Send + Send {
4433       fn test(&self) { println!("two"); }
4434   }
4435   ```
4436
4437 [49546]: https://github.com/rust-lang/rust/pull/49546/
4438 [50143]: https://github.com/rust-lang/rust/pull/50143/
4439 [50170]: https://github.com/rust-lang/rust/pull/50170/
4440 [50234]: https://github.com/rust-lang/rust/pull/50234/
4441 [50265]: https://github.com/rust-lang/rust/pull/50265/
4442 [50364]: https://github.com/rust-lang/rust/pull/50364/
4443 [50385]: https://github.com/rust-lang/rust/pull/50385/
4444 [50465]: https://github.com/rust-lang/rust/pull/50465/
4445 [50486]: https://github.com/rust-lang/rust/pull/50486/
4446 [50554]: https://github.com/rust-lang/rust/pull/50554/
4447 [50610]: https://github.com/rust-lang/rust/pull/50610/
4448 [50855]: https://github.com/rust-lang/rust/pull/50855/
4449 [51050]: https://github.com/rust-lang/rust/pull/51050/
4450 [51196]: https://github.com/rust-lang/rust/pull/51196/
4451 [51200]: https://github.com/rust-lang/rust/pull/51200/
4452 [51241]: https://github.com/rust-lang/rust/pull/51241/
4453 [51276]: https://github.com/rust-lang/rust/pull/51276/
4454 [51298]: https://github.com/rust-lang/rust/pull/51298/
4455 [51306]: https://github.com/rust-lang/rust/pull/51306/
4456 [51562]: https://github.com/rust-lang/rust/pull/51562/
4457 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
4458 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
4459 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
4460 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
4461 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
4462 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
4463 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
4464 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
4465 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
4466 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
4467 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
4468 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
4469 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
4470 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
4471 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
4472 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
4473 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
4474 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
4475 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
4476 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
4477 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
4478 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
4479 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
4480 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
4481 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
4482 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
4483 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
4484 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
4485 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
4486 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
4487
4488 Version 1.27.2 (2018-07-20)
4489 ===========================
4490
4491 Compatibility Notes
4492 -------------------
4493
4494 - The borrow checker was fixed to avoid potential unsoundness when using
4495   match ergonomics: [#52213][52213].
4496
4497 [52213]: https://github.com/rust-lang/rust/issues/52213
4498
4499 Version 1.27.1 (2018-07-10)
4500 ===========================
4501
4502 Security Notes
4503 --------------
4504
4505 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
4506   when running, which enabled executing code as some other user on a
4507   given machine. This release fixes that vulnerability; you can read
4508   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
4509
4510   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
4511
4512 Compatibility Notes
4513 -------------------
4514
4515 - The borrow checker was fixed to avoid an additional potential unsoundness when using
4516   match ergonomics: [#51415][51415], [#49534][49534].
4517
4518 [51415]: https://github.com/rust-lang/rust/issues/51415
4519 [49534]: https://github.com/rust-lang/rust/issues/49534
4520 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
4521 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
4522
4523 Version 1.27.0 (2018-06-21)
4524 ==========================
4525
4526 Language
4527 --------
4528 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
4529   be used as an identifier.
4530 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
4531   bare `Trait` syntax, and should make it clearer when being used in tandem with
4532   `impl Trait` because it is equivalent to the following syntax:
4533   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
4534   `Box<Trait> == Box<dyn Trait>`.
4535 - [Attributes on generic parameters such as types and lifetimes are
4536   now stable.][48851] e.g.
4537   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
4538 - [The `#[must_use]` attribute can now also be used on functions as well as
4539   types.][48925] It provides a lint that by default warns users when the
4540   value returned by a function has not been used.
4541
4542 Compiler
4543 --------
4544 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
4545
4546 Libraries
4547 ---------
4548 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
4549   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
4550   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
4551   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
4552   the `cfg` attribute.
4553 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
4554   std are now available in core.][49896]
4555 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
4556   to `Self`.][49630]
4557 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
4558   that the operation isn't done in place.
4559 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
4560   the `#[must_use]` attribute][49533] to warn about unused potentially
4561   expensive allocations.
4562
4563 Stabilized APIs
4564 ---------------
4565 - [`DoubleEndedIterator::rfind`]
4566 - [`DoubleEndedIterator::rfold`]
4567 - [`DoubleEndedIterator::try_rfold`]
4568 - [`Duration::from_micros`]
4569 - [`Duration::from_nanos`]
4570 - [`Duration::subsec_micros`]
4571 - [`Duration::subsec_millis`]
4572 - [`HashMap::remove_entry`]
4573 - [`Iterator::try_fold`]
4574 - [`Iterator::try_for_each`]
4575 - [`NonNull::cast`]
4576 - [`Option::filter`]
4577 - [`String::replace_range`]
4578 - [`Take::set_limit`]
4579 - [`hint::unreachable_unchecked`]
4580 - [`os::unix::process::parent_id`]
4581 - [`ptr::swap_nonoverlapping`]
4582 - [`slice::rsplit_mut`]
4583 - [`slice::rsplit`]
4584 - [`slice::swap_with_slice`]
4585
4586 Cargo
4587 -----
4588 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
4589   `readme`, and `repository` fields.][cargo/5386]
4590 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
4591 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
4592   a different directory than `target` for placing compilation artifacts.
4593 - [Cargo will be adding automatic target inference for binaries, benchmarks,
4594   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
4595   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
4596   where cargo would infer a binary, Cargo will produce a warning. You can
4597   disable this feature ahead of time by setting any of the following to false:
4598   `autobins`, `autobenches`, `autoexamples`, `autotests`.
4599 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
4600   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
4601
4602 Misc
4603 ----
4604 - [Added “The Rustc book” into the official documentation.][49707]
4605   [“The Rustc book”] documents and teaches how to use the rustc compiler.
4606 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
4607
4608 Compatibility Notes
4609 -------------------
4610 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
4611   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
4612   compile, `"".is_empty()` will still compile.
4613 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
4614   will only print the inner type.][48553] E.g.
4615   `print!("{:?}", AtomicBool::new(true))` will print `true`,
4616   not `AtomicBool(true)`.
4617 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
4618   could enter higher numbers but they were not supported by LLVM. Up to 512MB
4619   alignment should cover all use cases.
4620 - The `.description()` method on the `std::error::Error` trait
4621   [has been soft-deprecated][50163]. It is no longer required to implement it.
4622
4623 [48553]: https://github.com/rust-lang/rust/pull/48553/
4624 [48851]: https://github.com/rust-lang/rust/pull/48851/
4625 [48925]: https://github.com/rust-lang/rust/pull/48925/
4626 [49533]: https://github.com/rust-lang/rust/pull/49533/
4627 [49623]: https://github.com/rust-lang/rust/pull/49623/
4628 [49630]: https://github.com/rust-lang/rust/pull/49630/
4629 [49664]: https://github.com/rust-lang/rust/pull/49664/
4630 [49699]: https://github.com/rust-lang/rust/pull/49699/
4631 [49707]: https://github.com/rust-lang/rust/pull/49707/
4632 [49719]: https://github.com/rust-lang/rust/pull/49719/
4633 [49896]: https://github.com/rust-lang/rust/pull/49896/
4634 [49968]: https://github.com/rust-lang/rust/pull/49968/
4635 [50163]: https://github.com/rust-lang/rust/pull/50163
4636 [50177]: https://github.com/rust-lang/rust/pull/50177/
4637 [50378]: https://github.com/rust-lang/rust/pull/50378/
4638 [50398]: https://github.com/rust-lang/rust/pull/50398/
4639 [50423]: https://github.com/rust-lang/rust/pull/50423/
4640 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
4641 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
4642 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
4643 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
4644 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
4645 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
4646 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
4647 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
4648 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
4649 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
4650 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
4651 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
4652 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
4653 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
4654 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
4655 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
4656 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
4657 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
4658 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
4659 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
4660 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
4661 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
4662 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4663 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
4664 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
4665 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
4666 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
4667 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
4668 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
4669 [“The Rustc book”]: https://doc.rust-lang.org/rustc
4670
4671
4672 Version 1.26.2 (2018-06-05)
4673 ==========================
4674
4675 Compatibility Notes
4676 -------------------
4677
4678 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
4679
4680 [51117]: https://github.com/rust-lang/rust/issues/51117
4681
4682
4683 Version 1.26.1 (2018-05-29)
4684 ==========================
4685
4686 Tools
4687 -----
4688
4689 - [RLS now works on Windows.][50646]
4690 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
4691
4692
4693 Compatibility Notes
4694 --------
4695
4696 - [`fn main() -> impl Trait` no longer works for non-Termination
4697   trait.][50656]
4698   This reverts an accidental stabilization.
4699 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
4700 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
4701
4702 [50646]: https://github.com/rust-lang/rust/issues/50646
4703 [50656]: https://github.com/rust-lang/rust/pull/50656
4704 [50812]: https://github.com/rust-lang/rust/pull/50812
4705 [50950]: https://github.com/rust-lang/rust/issues/50950
4706 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
4707
4708 Version 1.26.0 (2018-05-10)
4709 ==========================
4710
4711 Language
4712 --------
4713 - [Closures now implement `Copy` and/or `Clone` if all captured variables
4714   implement either or both traits.][49299]
4715 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
4716 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
4717   lifetime can be elided.][49458]
4718 - [`impl Trait` is now stable allowing you to have abstract types in returns
4719    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
4720   `fn open(path: impl AsRef<Path>)`.
4721 - [Pattern matching will now automatically apply dereferences.][49394]
4722 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
4723 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
4724 - [A lot of operations are now available in a const context.][46882] E.g. You
4725   can now index into constant arrays, reference and dereference into constants,
4726   and use tuple struct constructors.
4727 - [Fixed entry slice patterns are now stable.][48516] E.g.
4728   ```rust
4729   let points = [1, 2, 3, 4];
4730   match points {
4731       [1, 2, 3, 4] => println!("All points were sequential."),
4732       _ => println!("Not all points were sequential."),
4733   }
4734   ```
4735
4736
4737 Compiler
4738 --------
4739 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
4740 - [Fixed exponential projection complexity on nested types.][48296]
4741   This can provide up to a ~12% reduction in compile times for certain crates.
4742 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
4743   to remap path prefixes outputted by the compiler.
4744 - [Added `powerpc-unknown-netbsd` target.][48281]
4745
4746 Libraries
4747 ---------
4748 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
4749 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
4750   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
4751 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
4752 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
4753 - [`ascii::escape_default` is now available in libcore.][48735]
4754 - [Trailing commas are now supported in std and core macros.][48056]
4755 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
4756 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
4757
4758 Stabilized APIs
4759 ---------------
4760 - [`*const T::add`]
4761 - [`*const T::copy_to_nonoverlapping`]
4762 - [`*const T::copy_to`]
4763 - [`*const T::read_unaligned`]
4764 - [`*const T::read_volatile`]
4765 - [`*const T::read`]
4766 - [`*const T::sub`]
4767 - [`*const T::wrapping_add`]
4768 - [`*const T::wrapping_sub`]
4769 - [`*mut T::add`]
4770 - [`*mut T::copy_to_nonoverlapping`]
4771 - [`*mut T::copy_to`]
4772 - [`*mut T::read_unaligned`]
4773 - [`*mut T::read_volatile`]
4774 - [`*mut T::read`]
4775 - [`*mut T::replace`]
4776 - [`*mut T::sub`]
4777 - [`*mut T::swap`]
4778 - [`*mut T::wrapping_add`]
4779 - [`*mut T::wrapping_sub`]
4780 - [`*mut T::write_bytes`]
4781 - [`*mut T::write_unaligned`]
4782 - [`*mut T::write_volatile`]
4783 - [`*mut T::write`]
4784 - [`Box::leak`]
4785 - [`FromUtf8Error::as_bytes`]
4786 - [`LocalKey::try_with`]
4787 - [`Option::cloned`]
4788 - [`btree_map::Entry::and_modify`]
4789 - [`fs::read_to_string`]
4790 - [`fs::read`]
4791 - [`fs::write`]
4792 - [`hash_map::Entry::and_modify`]
4793 - [`iter::FusedIterator`]
4794 - [`ops::RangeInclusive`]
4795 - [`ops::RangeToInclusive`]
4796 - [`process::id`]
4797 - [`slice::rotate_left`]
4798 - [`slice::rotate_right`]
4799 - [`String::retain`]
4800
4801
4802 Cargo
4803 -----
4804 - [Cargo will now output path to custom commands when `-v` is
4805   passed with `--list`][cargo/5041]
4806 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
4807
4808 Misc
4809 ----
4810 - [The second edition of "The Rust Programming Language" book is now recommended
4811   over the first.][48404]
4812
4813 Compatibility Notes
4814 -------------------
4815
4816 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
4817   syntax is now invalid.
4818   ```
4819   use std::ops::Fn as dyn;
4820   fn g(_: Box<dyn(std::fmt::Debug)>) {}
4821   ```
4822 - [The result of dereferences are no longer promoted to `'static`.][47408]
4823   e.g.
4824   ```rust
4825   fn main() {
4826       const PAIR: &(i32, i32) = &(0, 1);
4827       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
4828   }
4829   ```
4830 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
4831 - [`".e0"` will now no longer parse as `0.0` and will instead cause
4832   an error.][48235]
4833 - [Removed hoedown from rustdoc.][48274]
4834 - [Bounds on higher-kinded lifetimes a hard error.][48326]
4835
4836 [46882]: https://github.com/rust-lang/rust/pull/46882
4837 [47379]: https://github.com/rust-lang/rust/pull/47379
4838 [47408]: https://github.com/rust-lang/rust/pull/47408
4839 [47813]: https://github.com/rust-lang/rust/pull/47813
4840 [48056]: https://github.com/rust-lang/rust/pull/48056
4841 [48125]: https://github.com/rust-lang/rust/pull/48125
4842 [48166]: https://github.com/rust-lang/rust/pull/48166
4843 [48235]: https://github.com/rust-lang/rust/pull/48235
4844 [48274]: https://github.com/rust-lang/rust/pull/48274
4845 [48281]: https://github.com/rust-lang/rust/pull/48281
4846 [48296]: https://github.com/rust-lang/rust/pull/48296
4847 [48326]: https://github.com/rust-lang/rust/pull/48326
4848 [48359]: https://github.com/rust-lang/rust/pull/48359
4849 [48404]: https://github.com/rust-lang/rust/pull/48404
4850 [48481]: https://github.com/rust-lang/rust/pull/48481
4851 [48516]: https://github.com/rust-lang/rust/pull/48516
4852 [48628]: https://github.com/rust-lang/rust/pull/48628
4853 [48629]: https://github.com/rust-lang/rust/pull/48629
4854 [48657]: https://github.com/rust-lang/rust/pull/48657
4855 [48735]: https://github.com/rust-lang/rust/pull/48735
4856 [48978]: https://github.com/rust-lang/rust/pull/48978
4857 [49101]: https://github.com/rust-lang/rust/pull/49101
4858 [49109]: https://github.com/rust-lang/rust/pull/49109
4859 [49121]: https://github.com/rust-lang/rust/pull/49121
4860 [49162]: https://github.com/rust-lang/rust/pull/49162
4861 [49184]: https://github.com/rust-lang/rust/pull/49184
4862 [49234]: https://github.com/rust-lang/rust/pull/49234
4863 [49255]: https://github.com/rust-lang/rust/pull/49255
4864 [49299]: https://github.com/rust-lang/rust/pull/49299
4865 [49305]: https://github.com/rust-lang/rust/pull/49305
4866 [49394]: https://github.com/rust-lang/rust/pull/49394
4867 [49458]: https://github.com/rust-lang/rust/pull/49458
4868 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
4869 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
4870 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
4871 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
4872 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
4873 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
4874 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
4875 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
4876 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
4877 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
4878 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
4879 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
4880 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
4881 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
4882 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
4883 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
4884 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
4885 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
4886 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
4887 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
4888 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
4889 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
4890 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
4891 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
4892 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
4893 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
4894 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
4895 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
4896 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
4897 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
4898 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
4899 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
4900 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
4901 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
4902 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
4903 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
4904 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4905 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
4906 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
4907 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
4908 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
4909 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
4910
4911
4912 Version 1.25.0 (2018-03-29)
4913 ==========================
4914
4915 Language
4916 --------
4917 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
4918 - [You can now use nested groups of imports.][47948]
4919   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
4920 - [You can now have `|` at the start of a match arm.][47947] e.g.
4921 ```rust
4922 enum Foo { A, B, C }
4923
4924 fn main() {
4925     let x = Foo::A;
4926     match x {
4927         | Foo::A
4928         | Foo::B => println!("AB"),
4929         | Foo::C => println!("C"),
4930     }
4931 }
4932 ```
4933
4934 Compiler
4935 --------
4936 - [Upgraded to LLVM 6.][47828]
4937 - [Added `-C lto=val` option.][47521]
4938 - [Added `i586-unknown-linux-musl` target][47282]
4939
4940 Libraries
4941 ---------
4942 - [Impl Send for `process::Command` on Unix.][47760]
4943 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
4944 - [`UnsafeCell::into_inner` is now safe.][47204]
4945 - [Implement libstd for CloudABI.][47268]
4946 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
4947 - [Implement `AsRef<Path>` for Component][46985]
4948 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
4949 - [Moved `Duration` to libcore.][46666]
4950
4951 Stabilized APIs
4952 ---------------
4953 - [`Location::column`]
4954 - [`ptr::NonNull`]
4955
4956 The following functions can now be used in a constant expression.
4957 eg. `static MINUTE: Duration = Duration::from_secs(60);`
4958 - [`Duration::new`][47300]
4959 - [`Duration::from_secs`][47300]
4960 - [`Duration::from_millis`][47300]
4961
4962 Cargo
4963 -----
4964 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
4965 - [`cargo new` now defaults to creating a binary crate, instead of a
4966   library crate.][cargo/5029]
4967
4968 Misc
4969 ----
4970 - [Rust by example is now shipped with new releases][46196]
4971
4972 Compatibility Notes
4973 -------------------
4974 - [Deprecated `net::lookup_host`.][47510]
4975 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
4976 - The borrow checker was sometimes incorrectly permitting overlapping borrows
4977   around indexing operations (see [#47349][47349]). This has been fixed (which also
4978   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
4979 - [Removed deprecated unstable attribute `#[simd]`.][47251]
4980
4981 [33903]: https://github.com/rust-lang/rust/pull/33903
4982 [47947]: https://github.com/rust-lang/rust/pull/47947
4983 [47948]: https://github.com/rust-lang/rust/pull/47948
4984 [47760]: https://github.com/rust-lang/rust/pull/47760
4985 [47790]: https://github.com/rust-lang/rust/pull/47790
4986 [47828]: https://github.com/rust-lang/rust/pull/47828
4987 [47398]: https://github.com/rust-lang/rust/pull/47398
4988 [47510]: https://github.com/rust-lang/rust/pull/47510
4989 [47521]: https://github.com/rust-lang/rust/pull/47521
4990 [47204]: https://github.com/rust-lang/rust/pull/47204
4991 [47251]: https://github.com/rust-lang/rust/pull/47251
4992 [47268]: https://github.com/rust-lang/rust/pull/47268
4993 [47282]: https://github.com/rust-lang/rust/pull/47282
4994 [47300]: https://github.com/rust-lang/rust/pull/47300
4995 [47349]: https://github.com/rust-lang/rust/pull/47349
4996 [46931]: https://github.com/rust-lang/rust/pull/46931
4997 [46985]: https://github.com/rust-lang/rust/pull/46985
4998 [47006]: https://github.com/rust-lang/rust/pull/47006
4999 [46830]: https://github.com/rust-lang/rust/pull/46830
5000 [46095]: https://github.com/rust-lang/rust/pull/46095
5001 [46666]: https://github.com/rust-lang/rust/pull/46666
5002 [46196]: https://github.com/rust-lang/rust/pull/46196
5003 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
5004 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
5005 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
5006 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
5007 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
5008
5009
5010 Version 1.24.1 (2018-03-01)
5011 ==========================
5012
5013  - [Do not abort when unwinding through FFI][48251]
5014  - [Emit UTF-16 files for linker arguments on Windows][48318]
5015  - [Make the error index generator work again][48308]
5016  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
5017
5018 [48251]: https://github.com/rust-lang/rust/issues/48251
5019 [48308]: https://github.com/rust-lang/rust/issues/48308
5020 [48318]: https://github.com/rust-lang/rust/issues/48318
5021 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
5022
5023
5024 Version 1.24.0 (2018-02-15)
5025 ==========================
5026
5027 Language
5028 --------
5029 - [External `sysv64` ffi is now available.][46528]
5030   eg. `extern "sysv64" fn foo () {}`
5031
5032 Compiler
5033 --------
5034 - [rustc now uses 16 codegen units by default for release builds.][46910]
5035   For the fastest builds, utilize `codegen-units=1`.
5036 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
5037 - [Add `aarch64-unknown-openbsd` support][46760]
5038
5039 Libraries
5040 ---------
5041 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
5042   improvement in performance in the majority of cases.
5043 - [`OsStr`'s `Debug` implementation is now lossless and consistent
5044   with Windows.][46798]
5045 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
5046 - [impl `From<bool>` for `AtomicBool`][46293]
5047 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
5048 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
5049 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
5050 - [float::from_bits now just uses transmute.][46012] This provides
5051   some optimisations from LLVM.
5052 - [Copied `AsciiExt` methods onto `char`][46077]
5053 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
5054 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
5055 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
5056 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
5057
5058 Stabilized APIs
5059 ---------------
5060 - [`RefCell::replace`]
5061 - [`RefCell::swap`]
5062 - [`atomic::spin_loop_hint`]
5063
5064 The following functions can now be used in a constant expression.
5065 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
5066
5067 - [`AtomicBool::new`][46287]
5068 - [`AtomicUsize::new`][46287]
5069 - [`AtomicIsize::new`][46287]
5070 - [`AtomicPtr::new`][46287]
5071 - [`Cell::new`][46287]
5072 - [`{integer}::min_value`][46287]
5073 - [`{integer}::max_value`][46287]
5074 - [`mem::size_of`][46287]
5075 - [`mem::align_of`][46287]
5076 - [`ptr::null`][46287]
5077 - [`ptr::null_mut`][46287]
5078 - [`RefCell::new`][46287]
5079 - [`UnsafeCell::new`][46287]
5080
5081 Cargo
5082 -----
5083 - [Added a `workspace.default-members` config that
5084   overrides implied `--all` in virtual workspaces.][cargo/4743]
5085 - [Enable incremental by default on development builds.][cargo/4817] Also added
5086   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
5087   per-project or global basis respectively.
5088
5089 Misc
5090 ----
5091
5092 Compatibility Notes
5093 -------------------
5094 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
5095 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
5096   in accordance with IETF RFC 4291 §2.2.
5097 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
5098 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
5099   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
5100 - [Leading zeros in tuple struct members is now an error][47084]
5101 - [`column!()` macro is one-based instead of zero-based][46977]
5102 - [`fmt::Arguments` can no longer be shared across threads][45198]
5103 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
5104 - [Cargo sets a different working directory for the compiler][cargo/4788]
5105
5106 [44884]: https://github.com/rust-lang/rust/pull/44884
5107 [45198]: https://github.com/rust-lang/rust/pull/45198
5108 [45506]: https://github.com/rust-lang/rust/pull/45506
5109 [45904]: https://github.com/rust-lang/rust/pull/45904
5110 [45990]: https://github.com/rust-lang/rust/pull/45990
5111 [46012]: https://github.com/rust-lang/rust/pull/46012
5112 [46077]: https://github.com/rust-lang/rust/pull/46077
5113 [46094]: https://github.com/rust-lang/rust/pull/46094
5114 [46284]: https://github.com/rust-lang/rust/pull/46284
5115 [46287]: https://github.com/rust-lang/rust/pull/46287
5116 [46293]: https://github.com/rust-lang/rust/pull/46293
5117 [46528]: https://github.com/rust-lang/rust/pull/46528
5118 [46671]: https://github.com/rust-lang/rust/pull/46671
5119 [46713]: https://github.com/rust-lang/rust/pull/46713
5120 [46735]: https://github.com/rust-lang/rust/pull/46735
5121 [46749]: https://github.com/rust-lang/rust/pull/46749
5122 [46760]: https://github.com/rust-lang/rust/pull/46760
5123 [46798]: https://github.com/rust-lang/rust/pull/46798
5124 [46828]: https://github.com/rust-lang/rust/pull/46828
5125 [46831]: https://github.com/rust-lang/rust/pull/46831
5126 [46833]: https://github.com/rust-lang/rust/pull/46833
5127 [46910]: https://github.com/rust-lang/rust/pull/46910
5128 [46977]: https://github.com/rust-lang/rust/pull/46977
5129 [47018]: https://github.com/rust-lang/rust/pull/47018
5130 [47080]: https://github.com/rust-lang/rust/pull/47080
5131 [47084]: https://github.com/rust-lang/rust/pull/47084
5132 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
5133 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
5134 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
5135 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
5136 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
5137 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
5138
5139
5140 Version 1.23.0 (2018-01-04)
5141 ==========================
5142
5143 Language
5144 --------
5145 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
5146 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
5147   Which should fix some confusing errors in some operations.
5148
5149 Compiler
5150 --------
5151 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
5152   undefined behavior.][45920]
5153 - [rustc now suggests renaming import if names clash.][45660]
5154 - [Display errors/warnings correctly when there are zero-width or
5155   wide characters.][45711]
5156 - [rustc now avoids unnecessary copies of arguments that are
5157   simple bindings][45380] This should improve memory usage on average by 5-10%.
5158 - [Updated musl used to build musl rustc to 1.1.17][45393]
5159
5160 Libraries
5161 ---------
5162 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
5163 - [Implement Hash for raw pointers to unsized types][45483]
5164 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
5165 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
5166 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
5167 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
5168   and `<*mut T>::as_mut`][44932]
5169 - [Optimized `Thread::{park, unpark}` implementation][45524]
5170 - [Improved `SliceExt::binary_search` performance.][45333]
5171 - [impl `FromIterator<()>` for `()`][45379]
5172 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
5173   is now deprecated.
5174
5175 Stabilized APIs
5176 ---------------
5177
5178 Cargo
5179 -----
5180 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
5181   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
5182 - [Added unit test checking to `cargo check`][cargo/4592]
5183 - [Cargo now lets you install a specific version
5184   using `cargo install --version`][cargo/4637]
5185
5186 Misc
5187 ----
5188 - [Releases now ship with the Cargo book documentation.][45692]
5189 - [rustdoc now prints rendering warnings on every run.][45324]
5190
5191 Compatibility Notes
5192 -------------------
5193 - [Changes have been made to type equality to make it more correct,
5194   in rare cases this could break some code.][45853] [Tracking issue for
5195   further information][45852]
5196 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
5197 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
5198   Android 9, the minimum supported version is Android 14.
5199 - [Bumped the minimum LLVM to 3.9][45326]
5200
5201 [44042]: https://github.com/rust-lang/rust/pull/44042
5202 [44932]: https://github.com/rust-lang/rust/pull/44932
5203 [45267]: https://github.com/rust-lang/rust/pull/45267
5204 [45324]: https://github.com/rust-lang/rust/pull/45324
5205 [45326]: https://github.com/rust-lang/rust/pull/45326
5206 [45333]: https://github.com/rust-lang/rust/pull/45333
5207 [45379]: https://github.com/rust-lang/rust/pull/45379
5208 [45380]: https://github.com/rust-lang/rust/pull/45380
5209 [45393]: https://github.com/rust-lang/rust/pull/45393
5210 [45435]: https://github.com/rust-lang/rust/pull/45435
5211 [45483]: https://github.com/rust-lang/rust/pull/45483
5212 [45524]: https://github.com/rust-lang/rust/pull/45524
5213 [45571]: https://github.com/rust-lang/rust/pull/45571
5214 [45580]: https://github.com/rust-lang/rust/pull/45580
5215 [45610]: https://github.com/rust-lang/rust/pull/45610
5216 [45660]: https://github.com/rust-lang/rust/pull/45660
5217 [45692]: https://github.com/rust-lang/rust/pull/45692
5218 [45711]: https://github.com/rust-lang/rust/pull/45711
5219 [45772]: https://github.com/rust-lang/rust/pull/45772
5220 [45852]: https://github.com/rust-lang/rust/issues/45852
5221 [45853]: https://github.com/rust-lang/rust/pull/45853
5222 [45887]: https://github.com/rust-lang/rust/pull/45887
5223 [45920]: https://github.com/rust-lang/rust/pull/45920
5224 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
5225 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
5226 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
5227
5228
5229 Version 1.22.1 (2017-11-22)
5230 ==========================
5231
5232 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
5233
5234 [46183]: https://github.com/rust-lang/rust/pull/46183
5235
5236 Version 1.22.0 (2017-11-22)
5237 ==========================
5238
5239 Language
5240 --------
5241 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
5242 - [Now accepts underscores in unicode escapes][43716]
5243 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
5244 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
5245
5246 Compiler
5247 --------
5248 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
5249 - [rustc will no longer inline in codegen units when compiling for debug][45075]
5250   This should decrease compile times for debug builds.
5251 - [strict memory alignment now enabled on ARMv6][45094]
5252 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
5253
5254 Libraries
5255 ---------
5256 - [Allow atomic operations up to 32 bits
5257   on `armv5te_unknown_linux_gnueabi`][44978]
5258 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
5259 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
5260 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
5261 - [Properly detect overflow in `Instant += Duration`.][44220]
5262 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
5263 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
5264 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
5265
5266 Stabilized APIs
5267 ---------------
5268
5269 Cargo
5270 -----
5271 - [Cargo will now build multi file examples in subdirectories of the `examples`
5272   folder that have a `main.rs` file.][cargo/4496]
5273 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
5274   the old format will continue to work and can be updated with `cargo update`.
5275 - [Now supports vendoring git repositories][cargo/3992]
5276
5277 Misc
5278 ----
5279 - [`libbacktrace` is now available on Apple platforms.][44251]
5280 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
5281   This now lets you specify that a given code example will fail to compile.
5282
5283 Compatibility Notes
5284 -------------------
5285 - [The minimum Android version that rustc can build for has been bumped
5286   to `4.0` from `2.3`][45656]
5287 - [Allowing `T op= &T` for numeric types has broken some type
5288   inference cases][45480]
5289
5290
5291 [42526]: https://github.com/rust-lang/rust/pull/42526
5292 [43017]: https://github.com/rust-lang/rust/pull/43017
5293 [43716]: https://github.com/rust-lang/rust/pull/43716
5294 [43949]: https://github.com/rust-lang/rust/pull/43949
5295 [44015]: https://github.com/rust-lang/rust/pull/44015
5296 [44220]: https://github.com/rust-lang/rust/pull/44220
5297 [44251]: https://github.com/rust-lang/rust/pull/44251
5298 [44287]: https://github.com/rust-lang/rust/pull/44287
5299 [44303]: https://github.com/rust-lang/rust/pull/44303
5300 [44456]: https://github.com/rust-lang/rust/pull/44456
5301 [44466]: https://github.com/rust-lang/rust/pull/44466
5302 [44895]: https://github.com/rust-lang/rust/pull/44895
5303 [44966]: https://github.com/rust-lang/rust/pull/44966
5304 [44978]: https://github.com/rust-lang/rust/pull/44978
5305 [45041]: https://github.com/rust-lang/rust/pull/45041
5306 [45064]: https://github.com/rust-lang/rust/pull/45064
5307 [45075]: https://github.com/rust-lang/rust/pull/45075
5308 [45094]: https://github.com/rust-lang/rust/pull/45094
5309 [45095]: https://github.com/rust-lang/rust/pull/45095
5310 [45480]: https://github.com/rust-lang/rust/issues/45480
5311 [45656]: https://github.com/rust-lang/rust/pull/45656
5312 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
5313 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
5314 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
5315
5316
5317
5318
5319
5320
5321 Version 1.21.0 (2017-10-12)
5322 ==========================
5323
5324 Language
5325 --------
5326 - [You can now use static references for literals.][43838]
5327   Example:
5328   ```rust
5329   fn main() {
5330       let x: &'static u32 = &0;
5331   }
5332   ```
5333 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
5334   Example:
5335   ```rust
5336   my_macro!(Vec<i32>::new); // Always worked
5337   my_macro!(Vec::<i32>::new); // Now works
5338   ```
5339
5340 Compiler
5341 --------
5342 - [Upgraded jemalloc to 4.5.0][43911]
5343 - [Enabled unwinding panics on Redox][43917]
5344 - [Now runs LLVM in parallel during translation phase.][43506]
5345   This should reduce peak memory usage.
5346
5347 Libraries
5348 ---------
5349 - [Generate builtin impls for `Clone` for all arrays and tuples that
5350   are `T: Clone`][43690]
5351 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
5352 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
5353   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
5354
5355 Stabilized APIs
5356 ---------------
5357
5358 [`std::mem::discriminant`]
5359
5360 Cargo
5361 -----
5362 - [You can now call `cargo install` with multiple package names][cargo/4216]
5363 - [Cargo commands inside a virtual workspace will now implicitly
5364   pass `--all`][cargo/4335]
5365 - [Added a `[patch]` section to `Cargo.toml` to handle
5366   prepublication dependencies][cargo/4123] [RFC 1969]
5367 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
5368   like patterns][cargo/4270]
5369 - [Added the `--all-targets` option][cargo/4400]
5370 - [Using required dependencies as a feature is now deprecated and emits
5371   a warning][cargo/4364]
5372
5373
5374 Misc
5375 ----
5376 - [Cargo docs are moving][43916]
5377   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
5378 - [The rustdoc book is now available][43863]
5379   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
5380 - [Added a preview of RLS has been made available through rustup][44204]
5381   Install with `rustup component add rls-preview`
5382 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
5383   Previously only showed `std::os::unix`.
5384
5385 Compatibility Notes
5386 -------------------
5387 - [Changes in method matching against higher-ranked types][43880] This may cause
5388   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
5389 - [rustc's JSON error output's byte position start at top of file.][42973]
5390   Was previously relative to the rustc's internal `CodeMap` struct which
5391   required the unstable library `libsyntax` to correctly use.
5392 - [`unused_results` lint no longer ignores booleans][43728]
5393
5394 [42565]: https://github.com/rust-lang/rust/pull/42565
5395 [42973]: https://github.com/rust-lang/rust/pull/42973
5396 [43348]: https://github.com/rust-lang/rust/pull/43348
5397 [43459]: https://github.com/rust-lang/rust/pull/43459
5398 [43506]: https://github.com/rust-lang/rust/pull/43506
5399 [43540]: https://github.com/rust-lang/rust/pull/43540
5400 [43690]: https://github.com/rust-lang/rust/pull/43690
5401 [43728]: https://github.com/rust-lang/rust/pull/43728
5402 [43838]: https://github.com/rust-lang/rust/pull/43838
5403 [43863]: https://github.com/rust-lang/rust/pull/43863
5404 [43880]: https://github.com/rust-lang/rust/pull/43880
5405 [43911]: https://github.com/rust-lang/rust/pull/43911
5406 [43916]: https://github.com/rust-lang/rust/pull/43916
5407 [43917]: https://github.com/rust-lang/rust/pull/43917
5408 [44204]: https://github.com/rust-lang/rust/pull/44204
5409 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
5410 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
5411 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5412 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
5413 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
5414 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
5415 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
5416 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
5417 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
5418
5419 Version 1.20.0 (2017-08-31)
5420 ===========================
5421
5422 Language
5423 --------
5424 - [Associated constants are now stabilised.][42809]
5425 - [A lot of macro bugs are now fixed.][42913]
5426
5427 Compiler
5428 --------
5429
5430 - [Struct fields are now properly coerced to the expected field type.][42807]
5431 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
5432   `wasm32-experimental-emscripten` target.
5433 - [Changed some of the error messages to be more helpful.][42033]
5434 - [Add support for RELRO(RELocation Read-Only) for platforms that support
5435   it.][43170]
5436 - [rustc now reports the total number of errors on compilation failure][43015]
5437   previously this was only the number of errors in the pass that failed.
5438 - [Expansion in rustc has been sped up 29x.][42533]
5439 - [added `msp430-none-elf` target.][43099]
5440 - [rustc will now suggest one-argument enum variant to fix type mismatch when
5441   applicable][43178]
5442 - [Fixes backtraces on Redox][43228]
5443 - [rustc now identifies different versions of same crate when absolute paths of
5444   different types match in an error message.][42826]
5445
5446 Libraries
5447 ---------
5448
5449
5450 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
5451 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
5452   tuples.][43011]
5453 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
5454   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
5455 - [Impl `Clone` for `DefaultHasher`.][42799]
5456 - [Impl `Sync` for `SyncSender`.][42397]
5457 - [Impl `FromStr` for `char`][42271]
5458 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
5459   NaN.][42431]
5460 - [allow messages in the `unimplemented!()` macro.][42155]
5461   ie. `unimplemented!("Waiting for 1.21 to be stable")`
5462 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
5463 - [Upgrade to Unicode 10.0.0][42999]
5464 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
5465 - [Skip the main thread's manual stack guard on Linux][43072]
5466 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in *O*(1) time][43077]
5467 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
5468   previously 2^15.
5469 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
5470
5471 Stabilized APIs
5472 ---------------
5473
5474 - [`CStr::into_c_string`]
5475 - [`CString::as_c_str`]
5476 - [`CString::into_boxed_c_str`]
5477 - [`Chain::get_mut`]
5478 - [`Chain::get_ref`]
5479 - [`Chain::into_inner`]
5480 - [`Option::get_or_insert_with`]
5481 - [`Option::get_or_insert`]
5482 - [`OsStr::into_os_string`]
5483 - [`OsString::into_boxed_os_str`]
5484 - [`Take::get_mut`]
5485 - [`Take::get_ref`]
5486 - [`Utf8Error::error_len`]
5487 - [`char::EscapeDebug`]
5488 - [`char::escape_debug`]
5489 - [`compile_error!`]
5490 - [`f32::from_bits`]
5491 - [`f32::to_bits`]
5492 - [`f64::from_bits`]
5493 - [`f64::to_bits`]
5494 - [`mem::ManuallyDrop`]
5495 - [`slice::sort_unstable_by_key`]
5496 - [`slice::sort_unstable_by`]
5497 - [`slice::sort_unstable`]
5498 - [`str::from_boxed_utf8_unchecked`]
5499 - [`str::as_bytes_mut`]
5500 - [`str::as_bytes_mut`]
5501 - [`str::from_utf8_mut`]
5502 - [`str::from_utf8_unchecked_mut`]
5503 - [`str::get_mut`]
5504 - [`str::get_unchecked_mut`]
5505 - [`str::get_unchecked`]
5506 - [`str::get`]
5507 - [`str::into_boxed_bytes`]
5508
5509
5510 Cargo
5511 -----
5512 - [Cargo API token location moved from `~/.cargo/config` to
5513   `~/.cargo/credentials`.][cargo/3978]
5514 - [Cargo will now build `main.rs` binaries that are in sub-directories of
5515   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
5516   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
5517 - [You can now specify version of a binary when installed through
5518   `cargo install` using `--vers`.][cargo/4229]
5519 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
5520   failure.][cargo/4248]
5521 - [Changed the convention around which file is the crate root.][cargo/4259]
5522 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
5523   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
5524
5525 Compatibility Notes
5526 -------------------
5527
5528 - [Functions with `'static` in their return types will now not be as usable as
5529   if they were using lifetime parameters instead.][42417]
5530 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
5531   takes the sign of NaN into account where previously didn't.][42430]
5532
5533 [42033]: https://github.com/rust-lang/rust/pull/42033
5534 [42155]: https://github.com/rust-lang/rust/pull/42155
5535 [42271]: https://github.com/rust-lang/rust/pull/42271
5536 [42397]: https://github.com/rust-lang/rust/pull/42397
5537 [42417]: https://github.com/rust-lang/rust/pull/42417
5538 [42430]: https://github.com/rust-lang/rust/pull/42430
5539 [42431]: https://github.com/rust-lang/rust/pull/42431
5540 [42533]: https://github.com/rust-lang/rust/pull/42533
5541 [42571]: https://github.com/rust-lang/rust/pull/42571
5542 [42613]: https://github.com/rust-lang/rust/pull/42613
5543 [42799]: https://github.com/rust-lang/rust/pull/42799
5544 [42807]: https://github.com/rust-lang/rust/pull/42807
5545 [42809]: https://github.com/rust-lang/rust/pull/42809
5546 [42822]: https://github.com/rust-lang/rust/pull/42822
5547 [42826]: https://github.com/rust-lang/rust/pull/42826
5548 [42854]: https://github.com/rust-lang/rust/pull/42854
5549 [42913]: https://github.com/rust-lang/rust/pull/42913
5550 [42999]: https://github.com/rust-lang/rust/pull/42999
5551 [43011]: https://github.com/rust-lang/rust/pull/43011
5552 [43015]: https://github.com/rust-lang/rust/pull/43015
5553 [43072]: https://github.com/rust-lang/rust/pull/43072
5554 [43077]: https://github.com/rust-lang/rust/pull/43077
5555 [43097]: https://github.com/rust-lang/rust/pull/43097
5556 [43099]: https://github.com/rust-lang/rust/pull/43099
5557 [43170]: https://github.com/rust-lang/rust/pull/43170
5558 [43178]: https://github.com/rust-lang/rust/pull/43178
5559 [43185]: https://github.com/rust-lang/rust/pull/43185
5560 [43228]: https://github.com/rust-lang/rust/pull/43228
5561 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
5562 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
5563 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
5564 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
5565 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
5566 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5567 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
5568 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
5569 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
5570 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
5571 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
5572 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
5573 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
5574 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
5575 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
5576 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
5577 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
5578 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
5579 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
5580 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
5581 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
5582 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
5583 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
5584 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
5585 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
5586 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
5587 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
5588 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
5589 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
5590 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
5591 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
5592 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
5593 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
5594 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
5595 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
5596 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
5597 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
5598 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
5599 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
5600
5601
5602 Version 1.19.0 (2017-07-20)
5603 ===========================
5604
5605 Language
5606 --------
5607
5608 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
5609   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
5610 - [Macro recursion limit increased to 1024 from 64.][41676]
5611 - [Added lint for detecting unused macros.][41907]
5612 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
5613   For example: `let x = loop { break 7; };`
5614 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
5615   contain `Copy` types and cannot have a `Drop` implementation.
5616   Example: `union Foo { bar: u8, baz: usize }`
5617 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
5618   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
5619
5620 Compiler
5621 --------
5622
5623 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
5624 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
5625   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
5626   you should use `--target armv7-linux-androideabi`.
5627 - [Fixed ICE when removing a source file between compilation sessions.][41873]
5628 - [Minor optimisation of string operations.][42037]
5629 - [Compiler error message is now `aborting due to previous error(s)` instead of
5630   `aborting due to N previous errors`][42150] This was previously inaccurate and
5631   would only count certain kinds of errors.
5632 - [The compiler now supports Visual Studio 2017][42225]
5633 - [The compiler is now built against LLVM 4.0.1 by default][42948]
5634 - [Added a lot][42264] of [new error codes][42302]
5635 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
5636   libraries with C Run-time Libraries(CRT) to be statically linked.
5637 - [Fixed various ARM codegen bugs][42740]
5638
5639 Libraries
5640 ---------
5641
5642 - [`String` now implements `FromIterator<Cow<'a, str>>` and
5643   `Extend<Cow<'a, str>>`][41449]
5644 - [`Vec` now implements `From<&mut [T]>`][41530]
5645 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
5646 - [`SplitWhitespace` now implements `Clone`][41659]
5647 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
5648   1.5x faster][41764]
5649 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
5650   macros, but for printing to stderr.
5651
5652 Stabilized APIs
5653 ---------------
5654
5655 - [`OsString::shrink_to_fit`]
5656 - [`cmp::Reverse`]
5657 - [`Command::envs`]
5658 - [`thread::ThreadId`]
5659
5660 Cargo
5661 -----
5662
5663 - [Build scripts can now add environment variables to the environment
5664   the crate is being compiled in.
5665   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
5666 - [Subcommands now replace the current process rather than spawning a new
5667   child process][cargo/3970]
5668 - [Workspace members can now accept glob file patterns][cargo/3979]
5669 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
5670   the members in a given workspace.][cargo/3988]
5671 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
5672 - [Target directory path is now in the cargo metadata][cargo/4022]
5673 - [Cargo no longer checks out a local working directory for the
5674   crates.io index][cargo/4026] This should provide smaller file size for the
5675   registry, and improve cloning times, especially on Windows machines.
5676 - [Added an `--exclude` option for excluding certain packages when using the
5677   `--all` option][cargo/4031]
5678 - [Cargo will now automatically retry when receiving a 5xx error
5679   from crates.io][cargo/4032]
5680 - [The `--features` option now accepts multiple comma or space
5681   delimited values.][cargo/4084]
5682 - [Added support for custom target specific runners][cargo/3954]
5683
5684 Misc
5685 ----
5686
5687 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
5688   Windows Debugger.
5689 - [Rust will now release XZ compressed packages][rust-installer/57]
5690 - [rustup will now prefer to download rust packages with
5691   XZ compression][rustup/1100] over GZip packages.
5692 - [Added the ability to escape `#` in rust documentation][41785] By adding
5693   additional `#`'s ie. `##` is now `#`
5694
5695 Compatibility Notes
5696 -------------------
5697
5698 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
5699 - [`-Z` flags are now no longer allowed to be used on the stable
5700   compiler.][41751] This has been a warning for a year previous to this.
5701 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
5702   longer works][42844]. Users should migrate to the built-in `check`
5703   command, which has been available since 1.16.
5704 - [Ending a float literal with `._` is now a hard error.
5705   Example: `42._` .][41946]
5706 - [Any use of a private `extern crate` outside of its module is now a
5707   hard error.][36886] This was previously a warning.
5708 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
5709   relative while the `::` prefix makes a path absolute, but was ignored and the
5710   path was relative regardless.
5711 - [Floating point constants in match patterns is now a hard error][36890]
5712   This was previously a warning.
5713 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
5714   match patterns is now a hard error][36891] This was previously a warning.
5715 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
5716   a warning.
5717 - [From the pound escape, lines consisting of multiple `#`s are
5718   now visible][41785]
5719 - [It is an error to re-export private enum variants][42460]. This is
5720   known to break a number of crates that depend on an older version of
5721   mustache.
5722 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
5723   to use it to find the linker, and the build will fail where it did
5724   not previously][42607]
5725
5726 [36886]: https://github.com/rust-lang/rust/issues/36886
5727 [36888]: https://github.com/rust-lang/rust/issues/36888
5728 [36890]: https://github.com/rust-lang/rust/issues/36890
5729 [36891]: https://github.com/rust-lang/rust/issues/36891
5730 [36892]: https://github.com/rust-lang/rust/issues/36892
5731 [37406]: https://github.com/rust-lang/rust/issues/37406
5732 [39983]: https://github.com/rust-lang/rust/pull/39983
5733 [41145]: https://github.com/rust-lang/rust/pull/41145
5734 [41192]: https://github.com/rust-lang/rust/pull/41192
5735 [41258]: https://github.com/rust-lang/rust/pull/41258
5736 [41370]: https://github.com/rust-lang/rust/pull/41370
5737 [41449]: https://github.com/rust-lang/rust/pull/41449
5738 [41530]: https://github.com/rust-lang/rust/pull/41530
5739 [41624]: https://github.com/rust-lang/rust/pull/41624
5740 [41656]: https://github.com/rust-lang/rust/pull/41656
5741 [41659]: https://github.com/rust-lang/rust/pull/41659
5742 [41676]: https://github.com/rust-lang/rust/pull/41676
5743 [41751]: https://github.com/rust-lang/rust/pull/41751
5744 [41764]: https://github.com/rust-lang/rust/pull/41764
5745 [41785]: https://github.com/rust-lang/rust/pull/41785
5746 [41873]: https://github.com/rust-lang/rust/pull/41873
5747 [41907]: https://github.com/rust-lang/rust/pull/41907
5748 [41946]: https://github.com/rust-lang/rust/pull/41946
5749 [42016]: https://github.com/rust-lang/rust/pull/42016
5750 [42037]: https://github.com/rust-lang/rust/pull/42037
5751 [42068]: https://github.com/rust-lang/rust/pull/42068
5752 [42150]: https://github.com/rust-lang/rust/pull/42150
5753 [42162]: https://github.com/rust-lang/rust/pull/42162
5754 [42225]: https://github.com/rust-lang/rust/pull/42225
5755 [42264]: https://github.com/rust-lang/rust/pull/42264
5756 [42302]: https://github.com/rust-lang/rust/pull/42302
5757 [42460]: https://github.com/rust-lang/rust/issues/42460
5758 [42607]: https://github.com/rust-lang/rust/issues/42607
5759 [42740]: https://github.com/rust-lang/rust/pull/42740
5760 [42844]: https://github.com/rust-lang/rust/issues/42844
5761 [42948]: https://github.com/rust-lang/rust/pull/42948
5762 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
5763 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
5764 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
5765 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
5766 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
5767 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
5768 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
5769 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
5770 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
5771 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
5772 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
5773 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
5774 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
5775 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
5776 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
5777 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
5778 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
5779 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
5780 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
5781 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
5782 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
5783 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
5784
5785
5786 Version 1.18.0 (2017-06-08)
5787 ===========================
5788
5789 Language
5790 --------
5791
5792 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
5793   make the item visible to just that module tree. Also accepts the keyword
5794   `crate` to make something public to the whole crate but not users of the
5795   library. Example: `pub(crate) mod utils;`. [RFC 1422].
5796 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
5797   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
5798 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
5799   types like `Write + Send`, trailing `+` are now supported in trait objects,
5800   and better error reporting for trait objects starting with `?Sized`.
5801 - [0e+10 is now a valid floating point literal][40589]
5802 - [Now warns if you bind a lifetime parameter to 'static][40734]
5803 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
5804   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
5805   representation in some cases.][40377]
5806
5807 Compiler
5808 --------
5809
5810 - [rustc can now emit mir with `--emit mir`][39891]
5811 - [Improved LLVM IR for trivial functions][40367]
5812 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
5813 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
5814   opportunities found through profiling
5815 - [Improved backtrace formatting when panicking][38165]
5816
5817 Libraries
5818 ---------
5819
5820 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
5821   iterator hasn't been advanced the original `Vec` is reassembled with no actual
5822   iteration or reallocation.
5823 - [Simplified HashMap Bucket interface][40561] provides performance
5824   improvements for iterating and cloning.
5825 - [Specialize Vec::from_elem to use calloc][40409]
5826 - [Fixed Race condition in fs::create_dir_all][39799]
5827 - [No longer caching stdio on Windows][40516]
5828 - [Optimized insertion sort in slice][40807] insertion sort in some cases
5829   2.50%~ faster and in one case now 12.50% faster.
5830 - [Optimized `AtomicBool::fetch_nand`][41143]
5831
5832 Stabilized APIs
5833 ---------------
5834
5835 - [`Child::try_wait`]
5836 - [`HashMap::retain`]
5837 - [`HashSet::retain`]
5838 - [`PeekMut::pop`]
5839 - [`TcpStream::peek`]
5840 - [`UdpSocket::peek`]
5841 - [`UdpSocket::peek_from`]
5842
5843 Cargo
5844 -----
5845
5846 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
5847   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
5848 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
5849 - [Added Android build support][cargo/3885]
5850 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
5851   of a certain type, for example `cargo build --bins` will build all
5852   binaries.
5853 - [Added support for haiku][cargo/3952]
5854
5855 Misc
5856 ----
5857
5858 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
5859 - [Added rust-windbg script for better debugging on Windows][39983]
5860 - [Rust now uses the official cross compiler for NetBSD][40612]
5861 - [rustdoc now accepts `#` at the start of files][40828]
5862 - [Fixed jemalloc support for musl][41168]
5863
5864 Compatibility Notes
5865 -------------------
5866
5867 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
5868   always placed after the sign if it exists and before the digits. With the `#`
5869   flag the zeroes are placed after the prefix and before the digits.
5870 - [Due to the struct field optimisation][40377], using `transmute` on structs
5871   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
5872   always been undefined behavior, but is now more likely to break in practice.
5873 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
5874   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
5875   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
5876 - [Overlapping inherent `impl`s are now a hard error][40728]
5877 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
5878 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
5879   `out.asm` and `out.ll` instead of only one of the filetypes.
5880 - [ calling a function that returns `Self` will no longer work][41805] when
5881   the size of `Self` cannot be statically determined.
5882 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
5883   this has caused a few regressions namely:
5884
5885   - Changed the link order of local static/dynamic libraries (respecting the
5886     order on given rather than having the compiler reorder).
5887   - Changed how MinGW is linked, native code linked to dynamic libraries
5888     may require manually linking to the gcc support library (for the native
5889     code itself)
5890
5891 [38165]: https://github.com/rust-lang/rust/pull/38165
5892 [39799]: https://github.com/rust-lang/rust/pull/39799
5893 [39891]: https://github.com/rust-lang/rust/pull/39891
5894 [39983]: https://github.com/rust-lang/rust/pull/39983
5895 [40043]: https://github.com/rust-lang/rust/pull/40043
5896 [40241]: https://github.com/rust-lang/rust/pull/40241
5897 [40338]: https://github.com/rust-lang/rust/pull/40338
5898 [40367]: https://github.com/rust-lang/rust/pull/40367
5899 [40377]: https://github.com/rust-lang/rust/pull/40377
5900 [40409]: https://github.com/rust-lang/rust/pull/40409
5901 [40516]: https://github.com/rust-lang/rust/pull/40516
5902 [40556]: https://github.com/rust-lang/rust/pull/40556
5903 [40561]: https://github.com/rust-lang/rust/pull/40561
5904 [40589]: https://github.com/rust-lang/rust/pull/40589
5905 [40612]: https://github.com/rust-lang/rust/pull/40612
5906 [40723]: https://github.com/rust-lang/rust/pull/40723
5907 [40728]: https://github.com/rust-lang/rust/pull/40728
5908 [40731]: https://github.com/rust-lang/rust/pull/40731
5909 [40734]: https://github.com/rust-lang/rust/pull/40734
5910 [40805]: https://github.com/rust-lang/rust/pull/40805
5911 [40807]: https://github.com/rust-lang/rust/pull/40807
5912 [40828]: https://github.com/rust-lang/rust/pull/40828
5913 [40870]: https://github.com/rust-lang/rust/pull/40870
5914 [41085]: https://github.com/rust-lang/rust/pull/41085
5915 [41143]: https://github.com/rust-lang/rust/pull/41143
5916 [41168]: https://github.com/rust-lang/rust/pull/41168
5917 [41270]: https://github.com/rust-lang/rust/issues/41270
5918 [41469]: https://github.com/rust-lang/rust/pull/41469
5919 [41805]: https://github.com/rust-lang/rust/issues/41805
5920 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
5921 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
5922 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
5923 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
5924 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
5925 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
5926 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
5927 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
5928 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
5929 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
5930 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
5931 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
5932 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
5933 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
5934
5935
5936 Version 1.17.0 (2017-04-27)
5937 ===========================
5938
5939 Language
5940 --------
5941
5942 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
5943 * [Fields of structs may be initialized without duplicating the field/variable
5944   names][39761]. [RFC 1682]
5945 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
5946 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5947   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
5948   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
5949   `'b`. Soundness fix.
5950 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
5951 * [Static variables may contain references to other statics][40027]
5952
5953 Compiler
5954 --------
5955
5956 * [Exit quickly on only `--emit dep-info`][40336]
5957 * [Make `-C relocation-model` more correctly determine whether the linker
5958   creates a position-independent executable][40245]
5959 * [Add `-C overflow-checks` to directly control whether integer overflow
5960   panics][40037]
5961 * [The rustc type checker now checks items on demand instead of in a single
5962   in-order pass][40008]. This is mostly an internal refactoring in support of
5963   future work, including incremental type checking, but also resolves [RFC
5964   1647], allowing `Self` to appear in `impl` `where` clauses.
5965 * [Optimize vtable loads][39995]
5966 * [Turn off vectorization for Emscripten targets][39990]
5967 * [Provide suggestions for unknown macros imported with `use`][39953]
5968 * [Fix ICEs in path resolution][39939]
5969 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
5970 * [Add clearer error message using `&str + &str`][39116]
5971
5972 Stabilized APIs
5973 ---------------
5974
5975 * [`Arc::into_raw`]
5976 * [`Arc::from_raw`]
5977 * [`Arc::ptr_eq`]
5978 * [`Rc::into_raw`]
5979 * [`Rc::from_raw`]
5980 * [`Rc::ptr_eq`]
5981 * [`Ordering::then`]
5982 * [`Ordering::then_with`]
5983 * [`BTreeMap::range`]
5984 * [`BTreeMap::range_mut`]
5985 * [`collections::Bound`]
5986 * [`process::abort`]
5987 * [`ptr::read_unaligned`]
5988 * [`ptr::write_unaligned`]
5989 * [`Result::expect_err`]
5990 * [`Cell::swap`]
5991 * [`Cell::replace`]
5992 * [`Cell::into_inner`]
5993 * [`Cell::take`]
5994
5995 Libraries
5996 ---------
5997
5998 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
5999 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
6000 * [`String` implements `FromIterator<&char>`][40028]
6001 * `Box` [implements][40009] a number of new conversions:
6002   `From<Box<str>> for String`,
6003   `From<Box<[T]>> for Vec<T>`,
6004   `From<Box<CStr>> for CString`,
6005   `From<Box<OsStr>> for OsString`,
6006   `From<Box<Path>> for PathBuf`,
6007   `Into<Box<str>> for String`,
6008   `Into<Box<[T]>> for Vec<T>`,
6009   `Into<Box<CStr>> for CString`,
6010   `Into<Box<OsStr>> for OsString`,
6011   `Into<Box<Path>> for PathBuf`,
6012   `Default for Box<str>`,
6013   `Default for Box<CStr>`,
6014   `Default for Box<OsStr>`,
6015   `From<&CStr> for Box<CStr>`,
6016   `From<&OsStr> for Box<OsStr>`,
6017   `From<&Path> for Box<Path>`
6018 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
6019 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
6020 * [Slightly optimize `slice::sort`][39538]
6021 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
6022 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
6023   `Box<str>` implements `From<&str>`][39438]
6024 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
6025   `From<(I, u16)> where I: Into<IpAddr>`][39372]
6026 * [`format!` estimates the needed capacity before writing a string][39356]
6027 * [Support unprivileged symlink creation in Windows][38921]
6028 * [`PathBuf` implements `Default`][38764]
6029 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
6030 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
6031   and poor hash functions.
6032
6033 Cargo
6034 -----
6035
6036 * [Add `cargo check --all`][cargo/3731]
6037 * [Add an option to ignore SSL revocation checking][cargo/3699]
6038 * [Add `cargo run --package`][cargo/3691]
6039 * [Add `required_features`][cargo/3667]
6040 * [Assume `build.rs` is a build script][cargo/3664]
6041 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
6042
6043 Misc
6044 ----
6045
6046 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
6047   `rustbook`][39633]
6048 * [The "Unstable Book" documents nightly-only features][ubook]
6049 * [Improve the style of the sidebar in rustdoc output][40265]
6050 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
6051 * [Fix MSP430 breakage due to `i128`][40257]
6052 * [Preliminary Solaris/SPARCv9 support][39903]
6053 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
6054   run without installing the MSVC runtime.
6055 * [`rustdoc --test` includes file names in test names][39788]
6056 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
6057   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
6058 * [Initial support for `aarch64-unknown-freebsd`][39491]
6059 * [Initial support for `i686-unknown-netbsd`][39426]
6060 * [This release no longer includes the old makefile build system][39431]. Rust
6061   is built with a custom build system, written in Rust, and with Cargo.
6062 * [Add Debug implementations for libcollection structs][39002]
6063 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
6064 * [`--test-threads=0` produces an error][38945]
6065 * [`rustup` installs documentation by default][40526]
6066 * [The Rust source includes NatVis visualizations][39843]. These can be used by
6067   WinDbg and Visual Studio to improve the debugging experience.
6068
6069 Compatibility Notes
6070 -------------------
6071
6072 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
6073   workaround, either use MSVC 2015 or run vcvars.bat.
6074 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
6075   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
6076   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
6077   fix.
6078 * [`format!` and `Display::to_string` panic if an underlying formatting
6079   implementation returns an error][40117]. Previously the error was silently
6080   ignored. It is incorrect for `write_fmt` to return an error when writing
6081   to a string.
6082 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
6083   crates were marked stable and could be accessed from the stable toolchain.
6084 * [Rust git source no longer includes vendored crates][39728]. Those that need
6085   to build with vendored crates should build from release tarballs.
6086 * [Fix inert attributes from `proc_macro_derives`][39572]
6087 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
6088   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
6089   build system.
6090 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
6091   existing code generally ignores the type of dead-code unless a type-hint is
6092   provided; this can cause surprising inference interactions particularly around
6093   defaulting. The new code uniformly ignores the result type of dead-code.
6094 * [Tuple-struct constructors with private fields are no longer visible][38932]
6095 * [Lifetime parameters that do not appear in the arguments are now considered
6096   early-bound][38897], resolving a soundness bug (#[32330]). The
6097   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
6098   April of 2016.
6099 * [rustdoc: fix doctests with non-feature crate attributes][38161]
6100 * [Make transmuting from fn item types to pointer-sized types a hard
6101   error][34198]
6102
6103 [27787]: https://github.com/rust-lang/rust/issues/27787
6104 [32330]: https://github.com/rust-lang/rust/issues/32330
6105 [34198]: https://github.com/rust-lang/rust/pull/34198
6106 [38161]: https://github.com/rust-lang/rust/pull/38161
6107 [38368]: https://github.com/rust-lang/rust/pull/38368
6108 [38584]: https://github.com/rust-lang/rust/issues/38584
6109 [38661]: https://github.com/rust-lang/rust/pull/38661
6110 [38764]: https://github.com/rust-lang/rust/pull/38764
6111 [38864]: https://github.com/rust-lang/rust/issues/38864
6112 [38897]: https://github.com/rust-lang/rust/pull/38897
6113 [38921]: https://github.com/rust-lang/rust/pull/38921
6114 [38932]: https://github.com/rust-lang/rust/pull/38932
6115 [38945]: https://github.com/rust-lang/rust/pull/38945
6116 [38981]: https://github.com/rust-lang/rust/pull/38981
6117 [39002]: https://github.com/rust-lang/rust/pull/39002
6118 [39116]: https://github.com/rust-lang/rust/pull/39116
6119 [39193]: https://github.com/rust-lang/rust/pull/39193
6120 [39265]: https://github.com/rust-lang/rust/pull/39265
6121 [39356]: https://github.com/rust-lang/rust/pull/39356
6122 [39372]: https://github.com/rust-lang/rust/pull/39372
6123 [39426]: https://github.com/rust-lang/rust/pull/39426
6124 [39431]: https://github.com/rust-lang/rust/pull/39431
6125 [39438]: https://github.com/rust-lang/rust/pull/39438
6126 [39440]: https://github.com/rust-lang/rust/pull/39440
6127 [39485]: https://github.com/rust-lang/rust/pull/39485
6128 [39491]: https://github.com/rust-lang/rust/pull/39491
6129 [39518]: https://github.com/rust-lang/rust/pull/39518
6130 [39538]: https://github.com/rust-lang/rust/pull/39538
6131 [39572]: https://github.com/rust-lang/rust/pull/39572
6132 [39633]: https://github.com/rust-lang/rust/pull/39633
6133 [39642]: https://github.com/rust-lang/rust/pull/39642
6134 [39728]: https://github.com/rust-lang/rust/pull/39728
6135 [39761]: https://github.com/rust-lang/rust/pull/39761
6136 [39788]: https://github.com/rust-lang/rust/pull/39788
6137 [39793]: https://github.com/rust-lang/rust/pull/39793
6138 [39837]: https://github.com/rust-lang/rust/pull/39837
6139 [39843]: https://github.com/rust-lang/rust/pull/39843
6140 [39851]: https://github.com/rust-lang/rust/pull/39851
6141 [39903]: https://github.com/rust-lang/rust/pull/39903
6142 [39939]: https://github.com/rust-lang/rust/pull/39939
6143 [39953]: https://github.com/rust-lang/rust/pull/39953
6144 [39960]: https://github.com/rust-lang/rust/pull/39960
6145 [39990]: https://github.com/rust-lang/rust/pull/39990
6146 [39995]: https://github.com/rust-lang/rust/pull/39995
6147 [40008]: https://github.com/rust-lang/rust/pull/40008
6148 [40009]: https://github.com/rust-lang/rust/pull/40009
6149 [40027]: https://github.com/rust-lang/rust/pull/40027
6150 [40028]: https://github.com/rust-lang/rust/pull/40028
6151 [40037]: https://github.com/rust-lang/rust/pull/40037
6152 [40117]: https://github.com/rust-lang/rust/pull/40117
6153 [40166]: https://github.com/rust-lang/rust/pull/40166
6154 [40245]: https://github.com/rust-lang/rust/pull/40245
6155 [40257]: https://github.com/rust-lang/rust/pull/40257
6156 [40261]: https://github.com/rust-lang/rust/pull/40261
6157 [40265]: https://github.com/rust-lang/rust/pull/40265
6158 [40319]: https://github.com/rust-lang/rust/pull/40319
6159 [40336]: https://github.com/rust-lang/rust/pull/40336
6160 [40526]: https://github.com/rust-lang/rust/pull/40526
6161 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
6162 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
6163 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
6164 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
6165 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
6166 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
6167 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
6168 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
6169 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
6170 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
6171 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
6172 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
6173 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
6174 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
6175 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
6176 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
6177 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
6178 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
6179 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
6180 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
6181 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
6182 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
6183 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
6184 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
6185 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
6186 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
6187 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
6188 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
6189 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
6190 [mdbook]: https://crates.io/crates/mdbook
6191 [ubook]: https://doc.rust-lang.org/unstable-book/
6192
6193
6194 Version 1.16.0 (2017-03-16)
6195 ===========================
6196
6197 Language
6198 --------
6199
6200 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6201 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6202   match patterns][38069]
6203 * [Clean up semantics of `self` in an import list][38313]
6204 * [`Self` may appear in `impl` headers][38920]
6205 * [`Self` may appear in struct expressions][39282]
6206
6207 Compiler
6208 --------
6209
6210 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
6211   a `.rmeta` file containing only crate metadata][38571]. This can be
6212   used by tools like the Rust Language Service to perform
6213   metadata-only builds.
6214 * [Levenshtein based typo suggestions now work in most places, while
6215   previously they worked only for fields and sometimes for local
6216   variables][38927]. Together with the overhaul of "no
6217   resolution"/"unexpected resolution" errors (#[38154]) they result in
6218   large and systematic improvement in resolution diagnostics.
6219 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
6220   `U`][38670]
6221 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
6222 * [`rustc` no longer attempts to provide "consider using an explicit
6223   lifetime" suggestions][37057]. They were inaccurate.
6224
6225 Stabilized APIs
6226 ---------------
6227
6228 * [`VecDeque::truncate`]
6229 * [`VecDeque::resize`]
6230 * [`String::insert_str`]
6231 * [`Duration::checked_add`]
6232 * [`Duration::checked_sub`]
6233 * [`Duration::checked_div`]
6234 * [`Duration::checked_mul`]
6235 * [`str::replacen`]
6236 * [`str::repeat`]
6237 * [`SocketAddr::is_ipv4`]
6238 * [`SocketAddr::is_ipv6`]
6239 * [`IpAddr::is_ipv4`]
6240 * [`IpAddr::is_ipv6`]
6241 * [`Vec::dedup_by`]
6242 * [`Vec::dedup_by_key`]
6243 * [`Result::unwrap_or_default`]
6244 * [`<*const T>::wrapping_offset`]
6245 * [`<*mut T>::wrapping_offset`]
6246 * `CommandExt::creation_flags`
6247 * [`File::set_permissions`]
6248 * [`String::split_off`]
6249
6250 Libraries
6251 ---------
6252
6253 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
6254   their argument by `Borrow` parameter][37761]
6255 * [All public types in std implement `Debug`][38006]
6256 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
6257 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
6258 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6259   Windows][38274]
6260 * [std: Fix partial writes in `LineWriter`][38062]
6261 * [std: Clamp max read/write sizes on Unix][38062]
6262 * [Use more specific panic message for `&str` slicing errors][38066]
6263 * [`TcpListener::set_only_v6` is deprecated][38304]. This
6264   functionality cannot be achieved in std currently.
6265 * [`writeln!`, like `println!`, now accepts a form with no string
6266   or formatting arguments, to just print a newline][38469]
6267 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
6268 * [Reduce the size of static data in `std_unicode::tables`][38781]
6269 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
6270   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
6271   `Display`][38909]
6272 * [`Duration` implements `Sum`][38712]
6273 * [`String` implements `ToSocketAddrs`][39048]
6274
6275 Cargo
6276 -----
6277
6278 * [The `cargo check` command does a type check of a project without
6279   building it][cargo/3296]
6280 * [crates.io will display CI badges from Travis and AppVeyor, if
6281   specified in Cargo.toml][cargo/3546]
6282 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
6283 * [Compilation profiles accept integer values for `debug`, in addition
6284   to `true` and `false`. These are passed to `rustc` as the value to
6285   `-C debuginfo`][cargo/3534]
6286 * [Implement `cargo --version --verbose`][cargo/3604]
6287 * [All builds now output 'dep-info' build dependencies compatible with
6288   make and ninja][cargo/3557]
6289 * [Build all workspace members with `build --all`][cargo/3511]
6290 * [Document all workspace members with `doc --all`][cargo/3515]
6291 * [Path deps outside workspace are not members][cargo/3443]
6292
6293 Misc
6294 ----
6295
6296 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
6297   the path to the Rust implementation][38589]
6298 * [The `armv7-linux-androideabi` target no longer enables NEON
6299   extensions, per Google's ABI guide][38413]
6300 * [The stock standard library can be compiled for Redox OS][38401]
6301 * [Rust has initial SPARC support][38726]. Tier 3. No builds
6302   available.
6303 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
6304   builds available.
6305 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
6306
6307 Compatibility Notes
6308 -------------------
6309
6310 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6311   match patterns][38069]
6312 * In this release, references to uninhabited types can not be
6313   pattern-matched. This was accidentally allowed in 1.15.
6314 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6315 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6316   Windows][38274]
6317 * [Clean up semantics of `self` in an import list][38313]
6318 * Reimplemented lifetime elision. This change was almost entirely compatible
6319   with existing code, but it did close a number of small bugs and loopholes,
6320   as well as being more accepting in some other [cases][41105].
6321
6322 [37057]: https://github.com/rust-lang/rust/pull/37057
6323 [37761]: https://github.com/rust-lang/rust/pull/37761
6324 [38006]: https://github.com/rust-lang/rust/pull/38006
6325 [38051]: https://github.com/rust-lang/rust/pull/38051
6326 [38062]: https://github.com/rust-lang/rust/pull/38062
6327 [38062]: https://github.com/rust-lang/rust/pull/38622
6328 [38066]: https://github.com/rust-lang/rust/pull/38066
6329 [38069]: https://github.com/rust-lang/rust/pull/38069
6330 [38131]: https://github.com/rust-lang/rust/pull/38131
6331 [38154]: https://github.com/rust-lang/rust/pull/38154
6332 [38274]: https://github.com/rust-lang/rust/pull/38274
6333 [38304]: https://github.com/rust-lang/rust/pull/38304
6334 [38313]: https://github.com/rust-lang/rust/pull/38313
6335 [38314]: https://github.com/rust-lang/rust/pull/38314
6336 [38327]: https://github.com/rust-lang/rust/pull/38327
6337 [38401]: https://github.com/rust-lang/rust/pull/38401
6338 [38413]: https://github.com/rust-lang/rust/pull/38413
6339 [38469]: https://github.com/rust-lang/rust/pull/38469
6340 [38559]: https://github.com/rust-lang/rust/pull/38559
6341 [38571]: https://github.com/rust-lang/rust/pull/38571
6342 [38580]: https://github.com/rust-lang/rust/pull/38580
6343 [38589]: https://github.com/rust-lang/rust/pull/38589
6344 [38670]: https://github.com/rust-lang/rust/pull/38670
6345 [38712]: https://github.com/rust-lang/rust/pull/38712
6346 [38726]: https://github.com/rust-lang/rust/pull/38726
6347 [38781]: https://github.com/rust-lang/rust/pull/38781
6348 [38798]: https://github.com/rust-lang/rust/pull/38798
6349 [38909]: https://github.com/rust-lang/rust/pull/38909
6350 [38920]: https://github.com/rust-lang/rust/pull/38920
6351 [38927]: https://github.com/rust-lang/rust/pull/38927
6352 [39048]: https://github.com/rust-lang/rust/pull/39048
6353 [39282]: https://github.com/rust-lang/rust/pull/39282
6354 [39379]: https://github.com/rust-lang/rust/pull/39379
6355 [41105]: https://github.com/rust-lang/rust/issues/41105
6356 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6357 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6358 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
6359 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
6360 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
6361 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
6362 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
6363 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
6364 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
6365 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
6366 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
6367 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
6368 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
6369 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
6370 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
6371 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
6372 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
6373 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
6374 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
6375 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
6376 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
6377 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
6378 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
6379 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
6380 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
6381 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
6382 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
6383 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
6384 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
6385 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
6386
6387
6388 Version 1.15.1 (2017-02-09)
6389 ===========================
6390
6391 * [Fix IntoIter::as_mut_slice's signature][39466]
6392 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
6393
6394 [39466]: https://github.com/rust-lang/rust/pull/39466
6395 [39523]: https://github.com/rust-lang/rust/pull/39523
6396
6397
6398 Version 1.15.0 (2017-02-02)
6399 ===========================
6400
6401 Language
6402 --------
6403
6404 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
6405   stable. This allows popular code-generating crates like Serde and Diesel to
6406   work ergonomically. [RFC 1681].
6407 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
6408   with curly braces][36868]. Part of [RFC 1506].
6409 * [A number of minor changes to name resolution have been activated][37127].
6410   They add up to more consistent semantics, allowing for future evolution of
6411   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6412   details of what is different. The breaking changes here have been transitioned
6413   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6414 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
6415   bounds][38279]
6416 * [`?Sized` can be used in `where` clauses][37791]
6417 * [There is now a limit on the size of monomorphized types and it can be
6418   modified with the `#![type_size_limit]` crate attribute, similarly to
6419   the `#![recursion_limit]` attribute][37789]
6420
6421 Compiler
6422 --------
6423
6424 * [On Windows, the compiler will apply dllimport attributes when linking to
6425   extern functions][37973]. Additional attributes and flags can control which
6426   library kind is linked and its name. [RFC 1717].
6427 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6428 * [The `--test` flag works with procedural macro crates][38107]
6429 * [Fix `extern "aapcs" fn` ABI][37814]
6430 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
6431 * [The `format!` expander recognizes incorrect `printf` and shell-style
6432   formatting directives and suggests the correct format][37613].
6433 * [Only report one error for all unused imports in an import list][37456]
6434
6435 Compiler Performance
6436 --------------------
6437
6438 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
6439 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
6440 * [Don't clone in `UnificationTable::probe`][37848]
6441 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
6442 * [Use small vectors in type walker][37760]
6443 * [Macro expansion performance was improved][37701]
6444 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
6445 * [Replace FNV with a faster hash function][37229]
6446
6447 Stabilized APIs
6448 ---------------
6449
6450 * [`std::iter::Iterator::min_by`]
6451 * [`std::iter::Iterator::max_by`]
6452 * [`std::os::*::fs::FileExt`]
6453 * [`std::sync::atomic::Atomic*::get_mut`]
6454 * [`std::sync::atomic::Atomic*::into_inner`]
6455 * [`std::vec::IntoIter::as_slice`]
6456 * [`std::vec::IntoIter::as_mut_slice`]
6457 * [`std::sync::mpsc::Receiver::try_iter`]
6458 * [`std::os::unix::process::CommandExt::before_exec`]
6459 * [`std::rc::Rc::strong_count`]
6460 * [`std::rc::Rc::weak_count`]
6461 * [`std::sync::Arc::strong_count`]
6462 * [`std::sync::Arc::weak_count`]
6463 * [`std::char::encode_utf8`]
6464 * [`std::char::encode_utf16`]
6465 * [`std::cell::Ref::clone`]
6466 * [`std::io::Take::into_inner`]
6467
6468 Libraries
6469 ---------
6470
6471 * [The standard sorting algorithm has been rewritten for dramatic performance
6472   improvements][38192]. It is a hybrid merge sort, drawing influences from
6473   Timsort. Previously it was a naive merge sort.
6474 * [`Iterator::nth` no longer has a `Sized` bound][38134]
6475 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
6476   performance.
6477 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
6478   and `char_indices().last()`][37882]
6479 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
6480 * [Chinese characters display correctly in `fmt::Debug`][37855]
6481 * [Derive `Default` for `Duration`][37699]
6482 * [Support creation of anonymous pipes on WinXP/2k][37677]
6483 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
6484 * [Don't pass overlapped handles to processes][38835]
6485
6486 Cargo
6487 -----
6488
6489 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6490   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6491   should instead check the variable at runtime with `std::env`. That the value
6492   was set at build time was a bug, and incorrect when cross-compiling. This
6493   change is known to cause breakage.
6494 * [Add `--all` flag to `cargo test`][cargo/3221]
6495 * [Compile statically against the MSVC CRT][cargo/3363]
6496 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
6497 * [Link OpenSSL statically on OSX][cargo/3311]
6498 * [Apply new fingerprinting to build dir outputs][cargo/3310]
6499 * [Test for bad path overrides with summaries][cargo/3336]
6500 * [Require `cargo install --vers` to take a semver version][cargo/3338]
6501 * [Fix retrying crate downloads for network errors][cargo/3348]
6502 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
6503 * [Emit more info on --message-format=json][cargo/3319]
6504 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
6505 * [Don't ignore errors in workspace manifest][cargo/3409]
6506 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
6507
6508 Tooling
6509 -------
6510
6511 * [Test runners (binaries built with `--test`) now support a `--list` argument
6512   that lists the tests it contains][38185]
6513 * [Test runners now support a `--exact` argument that makes the test filter
6514   match exactly, instead of matching only a substring of the test name][38181]
6515 * [rustdoc supports a `--playground-url` flag][37763]
6516 * [rustdoc provides more details about `#[should_panic]` errors][37749]
6517
6518 Misc
6519 ----
6520
6521 * [The Rust build system is now written in Rust][37817]. The Makefiles may
6522   continue to be used in this release by passing `--disable-rustbuild` to the
6523   configure script, but they will be deleted soon. Note that the new build
6524   system uses a different on-disk layout that will likely affect any scripts
6525   building Rust.
6526 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
6527   releases.
6528 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
6529 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
6530   releases.
6531
6532 Compatibility Notes
6533 -------------------
6534
6535 * [A number of minor changes to name resolution have been activated][37127].
6536   They add up to more consistent semantics, allowing for future evolution of
6537   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6538   details of what is different. The breaking changes here have been transitioned
6539   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6540 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6541   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6542   should instead check the variable at runtime with `std::env`. That the value
6543   was set at build time was a bug, and incorrect when cross-compiling. This
6544   change is known to cause breakage.
6545 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
6546   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
6547   1.10 and is now an error by default. It will become a hard error in the near
6548   future.
6549 * [The semantics relating modules to file system directories are changing in
6550   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
6551   lint, which is a warning in this release, and will become a hard error in the
6552   future.
6553 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6554 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
6555   the underlying iterator][37834]
6556
6557 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
6558 [33685]: https://github.com/rust-lang/rust/issues/33685
6559 [36868]: https://github.com/rust-lang/rust/pull/36868
6560 [37127]: https://github.com/rust-lang/rust/pull/37127
6561 [37229]: https://github.com/rust-lang/rust/pull/37229
6562 [37456]: https://github.com/rust-lang/rust/pull/37456
6563 [37527]: https://github.com/rust-lang/rust/pull/37527
6564 [37602]: https://github.com/rust-lang/rust/pull/37602
6565 [37613]: https://github.com/rust-lang/rust/pull/37613
6566 [37615]: https://github.com/rust-lang/rust/pull/37615
6567 [37636]: https://github.com/rust-lang/rust/pull/37636
6568 [37627]: https://github.com/rust-lang/rust/pull/37627
6569 [37642]: https://github.com/rust-lang/rust/pull/37642
6570 [37677]: https://github.com/rust-lang/rust/pull/37677
6571 [37699]: https://github.com/rust-lang/rust/pull/37699
6572 [37701]: https://github.com/rust-lang/rust/pull/37701
6573 [37705]: https://github.com/rust-lang/rust/pull/37705
6574 [37749]: https://github.com/rust-lang/rust/pull/37749
6575 [37760]: https://github.com/rust-lang/rust/pull/37760
6576 [37763]: https://github.com/rust-lang/rust/pull/37763
6577 [37764]: https://github.com/rust-lang/rust/pull/37764
6578 [37789]: https://github.com/rust-lang/rust/pull/37789
6579 [37791]: https://github.com/rust-lang/rust/pull/37791
6580 [37814]: https://github.com/rust-lang/rust/pull/37814
6581 [37817]: https://github.com/rust-lang/rust/pull/37817
6582 [37834]: https://github.com/rust-lang/rust/pull/37834
6583 [37848]: https://github.com/rust-lang/rust/pull/37848
6584 [37855]: https://github.com/rust-lang/rust/pull/37855
6585 [37882]: https://github.com/rust-lang/rust/pull/37882
6586 [37888]: https://github.com/rust-lang/rust/pull/37888
6587 [37973]: https://github.com/rust-lang/rust/pull/37973
6588 [37979]: https://github.com/rust-lang/rust/pull/37979
6589 [38086]: https://github.com/rust-lang/rust/pull/38086
6590 [38107]: https://github.com/rust-lang/rust/pull/38107
6591 [38117]: https://github.com/rust-lang/rust/pull/38117
6592 [38134]: https://github.com/rust-lang/rust/pull/38134
6593 [38146]: https://github.com/rust-lang/rust/pull/38146
6594 [38181]: https://github.com/rust-lang/rust/pull/38181
6595 [38182]: https://github.com/rust-lang/rust/pull/38182
6596 [38185]: https://github.com/rust-lang/rust/pull/38185
6597 [38192]: https://github.com/rust-lang/rust/pull/38192
6598 [38279]: https://github.com/rust-lang/rust/pull/38279
6599 [38835]: https://github.com/rust-lang/rust/pull/38835
6600 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6601 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6602 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
6603 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
6604 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
6605 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
6606 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
6607 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
6608 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
6609 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
6610 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
6611 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
6612 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
6613 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
6614 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
6615 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
6616 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
6617 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
6618 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
6619 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
6620 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
6621 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
6622 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
6623 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
6624 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
6625 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
6626 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
6627 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
6628 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
6629 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
6630 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
6631 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
6632 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
6633 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
6634 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
6635 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
6636 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
6637 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
6638
6639
6640 Version 1.14.0 (2016-12-22)
6641 ===========================
6642
6643 Language
6644 --------
6645
6646 * [`..` matches multiple tuple fields in enum variants, structs
6647   and tuples][36843]. [RFC 1492].
6648 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
6649 * [`use *` and `use ::*` both glob-import from the crate root][37367]
6650 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
6651   dereferencing][36822]
6652
6653 Compiler
6654 --------
6655
6656 * [Mark enums with non-zero discriminant as non-zero][37224]
6657 * [Lower-case `static mut` names are linted like other
6658   statics and consts][37162]
6659 * [Fix ICE on some macros in const integer positions
6660    (e.g. `[u8; m!()]`)][36819]
6661 * [Improve error message and snippet for "did you mean `x`"][36798]
6662 * [Add a panic-strategy field to the target specification][36794]
6663 * [Include LLVM version in `--version --verbose`][37200]
6664
6665 Compile-time Optimizations
6666 --------------------------
6667
6668 * [Improve macro expansion performance][37569]
6669 * [Shrink `Expr_::ExprInlineAsm`][37445]
6670 * [Replace all uses of SHA-256 with BLAKE2b][37439]
6671 * [Reduce the number of bytes hashed by `IchHasher`][37427]
6672 * [Avoid more allocations when compiling html5ever][37373]
6673 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
6674 * [Avoid some allocations in the macro parser][37318]
6675 * [Use a faster deflate setting][37298]
6676 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
6677   during interning of slices][37270]
6678 * [Optimize `write_metadata`][37267]
6679 * [Don't process obligation forest cycles when stalled][37231]
6680 * [Avoid many `CrateConfig` clones][37161]
6681 * [Optimize `Substs::super_fold_with`][37108]
6682 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
6683 * [Speed up `plug_leaks`][36917]
6684
6685 Libraries
6686 ---------
6687
6688 * [`println!()`, with no arguments, prints newline][36825].
6689   Previously, an empty string was required to achieve the same.
6690 * [`Wrapping` impls standard binary and unary operators, as well as
6691    the `Sum` and `Product` iterators][37356]
6692 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
6693   Vec<T>`][37326]
6694 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
6695   `VecDeque` iterators][37315]
6696 * [Improve `SipHasher` performance on small values][37312]
6697 * [Add Iterator trait TrustedLen to enable better FromIterator /
6698   Extend][37306]
6699 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
6700 * [`ReadDir` implements `Debug`][37221]
6701 * [Implement `RefUnwindSafe` for atomic types][37178]
6702 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
6703 * [Avoid allocations in `Decoder::read_str`][37064]
6704 * [`io::Error` implements `From<io::ErrorKind>`][37037]
6705 * [Impl `Debug` for raw pointers to unsized data][36880]
6706 * [Don't reuse `HashMap` random seeds][37470]
6707 * [The internal memory layout of `HashMap` is more cache-friendly, for
6708   significant improvements in some operations][36692]
6709 * [`HashMap` uses less memory on 32-bit architectures][36595]
6710 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
6711
6712 Cargo
6713 -----
6714
6715 * [Expose rustc cfg values to build scripts][cargo/3243]
6716 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
6717 * [Fix passing --features when testing multiple packages][cargo/3280]
6718 * [Use a single profile set per workspace][cargo/3249]
6719 * [Load `replace` sections from lock files][cargo/3220]
6720 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
6721
6722 Tooling
6723 -------
6724
6725 * [rustup is the recommended Rust installation method][1.14rustup]
6726 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
6727   S390x. These are [tier 2] platforms and may have major defects. Follow the
6728   instructions on the website to install, or add the targets to an existing
6729   installation with `rustup target add`. The new target triples are:
6730   - `mips-unknown-linux-gnu`
6731   - `mipsel-unknown-linux-gnu`
6732   - `mips64-unknown-linux-gnuabi64`
6733   - `mips64el-unknown-linux-gnuabi64 `
6734   - `powerpc-unknown-linux-gnu`
6735   - `powerpc64-unknown-linux-gnu`
6736   - `powerpc64le-unknown-linux-gnu`
6737   - `s390x-unknown-linux-gnu `
6738 * This release includes target (std) builds for ARM Linux running MUSL
6739   libc. These are [tier 2] platforms and may have major defects. Add the
6740   following triples to an existing rustup installation with `rustup target add`:
6741   - `arm-unknown-linux-musleabi`
6742   - `arm-unknown-linux-musleabihf`
6743   - `armv7-unknown-linux-musleabihf`
6744 * This release includes [experimental support for WebAssembly][1.14wasm], via
6745   the `wasm32-unknown-emscripten` target. This target is known to have major
6746   defects. Please test, report, and fix.
6747 * rustup no longer installs documentation by default. Run `rustup
6748   component add rust-docs` to install.
6749 * [Fix line stepping in debugger][37310]
6750 * [Enable line number debuginfo in releases][37280]
6751
6752 Misc
6753 ----
6754
6755 * [Disable jemalloc on aarch64/powerpc/mips][37392]
6756 * [Add support for Fuchsia OS][37313]
6757 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
6758
6759 Compatibility Notes
6760 -------------------
6761
6762 * [A number of forward-compatibility lints used by the compiler
6763   to gradually introduce language changes have been converted
6764   to deny by default][36894]:
6765   - ["use of inaccessible extern crate erroneously allowed"][36886]
6766   - ["type parameter default erroneously allowed in invalid location"][36887]
6767   - ["detects super or self keywords at the beginning of global path"][36888]
6768   - ["two overlapping inherent impls define an item with the same name
6769     were erroneously allowed"][36889]
6770   - ["floating-point constants cannot be used in patterns"][36890]
6771   - ["constants of struct or enum type can only be used in a pattern if
6772      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
6773   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
6774 * [Prohibit patterns in trait methods without bodies][37378]
6775 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
6776 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
6777 * [The `$crate` macro variable is accepted in fewer locations][37213]
6778 * [Impls specifying extra region requirements beyond the trait
6779   they implement are rejected][37167]
6780 * [Enums may not be unsized][37111]. Unsized enums are intended to
6781   work but never have. For now they are forbidden.
6782 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
6783
6784 [tier 2]: https://forge.rust-lang.org/platform-support.html
6785 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
6786 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
6787 [36430]: https://github.com/rust-lang/rust/pull/36430
6788 [36595]: https://github.com/rust-lang/rust/pull/36595
6789 [36595]: https://github.com/rust-lang/rust/pull/36595
6790 [36692]: https://github.com/rust-lang/rust/pull/36692
6791 [36767]: https://github.com/rust-lang/rust/pull/36767
6792 [36794]: https://github.com/rust-lang/rust/pull/36794
6793 [36798]: https://github.com/rust-lang/rust/pull/36798
6794 [36819]: https://github.com/rust-lang/rust/pull/36819
6795 [36822]: https://github.com/rust-lang/rust/pull/36822
6796 [36825]: https://github.com/rust-lang/rust/pull/36825
6797 [36843]: https://github.com/rust-lang/rust/pull/36843
6798 [36880]: https://github.com/rust-lang/rust/pull/36880
6799 [36886]: https://github.com/rust-lang/rust/issues/36886
6800 [36887]: https://github.com/rust-lang/rust/issues/36887
6801 [36888]: https://github.com/rust-lang/rust/issues/36888
6802 [36889]: https://github.com/rust-lang/rust/issues/36889
6803 [36890]: https://github.com/rust-lang/rust/issues/36890
6804 [36891]: https://github.com/rust-lang/rust/issues/36891
6805 [36892]: https://github.com/rust-lang/rust/issues/36892
6806 [36894]: https://github.com/rust-lang/rust/pull/36894
6807 [36917]: https://github.com/rust-lang/rust/pull/36917
6808 [36993]: https://github.com/rust-lang/rust/pull/36993
6809 [37037]: https://github.com/rust-lang/rust/pull/37037
6810 [37064]: https://github.com/rust-lang/rust/pull/37064
6811 [37094]: https://github.com/rust-lang/rust/pull/37094
6812 [37108]: https://github.com/rust-lang/rust/pull/37108
6813 [37111]: https://github.com/rust-lang/rust/pull/37111
6814 [37161]: https://github.com/rust-lang/rust/pull/37161
6815 [37162]: https://github.com/rust-lang/rust/pull/37162
6816 [37167]: https://github.com/rust-lang/rust/pull/37167
6817 [37178]: https://github.com/rust-lang/rust/pull/37178
6818 [37200]: https://github.com/rust-lang/rust/pull/37200
6819 [37213]: https://github.com/rust-lang/rust/pull/37213
6820 [37221]: https://github.com/rust-lang/rust/pull/37221
6821 [37224]: https://github.com/rust-lang/rust/pull/37224
6822 [37230]: https://github.com/rust-lang/rust/pull/37230
6823 [37231]: https://github.com/rust-lang/rust/pull/37231
6824 [37247]: https://github.com/rust-lang/rust/pull/37247
6825 [37267]: https://github.com/rust-lang/rust/pull/37267
6826 [37270]: https://github.com/rust-lang/rust/pull/37270
6827 [37273]: https://github.com/rust-lang/rust/pull/37273
6828 [37280]: https://github.com/rust-lang/rust/pull/37280
6829 [37298]: https://github.com/rust-lang/rust/pull/37298
6830 [37306]: https://github.com/rust-lang/rust/pull/37306
6831 [37310]: https://github.com/rust-lang/rust/pull/37310
6832 [37312]: https://github.com/rust-lang/rust/pull/37312
6833 [37313]: https://github.com/rust-lang/rust/pull/37313
6834 [37315]: https://github.com/rust-lang/rust/pull/37315
6835 [37318]: https://github.com/rust-lang/rust/pull/37318
6836 [37322]: https://github.com/rust-lang/rust/pull/37322
6837 [37326]: https://github.com/rust-lang/rust/pull/37326
6838 [37351]: https://github.com/rust-lang/rust/pull/37351
6839 [37356]: https://github.com/rust-lang/rust/pull/37356
6840 [37367]: https://github.com/rust-lang/rust/pull/37367
6841 [37373]: https://github.com/rust-lang/rust/pull/37373
6842 [37378]: https://github.com/rust-lang/rust/pull/37378
6843 [37389]: https://github.com/rust-lang/rust/pull/37389
6844 [37392]: https://github.com/rust-lang/rust/pull/37392
6845 [37427]: https://github.com/rust-lang/rust/pull/37427
6846 [37439]: https://github.com/rust-lang/rust/pull/37439
6847 [37445]: https://github.com/rust-lang/rust/pull/37445
6848 [37470]: https://github.com/rust-lang/rust/pull/37470
6849 [37569]: https://github.com/rust-lang/rust/pull/37569
6850 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6851 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
6852 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
6853 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
6854 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
6855 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
6856 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
6857
6858
6859 Version 1.13.0 (2016-11-10)
6860 ===========================
6861
6862 Language
6863 --------
6864
6865 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
6866   errors, like the `try!` macro, described in [RFC 0243].
6867 * [Stabilize macros in type position][36014]. Described in [RFC 873].
6868 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
6869 * [Fix `#[derive]` for empty tuple structs/variants][35728]
6870 * [Fix lifetime rules for 'if' conditions][36029]
6871 * [Avoid loading and parsing unconfigured non-inline modules][36482]
6872
6873 Compiler
6874 --------
6875
6876 * [Add the `-C link-arg` argument][36574]
6877 * [Remove the old AST-based backend from rustc_trans][35764]
6878 * [Don't enable NEON by default on armv7 Linux][35814]
6879 * [Fix debug line number info for macro expansions][35238]
6880 * [Do not emit "class method" debuginfo for types that are not
6881   DICompositeType][36008]
6882 * [Warn about multiple conflicting #[repr] hints][34623]
6883 * [When sizing DST, don't double-count nested struct prefixes][36351]
6884 * [Default RUST_MIN_STACK to 16MiB for now][36505]
6885 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
6886 * [Reject macros with empty repetitions to avoid infinite loop][36721]
6887 * [Expand macros without recursing to avoid stack overflows][36214]
6888
6889 Diagnostics
6890 -----------
6891
6892 * [Replace macro backtraces with labeled local uses][35702]
6893 * [Improve error message for misplaced doc comments][33922]
6894 * [Buffer unix and lock windows to prevent message interleaving][35975]
6895 * [Update lifetime errors to specifically note temporaries][36171]
6896 * [Special case a few colors for Windows][36178]
6897 * [Suggest `use self` when such an import resolves][36289]
6898 * [Be more specific when type parameter shadows primitive type][36338]
6899 * Many minor improvements
6900
6901 Compile-time Optimizations
6902 --------------------------
6903
6904 * [Compute and cache HIR hashes at beginning][35854]
6905 * [Don't hash types in loan paths][36004]
6906 * [Cache projections in trans][35761]
6907 * [Optimize the parser's last token handling][36527]
6908 * [Only instantiate #[inline] functions in codegen units referencing
6909   them][36524]. This leads to big improvements in cases where crates export
6910   define many inline functions without using them directly.
6911 * [Lazily allocate TypedArena's first chunk][36592]
6912 * [Don't allocate during default HashSet creation][36734]
6913
6914 Stabilized APIs
6915 ---------------
6916
6917 * [`checked_abs`]
6918 * [`wrapping_abs`]
6919 * [`overflowing_abs`]
6920 * [`RefCell::try_borrow`]
6921 * [`RefCell::try_borrow_mut`]
6922
6923 Libraries
6924 ---------
6925
6926 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
6927 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
6928   covariant][35354]
6929 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
6930 * [Implement `Debug` for `std::vec::IntoIter`][35707]
6931 * [`CString`: avoid excessive growth just to 0-terminate][35871]
6932 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
6933 * [Use arc4rand on FreeBSD][35884]
6934 * [memrchr: Correct aligned offset computation][35969]
6935 * [Improve Demangling of Rust Symbols][36059]
6936 * [Use monotonic time in condition variables][35048]
6937 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
6938 * [Implement conversion traits for `char`][35755]
6939 * [Fix illegal instruction caused by overflow in channel cloning][36104]
6940 * [Zero first byte of CString on drop][36264]
6941 * [Inherit overflow checks for sum and product][36372]
6942 * [Add missing Eq implementations][36423]
6943 * [Implement `Debug` for `DirEntry`][36631]
6944 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
6945   `errno`][36754]
6946 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6947 * [Implement more traits for `std::io::ErrorKind`][35911]
6948 * [Optimize BinaryHeap bounds checking][36072]
6949 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
6950   `extend_with_element`][36355]
6951 * [Fix overflow checking in unsigned pow()][34942]
6952
6953 Cargo
6954 -----
6955
6956 * This release includes security fixes to both curl and OpenSSL.
6957 * [Fix transitive doctests when panic=abort][cargo/3021]
6958 * [Add --all-features flag to cargo][cargo/3038]
6959 * [Reject path-based dependencies in `cargo package`][cargo/3060]
6960 * [Don't parse the home directory more than once][cargo/3078]
6961 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
6962 * [Update OpenSSL to 1.0.2j][cargo/3121]
6963 * [Add license and license_file to cargo metadata output][cargo/3110]
6964 * [Make crates-io registry URL optional in config; ignore all changes to
6965   source.crates-io][cargo/3089]
6966 * [Don't download dependencies from other platforms][cargo/3123]
6967 * [Build transitive dev-dependencies when needed][cargo/3125]
6968 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
6969 * [Avoid updating registry when adding existing deps][cargo/3144]
6970 * [Warn about path overrides that won't work][cargo/3136]
6971 * [Use workspaces during `cargo install`][cargo/3146]
6972 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
6973 * [Add --message-format flag][cargo/3000]
6974 * [Pass target environment for rustdoc][cargo/3205]
6975 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
6976 * [Update curl and curl-sys][cargo/3241]
6977 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
6978
6979 Tooling
6980 -------
6981
6982 * [rustdoc: Add the `--sysroot` argument][36586]
6983 * [rustdoc: Fix a couple of issues with the search results][35655]
6984 * [rustdoc: remove the `!` from macro URLs and titles][35234]
6985 * [gdb: Fix pretty-printing special-cased Rust types][35585]
6986 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
6987
6988 Misc
6989 ----
6990
6991 * [Remove unmaintained style guide][35124]
6992 * [Add s390x support][36369]
6993 * [Initial work at Haiku OS support][36727]
6994 * [Add mips-uclibc targets][35734]
6995 * [Crate-ify compiler-rt into compiler-builtins][35021]
6996 * [Add rustc version info (git hash + date) to dist tarball][36213]
6997 * Many documentation improvements
6998
6999 Compatibility Notes
7000 -------------------
7001
7002 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
7003 * [Deny (by default) transmuting from fn item types to pointer-sized
7004   types][34923]. Continuing the long transition to zero-sized fn items,
7005   per [RFC 401].
7006 * [Fix `#[derive]` for empty tuple structs/variants][35728].
7007   Part of [RFC 1506].
7008 * [Issue deprecation warnings for safe accesses to extern statics][36173]
7009 * [Fix lifetime rules for 'if' conditions][36029].
7010 * [Inherit overflow checks for sum and product][36372].
7011 * [Forbid user-defined macros named "macro_rules"][36730].
7012
7013 [33922]: https://github.com/rust-lang/rust/pull/33922
7014 [34623]: https://github.com/rust-lang/rust/pull/34623
7015 [34923]: https://github.com/rust-lang/rust/pull/34923
7016 [34942]: https://github.com/rust-lang/rust/pull/34942
7017 [34982]: https://github.com/rust-lang/rust/pull/34982
7018 [35021]: https://github.com/rust-lang/rust/pull/35021
7019 [35048]: https://github.com/rust-lang/rust/pull/35048
7020 [35074]: https://github.com/rust-lang/rust/pull/35074
7021 [35124]: https://github.com/rust-lang/rust/pull/35124
7022 [35234]: https://github.com/rust-lang/rust/pull/35234
7023 [35238]: https://github.com/rust-lang/rust/pull/35238
7024 [35354]: https://github.com/rust-lang/rust/pull/35354
7025 [35559]: https://github.com/rust-lang/rust/pull/35559
7026 [35585]: https://github.com/rust-lang/rust/pull/35585
7027 [35627]: https://github.com/rust-lang/rust/pull/35627
7028 [35655]: https://github.com/rust-lang/rust/pull/35655
7029 [35702]: https://github.com/rust-lang/rust/pull/35702
7030 [35707]: https://github.com/rust-lang/rust/pull/35707
7031 [35728]: https://github.com/rust-lang/rust/pull/35728
7032 [35734]: https://github.com/rust-lang/rust/pull/35734
7033 [35755]: https://github.com/rust-lang/rust/pull/35755
7034 [35761]: https://github.com/rust-lang/rust/pull/35761
7035 [35764]: https://github.com/rust-lang/rust/pull/35764
7036 [35814]: https://github.com/rust-lang/rust/pull/35814
7037 [35854]: https://github.com/rust-lang/rust/pull/35854
7038 [35871]: https://github.com/rust-lang/rust/pull/35871
7039 [35884]: https://github.com/rust-lang/rust/pull/35884
7040 [35911]: https://github.com/rust-lang/rust/pull/35911
7041 [35969]: https://github.com/rust-lang/rust/pull/35969
7042 [35975]: https://github.com/rust-lang/rust/pull/35975
7043 [36004]: https://github.com/rust-lang/rust/pull/36004
7044 [36008]: https://github.com/rust-lang/rust/pull/36008
7045 [36014]: https://github.com/rust-lang/rust/pull/36014
7046 [36029]: https://github.com/rust-lang/rust/pull/36029
7047 [36059]: https://github.com/rust-lang/rust/pull/36059
7048 [36072]: https://github.com/rust-lang/rust/pull/36072
7049 [36101]: https://github.com/rust-lang/rust/pull/36101
7050 [36104]: https://github.com/rust-lang/rust/pull/36104
7051 [36171]: https://github.com/rust-lang/rust/pull/36171
7052 [36173]: https://github.com/rust-lang/rust/pull/36173
7053 [36178]: https://github.com/rust-lang/rust/pull/36178
7054 [36213]: https://github.com/rust-lang/rust/pull/36213
7055 [36214]: https://github.com/rust-lang/rust/pull/36214
7056 [36264]: https://github.com/rust-lang/rust/pull/36264
7057 [36266]: https://github.com/rust-lang/rust/pull/36266
7058 [36289]: https://github.com/rust-lang/rust/pull/36289
7059 [36338]: https://github.com/rust-lang/rust/pull/36338
7060 [36351]: https://github.com/rust-lang/rust/pull/36351
7061 [36355]: https://github.com/rust-lang/rust/pull/36355
7062 [36369]: https://github.com/rust-lang/rust/pull/36369
7063 [36372]: https://github.com/rust-lang/rust/pull/36372
7064 [36423]: https://github.com/rust-lang/rust/pull/36423
7065 [36482]: https://github.com/rust-lang/rust/pull/36482
7066 [36505]: https://github.com/rust-lang/rust/pull/36505
7067 [36524]: https://github.com/rust-lang/rust/pull/36524
7068 [36527]: https://github.com/rust-lang/rust/pull/36527
7069 [36551]: https://github.com/rust-lang/rust/pull/36551
7070 [36574]: https://github.com/rust-lang/rust/pull/36574
7071 [36586]: https://github.com/rust-lang/rust/pull/36586
7072 [36592]: https://github.com/rust-lang/rust/pull/36592
7073 [36631]: https://github.com/rust-lang/rust/pull/36631
7074 [36639]: https://github.com/rust-lang/rust/pull/36639
7075 [36721]: https://github.com/rust-lang/rust/pull/36721
7076 [36727]: https://github.com/rust-lang/rust/pull/36727
7077 [36730]: https://github.com/rust-lang/rust/pull/36730
7078 [36734]: https://github.com/rust-lang/rust/pull/36734
7079 [36754]: https://github.com/rust-lang/rust/pull/36754
7080 [36995]: https://github.com/rust-lang/rust/pull/36995
7081 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
7082 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
7083 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
7084 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
7085 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
7086 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
7087 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
7088 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
7089 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
7090 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
7091 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
7092 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
7093 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
7094 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
7095 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
7096 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
7097 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
7098 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
7099 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
7100 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
7101 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
7102 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
7103 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
7104 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
7105 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
7106 [rustup]: https://www.rustup.rs
7107 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
7108 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
7109 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
7110 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
7111 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
7112 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
7113 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
7114
7115
7116 Version 1.12.1 (2016-10-20)
7117 ===========================
7118
7119 Regression Fixes
7120 ----------------
7121
7122 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
7123 * [Confusion with double negation and booleans][36856]
7124 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
7125 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
7126 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
7127 * [Corrupted memory after updated to 1.12][36936]
7128 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
7129 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
7130 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
7131
7132 [36381]: https://github.com/rust-lang/rust/issues/36381
7133 [36856]: https://github.com/rust-lang/rust/issues/36856
7134 [36875]: https://github.com/rust-lang/rust/issues/36875
7135 [36924]: https://github.com/rust-lang/rust/issues/36924
7136 [36926]: https://github.com/rust-lang/rust/issues/36926
7137 [36936]: https://github.com/rust-lang/rust/issues/36936
7138 [37026]: https://github.com/rust-lang/rust/issues/37026
7139 [37112]: https://github.com/rust-lang/rust/issues/37112
7140 [37153]: https://github.com/rust-lang/rust/issues/37153
7141
7142
7143 Version 1.12.0 (2016-09-29)
7144 ===========================
7145
7146 Highlights
7147 ----------
7148
7149 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
7150   This translation pass is far simpler than the previous AST->LLVM pass, and
7151   creates opportunities to perform new optimizations directly on the MIR. It
7152   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
7153 * [`rustc` presents a new, more readable error format, along with
7154   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
7155   Most common editors supporting Rust have been updated to work with it. It was
7156   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
7157
7158 Compiler
7159 --------
7160
7161 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
7162   This translation pass is far simpler than the previous AST->LLVM pass, and
7163   creates opportunities to perform new optimizations directly on the MIR. It
7164   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
7165 * [Print the Rust target name, not the LLVM target name, with
7166   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
7167 * [The computation of `TypeId` is correct in some cases where it was previously
7168   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
7169 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
7170 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
7171   `--print relocation-models`, and `--print code-models` print the available
7172   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
7173   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
7174 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
7175   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
7176   These targets produce statically-linked binaries. There are no binary release
7177   builds yet though.
7178
7179 Diagnostics
7180 -----------
7181
7182 * [`rustc` presents a new, more readable error format, along with
7183   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
7184   Most common editors supporting Rust have been updated to work with it. It was
7185   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
7186 * [In error descriptions, references are now described in plain English,
7187   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
7188 * [In error type descriptions, unknown numeric types are named `{integer}` or
7189   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
7190 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
7191
7192 Language
7193 --------
7194
7195 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
7196 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
7197 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
7198   useful](https://github.com/rust-lang/rust/pull/34908)
7199 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
7200   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
7201 * [Semicolons are properly required as statement delimiters inside
7202   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
7203 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
7204
7205 Stabilized APIs
7206 ---------------
7207
7208 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
7209 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
7210 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
7211 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
7212 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
7213 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
7214 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
7215 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
7216 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
7217 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
7218   Both on Unix and Windows.
7219 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
7220 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
7221 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
7222 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
7223 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
7224 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
7225 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
7226 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
7227
7228 Libraries
7229 ---------
7230
7231 * [The `format!` macro and friends now allow a single argument to be formatted
7232   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
7233 * [The lifetime bounds on `[T]::binary_search_by` and
7234   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
7235 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
7236 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
7237 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
7238 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
7239 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
7240 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
7241 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
7242 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
7243   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
7244 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
7245   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
7246 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
7247 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
7248   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
7249 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
7250 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
7251 * [`mpsc::sync_channel` `Receiver`s return any available message before
7252   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
7253 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
7254 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
7255
7256 Cargo
7257 -----
7258
7259 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
7260 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
7261 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
7262 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
7263 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
7264 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
7265 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
7266 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
7267 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
7268 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
7269 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
7270 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
7271 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
7272 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
7273 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
7274 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
7275
7276 Performance
7277 -----------
7278
7279 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
7280 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
7281
7282 Tooling
7283 -------
7284
7285 * [Test binaries now support a `--test-threads` argument to specify the number
7286   of threads used to run tests, and which acts the same as the
7287   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
7288 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
7289 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
7290 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7291 * [Rust releases now come with source packages that can be installed by rustup
7292   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
7293   The resulting source code can be used by tools and IDES, located in the
7294   sysroot under `lib/rustlib/src`.
7295
7296 Misc
7297 ----
7298
7299 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
7300 * Many minor improvements to the documentation.
7301 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
7302
7303 Compatibility Notes
7304 -------------------
7305
7306 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
7307   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
7308 * [When formatting strings, if "precision" is specified, the "fill",
7309   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
7310 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
7311
7312
7313 Version 1.11.0 (2016-08-18)
7314 ===========================
7315
7316 Language
7317 --------
7318
7319 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
7320 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
7321 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
7322 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
7323
7324 Stabilized APIs
7325 ---------------
7326
7327 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
7328 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
7329 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
7330 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
7331 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
7332 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
7333   (in libcore - previously stabilized in libstd)
7334 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
7335   (in libcore - previously stabilized in libstd)
7336 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
7337   (in libcore - previously stabilized in libstd)
7338 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
7339   (in libcore - previously stabilized in libstd)
7340 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7341 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7342 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
7343 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
7344
7345 Libraries
7346 ---------
7347
7348 * [The `thread_local!` macro supports multiple definitions in a single
7349    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
7350 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
7351 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
7352   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
7353 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
7354 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
7355 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
7356 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
7357
7358 Cargo
7359 -----
7360
7361 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
7362 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
7363 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
7364 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
7365 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
7366   and `-vv` prints warnings for all crates.
7367 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
7368 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
7369   This provides room for expansion by arbitrary tools.
7370 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
7371 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
7372 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
7373 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
7374 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
7375 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
7376 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
7377
7378 Performance
7379 -----------
7380
7381 * [Caching projections speeds up type check dramatically for some
7382   workloads](https://github.com/rust-lang/rust/pull/33816)
7383 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
7384   This hasher is faster, but is believed to provide sufficient
7385   protection from collision attacks.
7386 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
7387
7388 Rustdoc
7389 -------
7390
7391 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
7392 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
7393 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
7394 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
7395 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
7396
7397 Tooling
7398 -------
7399
7400 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
7401 * [When emitting debug info, rustc emits frame pointers for closures,
7402   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
7403 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7404 * Many more errors have been given error codes and extended
7405   explanations
7406 * API documentation continues to be improved, with many new examples
7407
7408 Misc
7409 ----
7410
7411 * [rustc no longer hangs when dependencies recursively re-export
7412   submodules](https://github.com/rust-lang/rust/pull/34542)
7413 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
7414 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
7415   rewritten](https://github.com/rust-lang/rust/pull/33895)
7416 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
7417   No targets use this yet, but it works toward AVR support.
7418
7419 Compatibility Notes
7420 -------------------
7421
7422 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
7423 * [The new follow-set rules that place restrictions on `macro_rules!`
7424   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
7425   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
7426   and has been a warning since 1.10.
7427 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
7428   This causes breakage in some corner cases.
7429
7430
7431 Version 1.10.0 (2016-07-07)
7432 ===========================
7433
7434 Language
7435 --------
7436
7437 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
7438   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
7439 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
7440 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
7441 * [`panic!` can be converted to a runtime abort with the
7442   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
7443   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7444 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
7445   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
7446   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
7447   Note that Cargo does not yet directly support cdylibs.
7448
7449 Stabilized APIs
7450 ---------------
7451
7452 * `os::windows::fs::OpenOptionsExt::access_mode`
7453 * `os::windows::fs::OpenOptionsExt::share_mode`
7454 * `os::windows::fs::OpenOptionsExt::custom_flags`
7455 * `os::windows::fs::OpenOptionsExt::attributes`
7456 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
7457 * `os::unix::fs::OpenOptionsExt::custom_flags`
7458 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
7459 * `Default for sync::Weak`
7460 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
7461 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
7462 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
7463 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
7464 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
7465 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
7466 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
7467 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
7468 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
7469 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
7470 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
7471 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
7472 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
7473 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
7474 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
7475 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
7476 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
7477 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
7478 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
7479 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
7480 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
7481 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
7482 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
7483 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
7484 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
7485 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7486 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7487 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7488 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7489 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
7490 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
7491 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
7492 * Read/Write/RawFd impls for `UnixStream`
7493 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
7494 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
7495 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
7496 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
7497 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
7498 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
7499 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
7500 * RawFd impls for `UnixListener`
7501 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
7502 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
7503 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
7504 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
7505 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
7506 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
7507 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
7508 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
7509 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
7510 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
7511 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
7512 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
7513 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
7514 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
7515 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
7516 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
7517 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
7518 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
7519 * RawFd impls for `UnixDatagram`
7520 * `{BTree,Hash}Map::values_mut`
7521 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
7522
7523 Libraries
7524 ---------
7525
7526 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
7527   The semantics of this minor method are subtle and probably not what
7528   most people want.
7529 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
7530 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
7531   will fall back to `/dev/urandom` temporarily to avoid blocking
7532   during early boot](https://github.com/rust-lang/rust/pull/33086).
7533 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
7534 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
7535 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
7536 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
7537 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
7538 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
7539   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
7540
7541 Cargo
7542 -----
7543 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
7544   This controls the runtime behavior of the `panic!` macro
7545   and can be either "unwind" (the default), or "abort".
7546   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7547 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
7548 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
7549 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
7550   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
7551 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
7552 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
7553 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
7554   By default they are retried twice, which can be customized with the
7555   `net.retry` value in `.cargo/config`.
7556 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
7557 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
7558 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
7559 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
7560   Makes it possible to install multiple crates in parallel.
7561 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
7562 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
7563 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
7564 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
7565 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
7566 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
7567
7568 Performance
7569 -----------
7570
7571 * [rustc memory usage was reduced by refactoring the context used for
7572   type checking](https://github.com/rust-lang/rust/pull/33425).
7573 * [Speed up creation of `HashMap`s by caching the random keys used
7574   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
7575 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
7576 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
7577 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
7578   10x faster than the previous lookup tables.
7579 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
7580
7581 Usability
7582 ---------
7583
7584 * Many incremental improvements to documentation and rustdoc.
7585 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
7586 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
7587 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
7588 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
7589 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
7590 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
7591 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
7592
7593 Misc
7594 ----
7595
7596 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
7597 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
7598 * [`std` no longer prints backtraces on platforms where the running
7599   module must be loaded with `env::current_exe`, which can't be relied
7600   on](https://github.com/rust-lang/rust/pull/33554).
7601 * This release includes std binaries for the i586-unknown-linux-gnu,
7602   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
7603   i586 target is for old x86 hardware without SSE2, and the armv7
7604   target is for Android running on modern ARM architectures.
7605 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
7606   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
7607 * [On Unix the runtime aborts by calling `libc::abort` instead of
7608   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
7609 * [Rust is now bootstrapped from the previous release of Rust,
7610   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
7611
7612 Compatibility Notes
7613 -------------------
7614
7615 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
7616 * [`target_env` for Linux ARM targets is just `gnu`, not
7617   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
7618 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
7619 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
7620 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
7621   Affects how macros are parsed.
7622 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
7623 * [Feature-gated attributes on macro-generated macro invocations are
7624   now rejected](https://github.com/rust-lang/rust/pull/32791).
7625 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
7626   This caused some minor changes to type inference.
7627
7628
7629 Version 1.9.0 (2016-05-26)
7630 ==========================
7631
7632 Language
7633 --------
7634
7635 * The `#[deprecated]` attribute when applied to an API will generate
7636   warnings when used. The warnings may be suppressed with
7637   `#[allow(deprecated)]`. [RFC 1270].
7638 * [`fn` item types are zero sized, and each `fn` names a unique
7639   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7640   `transmute` on a `fn` type will generate a warning for a few cycles,
7641   then will be converted to an error.
7642 * [Field and method resolution understand visibility, so private
7643   fields and methods cannot prevent the proper use of public fields
7644   and methods][1.9fv].
7645 * [The parser considers unicode codepoints in the
7646   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
7647
7648 Stabilized APIs
7649 ---------------
7650
7651 * [`std::panic`]
7652 * [`std::panic::catch_unwind`] (renamed from `recover`)
7653 * [`std::panic::resume_unwind`] (renamed from `propagate`)
7654 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
7655 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
7656 * [`str::is_char_boundary`]
7657 * [`<*const T>::as_ref`]
7658 * [`<*mut T>::as_ref`]
7659 * [`<*mut T>::as_mut`]
7660 * [`AsciiExt::make_ascii_uppercase`]
7661 * [`AsciiExt::make_ascii_lowercase`]
7662 * [`char::decode_utf16`]
7663 * [`char::DecodeUtf16`]
7664 * [`char::DecodeUtf16Error`]
7665 * [`char::DecodeUtf16Error::unpaired_surrogate`]
7666 * [`BTreeSet::take`]
7667 * [`BTreeSet::replace`]
7668 * [`BTreeSet::get`]
7669 * [`HashSet::take`]
7670 * [`HashSet::replace`]
7671 * [`HashSet::get`]
7672 * [`OsString::with_capacity`]
7673 * [`OsString::clear`]
7674 * [`OsString::capacity`]
7675 * [`OsString::reserve`]
7676 * [`OsString::reserve_exact`]
7677 * [`OsStr::is_empty`]
7678 * [`OsStr::len`]
7679 * [`std::os::unix::thread`]
7680 * [`RawPthread`]
7681 * [`JoinHandleExt`]
7682 * [`JoinHandleExt::as_pthread_t`]
7683 * [`JoinHandleExt::into_pthread_t`]
7684 * [`HashSet::hasher`]
7685 * [`HashMap::hasher`]
7686 * [`CommandExt::exec`]
7687 * [`File::try_clone`]
7688 * [`SocketAddr::set_ip`]
7689 * [`SocketAddr::set_port`]
7690 * [`SocketAddrV4::set_ip`]
7691 * [`SocketAddrV4::set_port`]
7692 * [`SocketAddrV6::set_ip`]
7693 * [`SocketAddrV6::set_port`]
7694 * [`SocketAddrV6::set_flowinfo`]
7695 * [`SocketAddrV6::set_scope_id`]
7696 * [`slice::copy_from_slice`]
7697 * [`ptr::read_volatile`]
7698 * [`ptr::write_volatile`]
7699 * [`OpenOptions::create_new`]
7700 * [`TcpStream::set_nodelay`]
7701 * [`TcpStream::nodelay`]
7702 * [`TcpStream::set_ttl`]
7703 * [`TcpStream::ttl`]
7704 * [`TcpStream::set_only_v6`]
7705 * [`TcpStream::only_v6`]
7706 * [`TcpStream::take_error`]
7707 * [`TcpStream::set_nonblocking`]
7708 * [`TcpListener::set_ttl`]
7709 * [`TcpListener::ttl`]
7710 * [`TcpListener::set_only_v6`]
7711 * [`TcpListener::only_v6`]
7712 * [`TcpListener::take_error`]
7713 * [`TcpListener::set_nonblocking`]
7714 * [`UdpSocket::set_broadcast`]
7715 * [`UdpSocket::broadcast`]
7716 * [`UdpSocket::set_multicast_loop_v4`]
7717 * [`UdpSocket::multicast_loop_v4`]
7718 * [`UdpSocket::set_multicast_ttl_v4`]
7719 * [`UdpSocket::multicast_ttl_v4`]
7720 * [`UdpSocket::set_multicast_loop_v6`]
7721 * [`UdpSocket::multicast_loop_v6`]
7722 * [`UdpSocket::set_multicast_ttl_v6`]
7723 * [`UdpSocket::multicast_ttl_v6`]
7724 * [`UdpSocket::set_ttl`]
7725 * [`UdpSocket::ttl`]
7726 * [`UdpSocket::set_only_v6`]
7727 * [`UdpSocket::only_v6`]
7728 * [`UdpSocket::join_multicast_v4`]
7729 * [`UdpSocket::join_multicast_v6`]
7730 * [`UdpSocket::leave_multicast_v4`]
7731 * [`UdpSocket::leave_multicast_v6`]
7732 * [`UdpSocket::take_error`]
7733 * [`UdpSocket::connect`]
7734 * [`UdpSocket::send`]
7735 * [`UdpSocket::recv`]
7736 * [`UdpSocket::set_nonblocking`]
7737
7738 Libraries
7739 ---------
7740
7741 * [`std::sync::Once` is poisoned if its initialization function
7742   fails][1.9o].
7743 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
7744 * [Most types implement `fmt::Debug`][1.9db].
7745 * [The default buffer size used by `BufReader` and `BufWriter` was
7746   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
7747   used by other languages.
7748 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
7749   `Duration` additionally implements `*=` and `/=`][1.9ta].
7750 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
7751 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
7752 * [`Chain` implements `BufRead`][1.9ch].
7753 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
7754
7755 Cargo
7756 -----
7757
7758 * [Cargo can now run concurrently][1.9cc].
7759 * [Top-level overrides allow specific revisions of crates to be
7760   overridden through the entire crate graph][1.9ct].  This is intended
7761   to make upgrades easier for large projects, by allowing crates to be
7762   forked temporarily until they've been upgraded and republished.
7763 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
7764 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
7765   on the commandline][1.9cf]. `rustc` arguments can also be specified
7766   in the `build.rustflags` configuration key.
7767
7768 Performance
7769 -----------
7770
7771 * [The time complexity of comparing variables for equivalence during type
7772   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
7773   to major compilation time improvement in some scenarios.
7774 * [`ToString` is specialized for `str`, giving it the same performance
7775   as `to_owned`][1.9ts].
7776 * [Spawning processes with `Command::output` no longer creates extra
7777   threads][1.9sp].
7778 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
7779   for C-like enums][1.9cl].
7780
7781 Misc
7782 ----
7783
7784 * [Passing the `--quiet` flag to a test runner will produce
7785   much-abbreviated output][1.9q].
7786 * The Rust Project now publishes std binaries for the
7787   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
7788   `i586-pc-windows-msvc` targets.
7789
7790 Compatibility Notes
7791 -------------------
7792
7793 * [`std::sync::Once` is poisoned if its initialization function
7794   fails][1.9o].
7795 * [It is illegal to define methods with the same name in overlapping
7796   inherent `impl` blocks][1.9sn].
7797 * [`fn` item types are zero sized, and each `fn` names a unique
7798   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7799   `transmute` on a `fn` type will generate a warning for a few cycles,
7800   then will be converted to an error.
7801 * [Improvements to const evaluation may trigger new errors when integer
7802   literals are out of range][1.9ce].
7803
7804
7805 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
7806 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
7807 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
7808 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
7809 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
7810 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
7811 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
7812 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
7813 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
7814 [1.9db]: https://github.com/rust-lang/rust/pull/32054
7815 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
7816 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
7817 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
7818 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
7819 [1.9o]: https://github.com/rust-lang/rust/pull/32325
7820 [1.9q]: https://github.com/rust-lang/rust/pull/31887
7821 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
7822 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
7823 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
7824 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
7825 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
7826 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
7827 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
7828 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
7829 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7830 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
7831 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7832 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
7833 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
7834 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
7835 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
7836 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
7837 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
7838 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
7839 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
7840 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
7841 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
7842 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
7843 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
7844 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
7845 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
7846 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
7847 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
7848 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
7849 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
7850 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
7851 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
7852 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
7853 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
7854 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
7855 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
7856 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
7857 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
7858 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
7859 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
7860 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
7861 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
7862 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
7863 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
7864 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
7865 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7866 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7867 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7868 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7869 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7870 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7871 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
7872 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7873 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
7874 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7875 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7876 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7877 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7878 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7879 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
7880 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
7881 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
7882 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
7883 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
7884 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
7885 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
7886 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
7887 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
7888 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
7889 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
7890 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
7891 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
7892 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
7893 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
7894 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
7895 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
7896 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
7897 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
7898 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
7899 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
7900 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
7901 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
7902 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
7903 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
7904 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
7905 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
7906 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
7907 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
7908 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
7909 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
7910 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
7911 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
7912 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
7913 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
7914 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
7915
7916
7917 Version 1.8.0 (2016-04-14)
7918 ==========================
7919
7920 Language
7921 --------
7922
7923 * Rust supports overloading of compound assignment statements like
7924   `+=` by implementing the [`AddAssign`], [`SubAssign`],
7925   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
7926   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
7927   traits. [RFC 953].
7928 * Empty structs can be defined with braces, as in `struct Foo { }`, in
7929   addition to the non-braced form, `struct Foo;`. [RFC 218].
7930
7931 Libraries
7932 ---------
7933
7934 * Stabilized APIs:
7935   * [`str::encode_utf16`] (renamed from `utf16_units`)
7936   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
7937   * [`Ref::map`]
7938   * [`RefMut::map`]
7939   * [`ptr::drop_in_place`]
7940   * [`time::Instant`]
7941   * [`time::SystemTime`]
7942   * [`Instant::now`]
7943   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
7944   * [`Instant::elapsed`]
7945   * [`SystemTime::now`]
7946   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
7947   * [`SystemTime::elapsed`]
7948   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
7949   * [`SystemTimeError`]
7950   * [`SystemTimeError::duration`]
7951   * Various impls for `SystemTimeError`
7952   * [`UNIX_EPOCH`]
7953   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
7954     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
7955     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
7956 * [The `write!` and `writeln!` macros correctly emit errors if any of
7957   their arguments can't be formatted][1.8w].
7958 * [Various I/O functions support large files on 32-bit Linux][1.8l].
7959 * [The Unix-specific `raw` modules, which contain a number of
7960   redefined C types are deprecated][1.8r], including `os::raw::unix`,
7961   `os::raw::macos`, and `os::raw::linux`. These modules defined types
7962   such as `ino_t` and `dev_t`. The inconsistency of these definitions
7963   across platforms was making it difficult to implement `std`
7964   correctly. Those that need these definitions should use the `libc`
7965   crate. [RFC 1415].
7966 * The Unix-specific `MetadataExt` traits, including
7967   `os::unix::fs::MetadataExt`, which expose values such as inode
7968   numbers [no longer return platform-specific types][1.8r], but
7969   instead return widened integers. [RFC 1415].
7970 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
7971 * [Atomic loads and stores are not volatile][1.8a].
7972 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
7973
7974 Performance
7975 -----------
7976
7977 * [Inlining hash functions lead to a 3% compile-time improvement in
7978   some workloads][1.8h].
7979 * When using jemalloc, its symbols are [unprefixed so that it
7980   overrides the libc malloc implementation][1.8h]. This means that for
7981   rustc, LLVM is now using jemalloc, which results in a 6%
7982   compile-time improvement on a specific workload.
7983 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
7984
7985 Misc
7986 ----
7987
7988 * [32-bit MSVC builds finally implement unwinding][1.8ms].
7989   i686-pc-windows-msvc is now considered a tier-1 platform.
7990 * [The `--print targets` flag prints a list of supported targets][1.8t].
7991 * [The `--print cfg` flag prints the `cfg`s defined for the current
7992   target][1.8cf].
7993 * [`rustc` can be built with an new Cargo-based build system, written
7994   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
7995   build system. To enable it configure with `configure --rustbuild`.
7996 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
7997   variants while also indicating the total number of missing variants
7998   if more than 3][1.8m].
7999 * [Executable stacks are disabled on Linux and BSD][1.8nx].
8000 * The Rust Project now publishes binary releases of the standard
8001   library for a number of tier-2 targets:
8002   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
8003   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
8004   `x86_64-rumprun-netbsd`. These can be installed with
8005   tools such as [multirust][1.8mr].
8006
8007 Cargo
8008 -----
8009
8010 * [`cargo init` creates a new Cargo project in the current
8011   directory][1.8ci].  It is otherwise like `cargo new`.
8012 * [Cargo has configuration keys for `-v` and
8013   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
8014   `[term]` section of `.cargo/config`.
8015 * [Configuration keys that evaluate to strings or integers can be set
8016   via environment variables][1.8ce]. For example the `build.jobs` key
8017   can be set via `CARGO_BUILD_JOBS`. Environment variables take
8018   precedence over config files.
8019 * [Target-specific dependencies support Rust `cfg` syntax for
8020   describing targets][1.8cfg] so that dependencies for multiple
8021   targets can be specified together. [RFC 1361].
8022 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
8023   `RUSTDOC` take precedence over the `build.target-dir`,
8024   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
8025 * [The child process tree is killed on Windows when Cargo is
8026   killed][1.8ck].
8027 * [The `build.target` configuration value sets the target platform,
8028   like `--target`][1.8ct].
8029
8030 Compatibility Notes
8031 -------------------
8032
8033 * [Unstable compiler flags have been further restricted][1.8u]. Since
8034   1.0 `-Z` flags have been considered unstable, and other flags that
8035   were considered unstable additionally required passing `-Z
8036   unstable-options` to access. Unlike unstable language and library
8037   features though, these options have been accessible on the stable
8038   release channel. Going forward, *new unstable flags will not be
8039   available on the stable release channel*, and old unstable flags
8040   will warn about their usage. In the future, all unstable flags will
8041   be unavailable on the stable release channel.
8042 * [It is no longer possible to `match` on empty enum variants using
8043   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
8044 * The Unix-specific `MetadataExt` traits, including
8045   `os::unix::fs::MetadataExt`, which expose values such as inode
8046   numbers [no longer return platform-specific types][1.8r], but
8047   instead return widened integers. [RFC 1415].
8048 * [Modules sourced from the filesystem cannot appear within arbitrary
8049   blocks, but only within other modules][1.8mf].
8050 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
8051 * On Unix, [stack overflow triggers a runtime abort instead of a
8052   SIGSEGV][1.8so].
8053 * [`Command::spawn` and its equivalents return an error if any of
8054   its command-line arguments contain interior `NUL`s][1.8n].
8055 * [Tuple and unit enum variants from other crates are in the type
8056   namespace][1.8tn].
8057 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
8058   type instead of `.a` files][1.8st]. Additionally, for the MSVC
8059   toolchain, `rustc` emits import libraries named `foo.dll.lib`
8060   instead of `foo.lib`.
8061
8062
8063 [1.8a]: https://github.com/rust-lang/rust/pull/30962
8064 [1.8b]: https://github.com/rust-lang/rust/pull/31123
8065 [1.8c]: https://github.com/rust-lang/rust/pull/31530
8066 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
8067 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
8068 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
8069 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
8070 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
8071 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
8072 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
8073 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
8074 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
8075 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
8076 [1.8h]: https://github.com/rust-lang/rust/pull/31460
8077 [1.8l]: https://github.com/rust-lang/rust/pull/31668
8078 [1.8m]: https://github.com/rust-lang/rust/pull/31020
8079 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
8080 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
8081 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
8082 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
8083 [1.8n]: https://github.com/rust-lang/rust/pull/31056
8084 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
8085 [1.8r]: https://github.com/rust-lang/rust/pull/31551
8086 [1.8so]: https://github.com/rust-lang/rust/pull/31333
8087 [1.8st]: https://github.com/rust-lang/rust/pull/29520
8088 [1.8t]: https://github.com/rust-lang/rust/pull/31358
8089 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
8090 [1.8u]: https://github.com/rust-lang/rust/pull/31793
8091 [1.8v]: https://github.com/rust-lang/rust/pull/31757
8092 [1.8w]: https://github.com/rust-lang/rust/pull/31904
8093 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
8094 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
8095 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
8096 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
8097 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
8098 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
8099 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
8100 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
8101 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
8102 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
8103 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
8104 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
8105 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
8106 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
8107 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
8108 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
8109 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
8110 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
8111 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
8112 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
8113 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
8114 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
8115 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
8116 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
8117 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
8118 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
8119 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
8120 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
8121 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
8122 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
8123
8124
8125 Version 1.7.0 (2016-03-03)
8126 ==========================
8127
8128 Libraries
8129 ---------
8130
8131 * Stabilized APIs
8132   * `Path`
8133     * [`Path::strip_prefix`] (renamed from relative_from)
8134     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
8135   * `Ipv4Addr`
8136     * [`Ipv4Addr::is_loopback`]
8137     * [`Ipv4Addr::is_private`]
8138     * [`Ipv4Addr::is_link_local`]
8139     * [`Ipv4Addr::is_multicast`]
8140     * [`Ipv4Addr::is_broadcast`]
8141     * [`Ipv4Addr::is_documentation`]
8142   * `Ipv6Addr`
8143     * [`Ipv6Addr::is_unspecified`]
8144     * [`Ipv6Addr::is_loopback`]
8145     * [`Ipv6Addr::is_multicast`]
8146   * `Vec`
8147     * [`Vec::as_slice`]
8148     * [`Vec::as_mut_slice`]
8149   * `String`
8150     * [`String::as_str`]
8151     * [`String::as_mut_str`]
8152   * Slices
8153     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
8154     be the same length
8155     * `<[T]>::`[`sort_by_key`]
8156   * checked, saturated, and overflowing operations
8157     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
8158     * [`i32::saturating_mul`]
8159     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
8160     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
8161     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
8162     * [`u32::saturating_mul`]
8163     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
8164     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
8165     * and checked, saturated, and overflowing operations for other primitive types
8166   * FFI
8167     * [`ffi::IntoStringError`]
8168     * [`CString::into_string`]
8169     * [`CString::into_bytes`]
8170     * [`CString::into_bytes_with_nul`]
8171     * `From<CString> for Vec<u8>`
8172   * `IntoStringError`
8173     * [`IntoStringError::into_cstring`]
8174     * [`IntoStringError::utf8_error`]
8175     * `Error for IntoStringError`
8176   * Hashing
8177     * [`std::hash::BuildHasher`]
8178     * [`BuildHasher::Hasher`]
8179     * [`BuildHasher::build_hasher`]
8180     * [`std::hash::BuildHasherDefault`]
8181     * [`HashMap::with_hasher`]
8182     * [`HashMap::with_capacity_and_hasher`]
8183     * [`HashSet::with_hasher`]
8184     * [`HashSet::with_capacity_and_hasher`]
8185     * [`std::collections::hash_map::RandomState`]
8186     * [`RandomState::new`]
8187 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
8188   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
8189   from bytes is faster.
8190 * [The performance of `LineWriter` (and thus `io::stdout`) was
8191   improved by using `memchr` to search for newlines][1.7m].
8192 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
8193   `f64` variants were stabilized previously.
8194 * [`BTreeMap` was rewritten to use less memory and improve the performance
8195   of insertion and iteration, the latter by as much as 5x][1.7bm].
8196 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
8197   covariant over their contained type][1.7bt].
8198 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
8199   over their contained type][1.7ll].
8200 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
8201   searching methods.
8202 * [`Any` is implemented for unsized types][1.7a].
8203 * [`Hash` is implemented for `Duration`][1.7h].
8204
8205 Misc
8206 ----
8207
8208 * [When running tests with `--test`, rustdoc will pass `--cfg`
8209   arguments to the compiler][1.7dt].
8210 * [The compiler is built with RPATH information by default][1.7rpa].
8211   This means that it will be possible to run `rustc` when installed in
8212   unusual configurations without configuring the dynamic linker search
8213   path explicitly.
8214 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
8215   any RPATH entries (emitted with `-C rpath`) *not* take precedence
8216   over `LD_LIBRARY_PATH`.
8217
8218 Cargo
8219 -----
8220
8221 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
8222   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
8223 * [The `rerun-if-changed` build script directive no longer causes the
8224   build script to incorrectly run twice in certain scenarios][1.7rr].
8225
8226 Compatibility Notes
8227 -------------------
8228
8229 * Soundness fixes to the interactions between associated types and
8230   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
8231   code that violates the new rules. This is a significant change that
8232   is known to break existing code, so it has emitted warnings for the
8233   new error cases since 1.4 to give crate authors time to adapt. The
8234   details of what is changing are subtle; read the RFC for more.
8235 * [Several bugs in the compiler's visibility calculations were
8236   fixed][1.7v]. Since this was found to break significant amounts of
8237   code, the new errors will be emitted as warnings for several release
8238   cycles, under the `private_in_public` lint.
8239 * Defaulted type parameters were accidentally accepted in positions
8240   that were not intended. In this release, [defaulted type parameters
8241   appearing outside of type definitions will generate a
8242   warning][1.7d], which will become an error in future releases.
8243 * [Parsing "." as a float results in an error instead of 0][1.7p].
8244   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
8245 * [Borrows of closure parameters may not outlive the closure][1.7bc].
8246
8247 [1.7a]: https://github.com/rust-lang/rust/pull/30928
8248 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
8249 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
8250 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
8251 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
8252 [1.7d]: https://github.com/rust-lang/rust/pull/30724
8253 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
8254 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
8255 [1.7f]: https://github.com/rust-lang/rust/pull/30672
8256 [1.7h]: https://github.com/rust-lang/rust/pull/30818
8257 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
8258 [1.7m]: https://github.com/rust-lang/rust/pull/30381
8259 [1.7p]: https://github.com/rust-lang/rust/pull/30681
8260 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
8261 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
8262 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
8263 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
8264 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
8265 [1.7v]: https://github.com/rust-lang/rust/pull/29973
8266 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8267 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8268 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
8269 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
8270 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
8271 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
8272 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
8273 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
8274 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
8275 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
8276 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
8277 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
8278 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
8279 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
8280 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
8281 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
8282 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
8283 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
8284 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
8285 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
8286 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
8287 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
8288 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
8289 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
8290 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
8291 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
8292 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
8293 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
8294 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
8295 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
8296 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
8297 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
8298 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
8299 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
8300 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
8301 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
8302 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
8303 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
8304 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
8305 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
8306 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
8307 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
8308 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
8309 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
8310 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
8311 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
8312 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
8313 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8314 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
8315 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8316 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
8317 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
8318 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
8319 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
8320 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
8321 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
8322 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
8323 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
8324 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
8325 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
8326
8327
8328 Version 1.6.0 (2016-01-21)
8329 ==========================
8330
8331 Language
8332 --------
8333
8334 * The `#![no_std]` attribute causes a crate to not be linked to the
8335   standard library, but only the [core library][1.6co], as described
8336   in [RFC 1184]. The core library defines common types and traits but
8337   has no platform dependencies whatsoever, and is the basis for Rust
8338   software in environments that cannot support a full port of the
8339   standard library, such as operating systems. Most of the core
8340   library is now stable.
8341
8342 Libraries
8343 ---------
8344
8345 * Stabilized APIs:
8346   [`Read::read_exact`],
8347   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
8348   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
8349   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
8350   [`os::unix::fs::DirBuilderExt`],
8351   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
8352   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
8353   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
8354   [`collections::hash_map::Drain`],
8355   [`collections::hash_map::HashMap::drain`],
8356   [`collections::hash_set::Drain`],
8357   [`collections::hash_set::HashSet::drain`],
8358   [`collections::binary_heap::Drain`],
8359   [`collections::binary_heap::BinaryHeap::drain`],
8360   [`Vec::extend_from_slice`] (renamed from `push_all`),
8361   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
8362   [`RwLock::into_inner`],
8363   [`Iterator::min_by_key`] (renamed from `min_by`),
8364   [`Iterator::max_by_key`] (renamed from `max_by`).
8365 * The [core library][1.6co] is stable, as are most of its APIs.
8366 * [The `assert_eq!` macro supports arguments that don't implement
8367   `Sized`][1.6ae], such as arrays. In this way it behaves more like
8368   `assert!`.
8369 * Several timer functions that take duration in milliseconds [are
8370   deprecated in favor of those that take `Duration`][1.6ms]. These
8371   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
8372   `thread::park_timeout_ms`.
8373 * The algorithm by which `Vec` reserves additional elements was
8374   [tweaked to not allocate excessive space][1.6a] while still growing
8375   exponentially.
8376 * `From` conversions are [implemented from integers to floats][1.6f]
8377   in cases where the conversion is lossless. Thus they are not
8378   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
8379   or `f64`. They are also not implemented for `isize` and `usize`
8380   because the implementations would be platform-specific. `From` is
8381   also implemented from `f32` to `f64`.
8382 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
8383 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
8384 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
8385 * [`BinaryHeap` was refactored][1.6bh] for modest performance
8386   improvements.
8387 * Sorting slices that are already sorted [is 50% faster in some
8388   cases][1.6s].
8389
8390 Cargo
8391 -----
8392
8393 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
8394 * Cargo build scripts can specify their dependencies by emitting the
8395   [`rerun-if-changed`][1.6rr] key.
8396 * crates.io will reject publication of crates with dependencies that
8397   have a wildcard version constraint. Crates with wildcard
8398   dependencies were seen to cause a variety of problems, as described
8399   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
8400   warning.
8401 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
8402   release folder.  A variety of artifacts that Cargo failed to clean
8403   are now correctly deleted.
8404
8405 Misc
8406 ----
8407
8408 * The `unreachable_code` lint [warns when a function call's argument
8409   diverges][1.6dv].
8410 * The parser indicates [failures that may be caused by
8411   confusingly-similar Unicode characters][1.6uc]
8412 * Certain macro errors [are reported at definition time][1.6m], not
8413   expansion.
8414
8415 Compatibility Notes
8416 -------------------
8417
8418 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
8419   environment variable when locating crates. This was a pre-cargo
8420   feature for integrating with the package manager that was
8421   accidentally never removed.
8422 * [A number of bugs were fixed in the privacy checker][1.6p] that
8423   could cause previously-accepted code to break.
8424 * [Modules and unit/tuple structs may not share the same name][1.6ts].
8425 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
8426   struct pattern syntax (`Foo(..)`) can no longer be used to match
8427   unit structs. This is a warning now, but will become an error in
8428   future releases. Patterns that share the same name as a const are
8429   now an error.
8430 * A bug was fixed that causes [rustc not to apply default type
8431   parameters][1.6xc] when resolving certain method implementations of
8432   traits defined in other crates.
8433
8434 [1.6a]: https://github.com/rust-lang/rust/pull/29454
8435 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
8436 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
8437 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
8438 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
8439 [1.6co]: http://doc.rust-lang.org/core/index.html
8440 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
8441 [1.6f]: https://github.com/rust-lang/rust/pull/29129
8442 [1.6m]: https://github.com/rust-lang/rust/pull/29828
8443 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
8444 [1.6p]: https://github.com/rust-lang/rust/pull/29726
8445 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
8446 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
8447 [1.6s]: https://github.com/rust-lang/rust/pull/29675
8448 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
8449 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
8450 [1.6us]: https://github.com/rust-lang/rust/pull/29383
8451 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
8452 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
8453 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8454 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
8455 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
8456 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
8457 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
8458 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
8459 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
8460 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
8461 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
8462 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
8463 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
8464 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
8465 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
8466 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
8467 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
8468 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
8469 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
8470 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
8471 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
8472 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
8473 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
8474 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
8475 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
8476 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
8477 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
8478 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
8479 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
8480 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
8481
8482
8483 Version 1.5.0 (2015-12-10)
8484 ==========================
8485
8486 * ~700 changes, numerous bugfixes
8487
8488 Highlights
8489 ----------
8490
8491 * Stabilized APIs:
8492   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
8493   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
8494   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
8495   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
8496   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
8497   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
8498   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
8499   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
8500   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
8501   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
8502   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
8503   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
8504   [`Path::read_link`], [`Path::symlink_metadata`],
8505   [`Utf8Error::valid_up_to`], [`Vec::resize`],
8506   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
8507   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
8508   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
8509   [`slice::split_first_mut`], [`slice::split_first`],
8510   [`slice::split_last_mut`], [`slice::split_last`],
8511   [`char::from_u32_unchecked`], [`fs::canonicalize`],
8512   [`str::MatchIndices`], [`str::RMatchIndices`],
8513   [`str::match_indices`], [`str::rmatch_indices`],
8514   [`str::slice_mut_unchecked`], [`string::ParseError`].
8515 * Rust applications hosted on crates.io can be installed locally to
8516   `~/.cargo/bin` with the [`cargo install`] command. Among other
8517   things this makes it easier to augment Cargo with new subcommands:
8518   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
8519   invoked as `cargo foo`.
8520 * Crates with wildcard (`*`) dependencies will [emit warnings when
8521   published][1.5w]. In 1.6 it will no longer be possible to publish
8522   crates with wildcard dependencies.
8523
8524 Breaking Changes
8525 ----------------
8526
8527 * The rules determining when a particular lifetime must outlive
8528   a particular value (known as '[dropck]') have been [modified
8529   to not rely on parametricity][1.5p].
8530 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
8531   and `Arc`][1.5a]. Because these smart pointer types implement
8532   `Deref`, this causes breakage in cases where the interior type
8533   contains methods of the same name.
8534 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
8535   that they could drop their content. Soundness fix.
8536 * All method invocations are [properly checked][1.5wf1] for
8537   [well-formedness][1.5wf2]. Soundness fix.
8538 * Traits whose supertraits contain `Self` are [not object
8539   safe][1.5o]. Soundness fix.
8540 * Target specifications support a [`no_default_libraries`][1.5nd]
8541   setting that controls whether `-nodefaultlibs` is passed to the
8542   linker, and in turn the `is_like_windows` setting no longer affects
8543   the `-nodefaultlibs` flag.
8544 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
8545 * The `#[inline]` and `#[repr]` attributes [can only appear
8546   in valid locations][1.5at].
8547 * Native libraries linked from the local crate are [passed to
8548   the linker before native libraries from upstream crates][1.5nl].
8549 * Two rarely-used attributes, `#[no_debug]` and
8550   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
8551 * Negation of unsigned integers, which has been a warning for
8552   several releases, [is now behind a feature gate and will
8553   generate errors][1.5nu].
8554 * The parser accidentally accepted visibility modifiers on
8555   enum variants, a bug [which has been fixed][1.5ev].
8556 * [A bug was fixed that allowed `use` statements to import unstable
8557   features][1.5use].
8558
8559 Language
8560 --------
8561
8562 * When evaluating expressions at compile-time that are not
8563   compile-time constants (const-evaluating expressions in non-const
8564   contexts), incorrect code such as overlong bitshifts and arithmetic
8565   overflow will [generate a warning instead of an error][1.5ce],
8566   delaying the error until runtime. This will allow the
8567   const-evaluator to be expanded in the future backwards-compatibly.
8568 * The `improper_ctypes` lint [no longer warns about using `isize` and
8569   `usize` in FFI][1.5ict].
8570
8571 Libraries
8572 ---------
8573
8574 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
8575   invariant][1.5c].
8576 * `Default` is [implemented for mutable slices][1.5d].
8577 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
8578 * There are now `From` conversions [between floating point
8579   types][1.5f] where the conversions are lossless.
8580 * There are now `From` conversions [between integer types][1.5i] where
8581   the conversions are lossless.
8582 * [`fs::Metadata` implements `Clone`][1.5fs].
8583 * The `parse` method [accepts a leading "+" when parsing
8584   integers][1.5pi].
8585 * [`AsMut` is implemented for `Vec`][1.5am].
8586 * The `clone_from` implementations for `String` and `BinaryHeap` [have
8587   been optimized][1.5cf] and no longer rely on the default impl.
8588 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
8589   `unsafe extern "C"` function types now [implement `Clone`,
8590   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
8591   `fmt::Debug` for up to 12 arguments][1.5fp].
8592 * [Dropping `Vec`s is much faster in unoptimized builds when the
8593   element types don't implement `Drop`][1.5dv].
8594 * A bug that caused in incorrect behavior when [combining `VecDeque`
8595   with zero-sized types][1.5vdz] was resolved.
8596 * [`PartialOrd` for slices is faster][1.5po].
8597
8598 Miscellaneous
8599 -------------
8600
8601 * [Crate metadata size was reduced by 20%][1.5md].
8602 * [Improvements to code generation reduced the size of libcore by 3.3
8603   MB and rustc's memory usage by 18MB][1.5m].
8604 * [Improvements to deref translation increased performance in
8605   unoptimized builds][1.5dr].
8606 * Various errors in trait resolution [are deduplicated to only be
8607   reported once][1.5te].
8608 * Rust has preliminary [support for rumprun kernels][1.5rr].
8609 * Rust has preliminary [support for NetBSD on amd64][1.5na].
8610
8611 [1.5use]: https://github.com/rust-lang/rust/pull/28364
8612 [1.5po]: https://github.com/rust-lang/rust/pull/28436
8613 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
8614 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
8615 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
8616 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
8617 [1.5md]: https://github.com/rust-lang/rust/pull/28521
8618 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
8619 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
8620 [1.5na]: https://github.com/rust-lang/rust/pull/28543
8621 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
8622 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
8623 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
8624 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
8625 [1.5te]: https://github.com/rust-lang/rust/pull/28645
8626 [1.5at]: https://github.com/rust-lang/rust/pull/28650
8627 [1.5am]: https://github.com/rust-lang/rust/pull/28663
8628 [1.5m]: https://github.com/rust-lang/rust/pull/28778
8629 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
8630 [1.5a]: https://github.com/rust-lang/rust/pull/28811
8631 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
8632 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
8633 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
8634 [1.5i]: https://github.com/rust-lang/rust/pull/28921
8635 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
8636 [1.5f]: https://github.com/rust-lang/rust/pull/29129
8637 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
8638 [1.5s]: https://github.com/rust-lang/rust/pull/29190
8639 [1.5d]: https://github.com/rust-lang/rust/pull/29245
8640 [1.5o]: https://github.com/rust-lang/rust/pull/29259
8641 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
8642 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8643 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
8644 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
8645 [1.5c]: https://github.com/rust-lang/rust/pull/29110
8646 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8647 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
8648 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
8649 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
8650 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
8651 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
8652 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
8653 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
8654 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
8655 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
8656 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
8657 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
8658 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
8659 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
8660 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
8661 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
8662 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
8663 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
8664 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
8665 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
8666 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
8667 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
8668 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
8669 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
8670 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
8671 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
8672 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
8673 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
8674 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
8675 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
8676 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
8677 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
8678 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
8679 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
8680 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
8681 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
8682 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
8683 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
8684 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
8685 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
8686 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
8687 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
8688 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
8689 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
8690 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
8691 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
8692 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
8693 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
8694 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
8695 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
8696 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
8697 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
8698 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
8699 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
8700
8701 Version 1.4.0 (2015-10-29)
8702 ==========================
8703
8704 * ~1200 changes, numerous bugfixes
8705
8706 Highlights
8707 ----------
8708
8709 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
8710   GNU) are now supported and recommended for use.
8711
8712 Breaking Changes
8713 ----------------
8714
8715 * [Several changes have been made to fix type soundness and improve
8716   the behavior of associated types][sound]. See [RFC 1214]. Although
8717   we have mostly introduced these changes as warnings this release, to
8718   become errors next release, there are still some scenarios that will
8719   see immediate breakage.
8720 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
8721   line breaks in addition to `\n`][crlf].
8722 * [Loans of `'static` lifetime extend to the end of a function][stat].
8723 * [`str::parse` no longer introduces avoidable rounding error when
8724   parsing floating point numbers. Together with earlier changes to
8725   float formatting/output, "round trips" like f.to_string().parse()
8726   now preserve the value of f exactly. Additionally, leading plus
8727   signs are now accepted][fp3].
8728
8729
8730 Language
8731 --------
8732
8733 * `use` statements that import multiple items [can now rename
8734   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
8735 * [Binops work correctly on fat pointers][binfat].
8736 * `pub extern crate`, which does not behave as expected, [issues a
8737   warning][pec] until a better solution is found.
8738
8739 Libraries
8740 ---------
8741
8742 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
8743   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
8744   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
8745   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
8746   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
8747   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
8748   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
8749   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
8750   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
8751   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
8752   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
8753   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
8754   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
8755   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
8756   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
8757   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
8758   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
8759   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
8760   [`thread::sleep`].
8761 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
8762   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
8763   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
8764   `f64::from_str_radix`.
8765 * [Reverse-searching strings is faster with the 'two-way'
8766   algorithm][s].
8767 * [`std::io::copy` allows `?Sized` arguments][cc].
8768 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
8769   [override `count`, `nth` and `last` with an *O*(1)
8770   implementation][it].
8771 * [`Default` is implemented for arrays up to `[T; 32]`][d].
8772 * [`IntoRawFd` has been added to the Unix-specific prelude,
8773   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
8774   prelude][pr].
8775 * [`Extend<String>` and `FromIterator<String` are both implemented for
8776   `String`][es].
8777 * [`IntoIterator` is implemented for references to `Option` and
8778   `Result`][into2].
8779 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
8780   Copy`][ext] as part of [RFC 839]. This will cause type inference
8781   breakage in rare situations.
8782 * [`BinaryHeap` implements `Debug`][bh2].
8783 * [`Borrow` and `BorrowMut` are implemented for fixed-size
8784   arrays][bm].
8785 * [`extern fn`s with the "Rust" and "C" ABIs implement common
8786   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
8787 * [String comparison is faster][faststr].
8788 * `&mut T` where `T: std::fmt::Write` [also implements
8789   `std::fmt::Write`][mutw].
8790 * [A stable regression in `VecDeque::push_back` and other
8791   capacity-altering methods that caused panics for zero-sized types
8792   was fixed][vd].
8793 * [Function pointers implement traits for up to 12 parameters][fp2].
8794
8795 Miscellaneous
8796 -------------
8797
8798 * The compiler [no longer uses the 'morestack' feature to prevent
8799   stack overflow][mm]. Instead it uses guard pages and stack
8800   probes (though stack probes are not yet implemented on any platform
8801   but Windows).
8802 * [The compiler matches traits faster when projections are involved][p].
8803 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
8804   `usize`][ffi].
8805 * [Cargo now displays useful information about what its doing during
8806   `cargo update`][cu].
8807
8808 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
8809 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
8810 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
8811 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
8812 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
8813 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
8814 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
8815 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
8816 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
8817 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
8818 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
8819 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
8820 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
8821 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
8822 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
8823 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
8824 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
8825 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
8826 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8827 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8828 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8829 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8830 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8831 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8832 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8833 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8834 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
8835 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
8836 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
8837 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
8838 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
8839 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
8840 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
8841 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
8842 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
8843 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
8844 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
8845 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
8846 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
8847 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
8848 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
8849 [bh2]: https://github.com/rust-lang/rust/pull/28156
8850 [binfat]: https://github.com/rust-lang/rust/pull/28270
8851 [bm]: https://github.com/rust-lang/rust/pull/28197
8852 [cc]: https://github.com/rust-lang/rust/pull/27531
8853 [crlf]: https://github.com/rust-lang/rust/pull/28034
8854 [cu]: https://github.com/rust-lang/cargo/pull/1931
8855 [d]: https://github.com/rust-lang/rust/pull/27825
8856 [dep]: https://github.com/rust-lang/rust/pull/28339
8857 [es]: https://github.com/rust-lang/rust/pull/27956
8858 [ext]: https://github.com/rust-lang/rust/pull/28094
8859 [faststr]: https://github.com/rust-lang/rust/pull/28338
8860 [ffi]: https://github.com/rust-lang/rust/pull/28779
8861 [fp]: https://github.com/rust-lang/rust/pull/28268
8862 [fp2]: https://github.com/rust-lang/rust/pull/28560
8863 [fp3]: https://github.com/rust-lang/rust/pull/27307
8864 [i]: https://github.com/rust-lang/rust/pull/27451
8865 [into2]: https://github.com/rust-lang/rust/pull/28039
8866 [it]: https://github.com/rust-lang/rust/pull/27652
8867 [mm]: https://github.com/rust-lang/rust/pull/27338
8868 [mutw]: https://github.com/rust-lang/rust/pull/28368
8869 [sound]: https://github.com/rust-lang/rust/pull/27641
8870 [p]: https://github.com/rust-lang/rust/pull/27866
8871 [pec]: https://github.com/rust-lang/rust/pull/28486
8872 [pr]: https://github.com/rust-lang/rust/pull/27896
8873 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8874 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8875 [s]: https://github.com/rust-lang/rust/pull/27474
8876 [stab]: https://github.com/rust-lang/rust/pull/28339
8877 [stat]: https://github.com/rust-lang/rust/pull/28321
8878 [vd]: https://github.com/rust-lang/rust/pull/28494
8879
8880 Version 1.3.0 (2015-09-17)
8881 ==============================
8882
8883 * ~900 changes, numerous bugfixes
8884
8885 Highlights
8886 ----------
8887
8888 * The [new object lifetime defaults][nold] have been [turned
8889   on][nold2] after a cycle of warnings about the change. Now types
8890   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
8891   being interpreted as `&'a Box<Trait+'a>` to `&'a
8892   Box<Trait+'static>`.
8893 * [The Rustonomicon][nom] is a new book in the official documentation
8894   that dives into writing unsafe Rust.
8895 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
8896   timekeeping is employed by other std APIs, as well as out-of-tree
8897   time crates.
8898
8899 Breaking Changes
8900 ----------------
8901
8902 * The [new object lifetime defaults][nold] have been [turned
8903   on][nold2] after a cycle of warnings about the change.
8904 * There is a known [regression][lr] in how object lifetime elision is
8905   interpreted, the proper solution for which is undetermined.
8906 * The `#[prelude_import]` attribute, an internal implementation
8907   detail, was accidentally stabilized previously. [It has been put
8908   behind the `prelude_import` feature gate][pi]. This change is
8909   believed to break no existing code.
8910 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8911   [more sane for dynamically sized types][dst3]. Code that relied on
8912   the previous behavior is thought to be broken.
8913 * The `dropck` rules, which checks that destructors can't access
8914   destroyed values, [have been updated][dropck] to match the
8915   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
8916   cause some previously-compiling code to no longer build.
8917
8918 Language
8919 --------
8920
8921 * The [new object lifetime defaults][nold] have been [turned
8922   on][nold2] after a cycle of warnings about the change.
8923 * Semicolons may [now follow types and paths in
8924   macros](https://github.com/rust-lang/rust/pull/27000).
8925 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8926   [more sane for dynamically sized types][dst3]. Code that relied on
8927   the previous behavior is not known to exist, and suspected to be
8928   broken.
8929 * `'static` variables [may now be recursive][st].
8930 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
8931   implementations correctly.
8932 * The `dropck` rules, which checks that destructors can't access
8933   destroyed values, [have been updated][dropck] to match the
8934   [RFC][dropckrfc].
8935
8936 Libraries
8937 ---------
8938
8939 * The [`Duration`] API, [has been stabilized][ds], as well as the
8940   `std::time` module, which presently contains only `Duration`.
8941 * `Box<str>` and `Box<[T]>` both implement `Clone`.
8942 * The owned C string, [`CString`], implements [`Borrow`] and the
8943   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
8944   these allow C strings to be borrowed and cloned in generic code.
8945 * [`CStr`] implements [`Debug`].
8946 * [`AtomicPtr`] implements [`Debug`].
8947 * [`Error`] trait objects [can be downcast to their concrete types][e]
8948   in many common configurations, using the [`is`], [`downcast`],
8949   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
8950   [`Any`] trait.
8951 * Searching for substrings now [employs the two-way algorithm][search]
8952   instead of doing a naive search. This gives major speedups to a
8953   number of methods, including [`contains`][sc], [`find`][sf],
8954   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
8955   [`ends_with`][sew] are also faster.
8956 * The performance of `PartialEq` for slices is [much faster][ps].
8957 * The [`Hash`] trait offers the default method, [`hash_slice`], which
8958   is overridden and optimized by the implementations for scalars.
8959 * The [`Hasher`] trait now has a number of specialized `write_*`
8960   methods for primitive types, for efficiency.
8961 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
8962   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
8963   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
8964   of [`std::error::Error::cause`][iec] also delegates to the inner
8965   error.
8966 * [`process::Child`][pc] gained the [`id`] method, which returns a
8967   `u32` representing the platform-specific process identifier.
8968 * The [`connect`] method on slices is deprecated, replaced by the new
8969   [`join`] method (note that both of these are on the *unstable*
8970   [`SliceConcatExt`] trait, but through the magic of the prelude are
8971   available to stable code anyway).
8972 * The [`Div`] operator is implemented for [`Wrapping`] types.
8973 * [`DerefMut` is implemented for `String`][dms].
8974 * Performance of SipHash (the default hasher for `HashMap`) is
8975   [better for long data][sh].
8976 * [`AtomicPtr`] implements [`Send`].
8977 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
8978   are now [specialized to use uninitialized buffers for increased
8979   performance][rte].
8980 * Lifetime parameters of foreign functions [are now resolved
8981   properly][f].
8982
8983 Misc
8984 ----
8985
8986 * Rust can now, with some coercion, [produce programs that run on
8987   Windows XP][xp], though XP is not considered a supported platform.
8988 * Porting Rust on Windows from the GNU toolchain to MSVC continues
8989   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
8990   recommended for use in 1.3, though should be fully-functional
8991   in the [64-bit 1.4 beta][b14].
8992 * On Fedora-based systems installation will [properly configure the
8993   dynamic linker][fl].
8994 * The compiler gained many new extended error descriptions, which can
8995   be accessed with the `--explain` flag.
8996 * The `dropck` pass, which checks that destructors can't access
8997   destroyed values, [has been rewritten][dropck]. This fixes some
8998   soundness holes, and as such will cause some previously-compiling
8999   code to no longer build.
9000 * `rustc` now uses [LLVM to write archive files where possible][ar].
9001   Eventually this will eliminate the compiler's dependency on the ar
9002   utility.
9003 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
9004   supported FreeBSD on x86_64).
9005 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
9006   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
9007   more strict.
9008 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
9009   will kill the process instead of leaking][nlp].
9010
9011 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
9012 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
9013 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
9014 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
9015 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
9016 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
9017 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
9018 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
9019 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
9020 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
9021 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
9022 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
9023 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
9024 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
9025 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
9026 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
9027 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
9028 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
9029 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
9030 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
9031 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
9032 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
9033 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
9034 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
9035 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
9036 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
9037 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
9038 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
9039 [ar]: https://github.com/rust-lang/rust/pull/26926
9040 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
9041 [dms]: https://github.com/rust-lang/rust/pull/26241
9042 [dropck]: https://github.com/rust-lang/rust/pull/27261
9043 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
9044 [ds]: https://github.com/rust-lang/rust/pull/26818
9045 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
9046 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
9047 [dst3]: https://github.com/rust-lang/rust/pull/27351
9048 [e]: https://github.com/rust-lang/rust/pull/24793
9049 [f]: https://github.com/rust-lang/rust/pull/26588
9050 [fb]: https://github.com/rust-lang/rust/pull/26959
9051 [fl]: https://github.com/rust-lang/rust-installer/pull/41
9052 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
9053 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
9054 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
9055 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
9056 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
9057 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
9058 [lic]: https://github.com/rust-lang/rust/pull/26583
9059 [lnu]: https://github.com/rust-lang/rust/pull/27026
9060 [lr]: https://github.com/rust-lang/rust/issues/27248
9061 [lum]: https://github.com/rust-lang/rust/pull/26378
9062 [lur]: https://github.com/rust-lang/rust/pull/26783
9063 [nlp]: https://github.com/rust-lang/rust/pull/27176
9064 [nold2]: https://github.com/rust-lang/rust/pull/27045
9065 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
9066 [nom]: http://doc.rust-lang.org/nightly/nomicon/
9067 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
9068 [pi]: https://github.com/rust-lang/rust/pull/26699
9069 [ps]: https://github.com/rust-lang/rust/pull/26884
9070 [rte]: https://github.com/rust-lang/rust/pull/26950
9071 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
9072 [search]: https://github.com/rust-lang/rust/pull/26327
9073 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
9074 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
9075 [sh]: https://github.com/rust-lang/rust/pull/27280
9076 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
9077 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
9078 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
9079 [st]: https://github.com/rust-lang/rust/pull/26630
9080 [win1]: https://github.com/rust-lang/rust/pull/26569
9081 [win2]: https://github.com/rust-lang/rust/pull/26741
9082 [win3]: https://github.com/rust-lang/rust/pull/26741
9083 [win4]: https://github.com/rust-lang/rust/pull/27210
9084 [xp]: https://github.com/rust-lang/rust/pull/26569
9085
9086 Version 1.2.0 (2015-08-07)
9087 ==========================
9088
9089 * ~1200 changes, numerous bugfixes
9090
9091 Highlights
9092 ----------
9093
9094 * [Dynamically-sized-type coercions][dst] allow smart pointer types
9095   like `Rc` to contain types without a fixed size, arrays and trait
9096   objects, finally enabling use of `Rc<[T]>` and completing the
9097   implementation of DST.
9098 * [Parallel codegen][parcodegen] is now working again, which can
9099   substantially speed up large builds in debug mode; It also gets
9100   another ~33% speedup when bootstrapping on a 4 core machine (using 8
9101   jobs). It's not enabled by default, but will be "in the near
9102   future". It can be activated with the `-C codegen-units=N` flag to
9103   `rustc`.
9104 * This is the first release with [experimental support for linking
9105   with the MSVC linker and lib C on Windows (instead of using the GNU
9106   variants via MinGW)][win]. It is yet recommended only for the most
9107   intrepid Rustaceans.
9108 * Benchmark compilations are showing a 30% improvement in
9109   bootstrapping over 1.1.
9110
9111 Breaking Changes
9112 ----------------
9113
9114 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
9115   unicode case mapping, which is a previously-planned change in
9116   behavior and considered a bugfix.
9117 * [`mem::align_of`] now specifies [the *minimum alignment* for
9118   T][align], which is usually the alignment programs are interested
9119   in, and the same value reported by clang's
9120   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
9121   break real code.
9122 * [The `#[packed]` attribute is no longer silently accepted by the
9123   compiler][packed]. This attribute did nothing and code that
9124   mentioned it likely did not work as intended.
9125 * Associated type defaults are [now behind the
9126   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
9127   defaults *did not work*, but could be mentioned syntactically. As
9128   such this breakage has minimal impact.
9129
9130 Language
9131 --------
9132
9133 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
9134   matching against dereferenceable values.
9135
9136 Libraries
9137 ---------
9138
9139 * The [`Extend`] trait, which grows a collection from an iterator, is
9140   implemented over iterators of references, for `String`, `Vec`,
9141   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
9142   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
9143 * The [`iter::once`] function returns an iterator that yields a single
9144   element, and [`iter::empty`] returns an iterator that yields no
9145   elements.
9146 * The [`matches`] and [`rmatches`] methods on `str` return iterators
9147   over substring matches.
9148 * [`Cell`] and [`RefCell`] both implement `Eq`.
9149 * A number of methods for wrapping arithmetic are added to the
9150   integral types, [`wrapping_div`], [`wrapping_rem`],
9151   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
9152   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
9153   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
9154   type.. It is illegal for the default arithmetic operations in Rust
9155   to overflow; the desire to wrap must be explicit.
9156 * The `{:#?}` formatting specifier [displays the alternate,
9157   pretty-printed][debugfmt] form of the `Debug` formatter. This
9158   feature was actually introduced prior to 1.0 with little
9159   fanfare.
9160 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
9161   for writing data to formatted strings, similar to [`io::Write`].
9162 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
9163   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
9164   are used by code generators to emit implementations of [`Debug`].
9165 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
9166   methods that convert case, following Unicode case mapping.
9167 * It is now easier to handle poisoned locks. The [`PoisonError`]
9168   type, returned by failing lock operations, exposes `into_inner`,
9169   `get_ref`, and `get_mut`, which all give access to the inner lock
9170   guard, and allow the poisoned lock to continue to operate. The
9171   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
9172   poisoned lock without attempting to take the lock.
9173 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
9174   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
9175   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
9176   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
9177   `ChildStderr`.
9178 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
9179   malformed input.
9180
9181 Misc
9182 ----
9183
9184 * `rustc` employs smarter heuristics for guessing at [typos].
9185 * `rustc` emits more efficient code for [no-op conversions between
9186   unsafe pointers][nop].
9187 * Fat pointers are now [passed in pairs of immediate arguments][fat],
9188   resulting in faster compile times and smaller code.
9189
9190 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
9191 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
9192 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
9193 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
9194 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
9195 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
9196 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
9197 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
9198 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
9199 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
9200 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
9201 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
9202 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
9203 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
9204 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
9205 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
9206 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
9207 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
9208 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
9209 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
9210 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
9211 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
9212 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
9213 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
9214 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
9215 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
9216 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
9217 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
9218 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
9219 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
9220 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
9221 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
9222 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
9223 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9224 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9225 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
9226 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
9227 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
9228 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
9229 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
9230 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
9231 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
9232 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
9233 [align]: https://github.com/rust-lang/rust/pull/25646
9234 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
9235 [typos]: https://github.com/rust-lang/rust/pull/26087
9236 [nop]: https://github.com/rust-lang/rust/pull/26336
9237 [fat]: https://github.com/rust-lang/rust/pull/26411
9238 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
9239 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
9240 [packed]: https://github.com/rust-lang/rust/pull/25541
9241 [ad]: https://github.com/rust-lang/rust/pull/27382
9242 [win]: https://github.com/rust-lang/rust/pull/25350
9243
9244 Version 1.1.0 (2015-06-25)
9245 =========================
9246
9247 * ~850 changes, numerous bugfixes
9248
9249 Highlights
9250 ----------
9251
9252 * The [`std::fs` module has been expanded][fs] to expand the set of
9253   functionality exposed:
9254   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
9255     don't incur a syscall on some platforms.
9256   * A `symlink_metadata` function has been added.
9257   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
9258     access to all underlying information.
9259 * The compiler now contains extended explanations of many errors. When an error
9260   with an explanation occurs the compiler suggests using the `--explain` flag
9261   to read the explanation. Error explanations are also [available online][err-index].
9262 * Thanks to multiple [improvements][sk] to [type checking][pre], as
9263   well as other work, the time to bootstrap the compiler decreased by
9264   32%.
9265
9266 Libraries
9267 ---------
9268
9269 * The [`str::split_whitespace`] method splits a string on unicode
9270   whitespace boundaries.
9271 * On both Windows and Unix, new extension traits provide conversion of
9272   I/O types to and from the underlying system handles. On Unix, these
9273   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
9274   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
9275   `TcpListener`, and `UpdSocket`. Further implementations for
9276   `std::process` will be stabilized later.
9277 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
9278   Windows, symlinks can be created with
9279   `std::os::windows::symlink_dir` and
9280   `std::os::windows::symlink_file`.
9281 * The `mpsc::Receiver` type can now be converted into an iterator with
9282   `into_iter` on the [`IntoIterator`] trait.
9283 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
9284   implementation of the [`From`] trait.
9285 * The `Debug` implementation for `RangeFull` [creates output that is
9286   more consistent with other implementations][rf].
9287 * [`Debug` is implemented for `File`][file].
9288 * The `Default` implementation for `Arc` [no longer requires `Sync +
9289   Send`][arc].
9290 * [The `Iterator` methods `count`, `nth`, and `last` have been
9291   overridden for slices to have *O*(1) performance instead of *O*(*n*)][si].
9292 * Incorrect handling of paths on Windows has been improved in both the
9293   compiler and the standard library.
9294 * [`AtomicPtr` gained a `Default` implementation][ap].
9295 * In accordance with Rust's policy on arithmetic overflow `abs` now
9296   [panics on overflow when debug assertions are enabled][abs].
9297 * The [`Cloned`] iterator, which was accidentally left unstable for
9298   1.0 [has been stabilized][c].
9299 * The [`Incoming`] iterator, which iterates over incoming TCP
9300   connections, and which was accidentally unnamable in 1.0, [is now
9301   properly exported][inc].
9302 * [`BinaryHeap`] no longer corrupts itself [when functions called by
9303   `sift_up` or `sift_down` panic][bh].
9304 * The [`split_off`] method of `LinkedList` [no longer corrupts
9305   the list in certain scenarios][ll].
9306
9307 Misc
9308 ----
9309
9310 * Type checking performance [has improved notably][sk] with
9311   [multiple improvements][pre].
9312 * The compiler [suggests code changes][ch] for more errors.
9313 * rustc and it's build system have experimental support for [building
9314   toolchains against MUSL][m] instead of glibc on Linux.
9315 * The compiler defines the `target_env` cfg value, which is used for
9316   distinguishing toolchains that are otherwise for the same
9317   platform. Presently this is set to `gnu` for common GNU Linux
9318   targets and for MinGW targets, and `musl` for MUSL Linux targets.
9319 * The [`cargo rustc`][crc] command invokes a build with custom flags
9320   to rustc.
9321 * [Android executables are always position independent][pie].
9322 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
9323   with `Drop`][drop].
9324
9325 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
9326 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9327 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9328 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
9329 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
9330 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
9331 [rf]: https://github.com/rust-lang/rust/pull/24491
9332 [err-index]: https://doc.rust-lang.org/error-index.html
9333 [sk]: https://github.com/rust-lang/rust/pull/24615
9334 [pre]: https://github.com/rust-lang/rust/pull/25323
9335 [file]: https://github.com/rust-lang/rust/pull/24598
9336 [ch]: https://github.com/rust-lang/rust/pull/24683
9337 [arc]: https://github.com/rust-lang/rust/pull/24695
9338 [si]: https://github.com/rust-lang/rust/pull/24701
9339 [ap]: https://github.com/rust-lang/rust/pull/24834
9340 [m]: https://github.com/rust-lang/rust/pull/24777
9341 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
9342 [crc]: https://github.com/rust-lang/cargo/pull/1568
9343 [pie]: https://github.com/rust-lang/rust/pull/24953
9344 [abs]: https://github.com/rust-lang/rust/pull/25441
9345 [c]: https://github.com/rust-lang/rust/pull/25496
9346 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
9347 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
9348 [inc]: https://github.com/rust-lang/rust/pull/25522
9349 [bh]: https://github.com/rust-lang/rust/pull/25856
9350 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
9351 [ll]: https://github.com/rust-lang/rust/pull/26022
9352 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
9353 [drop]: https://github.com/rust-lang/rust/pull/24935
9354
9355 Version 1.0.0 (2015-05-15)
9356 ========================
9357
9358 * ~1500 changes, numerous bugfixes
9359
9360 Highlights
9361 ----------
9362
9363 * The vast majority of the standard library is now `#[stable]`. It is
9364   no longer possible to use unstable features with a stable build of
9365   the compiler.
9366 * Many popular crates on [crates.io] now work on the stable release
9367   channel.
9368 * Arithmetic on basic integer types now [checks for overflow in debug
9369   builds][overflow].
9370
9371 Language
9372 --------
9373
9374 * Several [restrictions have been added to trait coherence][coh] in
9375   order to make it easier for upstream authors to change traits
9376   without breaking downstream code.
9377 * Digits of binary and octal literals are [lexed more eagerly][lex] to
9378   improve error messages and macro behavior. For example, `0b1234` is
9379   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
9380 * Trait bounds [are always invariant][inv], eliminating the need for
9381   the `PhantomFn` and `MarkerTrait` lang items, which have been
9382   removed.
9383 * ["-" is no longer a valid character in crate names][cr], the `extern crate
9384   "foo" as bar` syntax has been replaced with `extern crate foo as
9385   bar`, and Cargo now automatically translates "-" in *package* names
9386   to underscore for the crate name.
9387 * [Lifetime shadowing is an error][lt].
9388 * [`Send` no longer implies `'static`][send-rfc].
9389 * [UFCS now supports trait-less associated paths][moar-ufcs] like
9390   `MyType::default()`.
9391 * Primitive types [now have inherent methods][prim-inherent],
9392   obviating the need for extension traits like `SliceExt`.
9393 * Methods with `Self: Sized` in their `where` clause are [considered
9394   object-safe][self-sized], allowing many extension traits like
9395   `IteratorExt` to be merged into the traits they extended.
9396 * You can now [refer to associated types][assoc-where] whose
9397   corresponding trait bounds appear only in a `where` clause.
9398 * The final bits of [OIBIT landed][oibit-final], meaning that traits
9399   like `Send` and `Sync` are now library-defined.
9400 * A [Reflect trait][reflect] was introduced, which means that
9401   downcasting via the `Any` trait is effectively limited to concrete
9402   types. This helps retain the potentially-important "parametricity"
9403   property: generic code cannot behave differently for different type
9404   arguments except in minor ways.
9405 * The `unsafe_destructor` feature is now deprecated in favor of the
9406   [new `dropck`][dropck]. This change is a major reduction in unsafe
9407   code.
9408
9409 Libraries
9410 ---------
9411
9412 * The `thread_local` module [has been renamed to `std::thread`][th].
9413 * The methods of `IteratorExt` [have been moved to the `Iterator`
9414   trait itself][ie].
9415 * Several traits that implement Rust's conventions for type
9416   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
9417   [centralized in the `std::convert` module][con].
9418 * The `FromError` trait [was removed in favor of `From`][fe].
9419 * The basic sleep function [has moved to
9420   `std::thread::sleep_ms`][slp].
9421 * The `splitn` function now takes an `n` parameter that represents the
9422   number of items yielded by the returned iterator [instead of the
9423   number of 'splits'][spl].
9424 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
9425 * [Derived implementations of `PartialOrd` now order enums according
9426   to their explicitly-assigned discriminants][po].
9427 * [Methods for searching strings are generic over `Pattern`s][pat],
9428   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
9429   some others.
9430 * [In method resolution, object methods are resolved before inherent
9431   methods][meth].
9432 * [`String::from_str` has been deprecated in favor of the `From` impl,
9433   `String::from`][sf].
9434 * [`io::Error` implements `Sync`][ios].
9435 * [The `words` method on `&str` has been replaced with
9436   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
9437   a word?'
9438 * The new path and IO modules are complete and `#[stable]`. This
9439   was the major library focus for this cycle.
9440 * The path API was [revised][path-normalize] to normalize `.`,
9441   adjusting the tradeoffs in favor of the most common usage.
9442 * A large number of remaining APIs in `std` were also stabilized
9443   during this cycle; about 75% of the non-deprecated API surface
9444   is now stable.
9445 * The new [string pattern API][string-pattern] landed, which makes
9446   the string slice API much more internally consistent and flexible.
9447 * A new set of [generic conversion traits][conversion] replaced
9448   many existing ad hoc traits.
9449 * Generic numeric traits were [completely removed][num-traits]. This
9450   was made possible thanks to inherent methods for primitive types,
9451   and the removal gives maximal flexibility for designing a numeric
9452   hierarchy in the future.
9453 * The `Fn` traits are now related via [inheritance][fn-inherit]
9454   and provide ergonomic [blanket implementations][fn-blanket].
9455 * The `Index` and `IndexMut` traits were changed to
9456   [take the index by value][index-value], enabling code like
9457   `hash_map["string"]` to work.
9458 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
9459   `Copy` data is known to be `Clone` as well.
9460
9461 Misc
9462 ----
9463
9464 * Many errors now have extended explanations that can be accessed with
9465   the `--explain` flag to `rustc`.
9466 * Many new examples have been added to the standard library
9467   documentation.
9468 * rustdoc has received a number of improvements focused on completion
9469   and polish.
9470 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
9471 * Much headway was made on ecosystem-wide CI, making it possible
9472   to [compare builds for breakage][ci-compare].
9473
9474
9475 [crates.io]: http://crates.io
9476 [clo]: https://github.com/rust-lang/rust/pull/24034
9477 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
9478 [con]: https://github.com/rust-lang/rust/pull/23875
9479 [cr]: https://github.com/rust-lang/rust/pull/23419
9480 [fe]: https://github.com/rust-lang/rust/pull/23879
9481 [ie]: https://github.com/rust-lang/rust/pull/23300
9482 [inv]: https://github.com/rust-lang/rust/pull/23938
9483 [ios]: https://github.com/rust-lang/rust/pull/24133
9484 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
9485 [lt]: https://github.com/rust-lang/rust/pull/24057
9486 [meth]: https://github.com/rust-lang/rust/pull/24056
9487 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
9488 [po]: https://github.com/rust-lang/rust/pull/24270
9489 [sf]: https://github.com/rust-lang/rust/pull/24517
9490 [slp]: https://github.com/rust-lang/rust/pull/23949
9491 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
9492 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
9493 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
9494 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
9495 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
9496 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
9497 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
9498 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
9499 [self-sized]: https://github.com/rust-lang/rust/pull/22301
9500 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
9501 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
9502 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
9503 [reflect]: https://github.com/rust-lang/rust/pull/23712
9504 [conversion]: https://github.com/rust-lang/rfcs/pull/529
9505 [num-traits]: https://github.com/rust-lang/rust/pull/23549
9506 [index-value]: https://github.com/rust-lang/rust/pull/23601
9507 [dropck]: https://github.com/rust-lang/rfcs/pull/769
9508 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
9509 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
9510 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
9511 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
9512 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
9513
9514
9515 Version 1.0.0-alpha.2 (2015-02-20)
9516 =====================================
9517
9518 * ~1300 changes, numerous bugfixes
9519
9520 * Highlights
9521
9522     * The various I/O modules were [overhauled][io-rfc] to reduce
9523       unnecessary abstractions and provide better interoperation with
9524       the underlying platform. The old `io` module remains temporarily
9525       at `std::old_io`.
9526     * The standard library now [participates in feature gating][feat],
9527       so use of unstable libraries now requires a `#![feature(...)]`
9528       attribute. The impact of this change is [described on the
9529       forum][feat-forum]. [RFC][feat-rfc].
9530
9531 * Language
9532
9533     * `for` loops [now operate on the `IntoIterator` trait][into],
9534       which eliminates the need to call `.iter()`, etc. to iterate
9535       over collections. There are some new subtleties to remember
9536       though regarding what sort of iterators various types yield, in
9537       particular that `for foo in bar { }` yields values from a move
9538       iterator, destroying the original collection. [RFC][into-rfc].
9539     * Objects now have [default lifetime bounds][obj], so you don't
9540       have to write `Box<Trait+'static>` when you don't care about
9541       storing references. [RFC][obj-rfc].
9542     * In types that implement `Drop`, [lifetimes must outlive the
9543       value][drop]. This will soon make it possible to safely
9544       implement `Drop` for types where `#[unsafe_destructor]` is now
9545       required. Read the [gorgeous RFC][drop-rfc] for details.
9546     * The fully qualified <T as Trait>::X syntax lets you set the Self
9547       type for a trait method or associated type. [RFC][ufcs-rfc].
9548     * References to types that implement `Deref<U>` now [automatically
9549       coerce to references][deref] to the dereferenced type `U`,
9550       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
9551       should eliminate many unsightly uses of `&*`, as when converting
9552       from references to vectors into references to
9553       slices. [RFC][deref-rfc].
9554     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
9555       `|:|`) is obsolete and closure kind is inferred from context.
9556     * [`Self` is a keyword][Self].
9557
9558 * Libraries
9559
9560     * The `Show` and `String` formatting traits [have been
9561       renamed][fmt] to `Debug` and `Display` to more clearly reflect
9562       their related purposes. Automatically getting a string
9563       conversion to use with `format!("{:?}", something_to_debug)` is
9564       now written `#[derive(Debug)]`.
9565     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
9566       OsStr}`, provide strings in platform-specific encodings for easier
9567       interop with system APIs. [RFC][osstr-rfc].
9568     * The `boxed::into_raw` and `Box::from_raw` functions [convert
9569       between `Box<T>` and `*mut T`][boxraw], a common pattern for
9570       creating raw pointers.
9571
9572 * Tooling
9573
9574     * Certain long error messages of the form 'expected foo found bar'
9575       are now [split neatly across multiple
9576       lines][multiline]. Examples in the PR.
9577     * On Unix Rust can be [uninstalled][un] by running
9578       `/usr/local/lib/rustlib/uninstall.sh`.
9579     * The `#[rustc_on_unimplemented]` attribute, requiring the
9580       'on_unimplemented' feature, lets rustc [display custom error
9581       messages when a trait is expected to be implemented for a type
9582       but is not][onun].
9583
9584 * Misc
9585
9586     * Rust is tested against a [LALR grammar][lalr], which parses
9587       almost all the Rust files that rustc does.
9588
9589 [boxraw]: https://github.com/rust-lang/rust/pull/21318
9590 [close]: https://github.com/rust-lang/rust/pull/21843
9591 [deref]: https://github.com/rust-lang/rust/pull/21351
9592 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
9593 [drop]: https://github.com/rust-lang/rust/pull/21972
9594 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
9595 [feat]: https://github.com/rust-lang/rust/pull/21248
9596 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
9597 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
9598 [fmt]: https://github.com/rust-lang/rust/pull/21457
9599 [into]: https://github.com/rust-lang/rust/pull/20790
9600 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
9601 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9602 [lalr]: https://github.com/rust-lang/rust/pull/21452
9603 [multiline]: https://github.com/rust-lang/rust/pull/19870
9604 [obj]: https://github.com/rust-lang/rust/pull/22230
9605 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
9606 [onun]: https://github.com/rust-lang/rust/pull/20889
9607 [osstr]: https://github.com/rust-lang/rust/pull/21488
9608 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9609 [Self]: https://github.com/rust-lang/rust/pull/22158
9610 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
9611 [un]: https://github.com/rust-lang/rust/pull/22256
9612
9613
9614 Version 1.0.0-alpha (2015-01-09)
9615 ==================================
9616
9617   * ~2400 changes, numerous bugfixes
9618
9619   * Highlights
9620
9621     * The language itself is considered feature complete for 1.0,
9622       though there will be many usability improvements and bugfixes
9623       before the final release.
9624     * Nearly 50% of the public API surface of the standard library has
9625       been declared 'stable'. Those interfaces are unlikely to change
9626       before 1.0.
9627     * The long-running debate over integer types has been
9628       [settled][ints]: Rust will ship with types named `isize` and
9629       `usize`, rather than `int` and `uint`, for pointer-sized
9630       integers. Guidelines will be rolled out during the alpha cycle.
9631     * Most crates that are not `std` have been moved out of the Rust
9632       distribution into the Cargo ecosystem so they can evolve
9633       separately and don't need to be stabilized as quickly, including
9634       'time', 'getopts', 'num', 'regex', and 'term'.
9635     * Documentation continues to be expanded with more API coverage, more
9636       examples, and more in-depth explanations. The guides have been
9637       consolidated into [The Rust Programming Language][trpl].
9638     * "[Rust By Example][rbe]" is now maintained by the Rust team.
9639     * All official Rust binary installers now come with [Cargo], the
9640       Rust package manager.
9641
9642 * Language
9643
9644     * Closures have been [completely redesigned][unboxed] to be
9645       implemented in terms of traits, can now be used as generic type
9646       bounds and thus monomorphized and inlined, or via an opaque
9647       pointer (boxed) as in the old system. The new system is often
9648       referred to as 'unboxed' closures.
9649     * Traits now support [associated types][assoc], allowing families
9650       of related types to be defined together and used generically in
9651       powerful ways.
9652     * Enum variants are [namespaced by their type names][enum].
9653     * [`where` clauses][where] provide a more versatile and attractive
9654       syntax for specifying generic bounds, though the previous syntax
9655       remains valid.
9656     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
9657       numeric types.
9658     * Rust [no longer has a runtime][rt] of any description, and only
9659       supports OS threads, not green threads.
9660     * At long last, Rust has been overhauled for 'dynamically-sized
9661       types' ([DST]), which integrates 'fat pointers' (object types,
9662       arrays, and `str`) more deeply into the type system, making it
9663       more consistent.
9664     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
9665       `..j` that produce range types and which, when combined with the
9666       `Index` operator and multidispatch, leads to a convenient slice
9667       notation, `[i..j]`.
9668     * The new range syntax revealed an ambiguity in the fixed-length
9669       array syntax, so now fixed length arrays [are written `[T;
9670       N]`][arrays].
9671     * The `Copy` trait is no longer implemented automatically. Unsafe
9672       pointers no longer implement `Sync` and `Send` so types
9673       containing them don't automatically either. `Sync` and `Send`
9674       are now 'unsafe traits' so one can "forcibly" implement them via
9675       `unsafe impl` if a type confirms to the requirements for them
9676       even though the internals do not (e.g. structs containing unsafe
9677       pointers like `Arc`). These changes are intended to prevent some
9678       footguns and are collectively known as [opt-in built-in
9679       traits][oibit] (though `Sync` and `Send` will soon become pure
9680       library types unknown to the compiler).
9681     * Operator traits now take their operands [by value][ops], and
9682       comparison traits can use multidispatch to compare one type
9683       against multiple other types, allowing e.g. `String` to be
9684       compared with `&str`.
9685     * `if let` and `while let` are no longer feature-gated.
9686     * Rust has adopted a more [uniform syntax for escaping unicode
9687       characters][unicode].
9688     * `macro_rules!` [has been declared stable][mac]. Though it is a
9689       flawed system it is sufficiently popular that it must be usable
9690       for 1.0. Effort has gone into [future-proofing][mac-future] it
9691       in ways that will allow other macro systems to be developed in
9692       parallel, and won't otherwise impact the evolution of the
9693       language.
9694     * The prelude has been [pared back significantly][prelude] such
9695       that it is the minimum necessary to support the most pervasive
9696       code patterns, and through [generalized where clauses][where]
9697       many of the prelude extension traits have been consolidated.
9698     * Rust's rudimentary reflection [has been removed][refl], as it
9699       incurred too much code generation for little benefit.
9700     * [Struct variants][structvars] are no longer feature-gated.
9701     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
9702       known as 'higher-ranked trait bounds', this crucially allows
9703       unboxed closures to work.
9704     * Macros invocations surrounded by parens or square brackets and
9705       not terminated by a semicolon are [parsed as
9706       expressions][macros], which makes expressions like `vec![1i32,
9707       2, 3].len()` work as expected.
9708     * Trait objects now implement their traits automatically, and
9709       traits that can be coerced to objects now must be [object
9710       safe][objsafe].
9711     * Automatically deriving traits is now done with `#[derive(...)]`
9712       not `#[deriving(...)]` for [consistency with other naming
9713       conventions][derive].
9714     * Importing the containing module or enum at the same time as
9715       items or variants they contain is [now done with `self` instead
9716       of `mod`][self], as in use `foo::{self, bar}`
9717     * Glob imports are no longer feature-gated.
9718     * The `box` operator and `box` patterns have been feature-gated
9719       pending a redesign. For now unique boxes should be allocated
9720       like other containers, with `Box::new`.
9721
9722 * Libraries
9723
9724     * A [series][coll1] of [efforts][coll2] to establish
9725       [conventions][coll3] for collections types has resulted in API
9726       improvements throughout the standard library.
9727     * New [APIs for error handling][err] provide ergonomic interop
9728       between error types, and [new conventions][err-conv] describe
9729       more clearly the recommended error handling strategies in Rust.
9730     * The `fail!` macro has been renamed to [`panic!`][panic] so that
9731       it is easier to discuss failure in the context of error handling
9732       without making clarifications as to whether you are referring to
9733       the 'fail' macro or failure more generally.
9734     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
9735       syscall when available.
9736     * The 'serialize' crate has been renamed 'rustc-serialize' and
9737       moved out of the distribution to Cargo. Although it is widely
9738       used now, it is expected to be superseded in the near future.
9739     * The `Show` formatter, typically implemented with
9740       `#[derive(Show)]` is [now requested with the `{:?}`
9741       specifier][show] and is intended for use by all types, for uses
9742       such as `println!` debugging. The new `String` formatter must be
9743       implemented by hand, uses the `{}` specifier, and is intended
9744       for full-fidelity conversions of things that can logically be
9745       represented as strings.
9746
9747 * Tooling
9748
9749     * [Flexible target specification][flex] allows rustc's code
9750       generation to be configured to support otherwise-unsupported
9751       platforms.
9752     * Rust comes with rust-gdb and rust-lldb scripts that launch their
9753       respective debuggers with Rust-appropriate pretty-printing.
9754     * The Windows installation of Rust is distributed with the
9755       MinGW components currently required to link binaries on that
9756       platform.
9757
9758 * Misc
9759
9760     * Nullable enum optimizations have been extended to more types so
9761       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
9762       space than the inner types themselves.
9763     * Work has begun on supporting AArch64.
9764
9765 [Cargo]: https://crates.io
9766 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
9767 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
9768 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
9769 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
9770 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
9771 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
9772 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
9773 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
9774 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
9775 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
9776 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
9777 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
9778 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
9779 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
9780 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
9781 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
9782 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
9783 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
9784 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
9785 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
9786 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
9787 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
9788 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
9789 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
9790 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
9791 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
9792 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
9793 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
9794 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
9795 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
9796 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
9797 [trpl]: https://doc.rust-lang.org/book/index.html
9798 [rbe]: http://rustbyexample.com/
9799
9800
9801 Version 0.12.0 (2014-10-09)
9802 =============================
9803
9804   * ~1900 changes, numerous bugfixes
9805
9806   * Highlights
9807
9808     * The introductory documentation (now called The Rust Guide) has
9809       been completely rewritten, as have a number of supplementary
9810       guides.
9811     * Rust's package manager, Cargo, continues to improve and is
9812       sometimes considered to be quite awesome.
9813     * Many API's in `std` have been reviewed and updated for
9814       consistency with the in-development Rust coding
9815       guidelines. The standard library documentation tracks
9816       stabilization progress.
9817     * Minor libraries have been moved out-of-tree to the rust-lang org
9818       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
9819       be installed with Cargo.
9820     * Lifetime elision allows lifetime annotations to be left off of
9821       function declarations in many common scenarios.
9822     * Rust now works on 64-bit Windows.
9823
9824   * Language
9825     * Indexing can be overloaded with the `Index` and `IndexMut`
9826       traits.
9827     * The `if let` construct takes a branch only if the `let` pattern
9828       matches, currently behind the 'if_let' feature gate.
9829     * 'where clauses', a more flexible syntax for specifying trait
9830       bounds that is more aesthetic, have been added for traits and
9831       free functions. Where clauses will in the future make it
9832       possible to constrain associated types, which would be
9833       impossible with the existing syntax.
9834     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
9835       the 'slicing_syntax' feature gate, and can be overloaded with
9836       the `Slice` or `SliceMut` traits.
9837     * The syntax for matching of sub-slices has been changed to use a
9838       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
9839       consistency with other uses of `..` and to future-proof
9840       potential additional uses of the syntax.
9841     * The syntax for matching inclusive ranges in patterns has changed
9842       from `0..3` to `0...4` to be consistent with the exclusive range
9843       syntax for slicing.
9844     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
9845       c]`) has been put behind the 'advanced_slice_patterns' feature
9846       gate and may be removed in the future.
9847     * Components of tuples and tuple structs can be extracted using
9848       the `value.0` syntax, currently behind the `tuple_indexing`
9849       feature gate.
9850     * The `#[crate_id]` attribute is no longer supported; versioning
9851       is handled by the package manager.
9852     * Renaming crate imports are now written `extern crate foo as bar`
9853       instead of `extern crate bar = foo`.
9854     * Renaming use statements are now written `use foo as bar` instead
9855       of `use bar = foo`.
9856     * `let` and `match` bindings and argument names in macros are now
9857       hygienic.
9858     * The new, more efficient, closure types ('unboxed closures') have
9859       been added under a feature gate, 'unboxed_closures'. These will
9860       soon replace the existing closure types, once higher-ranked
9861       trait lifetimes are added to the language.
9862     * `move` has been added as a keyword, for indicating closures
9863       that capture by value.
9864     * Mutation and assignment is no longer allowed in pattern guards.
9865     * Generic structs and enums can now have trait bounds.
9866     * The `Share` trait is now called `Sync` to free up the term
9867       'shared' to refer to 'shared reference' (the default reference
9868       type.
9869     * Dynamically-sized types have been mostly implemented,
9870       unifying the behavior of fat-pointer types with the rest of the
9871       type system.
9872     * As part of dynamically-sized types, the `Sized` trait has been
9873       introduced, which qualifying types implement by default, and
9874       which type parameters expect by default. To specify that a type
9875       parameter does not need to be sized, write `<Sized? T>`. Most
9876       types are `Sized`, notable exceptions being unsized arrays
9877       (`[T]`) and trait types.
9878     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
9879     * Lifetime bounds can now be applied to type parameters and object
9880       types.
9881     * The old, reference counted GC type, `Gc<T>` which was once
9882       denoted by the `@` sigil, has finally been removed. GC will be
9883       revisited in the future.
9884
9885   * Libraries
9886     * Library documentation has been improved for a number of modules.
9887     * Bit-vectors, collections::bitv has been modernized.
9888     * The url crate is deprecated in favor of
9889       http://github.com/servo/rust-url, which can be installed with
9890       Cargo.
9891     * Most I/O stream types can be cloned and subsequently closed from
9892       a different thread.
9893     * A `std::time::Duration` type has been added for use in I/O
9894       methods that rely on timers, as well as in the 'time' crate's
9895       `Timespec` arithmetic.
9896     * The runtime I/O abstraction layer that enabled the green thread
9897       scheduler to do non-thread-blocking I/O has been removed, along
9898       with the libuv-based implementation employed by the green thread
9899       scheduler. This will greatly simplify the future I/O work.
9900     * `collections::btree` has been rewritten to have a more
9901       idiomatic and efficient design.
9902
9903   * Tooling
9904     * rustdoc output now indicates the stability levels of API's.
9905     * The `--crate-name` flag can specify the name of the crate
9906       being compiled, like `#[crate_name]`.
9907     * The `-C metadata` specifies additional metadata to hash into
9908       symbol names, and `-C extra-filename` specifies additional
9909       information to put into the output filename, for use by the
9910       package manager for versioning.
9911     * debug info generation has continued to improve and should be
9912       more reliable under both gdb and lldb.
9913     * rustc has experimental support for compiling in parallel
9914       using the `-C codegen-units` flag.
9915     * rustc no longer encodes rpath information into binaries by
9916       default.
9917
9918   * Misc
9919     * Stack usage has been optimized with LLVM lifetime annotations.
9920     * Official Rust binaries on Linux are more compatible with older
9921       kernels and distributions, built on CentOS 5.10.
9922
9923
9924 Version 0.11.0 (2014-07-02)
9925 ==========================
9926
9927   * ~1700 changes, numerous bugfixes
9928
9929   * Language
9930     * ~[T] has been removed from the language. This type is superseded by
9931       the Vec<T> type.
9932     * ~str has been removed from the language. This type is superseded by
9933       the String type.
9934     * ~T has been removed from the language. This type is superseded by the
9935       Box<T> type.
9936     * @T has been removed from the language. This type is superseded by the
9937       standard library's std::gc::Gc<T> type.
9938     * Struct fields are now all private by default.
9939     * Vector indices and shift amounts are both required to be a `uint`
9940       instead of any integral type.
9941     * Byte character, byte string, and raw byte string literals are now all
9942       supported by prefixing the normal literal with a `b`.
9943     * Multiple ABIs are no longer allowed in an ABI string
9944     * The syntax for lifetimes on closures/procedures has been tweaked
9945       slightly: `<'a>|A, B|: 'b + K -> T`
9946     * Floating point modulus has been removed from the language; however it
9947       is still provided by a library implementation.
9948     * Private enum variants are now disallowed.
9949     * The `priv` keyword has been removed from the language.
9950     * A closure can no longer be invoked through a &-pointer.
9951     * The `use foo, bar, baz;` syntax has been removed from the language.
9952     * The transmute intrinsic no longer works on type parameters.
9953     * Statics now allow blocks/items in their definition.
9954     * Trait bounds are separated from objects with + instead of : now.
9955     * Objects can no longer be read while they are mutably borrowed.
9956     * The address of a static is now marked as insignificant unless the
9957       #[inline(never)] attribute is placed it.
9958     * The #[unsafe_destructor] attribute is now behind a feature gate.
9959     * Struct literals are no longer allowed in ambiguous positions such as
9960       if, while, match, and for..in.
9961     * Declaration of lang items and intrinsics are now feature-gated by
9962       default.
9963     * Integral literals no longer default to `int`, and floating point
9964       literals no longer default to `f64`. Literals must be suffixed with an
9965       appropriate type if inference cannot determine the type of the
9966       literal.
9967     * The Box<T> type is no longer implicitly borrowed to &mut T.
9968     * Procedures are now required to not capture borrowed references.
9969
9970   * Libraries
9971     * The standard library is now a "facade" over a number of underlying
9972       libraries. This means that development on the standard library should
9973       be speedier due to smaller crates, as well as a clearer line between
9974       all dependencies.
9975     * A new library, libcore, lives under the standard library's facade
9976       which is Rust's "0-assumption" library, suitable for embedded and
9977       kernel development for example.
9978     * A regex crate has been added to the standard distribution. This crate
9979       includes statically compiled regular expressions.
9980     * The unwrap/unwrap_err methods on Result require a Show bound for
9981       better error messages.
9982     * The return types of the std::comm primitives have been centralized
9983       around the Result type.
9984     * A number of I/O primitives have gained the ability to time out their
9985       operations.
9986     * A number of I/O primitives have gained the ability to close their
9987       reading/writing halves to cancel pending operations.
9988     * Reverse iterator methods have been removed in favor of `rev()` on
9989       their forward-iteration counterparts.
9990     * A bitflags! macro has been added to enable easy interop with C and
9991       management of bit flags.
9992     * A debug_assert! macro is now provided which is disabled when
9993       `--cfg ndebug` is passed to the compiler.
9994     * A graphviz crate has been added for creating .dot files.
9995     * The std::cast module has been migrated into std::mem.
9996     * The std::local_data api has been migrated from freestanding functions
9997       to being based on methods.
9998     * The Pod trait has been renamed to Copy.
9999     * jemalloc has been added as the default allocator for types.
10000     * The API for allocating memory has been changed to use proper alignment
10001       and sized deallocation
10002     * Connecting a TcpStream or binding a TcpListener is now based on a
10003       string address and a u16 port. This allows connecting to a hostname as
10004       opposed to an IP.
10005     * The Reader trait now contains a core method, read_at_least(), which
10006       correctly handles many repeated 0-length reads.
10007     * The process-spawning API is now centered around a builder-style
10008       Command struct.
10009     * The :? printing qualifier has been moved from the standard library to
10010       an external libdebug crate.
10011     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
10012       have been renamed to Eq/Ord.
10013     * The select/plural methods have been removed from format!. The escapes
10014       for { and } have also changed from \{ and \} to {{ and }},
10015       respectively.
10016     * The TaskBuilder API has been re-worked to be a true builder, and
10017       extension traits for spawning native/green tasks have been added.
10018
10019   * Tooling
10020     * All breaking changes to the language or libraries now have their
10021       commit message annotated with `[breaking-change]` to allow for easy
10022       discovery of breaking changes.
10023     * The compiler will now try to suggest how to annotate lifetimes if a
10024       lifetime-related error occurs.
10025     * Debug info continues to be improved greatly with general bug fixes and
10026       better support for situations like link time optimization (LTO).
10027     * Usage of syntax extensions when cross-compiling has been fixed.
10028     * Functionality equivalent to GCC & Clang's -ffunction-sections,
10029       -fdata-sections and --gc-sections has been enabled by default
10030     * The compiler is now stricter about where it will load module files
10031       from when a module is declared via `mod foo;`.
10032     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
10033       Syntax extensions are now discovered via a "plugin registrar" type
10034       which will be extended in the future to other various plugins.
10035     * Lints have been restructured to allow for dynamically loadable lints.
10036     * A number of rustdoc improvements:
10037       * The HTML output has been visually redesigned.
10038       * Markdown is now powered by hoedown instead of sundown.
10039       * Searching heuristics have been greatly improved.
10040       * The search index has been reduced in size by a great amount.
10041       * Cross-crate documentation via `pub use` has been greatly improved.
10042       * Primitive types are now hyperlinked and documented.
10043     * Documentation has been moved from static.rust-lang.org/doc to
10044       doc.rust-lang.org
10045     * A new sandbox, play.rust-lang.org, is available for running and
10046       sharing rust code examples on-line.
10047     * Unused attributes are now more robustly warned about.
10048     * The dead_code lint now warns about unused struct fields.
10049     * Cross-compiling to iOS is now supported.
10050     * Cross-compiling to mipsel is now supported.
10051     * Stability attributes are now inherited by default and no longer apply
10052       to intra-crate usage, only inter-crate usage.
10053     * Error message related to non-exhaustive match expressions have been
10054       greatly improved.
10055
10056
10057 Version 0.10 (2014-04-03)
10058 =========================
10059
10060   * ~1500 changes, numerous bugfixes
10061
10062   * Language
10063     * A new RFC process is now in place for modifying the language.
10064     * Patterns with `@`-pointers have been removed from the language.
10065     * Patterns with unique vectors (`~[T]`) have been removed from the
10066       language.
10067     * Patterns with unique strings (`~str`) have been removed from the
10068       language.
10069     * `@str` has been removed from the language.
10070     * `@[T]` has been removed from the language.
10071     * `@self` has been removed from the language.
10072     * `@Trait` has been removed from the language.
10073     * Headers on `~` allocations which contain `@` boxes inside the type for
10074       reference counting have been removed.
10075     * The semantics around the lifetimes of temporary expressions have changed,
10076       see #3511 and #11585 for more information.
10077     * Cross-crate syntax extensions are now possible, but feature gated. See
10078       #11151 for more information. This includes both `macro_rules!` macros as
10079       well as syntax extensions such as `format!`.
10080     * New lint modes have been added, and older ones have been turned on to be
10081       warn-by-default.
10082       * Unnecessary parentheses
10083       * Uppercase statics
10084       * Camel Case types
10085       * Uppercase variables
10086       * Publicly visible private types
10087       * `#[deriving]` with raw pointers
10088     * Unsafe functions can no longer be coerced to closures.
10089     * Various obscure macros such as `log_syntax!` are now behind feature gates.
10090     * The `#[simd]` attribute is now behind a feature gate.
10091     * Visibility is no longer allowed on `extern crate` statements, and
10092       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
10093     * Trailing commas are now allowed in argument lists and tuple patterns.
10094     * The `do` keyword has been removed, it is now a reserved keyword.
10095     * Default type parameters have been implemented, but are feature gated.
10096     * Borrowed variables through captures in closures are now considered soundly.
10097     * `extern mod` is now `extern crate`
10098     * The `Freeze` trait has been removed.
10099     * The `Share` trait has been added for types that can be shared among
10100       threads.
10101     * Labels in macros are now hygienic.
10102     * Expression/statement macro invocations can be delimited with `{}` now.
10103     * Treatment of types allowed in `static mut` locations has been tweaked.
10104     * The `*` and `.` operators are now overloadable through the `Deref` and
10105       `DerefMut` traits.
10106     * `~Trait` and `proc` no longer have `Send` bounds by default.
10107     * Partial type hints are now supported with the `_` type marker.
10108     * An `Unsafe` type was introduced for interior mutability. It is now
10109       considered undefined to transmute from `&T` to `&mut T` without using the
10110       `Unsafe` type.
10111     * The #[linkage] attribute was implemented for extern statics/functions.
10112     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
10113     * `Pod` was renamed to `Copy`.
10114
10115   * Libraries
10116     * The `libextra` library has been removed. It has now been decomposed into
10117       component libraries with smaller and more focused nuggets of
10118       functionality. The full list of libraries can be found on the
10119       documentation index page.
10120     * std: `std::condition` has been removed. All I/O errors are now propagated
10121       through the `Result` type. In order to assist with error handling, a
10122       `try!` macro for unwrapping errors with an early return and a lint for
10123       unused results has been added. See #12039 for more information.
10124     * std: The `vec` module has been renamed to `slice`.
10125     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
10126       This will become the only growable vector in the future.
10127     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
10128       are now found at `std::io::BufferedReader` instead of
10129       `std::io::buffered::BufferedReader`.
10130     * std: `print` and `println` are no longer in the prelude, the `print!` and
10131       `println!` macros are intended to be used instead.
10132     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
10133       attempts to statically prevent cycles.
10134     * std: The standard distribution is adopting the policy of pushing failure
10135       to the user rather than failing in libraries. Many functions (such as
10136       `slice::last()`) now return `Option<T>` instead of `T` + failing.
10137     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
10138       deriving mode: `#[deriving(Show)]`.
10139     * std: `ToStr` is now implemented for all types implementing `Show`.
10140     * std: The formatting trait methods now take `&self` instead of `&T`
10141     * std: The `invert()` method on iterators has been renamed to `rev()`
10142     * std: `std::num` has seen a reduction in the genericity of its traits,
10143       consolidating functionality into a few core traits.
10144     * std: Backtraces are now printed on task failure if the environment
10145       variable `RUST_BACKTRACE` is present.
10146     * std: Naming conventions for iterators have been standardized. More details
10147       can be found on the wiki's style guide.
10148     * std: `eof()` has been removed from the `Reader` trait. Specific types may
10149       still implement the function.
10150     * std: Networking types are now cloneable to allow simultaneous reads/writes.
10151     * std: `assert_approx_eq!` has been removed
10152     * std: The `e` and `E` formatting specifiers for floats have been added to
10153       print them in exponential notation.
10154     * std: The `Times` trait has been removed
10155     * std: Indications of variance and opting out of builtin bounds is done
10156       through marker types in `std::kinds::marker` now
10157     * std: `hash` has been rewritten, `IterBytes` has been removed, and
10158       `#[deriving(Hash)]` is now possible.
10159     * std: `SharedChan` has been removed, `Sender` is now cloneable.
10160     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
10161     * std: `Chan::new` is now `channel()`.
10162     * std: A new synchronous channel type has been implemented.
10163     * std: A `select!` macro is now provided for selecting over `Receiver`s.
10164     * std: `hashmap` and `trie` have been moved to `libcollections`
10165     * std: `run` has been rolled into `io::process`
10166     * std: `assert_eq!` now uses `{}` instead of `{:?}`
10167     * std: The equality and comparison traits have seen some reorganization.
10168     * std: `rand` has moved to `librand`.
10169     * std: `to_{lower,upper}case` has been implemented for `char`.
10170     * std: Logging has been moved to `liblog`.
10171     * collections: `HashMap` has been rewritten for higher performance and less
10172       memory usage.
10173     * native: The default runtime is now `libnative`. If `libgreen` is desired,
10174       it can be booted manually. The runtime guide has more information and
10175       examples.
10176     * native: All I/O functionality except signals has been implemented.
10177     * green: Task spawning with `libgreen` has been optimized with stack caching
10178       and various trimming of code.
10179     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
10180     * sync: The `extra::sync` module has been updated to modern rust (and moved
10181       to the `sync` library), tweaking and improving various interfaces while
10182       dropping redundant functionality.
10183     * sync: A new `Barrier` type has been added to the `sync` library.
10184     * sync: An efficient mutex for native and green tasks has been implemented.
10185     * serialize: The `base64` module has seen some improvement. It treats
10186       newlines better, has non-string error values, and has seen general
10187       cleanup.
10188     * fourcc: A `fourcc!` macro was introduced
10189     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
10190       hexadecimal literal.
10191
10192   * Tooling
10193     * `rustpkg` has been deprecated and removed from the main repository. Its
10194       replacement, `cargo`, is under development.
10195     * Nightly builds of rust are now available
10196     * The memory usage of rustc has been improved many times throughout this
10197       release cycle.
10198     * The build process supports disabling rpath support for the rustc binary
10199       itself.
10200     * Code generation has improved in some cases, giving more information to the
10201       LLVM optimization passes to enable more extensive optimizations.
10202     * Debuginfo compatibility with lldb on OSX has been restored.
10203     * The master branch is now gated on an android bot, making building for
10204       android much more reliable.
10205     * Output flags have been centralized into one `--emit` flag.
10206     * Crate type flags have been centralized into one `--crate-type` flag.
10207     * Codegen flags have been consolidated behind a `-C` flag.
10208     * Linking against outdated crates now has improved error messages.
10209     * Error messages with lifetimes will often suggest how to annotate the
10210       function to fix the error.
10211     * Many more types are documented in the standard library, and new guides
10212       were written.
10213     * Many `rustdoc` improvements:
10214       * code blocks are syntax highlighted.
10215       * render standalone markdown files.
10216       * the --test flag tests all code blocks by default.
10217       * exported macros are displayed.
10218       * re-exported types have their documentation inlined at the location of the
10219         first re-export.
10220       * search works across crates that have been rendered to the same output
10221         directory.
10222
10223
10224 Version 0.9 (2014-01-09)
10225 ==========================
10226
10227    * ~1800 changes, numerous bugfixes
10228
10229    * Language
10230       * The `float` type has been removed. Use `f32` or `f64` instead.
10231       * A new facility for enabling experimental features (feature gating) has
10232         been added, using the crate-level `#[feature(foo)]` attribute.
10233       * Managed boxes (@) are now behind a feature gate
10234         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
10235         standard library's `Gc` or `Rc` types instead.
10236       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
10237       * Jumping back to the top of a loop is now done with `continue` instead of
10238         `loop`.
10239       * Strings can no longer be mutated through index assignment.
10240       * Raw strings can be created via the basic `r"foo"` syntax or with matched
10241         hash delimiters, as in `r###"foo"###`.
10242       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
10243         called once.
10244       * The `&fn` type is now written `|args| -> ret` to match the literal form.
10245       * `@fn`s have been removed.
10246       * `do` only works with procs in order to make it obvious what the cost
10247         of `do` is.
10248       * Single-element tuple-like structs can no longer be dereferenced to
10249         obtain the inner value. A more comprehensive solution for overloading
10250         the dereference operator will be provided in the future.
10251       * The `#[link(...)]` attribute has been replaced with
10252         `#[crate_id = "name#vers"]`.
10253       * Empty `impl`s must be terminated with empty braces and may not be
10254         terminated with a semicolon.
10255       * Keywords are no longer allowed as lifetime names; the `self` lifetime
10256         no longer has any special meaning.
10257       * The old `fmt!` string formatting macro has been removed.
10258       * `printf!` and `printfln!` (old-style formatting) removed in favor of
10259         `print!` and `println!`.
10260       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
10261       * The `extern mod foo (name = "bar")` syntax has been removed. Use
10262         `extern mod foo = "bar"` instead.
10263       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
10264       * Macros can have attributes.
10265       * Macros can expand to items with attributes.
10266       * Macros can expand to multiple items.
10267       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
10268       * Comments may be nested.
10269       * Values automatically coerce to trait objects they implement, without
10270         an explicit `as`.
10271       * Enum discriminants are no longer an entire word but as small as needed to
10272         contain all the variants. The `repr` attribute can be used to override
10273         the discriminant size, as in `#[repr(int)]` for integer-sized, and
10274         `#[repr(C)]` to match C enums.
10275       * Non-string literals are not allowed in attributes (they never worked).
10276       * The FFI now supports variadic functions.
10277       * Octal numeric literals, as in `0o7777`.
10278       * The `concat!` syntax extension performs compile-time string concatenation.
10279       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
10280         removed as Rust no longer uses segmented stacks.
10281       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
10282       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
10283         not `*`; ignoring remaining fields of a struct is also done with `..`,
10284         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
10285       * `rustc` supports the "win64" calling convention via `extern "win64"`.
10286       * `rustc` supports the "system" calling convention, which defaults to the
10287         preferred convention for the target platform, "stdcall" on 32-bit Windows,
10288         "C" elsewhere.
10289       * The `type_overflow` lint (default: warn) checks literals for overflow.
10290       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
10291       * The `attribute_usage` lint (default: warn) warns about unknown
10292         attributes.
10293       * The `unknown_features` lint (default: warn) warns about unknown
10294         feature gates.
10295       * The `dead_code` lint (default: warn) checks for dead code.
10296       * Rust libraries can be linked statically to one another
10297       * `#[link_args]` is behind the `link_args` feature gate.
10298       * Native libraries are now linked with `#[link(name = "foo")]`
10299       * Native libraries can be statically linked to a rust crate
10300         (`#[link(name = "foo", kind = "static")]`).
10301       * Native OS X frameworks are now officially supported
10302         (`#[link(name = "foo", kind = "framework")]`).
10303       * The `#[thread_local]` attribute creates thread-local (not task-local)
10304         variables. Currently behind the `thread_local` feature gate.
10305       * The `return` keyword may be used in closures.
10306       * Types that can be copied via a memcpy implement the `Pod` kind.
10307       * The `cfg` attribute can now be used on struct fields and enum variants.
10308
10309    * Libraries
10310       * std: The `option` and `result` API's have been overhauled to make them
10311         simpler, more consistent, and more composable.
10312       * std: The entire `std::io` module has been replaced with one that is
10313         more comprehensive and that properly interfaces with the underlying
10314         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
10315         implemented.
10316       * std: `io::util` contains a number of useful implementations of
10317         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
10318         `ZeroReader`, `TeeReader`.
10319       * std: The reference counted pointer type `extra::rc` moved into std.
10320       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
10321         just a wrapper around it).
10322       * std: The `Either` type has been removed.
10323       * std: `fmt::Default` can be implemented for any type to provide default
10324         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
10325       * std: The `rand` API continues to be tweaked.
10326       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
10327         on failure in gdb, is now named `rust_fail`.
10328       * std: The `each_key` and `each_value` methods on `HashMap` have been
10329         replaced by the `keys` and `values` iterators.
10330       * std: Functions dealing with type size and alignment have moved from the
10331         `sys` module to the `mem` module.
10332       * std: The `path` module was written and API changed.
10333       * std: `str::from_utf8` has been changed to cast instead of allocate.
10334       * std: `starts_with` and `ends_with` methods added to vectors via the
10335         `ImmutableEqVector` trait, which is in the prelude.
10336       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
10337         if the index is out of bounds.
10338       * std: Task failure no longer propagates between tasks, as the model was
10339         complex, expensive, and incompatible with thread-based tasks.
10340       * std: The `Any` type can be used for dynamic typing.
10341       * std: `~Any` can be passed to the `fail!` macro and retrieved via
10342         `task::try`.
10343       * std: Methods that produce iterators generally do not have an `_iter`
10344         suffix now.
10345       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
10346         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
10347       * std: `util::ignore` renamed to `prelude::drop`.
10348       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
10349         trait.
10350       * std: `vec::raw` has seen a lot of cleanup and API changes.
10351       * std: The standard library no longer includes any C++ code, and very
10352         minimal C, eliminating the dependency on libstdc++.
10353       * std: Runtime scheduling and I/O functionality has been factored out into
10354         extensible interfaces and is now implemented by two different crates:
10355         libnative, for native threading and I/O; and libgreen, for green threading
10356         and I/O. This paves the way for using the standard library in more limited
10357         embedded environments.
10358       * std: The `comm` module has been rewritten to be much faster, have a
10359         simpler, more consistent API, and to work for both native and green
10360         threading.
10361       * std: All libuv dependencies have been moved into the rustuv crate.
10362       * native: New implementations of runtime scheduling on top of OS threads.
10363       * native: New native implementations of TCP, UDP, file I/O, process spawning,
10364         and other I/O.
10365       * green: The green thread scheduler and message passing types are almost
10366         entirely lock-free.
10367       * extra: The `flatpipes` module had bitrotted and was removed.
10368       * extra: All crypto functions have been removed and Rust now has a policy of
10369         not reimplementing crypto in the standard library. In the future crypto
10370         will be provided by external crates with bindings to established libraries.
10371       * extra: `c_vec` has been modernized.
10372       * extra: The `sort` module has been removed. Use the `sort` method on
10373         mutable slices.
10374
10375    * Tooling
10376       * The `rust` and `rusti` commands have been removed, due to lack of
10377         maintenance.
10378       * `rustdoc` was completely rewritten.
10379       * `rustdoc` can test code examples in documentation.
10380       * `rustpkg` can test packages with the argument, 'test'.
10381       * `rustpkg` supports arbitrary dependencies, including C libraries.
10382       * `rustc`'s support for generating debug info is improved again.
10383       * `rustc` has better error reporting for unbalanced delimiters.
10384       * `rustc`'s JIT support was removed due to bitrot.
10385       * Executables and static libraries can be built with LTO (-Z lto)
10386       * `rustc` adds a `--dep-info` flag for communicating dependencies to
10387         build tools.
10388
10389
10390 Version 0.8 (2013-09-26)
10391 ============================
10392
10393    * ~2200 changes, numerous bugfixes
10394
10395    * Language
10396       * The `for` loop syntax has changed to work with the `Iterator` trait.
10397       * At long last, unwinding works on Windows.
10398       * Default methods are ready for use.
10399       * Many trait inheritance bugs fixed.
10400       * Owned and borrowed trait objects work more reliably.
10401       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
10402       * rustc can omit emission of code for the `debug!` macro if it is passed
10403         `--cfg ndebug`
10404       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
10405         for foo.rs, then foo/mod.rs, and will generate an error when both are
10406         present.
10407       * Strings no longer contain trailing nulls. The new `std::c_str` module
10408         provides new mechanisms for converting to C strings.
10409       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
10410       * The FFI has been overhauled such that foreign functions are called directly,
10411         instead of through a stack-switching wrapper.
10412       * Calling a foreign function must be done through a Rust function with the
10413         `#[fixed_stack_segment]` attribute.
10414       * The `externfn!` macro can be used to declare both a foreign function and
10415         a `#[fixed_stack_segment]` wrapper at once.
10416       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
10417       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
10418       * `priv` is disallowed everywhere except for struct fields and enum variants.
10419       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
10420       * `ref` bindings in irrefutable patterns work correctly now.
10421       * `char` is now prevented from containing invalid code points.
10422       * Casting to `bool` is no longer allowed.
10423       * `\0` is now accepted as an escape in chars and strings.
10424       * `yield` is a reserved keyword.
10425       * `typeof` is a reserved keyword.
10426       * Crates may be imported by URL with `extern mod foo = "url";`.
10427       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
10428       * Static vectors can be initialized with repeating elements,
10429         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
10430       * Static structs can be initialized with functional record update,
10431         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
10432       * `cfg!` can be used to conditionally execute code based on the crate
10433         configuration, similarly to `#[cfg(...)]`.
10434       * The `unnecessary_qualification` lint detects unneeded module
10435         prefixes (default: allow).
10436       * Arithmetic operations have been implemented on the SIMD types in
10437         `std::unstable::simd`.
10438       * Exchange allocation headers were removed, reducing memory usage.
10439       * `format!` implements a completely new, extensible, and higher-performance
10440         string formatting system. It will replace `fmt!`.
10441       * `print!` and `println!` write formatted strings (using the `format!`
10442         extension) to stdout.
10443       * `write!` and `writeln!` write formatted strings (using the `format!`
10444         extension) to the new Writers in `std::rt::io`.
10445       * The library section in which a function or static is placed may
10446         be specified with `#[link_section = "..."]`.
10447       * The `proto!` syntax extension for defining bounded message protocols
10448         was removed.
10449       * `macro_rules!` is hygienic for `let` declarations.
10450       * The `#[export_name]` attribute specifies the name of a symbol.
10451       * `unreachable!` can be used to indicate unreachable code, and fails
10452         if executed.
10453
10454    * Libraries
10455       * std: Transitioned to the new runtime, written in Rust.
10456       * std: Added an experimental I/O library, `rt::io`, based on the new
10457         runtime.
10458       * std: A new generic `range` function was added to the prelude, replacing
10459         `uint::range` and friends.
10460       * std: `range_rev` no longer exists. Since range is an iterator it can be
10461         reversed with `range(lo, hi).invert()`.
10462       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
10463         renamed to `unwrap_or`.
10464       * std: The `iterator` module was renamed to `iter`.
10465       * std: Integral types now support the `checked_add`, `checked_sub`, and
10466         `checked_mul` operations for detecting overflow.
10467       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
10468         consistency.
10469       * std: Methods are standardizing on conventions for casting methods:
10470         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
10471         and cheap casts.
10472       * std: The `CString` type in `c_str` provides new ways to convert to and
10473         from C strings.
10474       * std: `DoubleEndedIterator` can yield elements in two directions.
10475       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
10476         two splices.
10477       * std: `str::from_bytes` renamed to `str::from_utf8`.
10478       * std: `pop_opt` and `shift_opt` methods added to vectors.
10479       * std: The task-local data interface no longer uses @, and keys are
10480         no longer function pointers.
10481       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
10482       * std: Added `SharedPort` to `comm`.
10483       * std: `Eq` has a default method for `ne`; only `eq` is required
10484         in implementations.
10485       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
10486         is required in implementations.
10487       * std: `is_utf8` performance is improved, impacting many string functions.
10488       * std: `os::MemoryMap` provides cross-platform mmap.
10489       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
10490         are not 'in-bounds' are considered undefined.
10491       * std: Many freestanding functions in `vec` removed in favor of methods.
10492       * std: Many freestanding functions on scalar types removed in favor of
10493         methods.
10494       * std: Many options to task builders were removed since they don't make
10495         sense in the new scheduler design.
10496       * std: More containers implement `FromIterator` so can be created by the
10497         `collect` method.
10498       * std: More complete atomic types in `unstable::atomics`.
10499       * std: `comm::PortSet` removed.
10500       * std: Mutating methods in the `Set` and `Map` traits have been moved into
10501         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
10502         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
10503         default implementations.
10504       * std: Various `from_str` functions were removed in favor of a generic
10505         `from_str` which is available in the prelude.
10506       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
10507       * extra: `dlist`, the doubly-linked list was modernized.
10508       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
10509       * extra: Added `glob` module, replacing `std::os::glob`.
10510       * extra: `rope` was removed.
10511       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
10512       * extra: `net`, and `timer` were removed. The experimental replacements
10513         are `std::rt::io::net` and `std::rt::io::timer`.
10514       * extra: Iterators implemented for `SmallIntMap`.
10515       * extra: Iterators implemented for `Bitv` and `BitvSet`.
10516       * extra: `SmallIntSet` removed. Use `BitvSet`.
10517       * extra: Performance of JSON parsing greatly improved.
10518       * extra: `semver` updated to SemVer 2.0.0.
10519       * extra: `term` handles more terminals correctly.
10520       * extra: `dbg` module removed.
10521       * extra: `par` module removed.
10522       * extra: `future` was cleaned up, with some method renames.
10523       * extra: Most free functions in `getopts` were converted to methods.
10524
10525    * Other
10526       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
10527       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
10528         similarly to gcc's `--march` flag.
10529       * rustc's performance compiling small crates is much better.
10530       * rustpkg has received many improvements.
10531       * rustpkg supports git tags as package IDs.
10532       * rustpkg builds into target-specific directories so it can be used for
10533         cross-compiling.
10534       * The number of concurrent test tasks is controlled by the environment
10535         variable RUST_TEST_TASKS.
10536       * The test harness can now report metrics for benchmarks.
10537       * All tools have man pages.
10538       * Programs compiled with `--test` now support the `-h` and `--help` flags.
10539       * The runtime uses jemalloc for allocations.
10540       * Segmented stacks are temporarily disabled as part of the transition to
10541         the new runtime. Stack overflows are possible!
10542       * A new documentation backend, rustdoc_ng, is available for use. It is
10543         still invoked through the normal `rustdoc` command.
10544
10545
10546 Version 0.7 (2013-07-03)
10547 =======================
10548
10549    * ~2000 changes, numerous bugfixes
10550
10551    * Language
10552       * `impl`s no longer accept a visibility qualifier. Put them on methods
10553         instead.
10554       * The borrow checker has been rewritten with flow-sensitivity, fixing
10555         many bugs and inconveniences.
10556       * The `self` parameter no longer implicitly means `&'self self`,
10557         and can be explicitly marked with a lifetime.
10558       * Overloadable compound operators (`+=`, etc.) have been temporarily
10559         removed due to bugs.
10560       * The `for` loop protocol now requires `for`-iterators to return `bool`
10561         so they compose better.
10562       * The `Durable` trait is replaced with the `'static` bounds.
10563       * Trait default methods work more often.
10564       * Structs with the `#[packed]` attribute have byte alignment and
10565         no padding between fields.
10566       * Type parameters bound by `Copy` must now be copied explicitly with
10567         the `copy` keyword.
10568       * It is now illegal to move out of a dereferenced unsafe pointer.
10569       * `Option<~T>` is now represented as a nullable pointer.
10570       * `@mut` does dynamic borrow checks correctly.
10571       * The `main` function is only detected at the topmost level of the crate.
10572         The `#[main]` attribute is still valid anywhere.
10573       * Struct fields may no longer be mutable. Use inherited mutability.
10574       * The `#[no_send]` attribute makes a type that would otherwise be
10575         `Send`, not.
10576       * The `#[no_freeze]` attribute makes a type that would otherwise be
10577         `Freeze`, not.
10578       * Unbounded recursion will abort the process after reaching the limit
10579         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
10580       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
10581         are never implicitly copyable.
10582       * `#[static_assert]` makes compile-time assertions about static bools.
10583       * At long last, 'argument modes' no longer exist.
10584       * The rarely used `use mod` statement no longer exists.
10585
10586    * Syntax extensions
10587       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
10588         argument list.
10589       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
10590         `Rand`, `Zero` and `ToStr` can all be automatically derived with
10591         `#[deriving(...)]`.
10592       * The `bytes!` macro returns a vector of bytes for string, u8, char,
10593         and unsuffixed integer literals.
10594
10595    * Libraries
10596       * The `core` crate was renamed to `std`.
10597       * The `std` crate was renamed to `extra`.
10598       * More and improved documentation.
10599       * std: `iterator` module for external iterator objects.
10600       * Many old-style (internal, higher-order function) iterators replaced by
10601         implementations of `Iterator`.
10602       * std: Many old internal vector and string iterators,
10603         incl. `any`, `all`. removed.
10604       * std: The `finalize` method of `Drop` renamed to `drop`.
10605       * std: The `drop` method now takes `&mut self` instead of `&self`.
10606       * std: The prelude no longer re-exports any modules, only types and traits.
10607       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
10608         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
10609       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
10610         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
10611       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
10612         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
10613       * std: Many types implement `Clone`.
10614       * std: `path` type renamed to `Path`.
10615       * std: `mut` module and `Mut` type removed.
10616       * std: Many standalone functions removed in favor of methods and iterators
10617         in `vec`, `str`. In the future methods will also work as functions.
10618       * std: `reinterpret_cast` removed. Use `transmute`.
10619       * std: ascii string handling in `std::ascii`.
10620       * std: `Rand` is implemented for ~/@.
10621       * std: `run` module for spawning processes overhauled.
10622       * std: Various atomic types added to `unstable::atomic`.
10623       * std: Various types implement `Zero`.
10624       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
10625       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
10626       * std: Added `os::mkdir_recursive`.
10627       * std: Added `os::glob` function performs filesystems globs.
10628       * std: `FuzzyEq` renamed to `ApproxEq`.
10629       * std: `Map` now defines `pop` and `swap` methods.
10630       * std: `Cell` constructors converted to static methods.
10631       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
10632       * extra: `flate` module moved from `std` to `extra`.
10633       * extra: `fileinput` module for iterating over a series of files.
10634       * extra: `Complex` number type and `complex` module.
10635       * extra: `Rational` number type and `rational` module.
10636       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
10637       * extra: `term` uses terminfo now, is more correct.
10638       * extra: `arc` functions converted to methods.
10639       * extra: Implementation of fixed output size variations of SHA-2.
10640
10641    * Tooling
10642       * `unused_variables` lint mode for unused variables (default: warn).
10643       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
10644         (default: warn).
10645       * `unused_mut` lint mode for identifying unused `mut` qualifiers
10646         (default: warn).
10647       * `dead_assignment` lint mode for unread variables (default: warn).
10648       * `unnecessary_allocation` lint mode detects some heap allocations that are
10649         immediately borrowed so could be written without allocating (default: warn).
10650       * `missing_doc` lint mode (default: allow).
10651       * `unreachable_code` lint mode (default: warn).
10652       * The `rusti` command has been rewritten and a number of bugs addressed.
10653       * rustc outputs in color on more terminals.
10654       * rustc accepts a `--link-args` flag to pass arguments to the linker.
10655       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
10656       * Compiling with `-g` will make the binary record information about
10657         dynamic borrowcheck failures for debugging.
10658       * rustdoc has a nicer stylesheet.
10659       * Various improvements to rustdoc.
10660       * Improvements to rustpkg (see the detailed release notes).
10661
10662
10663 Version 0.6 (2013-04-03)
10664 ========================
10665
10666    * ~2100 changes, numerous bugfixes
10667
10668    * Syntax changes
10669       * The self type parameter in traits is now spelled `Self`
10670       * The `self` parameter in trait and impl methods must now be explicitly
10671         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
10672       * Static methods no longer require the `static` keyword and instead
10673         are distinguished by the lack of a `self` parameter
10674       * Replaced the `Durable` trait with the `'static` lifetime
10675       * The old closure type syntax with the trailing sigil has been
10676         removed in favor of the more consistent leading sigil
10677       * `super` is a keyword, and may be prefixed to paths
10678       * Trait bounds are separated with `+` instead of whitespace
10679       * Traits are implemented with `impl Trait for Type`
10680         instead of `impl Type: Trait`
10681       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
10682       * The `export` keyword has finally been removed
10683       * The `move` keyword has been removed (see "Semantic changes")
10684       * The interior mutability qualifier on vectors, `[mut T]`, has been
10685         removed. Use `&mut [T]`, etc.
10686       * `mut` is no longer valid in `~mut T`. Use inherited mutability
10687       * `fail` is no longer a keyword. Use `fail!()`
10688       * `assert` is no longer a keyword. Use `assert!()`
10689       * `log` is no longer a keyword. use `debug!`, etc.
10690       * 1-tuples may be represented as `(T,)`
10691       * Struct fields may no longer be `mut`. Use inherited mutability,
10692         `@mut T`, `core::mut` or `core::cell`
10693       * `extern mod { ... }` is no longer valid syntax for foreign
10694         function modules. Use extern blocks: `extern { ... }`
10695       * Newtype enums removed. Use tuple-structs.
10696       * Trait implementations no longer support visibility modifiers
10697       * Pattern matching over vectors improved and expanded
10698       * `const` renamed to `static` to correspond to lifetime name,
10699         and make room for future `static mut` unsafe mutable globals.
10700       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
10701       * `Clone` implementations can be automatically generated with
10702         `#[deriving(Clone)]`
10703       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
10704         instead of `foo as Bar`.
10705       * Fixed length vector types are now written as `[int, .. 3]`
10706         instead of `[int * 3]`.
10707       * Fixed length vector types can express the length as a constant
10708         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
10709
10710    * Semantic changes
10711       * Types with owned pointers or custom destructors move by default,
10712         eliminating the `move` keyword
10713       * All foreign functions are considered unsafe
10714       * &mut is now unaliasable
10715       * Writes to borrowed @mut pointers are prevented dynamically
10716       * () has size 0
10717       * The name of the main function can be customized using #[main]
10718       * The default type of an inferred closure is &fn instead of @fn
10719       * `use` statements may no longer be "chained" - they cannot import
10720         identifiers imported by previous `use` statements
10721       * `use` statements are crate relative, importing from the "top"
10722         of the crate by default. Paths may be prefixed with `super::`
10723         or `self::` to change the search behavior.
10724       * Method visibility is inherited from the implementation declaration
10725       * Structural records have been removed
10726       * Many more types can be used in static items, including enums
10727         'static-lifetime pointers and vectors
10728       * Pattern matching over vectors improved and expanded
10729       * Typechecking of closure types has been overhauled to
10730         improve inference and eliminate unsoundness
10731       * Macros leave scope at the end of modules, unless that module is
10732         tagged with #[macro_escape]
10733
10734    * Libraries
10735       * Added big integers to `std::bigint`
10736       * Removed `core::oldcomm` module
10737       * Added pipe-based `core::comm` module
10738       * Numeric traits have been reorganized under `core::num`
10739       * `vec::slice` finally returns a slice
10740       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
10741       * Containers reorganized around traits in `core::container`
10742       * `core::dvec` removed, `~[T]` is a drop-in replacement
10743       * `core::send_map` renamed to `core::hashmap`
10744       * `std::map` removed; replaced with `core::hashmap`
10745       * `std::treemap` reimplemented as an owned balanced tree
10746       * `std::deque` and `std::smallintmap` reimplemented as owned containers
10747       * `core::trie` added as a fast ordered map for integer keys
10748       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
10749       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
10750         overload the comparison operators, whereas `TotalOrd` is used
10751         by certain container types
10752
10753    * Other
10754       * Replaced the 'cargo' package manager with 'rustpkg'
10755       * Added all-purpose 'rust' tool
10756       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
10757       * rustc now *attempts* to offer spelling suggestions
10758       * Improved support for ARM and Android
10759       * Preliminary MIPS backend
10760       * Improved foreign function ABI implementation for x86, x86_64
10761       * Various memory usage improvements
10762       * Rust code may be embedded in foreign code under limited circumstances
10763       * Inline assembler supported by new asm!() syntax extension.
10764
10765
10766 Version 0.5 (2012-12-21)
10767 ===========================
10768
10769    * ~900 changes, numerous bugfixes
10770
10771    * Syntax changes
10772       * Removed `<-` move operator
10773       * Completed the transition from the `#fmt` extension syntax to `fmt!`
10774       * Removed old fixed length vector syntax - `[T]/N`
10775       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
10776       * Macros may now expand to items and statements
10777       * `a.b()` is always parsed as a method call, never as a field projection
10778       * `Eq` and `IterBytes` implementations can be automatically generated
10779         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
10780       * Removed the special crate language for `.rc` files
10781       * Function arguments may consist of any irrefutable pattern
10782
10783    * Semantic changes
10784       * `&` and `~` pointers may point to objects
10785       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
10786       * Enum variants may be structs
10787       * Destructors can be added to all nominal types with the Drop trait
10788       * Structs and nullary enum variants may be constants
10789       * Values that cannot be implicitly copied are now automatically moved
10790         without writing `move` explicitly
10791       * `&T` may now be coerced to `*T`
10792       * Coercions happen in `let` statements as well as function calls
10793       * `use` statements now take crate-relative paths
10794       * The module and type namespaces have been merged so that static
10795         method names can be resolved under the trait in which they are
10796         declared
10797
10798    * Improved support for language features
10799       * Trait inheritance works in many scenarios
10800       * More support for explicit self arguments in methods - `self`, `&self`
10801         `@self`, and `~self` all generally work as expected
10802       * Static methods work in more situations
10803       * Experimental: Traits may declare default methods for the implementations
10804         to use
10805
10806    * Libraries
10807       * New condition handling system in `core::condition`
10808       * Timsort added to `std::sort`
10809       * New priority queue, `std::priority_queue`
10810       * Pipes for serializable types, `std::flatpipes'
10811       * Serialization overhauled to be trait-based
10812       * Expanded `getopts` definitions
10813       * Moved futures to `std`
10814       * More functions are pure now
10815       * `core::comm` renamed to `oldcomm`. Still deprecated
10816       * `rustdoc` and `cargo` are libraries now
10817
10818    * Misc
10819       * Added a preliminary REPL, `rusti`
10820       * License changed from MIT to dual MIT/APL2
10821
10822
10823 Version 0.4 (2012-10-15)
10824 ==========================
10825
10826    * ~2000 changes, numerous bugfixes
10827
10828    * Syntax
10829       * All keywords are now strict and may not be used as identifiers anywhere
10830       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
10831         'of', 'with', 'to', 'class'.
10832       * Classes are replaced with simpler structs
10833       * Explicit method self types
10834       * `ret` became `return` and `alt` became `match`
10835       * `import` is now `use`; `use is now `extern mod`
10836       * `extern mod { ... }` is now `extern { ... }`
10837       * `use mod` is the recommended way to import modules
10838       * `pub` and `priv` replace deprecated export lists
10839       * The syntax of `match` pattern arms now uses fat arrow (=>)
10840       * `main` no longer accepts an args vector; use `os::args` instead
10841
10842    * Semantics
10843       * Trait implementations are now coherent, ala Haskell typeclasses
10844       * Trait methods may be static
10845       * Argument modes are deprecated
10846       * Borrowed pointers are much more mature and recommended for use
10847       * Strings and vectors in the static region are stored in constant memory
10848       * Typestate was removed
10849       * Resolution rewritten to be more reliable
10850       * Support for 'dual-mode' data structures (freezing and thawing)
10851
10852    * Libraries
10853       * Most binary operators can now be overloaded via the traits in
10854         `core::ops'
10855       * `std::net::url` for representing URLs
10856       * Sendable hash maps in `core::send_map`
10857       * `core::task' gained a (currently unsafe) task-local storage API
10858
10859    * Concurrency
10860       * An efficient new intertask communication primitive called the pipe,
10861         along with a number of higher-level channel types, in `core::pipes`
10862       * `std::arc`, an atomically reference counted, immutable, shared memory
10863         type
10864       * `std::sync`, various exotic synchronization tools based on arcs and pipes
10865       * Futures are now based on pipes and sendable
10866       * More robust linked task failure
10867       * Improved task builder API
10868
10869    * Other
10870       * Improved error reporting
10871       * Preliminary JIT support
10872       * Preliminary work on precise GC
10873       * Extensive architectural improvements to rustc
10874       * Begun a transition away from buggy C++-based reflection (shape) code to
10875         Rust-based (visitor) code
10876       * All hash functions and tables converted to secure, randomized SipHash
10877
10878
10879 Version 0.3  (2012-07-12)
10880 ========================
10881
10882    * ~1900 changes, numerous bugfixes
10883
10884    * New coding conveniences
10885       * Integer-literal suffix inference
10886       * Per-item control over warnings, errors
10887       * #[cfg(windows)] and #[cfg(unix)] attributes
10888       * Documentation comments
10889       * More compact closure syntax
10890       * 'do' expressions for treating higher-order functions as
10891         control structures
10892       * *-patterns (wildcard extended to all constructor fields)
10893
10894    * Semantic cleanup
10895       * Name resolution pass and exhaustiveness checker rewritten
10896       * Region pointers and borrow checking supersede alias
10897         analysis
10898       * Init-ness checking is now provided by a region-based liveness
10899         pass instead of the typestate pass; same for last-use analysis
10900       * Extensive work on region pointers
10901
10902    * Experimental new language features
10903       * Slices and fixed-size, interior-allocated vectors
10904       * #!-comments for lang versioning, shell execution
10905       * Destructors and iface implementation for classes;
10906         type-parameterized classes and class methods
10907       * 'const' type kind for types that can be used to implement
10908         shared-memory concurrency patterns
10909
10910    * Type reflection
10911
10912    * Removal of various obsolete features
10913       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
10914                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
10915
10916       * Constructs: do-while loops ('do' repurposed), fn binding,
10917                     resources (replaced by destructors)
10918
10919    * Compiler reorganization
10920       * Syntax-layer of compiler split into separate crate
10921       * Clang (from LLVM project) integrated into build
10922       * Typechecker split into sub-modules
10923
10924    * New library code
10925       * New time functions
10926       * Extension methods for many built-in types
10927       * Arc: atomic-refcount read-only / exclusive-use shared cells
10928       * Par: parallel map and search routines
10929       * Extensive work on libuv interface
10930       * Much vector code moved to libraries
10931       * Syntax extensions: #line, #col, #file, #mod, #stringify,
10932         #include, #include_str, #include_bin
10933
10934    * Tool improvements
10935       * Cargo automatically resolves dependencies
10936
10937
10938 Version 0.2  (2012-03-29)
10939 =========================
10940
10941    * >1500 changes, numerous bugfixes
10942
10943    * New docs and doc tooling
10944
10945    * New port: FreeBSD x86_64
10946
10947    * Compilation model enhancements
10948       * Generics now specialized, multiply instantiated
10949       * Functions now inlined across separate crates
10950
10951    * Scheduling, stack and threading fixes
10952       * Noticeably improved message-passing performance
10953       * Explicit schedulers
10954       * Callbacks from C
10955       * Helgrind clean
10956
10957    * Experimental new language features
10958       * Operator overloading
10959       * Region pointers
10960       * Classes
10961
10962    * Various language extensions
10963       * C-callback function types: 'crust fn ...'
10964       * Infinite-loop construct: 'loop { ... }'
10965       * Shorten 'mutable' to 'mut'
10966       * Required mutable-local qualifier: 'let mut ...'
10967       * Basic glob-exporting: 'export foo::*;'
10968       * Alt now exhaustive, 'alt check' for runtime-checked
10969       * Block-function form of 'for' loop, with 'break' and 'ret'.
10970
10971    * New library code
10972       * AST quasi-quote syntax extension
10973       * Revived libuv interface
10974       * New modules: core::{future, iter}, std::arena
10975       * Merged per-platform std::{os*, fs*} to core::{libc, os}
10976       * Extensive cleanup, regularization in libstd, libcore
10977
10978
10979 Version 0.1  (2012-01-20)
10980 ===============================
10981
10982    * Most language features work, including:
10983       * Unique pointers, unique closures, move semantics
10984       * Interface-constrained generics
10985       * Static interface dispatch
10986       * Stack growth
10987       * Multithread task scheduling
10988       * Typestate predicates
10989       * Failure unwinding, destructors
10990       * Pattern matching and destructuring assignment
10991       * Lightweight block-lambda syntax
10992       * Preliminary macro-by-example
10993
10994    * Compiler works with the following configurations:
10995       * Linux: x86 and x86_64 hosts and targets
10996       * macOS: x86 and x86_64 hosts and targets
10997       * Windows: x86 hosts and targets
10998
10999    * Cross compilation / multi-target configuration supported.
11000
11001    * Preliminary API-documentation and package-management tools included.
11002
11003 Known issues:
11004
11005    * Documentation is incomplete.
11006
11007    * Performance is below intended target.
11008
11009    * Standard library APIs are subject to extensive change, reorganization.
11010
11011    * Language-level versioning is not yet operational - future code will
11012      break unexpectedly.