RELEASES.md

   1 Version 1.58.0 (2022-01-13)
   2 ==========================
   3
   4 Language
   5 --------
   6
   7 - [Format strings can now capture arguments simply by writing `{ident}` in the string.][90473] This works in all macros accepting format strings. Support for this in `panic!` (`panic!("{ident}")`) requires the 2021 edition; panic invocations in previous editions that appear to be trying to use this will result in a warning lint about not having the intended effect.
   8 - [`*const T` pointers can now be dereferenced in const contexts.][89551]
   9 - [The rules for when a generic struct implements `Unsize` have been relaxed.][90417]
  10
  11 Compiler
  12 --------
  13
  14 - [Add LLVM CFI support to the Rust compiler][89652]
  15 - [Stabilize -Z strip as -C strip][90058]. Note that while release builds already don't add debug symbols for the code you compile, the compiled standard library that ships with Rust includes debug symbols, so you may want to use the `strip` option to remove these symbols to produce smaller release binaries. Note that this release only includes support in rustc, not directly in cargo.
  16 - [Add support for LLVM coverage mapping format versions 5 and 6][91207]
  17 - [Emit LLVM optimization remarks when enabled with `-Cremark`][90833]
  18 - [Update the minimum external LLVM to 12][90175]
  19 - [Add `x86_64-unknown-none` at Tier 3*][89062]
  20 - [Build musl dist artifacts with debuginfo enabled][90733]. When building release binaries using musl, you may want to use the newly stabilized strip option to remove these debug symbols, reducing the size of your binaries.
  21 - [Don't abort compilation after giving a lint error][87337]
  22 - [Error messages point at the source of trait bound obligations in more places][89580]
  23
  24 \* Refer to Rust's [platform support page][platform-support-doc] for more
  25    information on Rust's tiered platform support.
  26
  27 Libraries
  28 ---------
  29
  30 - [All remaining functions in the standard library have `#[must_use]` annotations where appropriate][89692], producing a warning when ignoring their return value. This helps catch mistakes such as expecting a function to mutate a value in place rather than return a new value.
  31 - [Paths are automatically canonicalized on Windows for operations that support it][89174]
  32 - [Re-enable debug checks for `copy` and `copy_nonoverlapping`][90041]
  33 - [Implement `RefUnwindSafe` for `Rc<T>`][87467]
  34 - [Make RSplit<T, P>: Clone not require T: Clone][90117]
  35 - [Implement `Termination` for `Result<Infallible, E>`][88601]. This allows writing `fn main() -> Result<Infallible, ErrorType>`, for a program whose successful exits never involve returning from `main` (for instance, a program that calls `exit`, or that uses `exec` to run another program).
  36
  37 Stabilized APIs
  38 ---------------
  39
  40 - [`Metadata::is_symlink`]
  41 - [`Path::is_symlink`]
  42 - [`{integer}::saturating_div`]
  43 - [`Option::unwrap_unchecked`]
  44 - [`Result::unwrap_unchecked`]
  45 - [`Result::unwrap_err_unchecked`]
  46 - [`File::options`]
  47
  48 These APIs are now usable in const contexts:
  49
  50 - [`Duration::new`]
  51 - [`Duration::checked_add`]
  52 - [`Duration::saturating_add`]
  53 - [`Duration::checked_sub`]
  54 - [`Duration::saturating_sub`]
  55 - [`Duration::checked_mul`]
  56 - [`Duration::saturating_mul`]
  57 - [`Duration::checked_div`]
  58
  59 Cargo
  60 -----
  61
  62 - [Add --message-format for install command][cargo/10107]
  63 - [Warn when alias shadows external subcommand][cargo/10082]
  64
  65 Rustdoc
  66 -------
  67
  68 - [Show all Deref implementations recursively in rustdoc][90183]
  69 - [Use computed visibility in rustdoc][88447]
  70
  71 Compatibility Notes
  72 -------------------
  73
  74 - [Try all stable method candidates first before trying unstable ones][90329]. This change ensures that adding new nightly-only methods to the Rust standard library will not break code invoking methods of the same name from traits outside the standard library.
  75 - Windows: [`std::process::Command` will no longer search the current directory for executables.][87704]
  76 - [All proc-macro backward-compatibility lints are now deny-by-default.][88041]
  77 - [proc_macro: Append .0 to unsuffixed float if it would otherwise become int token][90297]
  78 - [Refactor weak symbols in std::sys::unix][90846]. This optimizes accesses to glibc functions, by avoiding the use of dlopen. This does not increase the [minimum expected version of glibc](https://doc.rust-lang.org/nightly/rustc/platform-support.html). However, software distributions that use symbol versions to detect library dependencies, and which take weak symbols into account in that analysis, may detect rust binaries as requiring newer versions of glibc.
  79 - [rustdoc now rejects some unexpected semicolons in doctests][91026]
  80
  81 Internal Changes
  82 ----------------
  83
  84 These changes provide no direct user facing benefits, but represent significant
  85 improvements to the internals and overall performance of rustc
  86 and related tools.
  87
  88 - [Implement coherence checks for negative trait impls][90104]
  89 - [Add rustc lint, warning when iterating over hashmaps][89558]
  90 - [Optimize live point computation][90491]
  91 - [Enable verification for 1/32nd of queries loaded from disk][90361]
  92 - [Implement version of normalize_erasing_regions that allows for normalization failure][91255]
  93
  94 [87337]: https://github.com/rust-lang/rust/pull/87337/
  95 [87467]: https://github.com/rust-lang/rust/pull/87467/
  96 [87704]: https://github.com/rust-lang/rust/pull/87704/
  97 [88041]: https://github.com/rust-lang/rust/pull/88041/
  98 [88447]: https://github.com/rust-lang/rust/pull/88447/
  99 [88601]: https://github.com/rust-lang/rust/pull/88601/
 100 [89062]: https://github.com/rust-lang/rust/pull/89062/
 101 [89174]: https://github.com/rust-lang/rust/pull/89174/
 102 [89551]: https://github.com/rust-lang/rust/pull/89551/
 103 [89558]: https://github.com/rust-lang/rust/pull/89558/
 104 [89580]: https://github.com/rust-lang/rust/pull/89580/
 105 [89652]: https://github.com/rust-lang/rust/pull/89652/
 106 [90041]: https://github.com/rust-lang/rust/pull/90041/
 107 [90058]: https://github.com/rust-lang/rust/pull/90058/
 108 [90104]: https://github.com/rust-lang/rust/pull/90104/
 109 [90117]: https://github.com/rust-lang/rust/pull/90117/
 110 [90175]: https://github.com/rust-lang/rust/pull/90175/
 111 [90183]: https://github.com/rust-lang/rust/pull/90183/
 112 [90297]: https://github.com/rust-lang/rust/pull/90297/
 113 [90329]: https://github.com/rust-lang/rust/pull/90329/
 114 [90361]: https://github.com/rust-lang/rust/pull/90361/
 115 [90417]: https://github.com/rust-lang/rust/pull/90417/
 116 [90473]: https://github.com/rust-lang/rust/pull/90473/
 117 [90491]: https://github.com/rust-lang/rust/pull/90491/
 118 [90733]: https://github.com/rust-lang/rust/pull/90733/
 119 [90833]: https://github.com/rust-lang/rust/pull/90833/
 120 [90846]: https://github.com/rust-lang/rust/pull/90846/
 121 [91026]: https://github.com/rust-lang/rust/pull/91026/
 122 [91207]: https://github.com/rust-lang/rust/pull/91207/
 123 [91255]: https://github.com/rust-lang/rust/pull/91255/
 124 [cargo/10082]: https://github.com/rust-lang/cargo/pull/10082/
 125 [cargo/10107]: https://github.com/rust-lang/cargo/pull/10107/
 126 [`Metadata::is_symlink`]: https://doc.rust-lang.org/stable/std/fs/struct.Metadata.html#method.is_symlink
 127 [`Path::is_symlink`]: https://doc.rust-lang.org/stable/std/path/struct.Path.html#method.is_symlink
 128 [`{integer}::saturating_div`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.saturating_div
 129 [`Option::unwrap_unchecked`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.unwrap_unchecked
 130 [`Result::unwrap_unchecked`]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.unwrap_unchecked
 131 [`Result::unwrap_err_unchecked`]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.unwrap_err_unchecked
 132 [`File::options`]: https://doc.rust-lang.org/stable/std/fs/struct.File.html#method.options
 133 [`Duration::new`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.new
 134
 135 Version 1.57.0 (2021-12-02)
 136 ==========================
 137
 138 Language
 139 --------
 140
 141 - [Macro attributes may follow `#[derive]` and will see the original (pre-`cfg`) input.][87220]
 142 - [Accept curly-brace macros in expressions, like `m!{ .. }.method()` and `m!{ .. }?`.][88690]
 143 - [Allow panicking in constant evaluation.][89508]
 144
 145 Compiler
 146 --------
 147
 148 - [Create more accurate debuginfo for vtables.][89597]
 149 - [Add `armv6k-nintendo-3ds` at Tier 3\*.][88529]
 150 - [Add `armv7-unknown-linux-uclibceabihf` at Tier 3\*.][88952]
 151 - [Add `m68k-unknown-linux-gnu` at Tier 3\*.][88321]
 152 - [Add SOLID targets at Tier 3\*:][86191] `aarch64-kmc-solid_asp3`, `armv7a-kmc-solid_asp3-eabi`, `armv7a-kmc-solid_asp3-eabihf`
 153
 154 \* Refer to Rust's [platform support page][platform-support-doc] for more
 155    information on Rust's tiered platform support.
 156
 157 Libraries
 158 ---------
 159
 160 - [Avoid allocations and copying in `Vec::leak`][89337]
 161 - [Add `#[repr(i8)]` to `Ordering`][89507]
 162 - [Optimize `File::read_to_end` and `read_to_string`][89582]
 163 - [Update to Unicode 14.0][89614]
 164 - [Many more functions are marked `#[must_use]`][89692], producing a warning
 165   when ignoring their return value. This helps catch mistakes such as expecting
 166   a function to mutate a value in place rather than return a new value.
 167
 168 Stabilised APIs
 169 ---------------
 170
 171 - [`[T; N]::as_mut_slice`][`array::as_mut_slice`]
 172 - [`[T; N]::as_slice`][`array::as_slice`]
 173 - [`collections::TryReserveError`]
 174 - [`HashMap::try_reserve`]
 175 - [`HashSet::try_reserve`]
 176 - [`String::try_reserve`]
 177 - [`String::try_reserve_exact`]
 178 - [`Vec::try_reserve`]
 179 - [`Vec::try_reserve_exact`]
 180 - [`VecDeque::try_reserve`]
 181 - [`VecDeque::try_reserve_exact`]
 182 - [`Iterator::map_while`]
 183 - [`iter::MapWhile`]
 184 - [`proc_macro::is_available`]
 185 - [`Command::get_program`]
 186 - [`Command::get_args`]
 187 - [`Command::get_envs`]
 188 - [`Command::get_current_dir`]
 189 - [`CommandArgs`]
 190 - [`CommandEnvs`]
 191
 192 These APIs are now usable in const contexts:
 193
 194 - [`hint::unreachable_unchecked`]
 195
 196 Cargo
 197 -----
 198
 199 - [Stabilize custom profiles][cargo/9943]
 200
 201 Compatibility notes
 202 -------------------
 203
 204 Internal changes
 205 ----------------
 206 These changes provide no direct user facing benefits, but represent significant
 207 improvements to the internals and overall performance of rustc
 208 and related tools.
 209
 210 - [Added an experimental backend for codegen with `libgccjit`.][87260]
 211
 212 [86191]: https://github.com/rust-lang/rust/pull/86191/
 213 [87220]: https://github.com/rust-lang/rust/pull/87220/
 214 [87260]: https://github.com/rust-lang/rust/pull/87260/
 215 [88321]: https://github.com/rust-lang/rust/pull/88321/
 216 [88529]: https://github.com/rust-lang/rust/pull/88529/
 217 [88690]: https://github.com/rust-lang/rust/pull/88690/
 218 [88952]: https://github.com/rust-lang/rust/pull/88952/
 219 [89337]: https://github.com/rust-lang/rust/pull/89337/
 220 [89507]: https://github.com/rust-lang/rust/pull/89507/
 221 [89508]: https://github.com/rust-lang/rust/pull/89508/
 222 [89582]: https://github.com/rust-lang/rust/pull/89582/
 223 [89597]: https://github.com/rust-lang/rust/pull/89597/
 224 [89614]: https://github.com/rust-lang/rust/pull/89614/
 225 [89692]: https://github.com/rust-lang/rust/issues/89692/
 226 [cargo/9943]: https://github.com/rust-lang/cargo/pull/9943/
 227 [`array::as_mut_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_mut_slice
 228 [`array::as_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_slice
 229 [`collections::TryReserveError`]: https://doc.rust-lang.org/std/collections/struct.TryReserveError.html
 230 [`HashMap::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_map/struct.HashMap.html#method.try_reserve
 231 [`HashSet::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_set/struct.HashSet.html#method.try_reserve
 232 [`String::try_reserve`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve
 233 [`String::try_reserve_exact`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve_exact
 234 [`Vec::try_reserve`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve
 235 [`Vec::try_reserve_exact`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve_exact
 236 [`VecDeque::try_reserve`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve
 237 [`VecDeque::try_reserve_exact`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve_exact
 238 [`Iterator::map_while`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.map_while
 239 [`iter::MapWhile`]: https://doc.rust-lang.org/std/iter/struct.MapWhile.html
 240 [`proc_macro::is_available`]: https://doc.rust-lang.org/proc_macro/fn.is_available.html
 241 [`Command::get_program`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_program
 242 [`Command::get_args`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_args
 243 [`Command::get_envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_envs
 244 [`Command::get_current_dir`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_current_dir
 245 [`CommandArgs`]: https://doc.rust-lang.org/std/process/struct.CommandArgs.html
 246 [`CommandEnvs`]: https://doc.rust-lang.org/std/process/struct.CommandEnvs.html
 247
 248 Version 1.56.1 (2021-11-01)
 249 ===========================
 250
 251 - New lints to detect the presence of bidirectional-override Unicode
 252   codepoints in the compiled source code ([CVE-2021-42574])
 253
 254 [CVE-2021-42574]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-42574
 255
 256 Version 1.56.0 (2021-10-21)
 257 ========================
 258
 259 Language
 260 --------
 261
 262 - [The 2021 Edition is now stable.][rust#88100]
 263   See [the edition guide][rust-2021-edition-guide] for more details.
 264 - [The pattern in `binding @ pattern` can now also introduce new bindings.][rust#85305]
 265 - [Union field access is permitted in `const fn`.][rust#85769]
 266
 267 [rust-2021-edition-guide]: https://doc.rust-lang.org/nightly/edition-guide/rust-2021/index.html
 268
 269 Compiler
 270 --------
 271
 272 - [Upgrade to LLVM 13.][rust#87570]
 273 - [Support memory, address, and thread sanitizers on aarch64-unknown-freebsd.][rust#88023]
 274 - [Allow specifying a deployment target version for all iOS targets][rust#87699]
 275 - [Warnings can be forced on with `--force-warn`.][rust#87472]
 276   This feature is primarily intended for usage by `cargo fix`, rather than end users.
 277 - [Promote `aarch64-apple-ios-sim` to Tier 2\*.][rust#87760]
 278 - [Add `powerpc-unknown-freebsd` at Tier 3\*.][rust#87370]
 279 - [Add `riscv32imc-esp-espidf` at Tier 3\*.][rust#87666]
 280
 281 \* Refer to Rust's [platform support page][platform-support-doc] for more
 282 information on Rust's tiered platform support.
 283
 284 Libraries
 285 ---------
 286
 287 - [Allow writing of incomplete UTF-8 sequences via stdout/stderr on Windows.][rust#83342]
 288   The Windows console still requires valid Unicode, but this change allows
 289   splitting a UTF-8 character across multiple write calls. This allows, for
 290   instance, programs that just read and write data buffers (e.g. copying a file
 291   to stdout) without regard for Unicode or character boundaries.
 292 - [Prefer `AtomicU{64,128}` over Mutex for Instant backsliding protection.][rust#83093]
 293   For this use case, atomics scale much better under contention.
 294 - [Implement `Extend<(A, B)>` for `(Extend<A>, Extend<B>)`][rust#85835]
 295 - [impl Default, Copy, Clone for std::io::Sink and std::io::Empty][rust#86744]
 296 - [`impl From<[(K, V); N]>` for all collections.][rust#84111]
 297 - [Remove `P: Unpin` bound on impl Future for Pin.][rust#81363]
 298 - [Treat invalid environment variable names as non-existent.][rust#86183]
 299   Previously, the environment functions would panic if given a variable name
 300   with an internal null character or equal sign (`=`). Now, these functions will
 301   just treat such names as non-existent variables, since the OS cannot represent
 302   the existence of a variable with such a name.
 303
 304 Stabilised APIs
 305 ---------------
 306
 307 - [`std::os::unix::fs::chroot`]
 308 - [`UnsafeCell::raw_get`]
 309 - [`BufWriter::into_parts`]
 310 - [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]
 311   These APIs were previously stable in `std`, but are now also available in `core`.
 312 - [`Vec::shrink_to`]
 313 - [`String::shrink_to`]
 314 - [`OsString::shrink_to`]
 315 - [`PathBuf::shrink_to`]
 316 - [`BinaryHeap::shrink_to`]
 317 - [`VecDeque::shrink_to`]
 318 - [`HashMap::shrink_to`]
 319 - [`HashSet::shrink_to`]
 320
 321 These APIs are now usable in const contexts:
 322
 323 - [`std::mem::transmute`]
 324 - [`[T]::first`][`slice::first`]
 325 - [`[T]::split_first`][`slice::split_first`]
 326 - [`[T]::last`][`slice::last`]
 327 - [`[T]::split_last`][`slice::split_last`]
 328
 329 Cargo
 330 -----
 331
 332 - [Cargo supports specifying a minimum supported Rust version in Cargo.toml.][`rust-version`]
 333   This has no effect at present on dependency version selection.
 334   We encourage crates to specify their minimum supported Rust version, and we encourage CI systems
 335   that support Rust code to include a crate's specified minimum version in the test matrix for that
 336   crate by default.
 337
 338 Compatibility notes
 339 -------------------
 340
 341 - [Update to new argument parsing rules on Windows.][rust#87580]
 342   This adjusts Rust's standard library to match the behavior of the standard
 343   libraries for C/C++. The rules have changed slightly over time, and this PR
 344   brings us to the latest set of rules (changed in 2008).
 345 - [Disallow the aapcs calling convention on aarch64][rust#88399]
 346   This was already not supported by LLVM; this change surfaces this lack of
 347   support with a better error message.
 348 - [Make `SEMICOLON_IN_EXPRESSIONS_FROM_MACROS` warn by default][rust#87385]
 349 - [Warn when an escaped newline skips multiple lines.][rust#87671]
 350 - [Calls to `libc::getpid` / `std::process::id` from `Command::pre_exec`
 351    may return different values on glibc <= 2.24.][rust#81825]
 352    Rust now invokes the `clone3` system call directly, when available, to use new functionality
 353    available via that system call. Older versions of glibc cache the result of `getpid`, and only
 354    update that cache when calling glibc's clone/fork functions, so a direct system call bypasses
 355    that cache update. glibc 2.25 and newer no longer cache `getpid` for exactly this reason.
 356
 357 Internal changes
 358 ----------------
 359 These changes provide no direct user facing benefits, but represent significant
 360 improvements to the internals and overall performance of rustc
 361 and related tools.
 362
 363 - [LLVM is compiled with PGO in published x86_64-unknown-linux-gnu artifacts.][rust#88069]
 364   This improves the performance of most Rust builds.
 365 - [Unify representation of macros in internal data structures.][rust#88019]
 366   This change fixes a host of bugs with the handling of macros by the compiler,
 367   as well as rustdoc.
 368
 369 [`std::os::unix::fs::chroot`]: https://doc.rust-lang.org/stable/std/os/unix/fs/fn.chroot.html
 370 [`UnsafeCell::raw_get`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.raw_get
 371 [`BufWriter::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.BufWriter.html#method.into_parts
 372 [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]: https://github.com/rust-lang/rust/pull/84662
 373 [`Vec::shrink_to`]: https://doc.rust-lang.org/stable/std/vec/struct.Vec.html#method.shrink_to
 374 [`String::shrink_to`]: https://doc.rust-lang.org/stable/std/string/struct.String.html#method.shrink_to
 375 [`OsString::shrink_to`]: https://doc.rust-lang.org/stable/std/ffi/struct.OsString.html#method.shrink_to
 376 [`PathBuf::shrink_to`]: https://doc.rust-lang.org/stable/std/path/struct.PathBuf.html#method.shrink_to
 377 [`BinaryHeap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.BinaryHeap.html#method.shrink_to
 378 [`VecDeque::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.VecDeque.html#method.shrink_to
 379 [`HashMap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_map/struct.HashMap.html#method.shrink_to
 380 [`HashSet::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_set/struct.HashSet.html#method.shrink_to
 381 [`std::mem::transmute`]: https://doc.rust-lang.org/stable/std/mem/fn.transmute.html
 382 [`slice::first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.first
 383 [`slice::split_first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_first
 384 [`slice::last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.last
 385 [`slice::split_last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_last
 386 [`rust-version`]: https://doc.rust-lang.org/nightly/cargo/reference/manifest.html#the-rust-version-field
 387 [rust#87671]: https://github.com/rust-lang/rust/pull/87671
 388 [rust#86183]: https://github.com/rust-lang/rust/pull/86183
 389 [rust#87385]: https://github.com/rust-lang/rust/pull/87385
 390 [rust#88100]: https://github.com/rust-lang/rust/pull/88100
 391 [rust#85305]: https://github.com/rust-lang/rust/pull/85305
 392 [rust#88069]: https://github.com/rust-lang/rust/pull/88069
 393 [rust#87472]: https://github.com/rust-lang/rust/pull/87472
 394 [rust#87699]: https://github.com/rust-lang/rust/pull/87699
 395 [rust#87570]: https://github.com/rust-lang/rust/pull/87570
 396 [rust#88023]: https://github.com/rust-lang/rust/pull/88023
 397 [rust#87760]: https://github.com/rust-lang/rust/pull/87760
 398 [rust#87370]: https://github.com/rust-lang/rust/pull/87370
 399 [rust#87580]: https://github.com/rust-lang/rust/pull/87580
 400 [rust#83342]: https://github.com/rust-lang/rust/pull/83342
 401 [rust#83093]: https://github.com/rust-lang/rust/pull/83093
 402 [rust#85835]: https://github.com/rust-lang/rust/pull/85835
 403 [rust#86744]: https://github.com/rust-lang/rust/pull/86744
 404 [rust#81363]: https://github.com/rust-lang/rust/pull/81363
 405 [rust#84111]: https://github.com/rust-lang/rust/pull/84111
 406 [rust#85769]: https://github.com/rust-lang/rust/pull/85769#issuecomment-854363720
 407 [rust#88399]: https://github.com/rust-lang/rust/pull/88399
 408 [rust#81825]: https://github.com/rust-lang/rust/pull/81825#issuecomment-808406918
 409 [rust#88019]: https://github.com/rust-lang/rust/pull/88019
 410 [rust#87666]: https://github.com/rust-lang/rust/pull/87666
 411
 412 Version 1.55.0 (2021-09-09)
 413 ============================
 414
 415 Language
 416 --------
 417 - [You can now write open "from" range patterns (`X..`), which will start at `X` and
 418   will end at the maximum value of the integer.][83918]
 419 - [You can now explicitly import the prelude of different editions
 420   through `std::prelude` (e.g. `use std::prelude::rust_2021::*;`).][86294]
 421
 422 Compiler
 423 --------
 424 - [Added tier 3\* support for `powerpc64le-unknown-freebsd`.][83572]
 425
 426 \* Refer to Rust's [platform support page][platform-support-doc] for more
 427    information on Rust's tiered platform support.
 428
 429 Libraries
 430 ---------
 431
 432 - [Updated std's float parsing to use the Eisel-Lemire algorithm.][86761]
 433   These improvements should in general provide faster string parsing of floats,
 434   no longer reject certain valid floating point values, and reduce
 435   the produced code size for non-stripped artifacts.
 436 - [`string::Drain` now implements `AsRef<str>` and `AsRef<[u8]>`.][86858]
 437
 438 Stabilised APIs
 439 ---------------
 440
 441 - [`Bound::cloned`]
 442 - [`Drain::as_str`]
 443 - [`IntoInnerError::into_error`]
 444 - [`IntoInnerError::into_parts`]
 445 - [`MaybeUninit::assume_init_mut`]
 446 - [`MaybeUninit::assume_init_ref`]
 447 - [`MaybeUninit::write`]
 448 - [`array::map`]
 449 - [`ops::ControlFlow`]
 450 - [`x86::_bittest`]
 451 - [`x86::_bittestandcomplement`]
 452 - [`x86::_bittestandreset`]
 453 - [`x86::_bittestandset`]
 454 - [`x86_64::_bittest64`]
 455 - [`x86_64::_bittestandcomplement64`]
 456 - [`x86_64::_bittestandreset64`]
 457 - [`x86_64::_bittestandset64`]
 458
 459 The following previously stable functions are now `const`.
 460
 461 - [`str::from_utf8_unchecked`]
 462
 463
 464 Cargo
 465 -----
 466 - [Cargo will now deduplicate compiler diagnostics to the terminal when invoking
 467   rustc in parallel such as when using `cargo test`.][cargo/9675]
 468 - [The package definition in `cargo metadata` now includes the `"default_run"`
 469   field from the manifest.][cargo/9550]
 470 - [Added `cargo d` as an alias for `cargo doc`.][cargo/9680]
 471 - [Added `{lib}` as formatting option for `cargo tree` to print the `"lib_name"`
 472   of packages.][cargo/9663]
 473
 474 Rustdoc
 475 -------
 476 - [Added "Go to item on exact match" search option.][85876]
 477 - [The "Implementors" section on traits no longer shows redundant
 478   method definitions.][85970]
 479 - [Trait implementations are toggled open by default.][86260] This should make the
 480   implementations more searchable by tools like `CTRL+F` in your browser.
 481 - [Intra-doc links should now correctly resolve associated items (e.g. methods)
 482   through type aliases.][86334]
 483 - [Traits which are marked with `#[doc(hidden)]` will no longer appear in the
 484   "Trait Implementations" section.][86513]
 485
 486
 487 Compatibility Notes
 488 -------------------
 489 - [std functions that return an `io::Error` will no longer use the
 490   `ErrorKind::Other` variant.][85746] This is to better reflect that these
 491   kinds of errors could be categorised [into newer more specific `ErrorKind`
 492   variants][79965], and that they do not represent a user error.
 493 - [Using environment variable names with `process::Command` on Windows now
 494   behaves as expected.][85270] Previously using envionment variables with
 495   `Command` would cause them to be ASCII-uppercased.
 496 - [Rustdoc will now warn on using rustdoc lints that aren't prefixed
 497   with `rustdoc::`][86849]
 498 - `RUSTFLAGS` is no longer set for build scripts. Build scripts
 499   should use `CARGO_ENCODED_RUSTFLAGS` instead. See the
 500   [documentation](https://doc.rust-lang.org/nightly/cargo/reference/environment-variables.html#environment-variables-cargo-sets-for-build-scripts)
 501   for more details.
 502
 503 [86849]: https://github.com/rust-lang/rust/pull/86849
 504 [86513]: https://github.com/rust-lang/rust/pull/86513
 505 [86334]: https://github.com/rust-lang/rust/pull/86334
 506 [86260]: https://github.com/rust-lang/rust/pull/86260
 507 [85970]: https://github.com/rust-lang/rust/pull/85970
 508 [85876]: https://github.com/rust-lang/rust/pull/85876
 509 [83572]: https://github.com/rust-lang/rust/pull/83572
 510 [86294]: https://github.com/rust-lang/rust/pull/86294
 511 [86858]: https://github.com/rust-lang/rust/pull/86858
 512 [86761]: https://github.com/rust-lang/rust/pull/86761
 513 [85746]: https://github.com/rust-lang/rust/pull/85746
 514 [85270]: https://github.com/rust-lang/rust/pull/85270
 515 [83918]: https://github.com/rust-lang/rust/pull/83918
 516 [79965]: https://github.com/rust-lang/rust/pull/79965
 517 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
 518 [cargo/9675]: https://github.com/rust-lang/cargo/pull/9675
 519 [cargo/9550]: https://github.com/rust-lang/cargo/pull/9550
 520 [cargo/9680]: https://github.com/rust-lang/cargo/pull/9680
 521 [`array::map`]: https://doc.rust-lang.org/stable/std/primitive.array.html#method.map
 522 [`Bound::cloned`]: https://doc.rust-lang.org/stable/std/ops/enum.Bound.html#method.cloned
 523 [`Drain::as_str`]: https://doc.rust-lang.org/stable/std/string/struct.Drain.html#method.as_str
 524 [`IntoInnerError::into_error`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_error
 525 [`IntoInnerError::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_parts
 526 [`MaybeUninit::assume_init_mut`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_mut
 527 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
 528 [`MaybeUninit::write`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.write
 529 [`ops::ControlFlow`]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html
 530 [`str::from_utf8_unchecked`]: https://doc.rust-lang.org/stable/std/str/fn.from_utf8_unchecked.html
 531 [`x86::_bittest`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittest.html
 532 [`x86::_bittestandcomplement`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandcomplement.html
 533 [`x86::_bittestandreset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandreset.html
 534 [`x86::_bittestandset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandset.html
 535 [`x86_64::_bittest64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittest64.html
 536 [`x86_64::_bittestandcomplement64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandcomplement64.html
 537 [`x86_64::_bittestandreset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandreset64.html
 538 [`x86_64::_bittestandset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandset64.html
 539
 540
 541 Version 1.54.0 (2021-07-29)
 542 ============================
 543
 544 Language
 545 -----------------------
 546
 547 - [You can now use macros for values in some built-in attributes.][83366]
 548   This primarily allows you to call macros within the `#[doc]` attribute. For
 549   example, to include external documentation in your crate, you can now write
 550   the following:
 551   ```rust
 552   #![doc = include_str!("README.md")]
 553   ```
 554
 555 - [You can now cast between unsized slice types (and types which contain
 556   unsized slices) in `const fn`.][85078]
 557 - [You can now use multiple generic lifetimes with `impl Trait` where the
 558    lifetimes don't explicitly outlive another.][84701] In code this means
 559    that you can now have `impl Trait<'a, 'b>` where as before you could
 560    only have `impl Trait<'a, 'b> where 'b: 'a`.
 561
 562 Compiler
 563 -----------------------
 564
 565 - [Rustc will now search for custom JSON targets in
 566   `/lib/rustlib/<target-triple>/target.json` where `/` is the "sysroot"
 567   directory.][83800] You can find your sysroot directory by running
 568   `rustc --print sysroot`.
 569 - [Added `wasm` as a `target_family` for WebAssembly platforms.][84072]
 570 - [You can now use `#[target_feature]` on safe functions when targeting
 571   WebAssembly platforms.][84988]
 572 - [Improved debugger output for enums on Windows MSVC platforms.][85292]
 573 - [Added tier 3\* support for `bpfel-unknown-none`
 574    and `bpfeb-unknown-none`.][79608]
 575 - [`-Zmutable-noalias=yes`][82834] is enabled by default when using LLVM 12 or above.
 576
 577 \* Refer to Rust's [platform support page][platform-support-doc] for more
 578    information on Rust's tiered platform support.
 579
 580 Libraries
 581 -----------------------
 582
 583 - [`panic::panic_any` will now `#[track_caller]`.][85745]
 584 - [Added `OutOfMemory` as a variant of `io::ErrorKind`.][84744]
 585 - [ `proc_macro::Literal` now implements `FromStr`.][84717]
 586 - [The implementations of vendor intrinsics in core::arch have been
 587    significantly refactored.][83278] The main user-visible changes are
 588    a 50% reduction in the size of libcore.rlib and stricter validation
 589    of constant operands passed to intrinsics. The latter is technically
 590    a breaking change, but allows Rust to more closely match the C vendor
 591    intrinsics API.
 592
 593 Stabilized APIs
 594 ---------------
 595
 596 - [`BTreeMap::into_keys`]
 597 - [`BTreeMap::into_values`]
 598 - [`HashMap::into_keys`]
 599 - [`HashMap::into_values`]
 600 - [`arch::wasm32`]
 601 - [`VecDeque::binary_search`]
 602 - [`VecDeque::binary_search_by`]
 603 - [`VecDeque::binary_search_by_key`]
 604 - [`VecDeque::partition_point`]
 605
 606 Cargo
 607 -----
 608
 609 - [Added the `--prune <spec>` option to `cargo-tree` to remove a package from
 610   the dependency graph.][cargo/9520]
 611 - [Added the `--depth` option to `cargo-tree` to print only to a certain depth
 612   in the tree ][cargo/9499]
 613 - [Added the `no-proc-macro` value to `cargo-tree --edges` to hide procedural
 614   macro dependencies.][cargo/9488]
 615 - [A new environment variable named `CARGO_TARGET_TMPDIR` is available.][cargo/9375]
 616   This variable points to a directory that integration tests and benches
 617   can use as a "scratchpad" for testing filesystem operations.
 618
 619 Compatibility Notes
 620 -------------------
 621 - [Mixing Option and Result via `?` is no longer permitted in closures for inferred types.][86831]
 622 - [Previously unsound code is no longer permitted where different constructors in branches
 623   could require different lifetimes.][85574]
 624 - As previously mentioned the [`std::arch` instrinsics now uses stricter const checking][83278]
 625   than before and may reject some previously accepted code.
 626 - [`i128` multiplication on Cortex M0+ platforms currently unconditionally causes overflow
 627    when compiled with `codegen-units = 1`.][86063]
 628
 629 [85574]: https://github.com/rust-lang/rust/issues/85574
 630 [86831]: https://github.com/rust-lang/rust/issues/86831
 631 [86063]: https://github.com/rust-lang/rust/issues/86063
 632 [79608]: https://github.com/rust-lang/rust/pull/79608
 633 [84988]: https://github.com/rust-lang/rust/pull/84988
 634 [84701]: https://github.com/rust-lang/rust/pull/84701
 635 [84072]: https://github.com/rust-lang/rust/pull/84072
 636 [85745]: https://github.com/rust-lang/rust/pull/85745
 637 [84744]: https://github.com/rust-lang/rust/pull/84744
 638 [85078]: https://github.com/rust-lang/rust/pull/85078
 639 [84717]: https://github.com/rust-lang/rust/pull/84717
 640 [83800]: https://github.com/rust-lang/rust/pull/83800
 641 [83366]: https://github.com/rust-lang/rust/pull/83366
 642 [83278]: https://github.com/rust-lang/rust/pull/83278
 643 [85292]: https://github.com/rust-lang/rust/pull/85292
 644 [82834]: https://github.com/rust-lang/rust/pull/82834
 645 [cargo/9520]: https://github.com/rust-lang/cargo/pull/9520
 646 [cargo/9499]: https://github.com/rust-lang/cargo/pull/9499
 647 [cargo/9488]: https://github.com/rust-lang/cargo/pull/9488
 648 [cargo/9375]: https://github.com/rust-lang/cargo/pull/9375
 649 [`BTreeMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_keys
 650 [`BTreeMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_values
 651 [`HashMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_keys
 652 [`HashMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_values
 653 [`arch::wasm32`]: https://doc.rust-lang.org/core/arch/wasm32/index.html
 654 [`VecDeque::binary_search`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search
 655 [`VecDeque::binary_search_by`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by
 656
 657 [`VecDeque::binary_search_by_key`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by_key
 658
 659 [`VecDeque::partition_point`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.partition_point
 660
 661 Version 1.53.0 (2021-06-17)
 662 ============================
 663
 664 Language
 665 -----------------------
 666 - [You can now use unicode for identifiers.][83799] This allows multilingual
 667   identifiers but still doesn't allow glyphs that are not considered characters
 668   such as `◆` or `🦀`. More specifically you can now use any identifier that
 669   matches the UAX #31 "Unicode Identifier and Pattern Syntax" standard. This
 670   is the same standard as languages like Python, however Rust uses NFC
 671   normalization which may be different from other languages.
 672 - [You can now specify "or patterns" inside pattern matches.][79278]
 673   Previously you could only use `|` (OR) on complete patterns. E.g.
 674   ```rust
 675   let x = Some(2u8);
 676   // Before
 677   matches!(x, Some(1) | Some(2));
 678   // Now
 679   matches!(x, Some(1 | 2));
 680   ```
 681 - [Added the `:pat_param` `macro_rules!` matcher.][83386] This matcher
 682   has the same semantics as the `:pat` matcher. This is to allow `:pat`
 683   to change semantics to being a pattern fragment in a future edition.
 684
 685 Compiler
 686 -----------------------
 687 - [Updated the minimum external LLVM version to LLVM 10.][83387]
 688 - [Added Tier 3\* support for the `wasm64-unknown-unknown` target.][80525]
 689 - [Improved debuginfo for closures and async functions on Windows MSVC.][83941]
 690
 691 \* Refer to Rust's [platform support page][platform-support-doc] for more
 692 information on Rust's tiered platform support.
 693
 694 Libraries
 695 -----------------------
 696 - [Abort messages will now forward to `android_set_abort_message` on
 697   Android platforms when available.][81469]
 698 - [`slice::IterMut<'_, T>` now implements `AsRef<[T]>`][82771]
 699 - [Arrays of any length now implement `IntoIterator`.][84147]
 700   Currently calling `.into_iter()` as a method on an array will
 701   return `impl Iterator<Item=&T>`, but this may change in a
 702   future edition to change `Item` to `T`. Calling `IntoIterator::into_iter`
 703   directly on arrays will provide `impl Iterator<Item=T>` as expected.
 704 - [`leading_zeros`, and `trailing_zeros` are now available on all
 705   `NonZero` integer types.][84082]
 706 - [`{f32, f64}::from_str` now parse and print special values
 707   (`NaN`, `-0`) according to IEEE 754.][78618]
 708 - [You can now index into slices using `(Bound<usize>, Bound<usize>)`.][77704]
 709 - [Add the `BITS` associated constant to all numeric types.][82565]
 710
 711 Stabilised APIs
 712 ---------------
 713 - [`AtomicBool::fetch_update`]
 714 - [`AtomicPtr::fetch_update`]
 715 - [`BTreeMap::retain`]
 716 - [`BTreeSet::retain`]
 717 - [`BufReader::seek_relative`]
 718 - [`DebugStruct::non_exhaustive`]
 719 - [`Duration::MAX`]
 720 - [`Duration::ZERO`]
 721 - [`Duration::is_zero`]
 722 - [`Duration::saturating_add`]
 723 - [`Duration::saturating_mul`]
 724 - [`Duration::saturating_sub`]
 725 - [`ErrorKind::Unsupported`]
 726 - [`Option::insert`]
 727 - [`Ordering::is_eq`]
 728 - [`Ordering::is_ge`]
 729 - [`Ordering::is_gt`]
 730 - [`Ordering::is_le`]
 731 - [`Ordering::is_lt`]
 732 - [`Ordering::is_ne`]
 733 - [`OsStr::is_ascii`]
 734 - [`OsStr::make_ascii_lowercase`]
 735 - [`OsStr::make_ascii_uppercase`]
 736 - [`OsStr::to_ascii_lowercase`]
 737 - [`OsStr::to_ascii_uppercase`]
 738 - [`Peekable::peek_mut`]
 739 - [`Rc::decrement_strong_count`]
 740 - [`Rc::increment_strong_count`]
 741 - [`Vec::extend_from_within`]
 742 - [`array::from_mut`]
 743 - [`array::from_ref`]
 744 - [`cmp::max_by_key`]
 745 - [`cmp::max_by`]
 746 - [`cmp::min_by_key`]
 747 - [`cmp::min_by`]
 748 - [`f32::is_subnormal`]
 749 - [`f64::is_subnormal`]
 750
 751 Cargo
 752 -----------------------
 753 - [Cargo now supports git repositories where the default `HEAD` branch is not
 754   "master".][cargo/9392] This also includes a switch to the version 3 `Cargo.lock` format
 755   which can handle default branches correctly.
 756 - [macOS targets now default to `unpacked` split-debuginfo.][cargo/9298]
 757 - [The `authors` field is no longer included in `Cargo.toml` for new
 758   projects.][cargo/9282]
 759
 760 Rustdoc
 761 -----------------------
 762 - [Added the `rustdoc::bare_urls` lint that warns when you have URLs
 763   without hyperlinks.][81764]
 764
 765 Compatibility Notes
 766 -------------------
 767 - [Implement token-based handling of attributes during expansion][82608]
 768 - [`Ipv4::from_str` will now reject octal format IP addresses in addition
 769   to rejecting hexadecimal IP addresses.][83652] The octal format can lead
 770   to confusion and potential security vulnerabilities and [is no
 771   longer recommended][ietf6943].
 772 - [The added `BITS` constant may conflict with external definitions.][85667]
 773   In particular, this was known to be a problem in the `lexical-core` crate,
 774   but they have published fixes for semantic versions 0.4 through 0.7. To
 775   update this dependency alone, use `cargo update -p lexical-core`.
 776 - Incremental compilation remains off by default, unless one uses the `RUSTC_FORCE_INCREMENTAL=1` environment variable added in 1.52.1.
 777
 778 Internal Only
 779 -------------
 780 These changes provide no direct user facing benefits, but represent significant
 781 improvements to the internals and overall performance of rustc and
 782 related tools.
 783
 784 - [Rework the `std::sys::windows::alloc` implementation.][83065]
 785 - [rustdoc: Don't enter an infer_ctxt in get_blanket_impls for impls that aren't blanket impls.][82864]
 786 - [rustdoc: Only look at blanket impls in `get_blanket_impls`][83681]
 787 - [Rework rustdoc const type][82873]
 788
 789 [85667]: https://github.com/rust-lang/rust/pull/85667
 790 [83386]: https://github.com/rust-lang/rust/pull/83386
 791 [82771]: https://github.com/rust-lang/rust/pull/82771
 792 [84147]: https://github.com/rust-lang/rust/pull/84147
 793 [84082]: https://github.com/rust-lang/rust/pull/84082
 794 [83799]: https://github.com/rust-lang/rust/pull/83799
 795 [83681]: https://github.com/rust-lang/rust/pull/83681
 796 [83652]: https://github.com/rust-lang/rust/pull/83652
 797 [83387]: https://github.com/rust-lang/rust/pull/83387
 798 [82873]: https://github.com/rust-lang/rust/pull/82873
 799 [82864]: https://github.com/rust-lang/rust/pull/82864
 800 [82608]: https://github.com/rust-lang/rust/pull/82608
 801 [82565]: https://github.com/rust-lang/rust/pull/82565
 802 [80525]: https://github.com/rust-lang/rust/pull/80525
 803 [79278]: https://github.com/rust-lang/rust/pull/79278
 804 [78618]: https://github.com/rust-lang/rust/pull/78618
 805 [77704]: https://github.com/rust-lang/rust/pull/77704
 806 [83941]: https://github.com/rust-lang/rust/pull/83941
 807 [83065]: https://github.com/rust-lang/rust/pull/83065
 808 [81764]: https://github.com/rust-lang/rust/pull/81764
 809 [81469]: https://github.com/rust-lang/rust/pull/81469
 810 [cargo/9298]: https://github.com/rust-lang/cargo/pull/9298
 811 [cargo/9282]: https://github.com/rust-lang/cargo/pull/9282
 812 [cargo/9392]: https://github.com/rust-lang/cargo/pull/9392
 813 [`AtomicBool::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicBool.html#method.fetch_update
 814 [`AtomicPtr::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicPtr.html#method.fetch_update
 815 [`BTreeMap::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.retain
 816 [`BTreeSet::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeSet.html#method.retain
 817 [`BufReader::seek_relative`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.seek_relative
 818 [`DebugStruct::non_exhaustive`]: https://doc.rust-lang.org/std/fmt/struct.DebugStruct.html#method.finish_non_exhaustive
 819 [`Duration::MAX`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
 820 [`Duration::ZERO`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.ZERO
 821 [`Duration::is_zero`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.is_zero
 822 [`Duration::saturating_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_add
 823 [`Duration::saturating_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_mul
 824 [`Duration::saturating_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_sub
 825 [`ErrorKind::Unsupported`]: https://doc.rust-lang.org/std/io/enum.ErrorKind.html#variant.Unsupported
 826 [`Option::insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.insert
 827 [`Ordering::is_eq`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_eq
 828 [`Ordering::is_ge`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ge
 829 [`Ordering::is_gt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_gt
 830 [`Ordering::is_le`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_le
 831 [`Ordering::is_lt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_lt
 832 [`Ordering::is_ne`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ne
 833 [`OsStr::is_ascii`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.is_ascii
 834 [`OsStr::make_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_lowercase
 835 [`OsStr::make_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_uppercase
 836 [`OsStr::to_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_lowercase
 837 [`OsStr::to_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_uppercase
 838 [`Peekable::peek_mut`]: https://doc.rust-lang.org/std/iter/struct.Peekable.html#method.peek_mut
 839 [`Rc::decrement_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
 840 [`Rc::increment_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
 841 [`Vec::extend_from_within`]: https://doc.rust-lang.org/beta/std/vec/struct.Vec.html#method.extend_from_within
 842 [`array::from_mut`]: https://doc.rust-lang.org/beta/std/array/fn.from_mut.html
 843 [`array::from_ref`]: https://doc.rust-lang.org/beta/std/array/fn.from_ref.html
 844 [`cmp::max_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by_key.html
 845 [`cmp::max_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by.html
 846 [`cmp::min_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by_key.html
 847 [`cmp::min_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by.html
 848 [`f32::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
 849 [`f64::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
 850 [ietf6943]: https://datatracker.ietf.org/doc/html/rfc6943#section-3.1.1
 851
 852
 853 Version 1.52.1 (2021-05-10)
 854 ============================
 855
 856 This release disables incremental compilation, unless the user has explicitly
 857 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
 858
 859 This is due to the widespread, and frequently occuring, breakage encountered by
 860 Rust users due to newly enabled incremental verification in 1.52.0. Notably,
 861 Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
 862 newly added incremental verification are still present in past stable versions,
 863 and are not yet fixed on any channel. These bugs can lead to miscompilation of
 864 Rust binaries.
 865
 866 These problems only affect incremental builds, so release builds with Cargo
 867 should not be affected unless the user has explicitly opted into incremental.
 868 Debug and check builds are affected.
 869
 870 See [84970] for more details.
 871
 872 [84970]: https://github.com/rust-lang/rust/issues/84970
 873
 874 Version 1.52.0 (2021-05-06)
 875 ============================
 876
 877 Language
 878 --------
 879 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
 880   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
 881   is allowed by default, and may become a warning or hard error in a
 882   future edition.
 883 - [You can now cast mutable references to arrays to a pointer of the same type as
 884   the element.][81479]
 885
 886 Compiler
 887 --------
 888 - [Upgraded the default LLVM to LLVM 12.][81451]
 889
 890 Added tier 3\* support for the following targets.
 891
 892 - [`s390x-unknown-linux-musl`][82166]
 893 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
 894 - [`powerpc-unknown-openbsd`][82733]
 895
 896 \* Refer to Rust's [platform support page][platform-support-doc] for more
 897 information on Rust's tiered platform support.
 898
 899 Libraries
 900 ---------
 901 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
 902 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
 903 - [`Arc<impl Error>` now implements `error::Error`.][80553]
 904 - [All integer division and remainder operations are now `const`.][80962]
 905
 906 Stabilised APIs
 907 -------------
 908 - [`Arguments::as_str`]
 909 - [`char::MAX`]
 910 - [`char::REPLACEMENT_CHARACTER`]
 911 - [`char::UNICODE_VERSION`]
 912 - [`char::decode_utf16`]
 913 - [`char::from_digit`]
 914 - [`char::from_u32_unchecked`]
 915 - [`char::from_u32`]
 916 - [`slice::partition_point`]
 917 - [`str::rsplit_once`]
 918 - [`str::split_once`]
 919
 920 The following previously stable APIs are now `const`.
 921
 922 - [`char::len_utf8`]
 923 - [`char::len_utf16`]
 924 - [`char::to_ascii_uppercase`]
 925 - [`char::to_ascii_lowercase`]
 926 - [`char::eq_ignore_ascii_case`]
 927 - [`u8::to_ascii_uppercase`]
 928 - [`u8::to_ascii_lowercase`]
 929 - [`u8::eq_ignore_ascii_case`]
 930
 931 Rustdoc
 932 -------
 933 - [Rustdoc lints are now treated as a tool lint, meaning that
 934   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
 935   Using the old style is still allowed, and will become a warning in
 936   a future release.
 937 - [Rustdoc now supports argument files.][82261]
 938 - [Rustdoc now generates smart punctuation for documentation.][79423]
 939 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
 940   ```markdown
 941   - [x] Complete
 942   - [ ] Todo
 943   ```
 944
 945 Misc
 946 ----
 947 - [You can now pass multiple filters to tests.][81356] E.g.
 948   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
 949 - [Rustup now distributes PDB symbols for the `std` library on Windows,
 950   allowing you to see `std` symbols when debugging.][82218]
 951
 952 Internal Only
 953 -------------
 954 These changes provide no direct user facing benefits, but represent significant
 955 improvements to the internals and overall performance of rustc and
 956 related tools.
 957
 958 - [Check the result cache before the DepGraph when ensuring queries][81855]
 959 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
 960 - [Only store a LocalDefId in some HIR nodes][81611]
 961 - [Store HIR attributes in a side table][79519]
 962
 963 Compatibility Notes
 964 -------------------
 965 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
 966 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
 967 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
 968 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
 969   languages in code blocks.][78429]
 970 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
 971 - [Changes in how proc macros handle whitespace may lead to panics when used
 972   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
 973 - [Turn `#[derive]` into a regular macro attribute][79078]
 974
 975 [84136]: https://github.com/rust-lang/rust/issues/84136
 976 [80763]: https://github.com/rust-lang/rust/pull/80763
 977 [82166]: https://github.com/rust-lang/rust/pull/82166
 978 [82121]: https://github.com/rust-lang/rust/pull/82121
 979 [81879]: https://github.com/rust-lang/rust/pull/81879
 980 [82261]: https://github.com/rust-lang/rust/pull/82261
 981 [82218]: https://github.com/rust-lang/rust/pull/82218
 982 [82216]: https://github.com/rust-lang/rust/pull/82216
 983 [82202]: https://github.com/rust-lang/rust/pull/82202
 984 [81855]: https://github.com/rust-lang/rust/pull/81855
 985 [81766]: https://github.com/rust-lang/rust/pull/81766
 986 [81744]: https://github.com/rust-lang/rust/pull/81744
 987 [81611]: https://github.com/rust-lang/rust/pull/81611
 988 [81479]: https://github.com/rust-lang/rust/pull/81479
 989 [81451]: https://github.com/rust-lang/rust/pull/81451
 990 [81356]: https://github.com/rust-lang/rust/pull/81356
 991 [80962]: https://github.com/rust-lang/rust/pull/80962
 992 [80553]: https://github.com/rust-lang/rust/pull/80553
 993 [80527]: https://github.com/rust-lang/rust/pull/80527
 994 [79519]: https://github.com/rust-lang/rust/pull/79519
 995 [79423]: https://github.com/rust-lang/rust/pull/79423
 996 [79208]: https://github.com/rust-lang/rust/pull/79208
 997 [78429]: https://github.com/rust-lang/rust/pull/78429
 998 [82733]: https://github.com/rust-lang/rust/pull/82733
 999 [82594]: https://github.com/rust-lang/rust/pull/82594
1000 [79078]: https://github.com/rust-lang/rust/pull/79078
1001 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
1002 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
1003 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
1004 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
1005 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
1006 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
1007 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
1008 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
1009 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
1010 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
1011 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
1012 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
1013 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
1014 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
1015 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
1016 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
1017 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
1018 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
1019 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
1020 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
1021 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
1022 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
1023
1024 Version 1.51.0 (2021-03-25)
1025 ============================
1026
1027 Language
1028 --------
1029 - [You can now parameterize items such as functions, traits, and `struct`s by constant
1030   values in addition to by types and lifetimes.][79135] Also known as "const generics"
1031   E.g. you can now write the following. Note: Only values of primitive integers,
1032   `bool`, or `char` types are currently permitted.
1033   ```rust
1034   struct GenericArray<T, const LENGTH: usize> {
1035       inner: [T; LENGTH]
1036   }
1037
1038   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
1039       const fn last(&self) -> Option<&T> {
1040           if LENGTH == 0 {
1041               None
1042           } else {
1043               Some(&self.inner[LENGTH - 1])
1044           }
1045       }
1046   }
1047   ```
1048
1049
1050 Compiler
1051 --------
1052
1053 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
1054   This option controls whether debug information is split across multiple files
1055   or packed into a single file. **Note** This option is unstable on other platforms.
1056 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
1057   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
1058 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
1059 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
1060
1061 \* Refer to Rust's [platform support page][platform-support-doc] for more
1062 information on Rust's tiered platform support.
1063
1064 Libraries
1065 ---------
1066
1067 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
1068 - [`str` now implements `AsMut<str>`.][80279]
1069 - [`u64` and `u128` now implement `From<char>`.][79502]
1070 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
1071 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
1072 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
1073 - [`io::Empty` now implements `io::Seek`.][78044]
1074 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
1075   `T: ?Sized` types.][80764]
1076 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
1077
1078
1079 Stabilized APIs
1080 ---------------
1081
1082 - [`Arc::decrement_strong_count`]
1083 - [`Arc::increment_strong_count`]
1084 - [`Once::call_once_force`]
1085 - [`Peekable::next_if_eq`]
1086 - [`Peekable::next_if`]
1087 - [`Seek::stream_position`]
1088 - [`array::IntoIter`]
1089 - [`panic::panic_any`]
1090 - [`ptr::addr_of!`]
1091 - [`ptr::addr_of_mut!`]
1092 - [`slice::fill_with`]
1093 - [`slice::split_inclusive_mut`]
1094 - [`slice::split_inclusive`]
1095 - [`slice::strip_prefix`]
1096 - [`slice::strip_suffix`]
1097 - [`str::split_inclusive`]
1098 - [`sync::OnceState`]
1099 - [`task::Wake`]
1100 - [`VecDeque::range`]
1101 - [`VecDeque::range_mut`]
1102
1103 Cargo
1104 -----
1105 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
1106   codegen option.][cargo/9112]
1107 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
1108   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
1109   to avoid unifying features of dependencies where that unification could be unwanted.
1110   Such as using the same dependency with a `std` feature in a build scripts and
1111   proc-macros, while using the `no-std` feature in the final binary. See the
1112   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
1113
1114 Rustdoc
1115 -------
1116
1117 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
1118 - [You can now provide a `--default-theme` flag which sets the default theme to use for
1119   documentation.][79642]
1120
1121 Various improvements to intra-doc links:
1122
1123 - [You can link to non-path primitives such as `slice`.][80181]
1124 - [You can link to associated items.][74489]
1125 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
1126
1127 Misc
1128 ----
1129 - [You can now pass `--include-ignored` to tests (e.g. with
1130   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
1131
1132 Compatibility Notes
1133 -------------------
1134
1135 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
1136 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
1137   could fail.][80579]
1138 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
1139   for the distributed artifacts.][81521]
1140     - `armv5te-unknown-linux-gnueabi`
1141     - `sparc64-unknown-linux-gnu`
1142     - `thumbv7neon-unknown-linux-gnueabihf`
1143     - `armv7-unknown-linux-gnueabi`
1144     - `x86_64-unknown-linux-gnux32`
1145 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
1146
1147 Internal Only
1148 -------------
1149
1150 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
1151
1152 [79135]: https://github.com/rust-lang/rust/pull/79135
1153 [74489]: https://github.com/rust-lang/rust/pull/74489
1154 [76934]: https://github.com/rust-lang/rust/pull/76934
1155 [79570]: https://github.com/rust-lang/rust/pull/79570
1156 [80181]: https://github.com/rust-lang/rust/pull/80181
1157 [79642]: https://github.com/rust-lang/rust/pull/79642
1158 [80945]: https://github.com/rust-lang/rust/pull/80945
1159 [80279]: https://github.com/rust-lang/rust/pull/80279
1160 [80053]: https://github.com/rust-lang/rust/pull/80053
1161 [79502]: https://github.com/rust-lang/rust/pull/79502
1162 [75180]: https://github.com/rust-lang/rust/pull/75180
1163 [81521]: https://github.com/rust-lang/rust/pull/81521
1164 [80968]: https://github.com/rust-lang/rust/pull/80968
1165 [80959]: https://github.com/rust-lang/rust/pull/80959
1166 [80718]: https://github.com/rust-lang/rust/pull/80718
1167 [80653]: https://github.com/rust-lang/rust/pull/80653
1168 [80579]: https://github.com/rust-lang/rust/pull/80579
1169 [79998]: https://github.com/rust-lang/rust/pull/79998
1170 [78044]: https://github.com/rust-lang/rust/pull/78044
1171 [81455]: https://github.com/rust-lang/rust/pull/81455
1172 [80764]: https://github.com/rust-lang/rust/pull/80764
1173 [80749]: https://github.com/rust-lang/rust/pull/80749
1174 [80662]: https://github.com/rust-lang/rust/pull/80662
1175 [79134]: https://github.com/rust-lang/rust/pull/79134
1176 [80966]: https://github.com/rust-lang/rust/pull/80966
1177 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
1178 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
1179 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
1180 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
1181 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
1182 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
1183 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
1184 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
1185 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
1186 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
1187 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
1188 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
1189 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
1190 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
1191 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
1192 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
1193 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
1194 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
1195 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
1196 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
1197 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
1198 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
1199 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
1200
1201 Version 1.50.0 (2021-02-11)
1202 ============================
1203
1204 Language
1205 -----------------------
1206 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
1207   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
1208 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
1209
1210 Compiler
1211 -----------------------
1212 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
1213 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
1214 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
1215 - [Dropped support for all cloudabi targets.][78439]
1216
1217 \* Refer to Rust's [platform support page][platform-support-doc] for more
1218 information on Rust's tiered platform support.
1219
1220 Libraries
1221 -----------------------
1222
1223 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
1224 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
1225 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
1226   This value cannot be a valid file descriptor, and now means `Option<File>` takes
1227   up the same amount of space as `File`.
1228
1229 Stabilized APIs
1230 ---------------
1231
1232 - [`bool::then`]
1233 - [`btree_map::Entry::or_insert_with_key`]
1234 - [`f32::clamp`]
1235 - [`f64::clamp`]
1236 - [`hash_map::Entry::or_insert_with_key`]
1237 - [`Ord::clamp`]
1238 - [`RefCell::take`]
1239 - [`slice::fill`]
1240 - [`UnsafeCell::get_mut`]
1241
1242 The following previously stable methods are now `const`.
1243
1244 - [`IpAddr::is_ipv4`]
1245 - [`IpAddr::is_ipv6`]
1246 - [`IpAddr::is_unspecified`]
1247 - [`IpAddr::is_loopback`]
1248 - [`IpAddr::is_multicast`]
1249 - [`Ipv4Addr::octets`]
1250 - [`Ipv4Addr::is_loopback`]
1251 - [`Ipv4Addr::is_private`]
1252 - [`Ipv4Addr::is_link_local`]
1253 - [`Ipv4Addr::is_multicast`]
1254 - [`Ipv4Addr::is_broadcast`]
1255 - [`Ipv4Addr::is_documentation`]
1256 - [`Ipv4Addr::to_ipv6_compatible`]
1257 - [`Ipv4Addr::to_ipv6_mapped`]
1258 - [`Ipv6Addr::segments`]
1259 - [`Ipv6Addr::is_unspecified`]
1260 - [`Ipv6Addr::is_loopback`]
1261 - [`Ipv6Addr::is_multicast`]
1262 - [`Ipv6Addr::to_ipv4`]
1263 - [`Layout::size`]
1264 - [`Layout::align`]
1265 - [`Layout::from_size_align`]
1266 - `pow` for all integer types.
1267 - `checked_pow` for all integer types.
1268 - `saturating_pow` for all integer types.
1269 - `wrapping_pow` for all integer types.
1270 - `next_power_of_two` for all unsigned integer types.
1271 - `checked_next_power_of_two` for all unsigned integer types.
1272
1273 Cargo
1274 -----------------------
1275
1276 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
1277   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
1278 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
1279   contents of that directory for changes.][cargo/8973]
1280 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
1281
1282 Misc
1283 ----
1284
1285 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
1286 - [Running tests will now print the total time taken to execute.][75752]
1287
1288 Compatibility Notes
1289 -------------------
1290
1291 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
1292   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
1293 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
1294   unhygenic `macro_rules!` macros.][79472]
1295 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
1296   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
1297 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
1298 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
1299   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
1300 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
1301
1302 [74989]: https://github.com/rust-lang/rust/pull/74989
1303 [79261]: https://github.com/rust-lang/rust/pull/79261
1304 [79896]: https://github.com/rust-lang/rust/pull/79896
1305 [79484]: https://github.com/rust-lang/rust/pull/79484
1306 [79472]: https://github.com/rust-lang/rust/pull/79472
1307 [79270]: https://github.com/rust-lang/rust/pull/79270
1308 [79003]: https://github.com/rust-lang/rust/pull/79003
1309 [78864]: https://github.com/rust-lang/rust/pull/78864
1310 [78636]: https://github.com/rust-lang/rust/pull/78636
1311 [78439]: https://github.com/rust-lang/rust/pull/78439
1312 [78343]: https://github.com/rust-lang/rust/pull/78343
1313 [78296]: https://github.com/rust-lang/rust/pull/78296
1314 [78068]: https://github.com/rust-lang/rust/pull/78068
1315 [75752]: https://github.com/rust-lang/rust/pull/75752
1316 [74699]: https://github.com/rust-lang/rust/pull/74699
1317 [78142]: https://github.com/rust-lang/rust/pull/78142
1318 [77484]: https://github.com/rust-lang/rust/pull/77484
1319 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
1320 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
1321 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
1322 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
1323 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
1324 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
1325 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
1326 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
1327 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
1328 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
1329 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
1330 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
1331 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
1332 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
1333 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
1334 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
1335 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
1336 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
1337 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
1338 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
1339 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
1340 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
1341 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
1342 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
1343 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
1344 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
1345 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
1346 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
1347 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
1348 [`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
1349 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
1350 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
1351 [`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
1352 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
1353
1354
1355 Version 1.49.0 (2020-12-31)
1356 ============================
1357
1358 Language
1359 -----------------------
1360
1361 - [Unions can now implement `Drop`, and you can now have a field in a union
1362   with `ManuallyDrop<T>`.][77547]
1363 - [You can now cast uninhabited enums to integers.][76199]
1364 - [You can now bind by reference and by move in patterns.][76119] This
1365   allows you to selectively borrow individual components of a type. E.g.
1366   ```rust
1367   #[derive(Debug)]
1368   struct Person {
1369       name: String,
1370       age: u8,
1371   }
1372
1373   let person = Person {
1374       name: String::from("Alice"),
1375       age: 20,
1376   };
1377
1378   // `name` is moved out of person, but `age` is referenced.
1379   let Person { name, ref age } = person;
1380   println!("{} {}", name, age);
1381   ```
1382
1383 Compiler
1384 -----------------------
1385
1386 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
1387 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
1388 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
1389 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
1390 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
1391 - [Output from threads spawned in tests is now captured.][78227]
1392 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
1393
1394 \* Refer to Rust's [platform support page][platform-support-doc] for more
1395 information on Rust's tiered platform support.
1396
1397 Libraries
1398 -----------------------
1399
1400 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
1401 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
1402
1403 Stabilized APIs
1404 ---------------
1405
1406 - [`slice::select_nth_unstable`]
1407 - [`slice::select_nth_unstable_by`]
1408 - [`slice::select_nth_unstable_by_key`]
1409
1410 The following previously stable methods are now `const`.
1411
1412 - [`Poll::is_ready`]
1413 - [`Poll::is_pending`]
1414
1415 Cargo
1416 -----------------------
1417 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
1418 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
1419 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
1420   variable will be set if the crate being built is one the user selected to build, either
1421   with `-p` or through defaults.
1422 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
1423
1424
1425 Compatibility Notes
1426 -------------------
1427
1428 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
1429 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
1430 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
1431   Previously such invalid or unused attributes could be ignored.
1432 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
1433   read [this post about the changes][rustdoc-ws-post] for more details.
1434 - [Trait bounds are no longer inferred for associated types.][79904]
1435
1436 Internal Only
1437 -------------
1438 These changes provide no direct user facing benefits, but represent significant
1439 improvements to the internals and overall performance of rustc and
1440 related tools.
1441
1442 - [rustc's internal crates are now compiled using the `initial-exec` Thread
1443   Local Storage model.][78201]
1444 - [Calculate visibilities once in resolve.][78077]
1445 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
1446 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
1447
1448
1449 [75991]: https://github.com/rust-lang/rust/pull/75991
1450 [78951]: https://github.com/rust-lang/rust/pull/78951
1451 [78848]: https://github.com/rust-lang/rust/pull/78848
1452 [78746]: https://github.com/rust-lang/rust/pull/78746
1453 [78376]: https://github.com/rust-lang/rust/pull/78376
1454 [78228]: https://github.com/rust-lang/rust/pull/78228
1455 [78227]: https://github.com/rust-lang/rust/pull/78227
1456 [78201]: https://github.com/rust-lang/rust/pull/78201
1457 [78109]: https://github.com/rust-lang/rust/pull/78109
1458 [78077]: https://github.com/rust-lang/rust/pull/78077
1459 [77997]: https://github.com/rust-lang/rust/pull/77997
1460 [77703]: https://github.com/rust-lang/rust/pull/77703
1461 [77547]: https://github.com/rust-lang/rust/pull/77547
1462 [77015]: https://github.com/rust-lang/rust/pull/77015
1463 [76199]: https://github.com/rust-lang/rust/pull/76199
1464 [76119]: https://github.com/rust-lang/rust/pull/76119
1465 [75914]: https://github.com/rust-lang/rust/pull/75914
1466 [79004]: https://github.com/rust-lang/rust/pull/79004
1467 [78676]: https://github.com/rust-lang/rust/pull/78676
1468 [79904]: https://github.com/rust-lang/rust/issues/79904
1469 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
1470 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
1471 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
1472 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
1473 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
1474 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
1475 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
1476 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
1477 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
1478 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
1479
1480 Version 1.48.0 (2020-11-19)
1481 ==========================
1482
1483 Language
1484 --------
1485
1486 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
1487   is still rejected *semantically*, but can now be parsed by procedural macros.
1488
1489 Compiler
1490 --------
1491 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
1492   `rustc` whether to link its own C runtime and libraries or to rely on a external
1493   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
1494 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
1495   Note: If you're using cargo you must explicitly pass the `--target` flag.
1496 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
1497
1498 \* Refer to Rust's [platform support page][platform-support-doc] for more
1499 information on Rust's tiered platform support.
1500
1501 Libraries
1502 ---------
1503 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
1504   and `&Stderr`.][76275]
1505 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
1506 - [The `matches!` macro now supports having a trailing comma.][74880]
1507 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
1508 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
1509
1510 Stabilized APIs
1511 ---------------
1512 - [`slice::as_ptr_range`]
1513 - [`slice::as_mut_ptr_range`]
1514 - [`VecDeque::make_contiguous`]
1515 - [`future::pending`]
1516 - [`future::ready`]
1517
1518 The following previously stable methods are now `const fn`'s:
1519
1520 - [`Option::is_some`]
1521 - [`Option::is_none`]
1522 - [`Option::as_ref`]
1523 - [`Result::is_ok`]
1524 - [`Result::is_err`]
1525 - [`Result::as_ref`]
1526 - [`Ordering::reverse`]
1527 - [`Ordering::then`]
1528
1529 Cargo
1530 -----
1531
1532 Rustdoc
1533 -------
1534 - [You can now link to items in `rustdoc` using the intra-doc link
1535   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
1536   a link to `std::future`'s documentation. See ["Linking to items by
1537   name"][intradoc-links] for more information.
1538 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
1539   when searching through `rustdoc`'s UI.][75740]
1540
1541 Compatibility Notes
1542 -------------------
1543 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
1544   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
1545   promoted to `'static` lifetime any more inside `const fn`s.
1546 - [Associated type bindings on trait objects are now verified to meet the bounds
1547   declared on the trait when checking that they implement the trait.][27675]
1548 - [When trait bounds on associated types or opaque types are ambiguous, the
1549   compiler no longer makes an arbitrary choice on which bound to use.][54121]
1550 - [Fixed recursive nonterminals not being expanded in macros during
1551   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
1552   correctly handling recursive nonterminal tokens.
1553 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
1554 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
1555   in places where they have no effect.][73461]
1556 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
1557   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
1558 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
1559   disallow zero-initialization.][71274]
1560 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
1561 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
1562   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
1563   see the [`catch_unwind`] documentation for further information.
1564
1565
1566
1567 Internal Only
1568 -------------
1569 These changes provide no direct user facing benefits, but represent significant
1570 improvements to the internals and overall performance of rustc and
1571 related tools.
1572
1573 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
1574   You can continue building with `make` by setting `ninja=false` in
1575   your `config.toml`.
1576 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
1577 - [Made `ensure_sufficient_stack()` non-generic][76680]
1578
1579 [78143]: https://github.com/rust-lang/rust/issues/78143
1580 [76680]: https://github.com/rust-lang/rust/pull/76680/
1581 [76030]: https://github.com/rust-lang/rust/pull/76030/
1582 [70212]: https://github.com/rust-lang/rust/pull/70212/
1583 [27675]: https://github.com/rust-lang/rust/issues/27675/
1584 [54121]: https://github.com/rust-lang/rust/issues/54121/
1585 [71274]: https://github.com/rust-lang/rust/pull/71274/
1586 [77386]: https://github.com/rust-lang/rust/pull/77386/
1587 [77153]: https://github.com/rust-lang/rust/pull/77153/
1588 [77055]: https://github.com/rust-lang/rust/pull/77055/
1589 [76275]: https://github.com/rust-lang/rust/pull/76275/
1590 [76310]: https://github.com/rust-lang/rust/pull/76310/
1591 [76420]: https://github.com/rust-lang/rust/pull/76420/
1592 [76158]: https://github.com/rust-lang/rust/pull/76158/
1593 [75857]: https://github.com/rust-lang/rust/pull/75857/
1594 [75585]: https://github.com/rust-lang/rust/pull/75585/
1595 [75740]: https://github.com/rust-lang/rust/pull/75740/
1596 [75502]: https://github.com/rust-lang/rust/pull/75502/
1597 [74880]: https://github.com/rust-lang/rust/pull/74880/
1598 [74922]: https://github.com/rust-lang/rust/pull/74922/
1599 [74430]: https://github.com/rust-lang/rust/pull/74430/
1600 [74194]: https://github.com/rust-lang/rust/pull/74194/
1601 [73461]: https://github.com/rust-lang/rust/pull/73461/
1602 [73166]: https://github.com/rust-lang/rust/pull/73166/
1603 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
1604 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
1605 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
1606 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
1607 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
1608 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
1609 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
1610 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
1611 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
1612 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
1613 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
1614 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
1615 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
1616 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
1617 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
1618
1619
1620 Version 1.47.0 (2020-10-08)
1621 ==========================
1622
1623 Language
1624 --------
1625 - [Closures will now warn when not used.][74869]
1626
1627 Compiler
1628 --------
1629 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
1630   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
1631   platforms.
1632 - [Upgraded to LLVM 11.][73526]
1633 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
1634 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
1635 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
1636
1637 \* Refer to Rust's [platform support page][platform-support-doc] for more
1638 information on Rust's tiered platform support.
1639
1640 Libraries
1641 ---------
1642 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
1643 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
1644   those of length less than 33.][74060]
1645 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
1646 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
1647   `PartialEq`, and `PartialOrd`.][73583]
1648
1649 Stabilized APIs
1650 ---------------
1651 - [`Ident::new_raw`]
1652 - [`Range::is_empty`]
1653 - [`RangeInclusive::is_empty`]
1654 - [`Result::as_deref`]
1655 - [`Result::as_deref_mut`]
1656 - [`Vec::leak`]
1657 - [`pointer::offset_from`]
1658 - [`f32::TAU`]
1659 - [`f64::TAU`]
1660
1661 The following previously stable APIs have now been made const.
1662
1663 - [The `new` method for all `NonZero` integers.][73858]
1664 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
1665   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
1666   methods for all integers.][73858]
1667 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
1668   signed integers.][73858]
1669 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
1670   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
1671   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
1672   `is_ascii_control` methods for `char` and `u8`.][73858]
1673
1674 Cargo
1675 -----
1676 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
1677   You can override this by setting the following in your `Cargo.toml`.
1678   ```toml
1679   [profile.release.build-override]
1680   opt-level = 3
1681   ```
1682 - [`cargo-help` will now display man pages for commands rather just the
1683   `--help` text.][cargo/8456]
1684 - [`cargo-metadata` now emits a `test` field indicating if a target has
1685   tests enabled.][cargo/8478]
1686 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
1687 - [`cargo-publish` will now use an alternative registry by default if it's the
1688   only registry specified in `package.publish`.][cargo/8571]
1689
1690 Misc
1691 ----
1692 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
1693   type based search.][75366]
1694 - [Added the Ayu theme to rustdoc.][71237]
1695
1696 Compatibility Notes
1697 -------------------
1698 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
1699 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
1700 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
1701   help to preserve more span information.][73084] These changes may cause
1702   compiliation errors if your macro was unhygenic or didn't correctly handle
1703   `Delimiter::None`.
1704 - [Moved support for the CloudABI target to tier 3.][75568]
1705 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
1706 - [Added the `rustc-docs` component.][75560] This allows you to install
1707   and read the documentation for the compiler internal APIs. (Currently only
1708   available for `x86_64-unknown-linux-gnu`.)
1709
1710 Internal Only
1711 --------
1712
1713 - [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.
1714
1715 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
1716 [75048]: https://github.com/rust-lang/rust/pull/75048/
1717 [74163]: https://github.com/rust-lang/rust/pull/74163/
1718 [71237]: https://github.com/rust-lang/rust/pull/71237/
1719 [74869]: https://github.com/rust-lang/rust/pull/74869/
1720 [73858]: https://github.com/rust-lang/rust/pull/73858/
1721 [75716]: https://github.com/rust-lang/rust/pull/75716/
1722 [75560]: https://github.com/rust-lang/rust/pull/75560/
1723 [75568]: https://github.com/rust-lang/rust/pull/75568/
1724 [75366]: https://github.com/rust-lang/rust/pull/75366/
1725 [75204]: https://github.com/rust-lang/rust/pull/75204/
1726 [74650]: https://github.com/rust-lang/rust/pull/74650/
1727 [74419]: https://github.com/rust-lang/rust/pull/74419/
1728 [73964]: https://github.com/rust-lang/rust/pull/73964/
1729 [74021]: https://github.com/rust-lang/rust/pull/74021/
1730 [74060]: https://github.com/rust-lang/rust/pull/74060/
1731 [73893]: https://github.com/rust-lang/rust/pull/73893/
1732 [73526]: https://github.com/rust-lang/rust/pull/73526/
1733 [73583]: https://github.com/rust-lang/rust/pull/73583/
1734 [73084]: https://github.com/rust-lang/rust/pull/73084/
1735 [73197]: https://github.com/rust-lang/rust/pull/73197/
1736 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
1737 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
1738 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
1739 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
1740 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
1741 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
1742 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
1743 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
1744 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
1745 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
1746 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
1747 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
1748 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
1749 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
1750
1751
1752 Version 1.46.0 (2020-08-27)
1753 ==========================
1754
1755 Language
1756 --------
1757 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
1758 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
1759   const functions.][73862]
1760 - [The `#[track_caller]` attribute can now be added to functions to use the
1761   function's caller's location information for panic messages.][72445]
1762 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
1763   `x.0.0` over `(x.0).0`.
1764 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
1765   You currently can't use `mem::transmute` in constant functions.
1766
1767 Compiler
1768 --------
1769 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
1770 - [Enabled static "Position Independent Executables" by default
1771   for `x86_64-unknown-linux-musl`.][70740]
1772
1773 Libraries
1774 ---------
1775 - [`mem::forget` is now a `const fn`.][73887]
1776 - [`String` now implements `From<char>`.][73466]
1777 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
1778   integer types.][73032]
1779 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
1780 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
1781   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
1782 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
1783 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
1784 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
1785
1786 Stabilized APIs
1787 ---------------
1788 - [`Option::zip`]
1789 - [`vec::Drain::as_slice`]
1790
1791 Cargo
1792 -----
1793 Added a number of new environment variables that are now available when
1794 compiling your crate.
1795
1796 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
1797   the specific binary being compiled and the name of the crate.
1798 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
1799 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
1800
1801 Compatibility Notes
1802 -------------------
1803 - [The target configuration option `abi_blacklist` has been renamed
1804   to `unsupported_abis`.][74150] The old name will still continue to work.
1805 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
1806   This was previously accepted but will become a hard error in a future release.
1807 - [Rustc will fail to compile if you have a struct with
1808   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
1809   allowed on `enum`s.
1810 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
1811   ensure that spans have the correct information, and may cause breakage if you
1812   were relying on receiving spans with dummy information.
1813 - [The InnoSetup installer for Windows is no longer available.][72569] This was
1814   a legacy installer that was replaced by a MSI installer a few years ago but
1815   was still being built.
1816 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
1817 - [Rustc will no longer accept overlapping trait implementations that only
1818   differ in how the lifetime was bound.][72493]
1819 - [Rustc now correctly relates the lifetime of an existential associated
1820   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
1821   you to pass a shorter lifetime than expected.
1822 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
1823   The library will need to be installed for `rustc` to work, even though we
1824   expect it to be already available on most systems.
1825 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
1826   under QEMU.][74820]
1827 - [Pretty printing of some tokens in procedural macros changed.][75453] The
1828   exact output returned by rustc's pretty printing is an unstable
1829   implementation detail: we recommend any macro relying on it to switch to a
1830   more robust parsing system.
1831
1832 [75453]: https://github.com/rust-lang/rust/issues/75453/
1833 [74820]: https://github.com/rust-lang/rust/issues/74820/
1834 [74420]: https://github.com/rust-lang/rust/issues/74420/
1835 [74109]: https://github.com/rust-lang/rust/pull/74109/
1836 [74150]: https://github.com/rust-lang/rust/pull/74150/
1837 [73862]: https://github.com/rust-lang/rust/pull/73862/
1838 [73887]: https://github.com/rust-lang/rust/pull/73887/
1839 [73466]: https://github.com/rust-lang/rust/pull/73466/
1840 [73516]: https://github.com/rust-lang/rust/pull/73516/
1841 [73293]: https://github.com/rust-lang/rust/pull/73293/
1842 [73007]: https://github.com/rust-lang/rust/pull/73007/
1843 [73032]: https://github.com/rust-lang/rust/pull/73032/
1844 [72920]: https://github.com/rust-lang/rust/pull/72920/
1845 [72569]: https://github.com/rust-lang/rust/pull/72569/
1846 [72583]: https://github.com/rust-lang/rust/pull/72583/
1847 [72584]: https://github.com/rust-lang/rust/pull/72584/
1848 [72717]: https://github.com/rust-lang/rust/pull/72717/
1849 [72437]: https://github.com/rust-lang/rust/pull/72437/
1850 [72445]: https://github.com/rust-lang/rust/pull/72445/
1851 [72486]: https://github.com/rust-lang/rust/pull/72486/
1852 [72493]: https://github.com/rust-lang/rust/pull/72493/
1853 [72331]: https://github.com/rust-lang/rust/pull/72331/
1854 [71896]: https://github.com/rust-lang/rust/pull/71896/
1855 [71660]: https://github.com/rust-lang/rust/pull/71660/
1856 [71322]: https://github.com/rust-lang/rust/pull/71322/
1857 [70740]: https://github.com/rust-lang/rust/pull/70740/
1858 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
1859 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
1860 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
1861 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
1862 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
1863
1864
1865 Version 1.45.2 (2020-08-03)
1866 ==========================
1867
1868 * [Fix bindings in tuple struct patterns][74954]
1869 * [Fix track_caller integration with trait objects][74784]
1870
1871 [74954]: https://github.com/rust-lang/rust/issues/74954
1872 [74784]: https://github.com/rust-lang/rust/issues/74784
1873
1874
1875 Version 1.45.1 (2020-07-30)
1876 ==========================
1877
1878 * [Fix const propagation with references.][73613]
1879 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1880 * [Avoid spurious implicit region bound.][74509]
1881 * [Install clippy on x.py install][74457]
1882
1883 [73613]: https://github.com/rust-lang/rust/pull/73613
1884 [73078]: https://github.com/rust-lang/rust/issues/73078
1885 [74509]: https://github.com/rust-lang/rust/pull/74509
1886 [74457]: https://github.com/rust-lang/rust/pull/74457
1887
1888
1889 Version 1.45.0 (2020-07-16)
1890 ==========================
1891
1892 Language
1893 --------
1894 - [Out of range float to int conversions using `as` has been defined as a saturating
1895   conversion.][71269] This was previously undefined behaviour, but you can use the
1896    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
1897    may be desirable in rare performance sensitive situations.
1898 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
1899   using `u64`.][70705]
1900 - [Function like procedural macros can now be used in expression, pattern, and  statement
1901   positions.][68717] This means you can now use a function-like procedural macro
1902   anywhere you can use a declarative (`macro_rules!`) macro.
1903
1904 Compiler
1905 --------
1906 - [You can now override individual target features through the `target-feature`
1907   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
1908   equivalent to `-C target-feature=+avx2,+fma`.
1909 - [Added the `force-unwind-tables` flag.][69984] This option allows
1910   rustc to always generate unwind tables regardless of panic strategy.
1911 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
1912   to include LLVM bitcode into generated `rlib`s (this is on by default).
1913 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
1914 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
1915 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
1916 - [Upgraded to LLVM 10.][67759]
1917
1918 \* Refer to Rust's [platform support page][platform-support-doc] for more
1919 information on Rust's tiered platform support.
1920
1921
1922 Libraries
1923 ---------
1924 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
1925   and `Ord`.][72239]
1926 - [`proc_macro::TokenStream` now implements `Default`.][72234]
1927 - [You can now use `char` with
1928   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
1929   a range of codepoints.][72413] E.g.
1930   you can now write the following;
1931   ```rust
1932   for ch in 'a'..='z' {
1933       print!("{}", ch);
1934   }
1935   println!();
1936   // Prints "abcdefghijklmnopqrstuvwxyz"
1937   ```
1938 - [`OsString` now implements `FromStr`.][71662]
1939 - [The `saturating_neg` method has been added to all signed integer primitive
1940   types, and the `saturating_abs` method has been added for all integer
1941   primitive types.][71886]
1942 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
1943   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
1944   or `Path`.][71447]
1945 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
1946 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
1947   integer types.][69813]
1948 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
1949   integer types.][72324]
1950 - [The `fetch_update` method has been added to all atomic integer types.][71843]
1951
1952 Stabilized APIs
1953 ---------------
1954 - [`Arc::as_ptr`]
1955 - [`BTreeMap::remove_entry`]
1956 - [`Rc::as_ptr`]
1957 - [`rc::Weak::as_ptr`]
1958 - [`rc::Weak::from_raw`]
1959 - [`rc::Weak::into_raw`]
1960 - [`str::strip_prefix`]
1961 - [`str::strip_suffix`]
1962 - [`sync::Weak::as_ptr`]
1963 - [`sync::Weak::from_raw`]
1964 - [`sync::Weak::into_raw`]
1965 - [`char::UNICODE_VERSION`]
1966 - [`Span::resolved_at`]
1967 - [`Span::located_at`]
1968 - [`Span::mixed_site`]
1969 - [`unix::process::CommandExt::arg0`]
1970
1971 Cargo
1972 -----
1973
1974 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
1975   time.][cargo/8066]
1976
1977 Misc
1978 ----
1979 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
1980   `~~outdated information~~` becomes "~~outdated information~~".
1981 - [Added an emoji to Rustdoc's deprecated API message.][72014]
1982
1983 Compatibility Notes
1984 -------------------
1985 - [Trying to self initialize a static value (that is creating a value using
1986   itself) is unsound and now causes a compile error.][71140]
1987 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
1988   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
1989 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
1990   previously undocumented and not intended for public use. Rustdoc still provides
1991   a non-zero exit code on errors.
1992 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
1993   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
1994   flags while cargo is adding `embed-bitcode` itself. The recommended way to
1995   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
1996   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
1997
1998 Internals Only
1999 --------------
2000 - [Make clippy a git subtree instead of a git submodule][70655]
2001 - [Unify the undo log of all snapshot types][69464]
2002
2003 [71848]: https://github.com/rust-lang/rust/issues/71848/
2004 [73420]: https://github.com/rust-lang/rust/issues/73420/
2005 [72324]: https://github.com/rust-lang/rust/pull/72324/
2006 [71843]: https://github.com/rust-lang/rust/pull/71843/
2007 [71886]: https://github.com/rust-lang/rust/pull/71886/
2008 [72234]: https://github.com/rust-lang/rust/pull/72234/
2009 [72239]: https://github.com/rust-lang/rust/pull/72239/
2010 [72397]: https://github.com/rust-lang/rust/pull/72397/
2011 [72413]: https://github.com/rust-lang/rust/pull/72413/
2012 [72014]: https://github.com/rust-lang/rust/pull/72014/
2013 [72062]: https://github.com/rust-lang/rust/pull/72062/
2014 [72094]: https://github.com/rust-lang/rust/pull/72094/
2015 [72133]: https://github.com/rust-lang/rust/pull/72133/
2016 [67759]: https://github.com/rust-lang/rust/pull/67759/
2017 [71900]: https://github.com/rust-lang/rust/pull/71900/
2018 [71928]: https://github.com/rust-lang/rust/pull/71928/
2019 [71662]: https://github.com/rust-lang/rust/pull/71662/
2020 [71716]: https://github.com/rust-lang/rust/pull/71716/
2021 [71447]: https://github.com/rust-lang/rust/pull/71447/
2022 [71269]: https://github.com/rust-lang/rust/pull/71269/
2023 [71095]: https://github.com/rust-lang/rust/pull/71095/
2024 [71140]: https://github.com/rust-lang/rust/pull/71140/
2025 [70655]: https://github.com/rust-lang/rust/pull/70655/
2026 [70705]: https://github.com/rust-lang/rust/pull/70705/
2027 [69984]: https://github.com/rust-lang/rust/pull/69984/
2028 [69813]: https://github.com/rust-lang/rust/pull/69813/
2029 [69464]: https://github.com/rust-lang/rust/pull/69464/
2030 [68717]: https://github.com/rust-lang/rust/pull/68717/
2031 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
2032 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
2033 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
2034 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
2035 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
2036 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
2037 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
2038 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
2039 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
2040 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
2041 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
2042 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
2043 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
2044 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
2045 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
2046 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
2047 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
2048
2049
2050 Version 1.44.1 (2020-06-18)
2051 ===========================
2052
2053 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
2054 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
2055 * [Fix crashes when finding backtrace on macOS.][71397]
2056 * [Clippy applies lint levels into different files.][clippy/5356]
2057
2058 [71397]: https://github.com/rust-lang/rust/issues/71397
2059 [73078]: https://github.com/rust-lang/rust/issues/73078
2060 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
2061 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
2062
2063
2064 Version 1.44.0 (2020-06-04)
2065 ==========================
2066
2067 Language
2068 --------
2069 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
2070 - [Added the `unused_braces` lint.][70081]
2071
2072 **Syntax-only changes**
2073
2074 - [Expansion-driven outline module parsing][69838]
2075 ```rust
2076 #[cfg(FALSE)]
2077 mod foo {
2078     mod bar {
2079         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
2080     }
2081 }
2082 ```
2083
2084 These are still rejected semantically, so you will likely receive an error but
2085 these changes can be seen and parsed by macros and conditional compilation.
2086
2087 Compiler
2088 --------
2089 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
2090   Additionally when in incremental mode rustc defaults to 256 codegen units.
2091 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
2092   a panic is thrown.][67502]
2093 - [Added tier 3\* support for the `aarch64-unknown-none` and
2094   `aarch64-unknown-none-softfloat` targets.][68334]
2095 - [Added tier 3 support for `arm64-apple-tvos` and
2096   `x86_64-apple-tvos` targets.][68191]
2097
2098
2099 Libraries
2100 ---------
2101 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
2102   `vec![]` to be able to be used in `const` contexts.
2103 - [`convert::Infallible` now implements `Hash`.][70281]
2104 - [`OsString` now implements `DerefMut` and `IndexMut` returning
2105   a `&mut OsStr`.][70048]
2106 - [Unicode 13 is now supported.][69929]
2107 - [`String` now implements `From<&mut str>`.][69661]
2108 - [`IoSlice` now implements `Copy`.][69403]
2109 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
2110 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
2111 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
2112   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
2113   integer types.][69373]
2114
2115 Stabilized APIs
2116 ---------------
2117 - [`PathBuf::with_capacity`]
2118 - [`PathBuf::capacity`]
2119 - [`PathBuf::clear`]
2120 - [`PathBuf::reserve`]
2121 - [`PathBuf::reserve_exact`]
2122 - [`PathBuf::shrink_to_fit`]
2123 - [`f32::to_int_unchecked`]
2124 - [`f64::to_int_unchecked`]
2125 - [`Layout::align_to`]
2126 - [`Layout::pad_to_align`]
2127 - [`Layout::array`]
2128 - [`Layout::extend`]
2129
2130 Cargo
2131 -----
2132 - [Added the `cargo tree` command which will print a tree graph of
2133   your dependencies.][cargo/8062] E.g.
2134   ```
2135     mdbook v0.3.2 (/Users/src/rust/mdbook)
2136   ├── ammonia v3.0.0
2137   │   ├── html5ever v0.24.0
2138   │   │   ├── log v0.4.8
2139   │   │   │   └── cfg-if v0.1.9
2140   │   │   ├── mac v0.1.1
2141   │   │   └── markup5ever v0.9.0
2142   │   │       ├── log v0.4.8 (*)
2143   │   │       ├── phf v0.7.24
2144   │   │       │   └── phf_shared v0.7.24
2145   │   │       │       ├── siphasher v0.2.3
2146   │   │       │       └── unicase v1.4.2
2147   │   │       │           [build-dependencies]
2148   │   │       │           └── version_check v0.1.5
2149   ...
2150   ```
2151   You can also display dependencies on multiple versions of the same crate with
2152   `cargo tree -d` (short for `cargo tree --duplicates`).
2153
2154 Misc
2155 ----
2156 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
2157   the version in the sidebar.][69494]
2158
2159 Compatibility Notes
2160 -------------------
2161 - [Rustc now correctly generates static libraries on Windows GNU targets with
2162   the `.a` extension, rather than the previous `.lib`.][70937]
2163 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
2164 - [The `file_name` property in JSON output of macro errors now points the actual
2165   source file rather than the previous format of `<NAME macros>`.][70969]
2166   **Note:** this may not point to a file that actually exists on the user's system.
2167 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
2168 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
2169   not allow zero initialization such as `NonZeroU8`.][66059] This was
2170   previously a warning.
2171 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
2172   operator has been defined as a saturating operation.][71269] This was previously
2173   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
2174   continue using the current behaviour, which may be desirable in rare performance
2175   sensitive situations.
2176
2177 Internal Only
2178 -------------
2179 These changes provide no direct user facing benefits, but represent significant
2180 improvements to the internals and overall performance of rustc and
2181 related tools.
2182
2183 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
2184 - [Replace big JS dict with JSON parsing.][71250]
2185
2186 [69373]: https://github.com/rust-lang/rust/pull/69373/
2187 [66059]: https://github.com/rust-lang/rust/pull/66059/
2188 [68191]: https://github.com/rust-lang/rust/pull/68191/
2189 [68899]: https://github.com/rust-lang/rust/pull/68899/
2190 [71147]: https://github.com/rust-lang/rust/pull/71147/
2191 [71250]: https://github.com/rust-lang/rust/pull/71250/
2192 [70937]: https://github.com/rust-lang/rust/pull/70937/
2193 [70969]: https://github.com/rust-lang/rust/pull/70969/
2194 [70632]: https://github.com/rust-lang/rust/pull/70632/
2195 [70281]: https://github.com/rust-lang/rust/pull/70281/
2196 [70345]: https://github.com/rust-lang/rust/pull/70345/
2197 [70048]: https://github.com/rust-lang/rust/pull/70048/
2198 [70081]: https://github.com/rust-lang/rust/pull/70081/
2199 [70156]: https://github.com/rust-lang/rust/pull/70156/
2200 [71269]: https://github.com/rust-lang/rust/pull/71269/
2201 [69838]: https://github.com/rust-lang/rust/pull/69838/
2202 [69929]: https://github.com/rust-lang/rust/pull/69929/
2203 [69661]: https://github.com/rust-lang/rust/pull/69661/
2204 [69778]: https://github.com/rust-lang/rust/pull/69778/
2205 [69494]: https://github.com/rust-lang/rust/pull/69494/
2206 [69403]: https://github.com/rust-lang/rust/pull/69403/
2207 [69033]: https://github.com/rust-lang/rust/pull/69033/
2208 [68692]: https://github.com/rust-lang/rust/pull/68692/
2209 [68334]: https://github.com/rust-lang/rust/pull/68334/
2210 [67502]: https://github.com/rust-lang/rust/pull/67502/
2211 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
2212 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
2213 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
2214 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
2215 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
2216 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
2217 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
2218 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
2219 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
2220 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
2221 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
2222 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
2223 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
2224
2225
2226 Version 1.43.1 (2020-05-07)
2227 ===========================
2228
2229 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
2230 * [Fixed the stabilization of AVX-512 features.][71473]
2231 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
2232
2233 [71430]: https://github.com/rust-lang/rust/pull/71430
2234 [71473]: https://github.com/rust-lang/rust/issues/71473
2235 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
2236
2237
2238 Version 1.43.0 (2020-04-23)
2239 ==========================
2240
2241 Language
2242 --------
2243 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
2244   the type inferred correctly.][68129]
2245 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
2246
2247 **Syntax only changes**
2248 - [Allow `type Foo: Ord` syntactically.][69361]
2249 - [Fuse associated and extern items up to defaultness.][69194]
2250 - [Syntactically allow `self` in all `fn` contexts.][68764]
2251 - [Merge `fn` syntax + cleanup item parsing.][68728]
2252 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
2253   For example, you may now write:
2254   ```rust
2255   macro_rules! mac_trait {
2256       ($i:item) => {
2257           trait T { $i }
2258       }
2259   }
2260   mac_trait! {
2261       fn foo() {}
2262   }
2263   ```
2264
2265 These are still rejected *semantically*, so you will likely receive an error but
2266 these changes can be seen and parsed by macros and
2267 conditional compilation.
2268
2269
2270 Compiler
2271 --------
2272 - [You can now pass multiple lint flags to rustc to override the previous
2273   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
2274   everything in the `unused` lint group except `unused-variables` which
2275   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
2276   everything in the `unused` lint group **including** `unused-variables` since
2277   the allow flag is specified before the deny flag (and therefore overridden).
2278 - [rustc will now prefer your system MinGW libraries over its bundled libraries
2279   if they are available on `windows-gnu`.][67429]
2280 - [rustc now buffers errors/warnings printed in JSON.][69227]
2281
2282 Libraries
2283 ---------
2284 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
2285   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
2286   respectively.][69538] **Note** These conversions are only available when `N`
2287   is `0..=32`.
2288 - [You can now use associated constants on floats and integers directly, rather
2289   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
2290   `f32::NAN` with no imports.
2291 - [`u8::is_ascii` is now `const`.][68984]
2292 - [`String` now implements `AsMut<str>`.][68742]
2293 - [Added the `primitive` module to `std` and `core`.][67637] This module
2294   reexports Rust's primitive types. This is mainly useful in macros
2295   where you want avoid these types being shadowed.
2296 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
2297 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
2298
2299 Stabilized APIs
2300 ---------------
2301 - [`Once::is_completed`]
2302 - [`f32::LOG10_2`]
2303 - [`f32::LOG2_10`]
2304 - [`f64::LOG10_2`]
2305 - [`f64::LOG2_10`]
2306 - [`iter::once_with`]
2307
2308 Cargo
2309 -----
2310 - [You can now set config `[profile]`s in your `.cargo/config`, or through
2311   your environment.][cargo/7823]
2312 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
2313   executable path when running integration tests or benchmarks.][cargo/7697]
2314   `<name>` is the name of your binary as-is e.g. If you wanted the executable
2315   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
2316
2317 Misc
2318 ----
2319 - [Certain checks in the `const_err` lint were deemed unrelated to const
2320   evaluation][69185], and have been moved to the `unconditional_panic` and
2321   `arithmetic_overflow` lints.
2322
2323 Compatibility Notes
2324 -------------------
2325
2326 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
2327   has been a warning since 1.36.0.
2328 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
2329   led to some instances being accepted, and now correctly emits a hard error.
2330
2331 [69340]: https://github.com/rust-lang/rust/pull/69340
2332
2333 Internal Only
2334 -------------
2335 These changes provide no direct user facing benefits, but represent significant
2336 improvements to the internals and overall performance of `rustc` and
2337 related tools.
2338
2339 - [All components are now built with `opt-level=3` instead of `2`.][67878]
2340 - [Improved how rustc generates drop code.][67332]
2341 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
2342 - [traits: preallocate 2 Vecs of known initial size][69022]
2343 - [Avoid exponential behaviour when relating types][68772]
2344 - [Skip `Drop` terminators for enum variants without drop glue][68943]
2345 - [Improve performance of coherence checks][68966]
2346 - [Deduplicate types in the generator witness][68672]
2347 - [Invert control in struct_lint_level.][68725]
2348
2349 [67332]: https://github.com/rust-lang/rust/pull/67332/
2350 [67429]: https://github.com/rust-lang/rust/pull/67429/
2351 [67637]: https://github.com/rust-lang/rust/pull/67637/
2352 [67642]: https://github.com/rust-lang/rust/pull/67642/
2353 [67878]: https://github.com/rust-lang/rust/pull/67878/
2354 [67885]: https://github.com/rust-lang/rust/pull/67885/
2355 [68129]: https://github.com/rust-lang/rust/pull/68129/
2356 [68672]: https://github.com/rust-lang/rust/pull/68672/
2357 [68725]: https://github.com/rust-lang/rust/pull/68725/
2358 [68728]: https://github.com/rust-lang/rust/pull/68728/
2359 [68738]: https://github.com/rust-lang/rust/pull/68738/
2360 [68742]: https://github.com/rust-lang/rust/pull/68742/
2361 [68764]: https://github.com/rust-lang/rust/pull/68764/
2362 [68772]: https://github.com/rust-lang/rust/pull/68772/
2363 [68943]: https://github.com/rust-lang/rust/pull/68943/
2364 [68952]: https://github.com/rust-lang/rust/pull/68952/
2365 [68966]: https://github.com/rust-lang/rust/pull/68966/
2366 [68984]: https://github.com/rust-lang/rust/pull/68984/
2367 [69022]: https://github.com/rust-lang/rust/pull/69022/
2368 [69185]: https://github.com/rust-lang/rust/pull/69185/
2369 [69194]: https://github.com/rust-lang/rust/pull/69194/
2370 [69201]: https://github.com/rust-lang/rust/pull/69201/
2371 [69227]: https://github.com/rust-lang/rust/pull/69227/
2372 [69548]: https://github.com/rust-lang/rust/pull/69548/
2373 [69256]: https://github.com/rust-lang/rust/pull/69256/
2374 [69361]: https://github.com/rust-lang/rust/pull/69361/
2375 [69366]: https://github.com/rust-lang/rust/pull/69366/
2376 [69538]: https://github.com/rust-lang/rust/pull/69538/
2377 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
2378 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
2379 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
2380 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
2381 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
2382 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
2383 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
2384 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
2385
2386
2387 Version 1.42.0 (2020-03-12)
2388 ==========================
2389
2390 Language
2391 --------
2392 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
2393   ```rust
2394   fn foo(words: &[&str]) {
2395       match words {
2396           ["Hello", "World", "!", ..] => println!("Hello World!"),
2397           ["Foo", "Bar", ..] => println!("Baz"),
2398           rest => println!("{:?}", rest),
2399       }
2400   }
2401   ```
2402 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
2403   that you can create an enum that has the exact layout and ABI of the type
2404   it contains.
2405 - [You can now use outer attribute procedural macros on inline modules.][64273]
2406 - [There are some *syntax-only* changes:][67131]
2407    - `default` is syntactically allowed before items in `trait` definitions.
2408    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
2409      leave out their bodies in favor of `;`.
2410    - Bounds on associated types in `impl`s are now syntactically allowed
2411      (e.g. `type Foo: Ord;`).
2412    - `...` (the C-variadic type) may occur syntactically directly as the type of
2413       any function parameter.
2414
2415   These are still rejected *semantically*, so you will likely receive an error
2416   but these changes can be seen and parsed by procedural macros and
2417   conditional compilation.
2418
2419 Compiler
2420 --------
2421 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
2422 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
2423 - [`Option::{expect,unwrap}` and
2424    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
2425    pointing to the location where they were called, rather than
2426    `core`'s internals. ][67887]
2427
2428 \* Refer to Rust's [platform support page][platform-support-doc] for more
2429 information on Rust's tiered platform support.
2430
2431 Libraries
2432 ---------
2433 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
2434 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
2435    to implement `Sized`.][67935]
2436 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
2437 - [`Layout::new` is now `const`.][66254]
2438 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
2439
2440
2441 Stabilized APIs
2442 ---------------
2443 - [`CondVar::wait_while`]
2444 - [`CondVar::wait_timeout_while`]
2445 - [`DebugMap::key`]
2446 - [`DebugMap::value`]
2447 - [`ManuallyDrop::take`]
2448 - [`matches!`]
2449 - [`ptr::slice_from_raw_parts_mut`]
2450 - [`ptr::slice_from_raw_parts`]
2451
2452 Cargo
2453 -----
2454 - [You no longer need to include `extern crate proc_macro;` to be able to
2455   `use proc_macro;` in the `2018` edition.][cargo/7700]
2456
2457 Compatibility Notes
2458 -------------------
2459 - [`Error::description` has been deprecated, and its use will now produce a
2460   warning.][66919] It's recommended to use `Display`/`to_string` instead.
2461
2462 [68253]: https://github.com/rust-lang/rust/pull/68253/
2463 [68348]: https://github.com/rust-lang/rust/pull/68348/
2464 [67935]: https://github.com/rust-lang/rust/pull/67935/
2465 [68339]: https://github.com/rust-lang/rust/pull/68339/
2466 [68122]: https://github.com/rust-lang/rust/pull/68122/
2467 [64273]: https://github.com/rust-lang/rust/pull/64273/
2468 [67712]: https://github.com/rust-lang/rust/pull/67712/
2469 [67887]: https://github.com/rust-lang/rust/pull/67887/
2470 [67131]: https://github.com/rust-lang/rust/pull/67131/
2471 [67233]: https://github.com/rust-lang/rust/pull/67233/
2472 [66899]: https://github.com/rust-lang/rust/pull/66899/
2473 [66919]: https://github.com/rust-lang/rust/pull/66919/
2474 [66254]: https://github.com/rust-lang/rust/pull/66254/
2475 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
2476 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
2477 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
2478 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
2479 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
2480 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
2481 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
2482 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
2483 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
2484
2485
2486 Version 1.41.1 (2020-02-27)
2487 ===========================
2488
2489 * [Always check types of static items][69145]
2490 * [Always check lifetime bounds of `Copy` impls][69145]
2491 * [Fix miscompilation in callers of `Layout::repeat`][69225]
2492
2493 [69225]: https://github.com/rust-lang/rust/issues/69225
2494 [69145]: https://github.com/rust-lang/rust/pull/69145
2495
2496
2497 Version 1.41.0 (2020-01-30)
2498 ===========================
2499
2500 Language
2501 --------
2502
2503 - [You can now pass type parameters to foreign items when implementing
2504   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
2505 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
2506   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
2507   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
2508 - [You can now use any valid identifier in a `format_args` macro.][66847]
2509   Previously identifiers starting with an underscore were not allowed.
2510 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
2511   enum variants.][66183] These are still rejected semantically, but
2512   can be seen and parsed by procedural macros and conditional compilation.
2513 - [You can now define a Rust `extern "C"` function with `Box<T>` and use `T*` as the corresponding
2514   type on the C side.][62514] Please see [the documentation][box-memory-layout] for more information,
2515   including the important caveat about preferring to avoid `Box<T>` in Rust signatures for functions defined in C.
2516
2517 [box-memory-layout]: https://doc.rust-lang.org/std/boxed/index.html#memory-layout
2518
2519 Compiler
2520 --------
2521
2522 - [Rustc will now warn if you have unused loop `'label`s.][66325]
2523 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
2524 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
2525 - [You can now pass an arguments file passing the `@path` syntax
2526   to rustc.][66172] Note that the format differs somewhat from what is
2527   found in other tooling; please see [the documentation][argfile-docs] for
2528   more information.
2529 - [You can now provide `--extern` flag without a path, indicating that it is
2530   available from the search path or specified with an `-L` flag.][64882]
2531
2532 \* Refer to Rust's [platform support page][platform-support-doc] for more
2533 information on Rust's tiered platform support.
2534
2535 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
2536
2537 Libraries
2538 ---------
2539
2540 - [The `core::panic` module is now stable.][66771] It was already stable
2541   through `std`.
2542 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
2543   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
2544 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
2545
2546 Stabilized APIs
2547 ---------------
2548
2549 - [`Result::map_or`]
2550 - [`Result::map_or_else`]
2551 - [`std::rc::Weak::weak_count`]
2552 - [`std::rc::Weak::strong_count`]
2553 - [`std::sync::Weak::weak_count`]
2554 - [`std::sync::Weak::strong_count`]
2555
2556 Cargo
2557 -----
2558
2559 - [Cargo will now document all the private items for binary crates
2560   by default.][cargo/7593]
2561 - [`cargo-install` will now reinstall the package if it detects that it is out
2562   of date.][cargo/7560]
2563 - [Cargo.lock now uses a more git friendly format that should help to reduce
2564   merge conflicts.][cargo/7579]
2565 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
2566   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
2567   optimisation level to `2` for debug builds. You can also use
2568   `[profile.<profile>.build-override]` to override build scripts and
2569   their dependencies.
2570
2571 Misc
2572 ----
2573
2574 - [You can now specify `edition` in documentation code blocks to compile the block
2575   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
2576   should be compiled the 2018 edition of Rust.
2577 - [You can now provide custom themes to rustdoc with `--theme`, and check the
2578   current theme with `--check-theme`.][54733]
2579 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
2580
2581 Compatibility Notes
2582 -------------------
2583
2584 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
2585   Apple targets.][apple-32bit-drop] This means that the source code is still
2586   available to build, but the targets are no longer being tested and release
2587   binaries for those platforms will no longer be distributed by the Rust project.
2588   Please refer to the linked blog post for more information.
2589
2590 [54733]: https://github.com/rust-lang/rust/pull/54733/
2591 [61351]: https://github.com/rust-lang/rust/pull/61351/
2592 [62514]: https://github.com/rust-lang/rust/pull/62514/
2593 [67255]: https://github.com/rust-lang/rust/pull/67255/
2594 [66661]: https://github.com/rust-lang/rust/pull/66661/
2595 [66771]: https://github.com/rust-lang/rust/pull/66771/
2596 [66847]: https://github.com/rust-lang/rust/pull/66847/
2597 [66238]: https://github.com/rust-lang/rust/pull/66238/
2598 [66277]: https://github.com/rust-lang/rust/pull/66277/
2599 [66325]: https://github.com/rust-lang/rust/pull/66325/
2600 [66172]: https://github.com/rust-lang/rust/pull/66172/
2601 [66183]: https://github.com/rust-lang/rust/pull/66183/
2602 [65879]: https://github.com/rust-lang/rust/pull/65879/
2603 [65013]: https://github.com/rust-lang/rust/pull/65013/
2604 [64882]: https://github.com/rust-lang/rust/pull/64882/
2605 [64325]: https://github.com/rust-lang/rust/pull/64325/
2606 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
2607 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
2608 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
2609 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
2610 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
2611 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
2612 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
2613 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
2614 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
2615 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
2616 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
2617
2618 Version 1.40.0 (2019-12-19)
2619 ===========================
2620
2621 Language
2622 --------
2623 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
2624   `const` contexts.][65188] e.g.
2625
2626   ```rust
2627   pub struct Point(i32, i32);
2628
2629   const ORIGIN: Point = {
2630       let constructor = Point;
2631
2632       constructor(0, 0)
2633   };
2634   ```
2635
2636 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
2637   indicate that there may be variants or fields added in the future.][64639]
2638   For example this requires adding a wild-card branch (`_ => {}`) to any match
2639   statements on a non-exhaustive `enum`. [(RFC 2008)]
2640 - [You can now use function-like procedural macros in `extern` blocks and in
2641   type positions.][63931] e.g. `type Generated = macro!();`
2642 - [Function-like and attribute procedural macros can now emit
2643   `macro_rules!` items, so you can now have your macros generate macros.][64035]
2644 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
2645   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
2646   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
2647
2648 Compiler
2649 --------
2650 - [Added tier 3 support\* for the
2651   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
2652 - [Added tier 3 support for the
2653   `aarch64-unknown-none-softfloat` target.][64589]
2654 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
2655   `mips64el-unknown-linux-muslabi64` targets.][65843]
2656
2657 \* Refer to Rust's [platform support page][platform-support-doc] for more
2658   information on Rust's tiered platform support.
2659
2660 Libraries
2661 ---------
2662 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
2663
2664 Stabilized APIs
2665 ---------------
2666 - [`BTreeMap::get_key_value`]
2667 - [`HashMap::get_key_value`]
2668 - [`Option::as_deref_mut`]
2669 - [`Option::as_deref`]
2670 - [`Option::flatten`]
2671 - [`UdpSocket::peer_addr`]
2672 - [`f32::to_be_bytes`]
2673 - [`f32::to_le_bytes`]
2674 - [`f32::to_ne_bytes`]
2675 - [`f64::to_be_bytes`]
2676 - [`f64::to_le_bytes`]
2677 - [`f64::to_ne_bytes`]
2678 - [`f32::from_be_bytes`]
2679 - [`f32::from_le_bytes`]
2680 - [`f32::from_ne_bytes`]
2681 - [`f64::from_be_bytes`]
2682 - [`f64::from_le_bytes`]
2683 - [`f64::from_ne_bytes`]
2684 - [`mem::take`]
2685 - [`slice::repeat`]
2686 - [`todo!`]
2687
2688 Cargo
2689 -----
2690 - [Cargo will now always display warnings, rather than only on
2691   fresh builds.][cargo/7450]
2692 - [Feature flags (except `--all-features`) passed to a virtual workspace will
2693   now produce an error.][cargo/7507] Previously these flags were ignored.
2694 - [You can now publish `dev-dependencies` without including
2695   a `version`.][cargo/7333]
2696
2697 Misc
2698 ----
2699 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
2700   when running documentation tests with `rustdoc`.][63803]
2701
2702 Compatibility Notes
2703 -------------------
2704 - [As previously announced, any previous NLL warnings in the 2015 edition are
2705   now hard errors.][64221]
2706 - [The `include!` macro will now warn if it failed to include the
2707   entire file.][64284] The `include!` macro unintentionally only includes the
2708   first _expression_ in a file, and this can be unintuitive. This will become
2709   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
2710 - [Using `#[inline]` on function prototypes and consts now emits a warning under
2711   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
2712   or `extern` blocks now correctly emits a hard error.
2713
2714 [65294]: https://github.com/rust-lang/rust/pull/65294/
2715 [66103]: https://github.com/rust-lang/rust/pull/66103/
2716 [65843]: https://github.com/rust-lang/rust/pull/65843/
2717 [65188]: https://github.com/rust-lang/rust/pull/65188/
2718 [65092]: https://github.com/rust-lang/rust/pull/65092/
2719 [64589]: https://github.com/rust-lang/rust/pull/64589/
2720 [64639]: https://github.com/rust-lang/rust/pull/64639/
2721 [64221]: https://github.com/rust-lang/rust/pull/64221/
2722 [64284]: https://github.com/rust-lang/rust/pull/64284/
2723 [63931]: https://github.com/rust-lang/rust/pull/63931/
2724 [64035]: https://github.com/rust-lang/rust/pull/64035/
2725 [63674]: https://github.com/rust-lang/rust/pull/63674/
2726 [63803]: https://github.com/rust-lang/rust/pull/63803/
2727 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
2728 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
2729 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
2730 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
2731 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
2732 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
2733 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
2734 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
2735 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
2736 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
2737 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
2738 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
2739 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
2740 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
2741 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
2742 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
2743 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
2744 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
2745 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
2746 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
2747 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
2748 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
2749 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
2750 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
2751 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
2752
2753
2754 Version 1.39.0 (2019-11-07)
2755 ===========================
2756
2757 Language
2758 --------
2759 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
2760   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
2761 - [You can now use certain attributes on function, closure, and function pointer
2762   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
2763   `deny`, `forbid` as well as inert helper attributes used by procedural macro
2764   attributes applied to items. e.g.
2765   ```rust
2766   fn len(
2767       #[cfg(windows)] slice: &[u16],
2768       #[cfg(not(windows))] slice: &[u8],
2769   ) -> usize {
2770       slice.len()
2771   }
2772   ```
2773 - [You can now take shared references to bind-by-move patterns in the `if` guards
2774   of `match` arms.][63118] e.g.
2775   ```rust
2776   fn main() {
2777       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
2778
2779       match array {
2780           nums
2781   //      ---- `nums` is bound by move.
2782               if nums.iter().sum::<u8>() == 10
2783   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
2784           => {
2785               drop(nums);
2786   //          ----------- Legal as `nums` was bound by move and so we have ownership.
2787           }
2788           _ => unreachable!(),
2789       }
2790   }
2791   ```
2792
2793
2794
2795 Compiler
2796 --------
2797 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
2798 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
2799 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
2800   **Note** Cargo currently doesn't use this feature. Refer to
2801   [cargo#7315][cargo/7315] to track this feature's progress.
2802 - [You can now pass `--show-output` argument to test binaries to print the
2803   output of successful tests.][62600]
2804
2805
2806 \* Refer to Rust's [platform support page][platform-support-doc] for more
2807 information on Rust's tiered platform support.
2808
2809 Libraries
2810 ---------
2811 - [`Vec::new` and `String::new` are now `const` functions.][64028]
2812 - [`LinkedList::new` is now a `const` function.][63684]
2813 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
2814 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
2815   now `const`.][63786]
2816
2817 Stabilized APIs
2818 ---------------
2819 - [`Pin::into_inner`]
2820 - [`Instant::checked_duration_since`]
2821 - [`Instant::saturating_duration_since`]
2822
2823 Cargo
2824 -----
2825 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
2826 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
2827   `--all` is now deprecated.
2828
2829 Misc
2830 ----
2831 - [You can now pass `-Clinker` to rustdoc to control the linker used
2832   for compiling doctests.][63834]
2833
2834 Compatibility Notes
2835 -------------------
2836 - [Code that was previously accepted by the old borrow checker, but rejected by
2837   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
2838   previously a warning, and will also become a hard error in the Rust 2015
2839   edition in the 1.40.0 release.
2840 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
2841   run tests.][63827] This should improve performance when running a large
2842   amount of doctests.
2843 - [The `try!` macro will now issue a deprecation warning.][62672] It is
2844   recommended to use the `?` operator instead.
2845 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
2846   returned `0.0`.
2847
2848 [62600]: https://github.com/rust-lang/rust/pull/62600/
2849 [62672]: https://github.com/rust-lang/rust/pull/62672/
2850 [63118]: https://github.com/rust-lang/rust/pull/63118/
2851 [63209]: https://github.com/rust-lang/rust/pull/63209/
2852 [63402]: https://github.com/rust-lang/rust/pull/63402/
2853 [63565]: https://github.com/rust-lang/rust/pull/63565/
2854 [63595]: https://github.com/rust-lang/rust/pull/63595/
2855 [63684]: https://github.com/rust-lang/rust/pull/63684/
2856 [63698]: https://github.com/rust-lang/rust/pull/63698/
2857 [63770]: https://github.com/rust-lang/rust/pull/63770/
2858 [63786]: https://github.com/rust-lang/rust/pull/63786/
2859 [63827]: https://github.com/rust-lang/rust/pull/63827/
2860 [63834]: https://github.com/rust-lang/rust/pull/63834/
2861 [64010]: https://github.com/rust-lang/rust/pull/64010/
2862 [64028]: https://github.com/rust-lang/rust/pull/64028/
2863 [64334]: https://github.com/rust-lang/rust/pull/64334/
2864 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
2865 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
2866 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
2867 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
2868 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
2869 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
2870
2871 Version 1.38.0 (2019-09-26)
2872 ==========================
2873
2874 Language
2875 --------
2876 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
2877 - [The `#[deprecated]` attribute can now be used on macros.][62042]
2878
2879 Compiler
2880 --------
2881 - [Added pipelined compilation support to `rustc`.][62766] This will
2882   improve compilation times in some cases. For further information please refer
2883   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
2884 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
2885   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
2886   `x86_64-uwp-windows-msvc` targets.][60260]
2887 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
2888   `armv7-unknown-linux-musleabi` targets.][63107]
2889 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
2890 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
2891 - [Upgraded to LLVM 9.][62592]
2892
2893 \* Refer to Rust's [platform support page][platform-support-doc] for more
2894 information on Rust's tiered platform support.
2895
2896 Libraries
2897 ---------
2898 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
2899 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
2900   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
2901   is available at `std::clone::Clone`). This also makes all built-in macros
2902   available in `std`/`core` root. e.g. `std::include_bytes!`.
2903 - [`str::Chars` now implements `Debug`.][63000]
2904 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
2905 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
2906 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
2907 - [Added euclidean remainder and division operations (`div_euclid`,
2908   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
2909   `overflowing`, and `wrapping` versions are available for all
2910   integer primitives.
2911 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
2912   `PartialEq`.][61491]
2913 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
2914
2915 Stabilized APIs
2916 ---------------
2917 - [`<*const T>::cast`]
2918 - [`<*mut T>::cast`]
2919 - [`Duration::as_secs_f32`]
2920 - [`Duration::as_secs_f64`]
2921 - [`Duration::div_f32`]
2922 - [`Duration::div_f64`]
2923 - [`Duration::from_secs_f32`]
2924 - [`Duration::from_secs_f64`]
2925 - [`Duration::mul_f32`]
2926 - [`Duration::mul_f64`]
2927 - [`any::type_name`]
2928
2929 Cargo
2930 -----
2931 - [Added pipelined compilation support to `cargo`.][cargo/7143]
2932 - [You can now pass the `--features` option multiple times to enable
2933   multiple features.][cargo/7084]
2934
2935 Rustdoc
2936 -------
2937
2938 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
2939
2940 Misc
2941 ----
2942 - [`rustc` will now warn about some incorrect uses of
2943   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
2944
2945 Compatibility Notes
2946 -------------------
2947 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
2948   1.38.0.
2949 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
2950   issues][62896] with certain crates such as libc.
2951
2952 [60260]: https://github.com/rust-lang/rust/pull/60260/
2953 [61457]: https://github.com/rust-lang/rust/pull/61457/
2954 [61491]: https://github.com/rust-lang/rust/pull/61491/
2955 [61884]: https://github.com/rust-lang/rust/pull/61884/
2956 [61953]: https://github.com/rust-lang/rust/pull/61953/
2957 [62042]: https://github.com/rust-lang/rust/pull/62042/
2958 [62528]: https://github.com/rust-lang/rust/pull/62528/
2959 [62583]: https://github.com/rust-lang/rust/pull/62583/
2960 [62735]: https://github.com/rust-lang/rust/pull/62735/
2961 [62766]: https://github.com/rust-lang/rust/pull/62766/
2962 [62784]: https://github.com/rust-lang/rust/pull/62784/
2963 [62592]: https://github.com/rust-lang/rust/pull/62592/
2964 [62785]: https://github.com/rust-lang/rust/issues/62785/
2965 [62814]: https://github.com/rust-lang/rust/pull/62814/
2966 [62896]: https://github.com/rust-lang/rust/issues/62896/
2967 [63000]: https://github.com/rust-lang/rust/pull/63000/
2968 [63056]: https://github.com/rust-lang/rust/pull/63056/
2969 [63107]: https://github.com/rust-lang/rust/pull/63107/
2970 [63346]: https://github.com/rust-lang/rust/pull/63346/
2971 [63421]: https://github.com/rust-lang/rust/pull/63421/
2972 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
2973 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
2974 [63048]: https://github.com/rust-lang/rust/pull/63048
2975 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2976 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2977 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
2978 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
2979 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
2980 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
2981 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
2982 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
2983 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
2984 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
2985 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
2986 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
2987 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
2988
2989 Version 1.37.0 (2019-08-15)
2990 ==========================
2991
2992 Language
2993 --------
2994 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
2995   [`Box`][62228], or an [array][62235] and unused.
2996 - [You can now use the `cfg` and `cfg_attr` attributes on
2997   generic parameters.][61547]
2998 - [You can now use enum variants through type alias.][61682] e.g. You can
2999   write the following:
3000   ```rust
3001   type MyOption = Option<u8>;
3002
3003   fn increment_or_zero(x: MyOption) -> u8 {
3004       match x {
3005           MyOption::Some(y) => y + 1,
3006           MyOption::None => 0,
3007       }
3008   }
3009   ```
3010 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
3011   `const _: u32 = 5;`.
3012 - [You can now use `#[repr(align(X)]` on enums.][61229]
3013 - [The  `?` Kleene macro operator is now available in the
3014   2015 edition.][60932]
3015
3016 Compiler
3017 --------
3018 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
3019   and `-C profile-use` flags.][61268] For more information on how to use profile
3020   guided optimization, please refer to the [rustc book][rustc-book-pgo].
3021 - [The `rust-lldb` wrapper script should now work again.][61827]
3022
3023 Libraries
3024 ---------
3025 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
3026
3027 Stabilized APIs
3028 ---------------
3029 - [`BufReader::buffer`]
3030 - [`BufWriter::buffer`]
3031 - [`Cell::from_mut`]
3032 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
3033 - [`DoubleEndedIterator::nth_back`]
3034 - [`Option::xor`]
3035 - [`Wrapping::reverse_bits`]
3036 - [`i128::reverse_bits`]
3037 - [`i16::reverse_bits`]
3038 - [`i32::reverse_bits`]
3039 - [`i64::reverse_bits`]
3040 - [`i8::reverse_bits`]
3041 - [`isize::reverse_bits`]
3042 - [`slice::copy_within`]
3043 - [`u128::reverse_bits`]
3044 - [`u16::reverse_bits`]
3045 - [`u32::reverse_bits`]
3046 - [`u64::reverse_bits`]
3047 - [`u8::reverse_bits`]
3048 - [`usize::reverse_bits`]
3049
3050 Cargo
3051 -----
3052 - [`Cargo.lock` files are now included by default when publishing executable crates
3053   with executables.][cargo/7026]
3054 - [You can now specify `default-run="foo"` in `[package]` to specify the
3055   default executable to use for `cargo run`.][cargo/7056]
3056
3057 Misc
3058 ----
3059
3060 Compatibility Notes
3061 -------------------
3062 - [Using `...` for inclusive range patterns will now warn by default.][61342]
3063   Please transition your code to using the `..=` syntax for inclusive
3064   ranges instead.
3065 - [Using a trait object without the `dyn` will now warn by default.][61203]
3066   Please transition your code to use `dyn Trait` for trait objects instead.
3067
3068 [62228]: https://github.com/rust-lang/rust/pull/62228/
3069 [62235]: https://github.com/rust-lang/rust/pull/62235/
3070 [61802]: https://github.com/rust-lang/rust/pull/61802/
3071 [61827]: https://github.com/rust-lang/rust/pull/61827/
3072 [61547]: https://github.com/rust-lang/rust/pull/61547/
3073 [61682]: https://github.com/rust-lang/rust/pull/61682/
3074 [61268]: https://github.com/rust-lang/rust/pull/61268/
3075 [61342]: https://github.com/rust-lang/rust/pull/61342/
3076 [61347]: https://github.com/rust-lang/rust/pull/61347/
3077 [61100]: https://github.com/rust-lang/rust/pull/61100/
3078 [61203]: https://github.com/rust-lang/rust/pull/61203/
3079 [61229]: https://github.com/rust-lang/rust/pull/61229/
3080 [60932]: https://github.com/rust-lang/rust/pull/60932/
3081 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
3082 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
3083 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
3084 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
3085 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
3086 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
3087 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
3088 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
3089 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
3090 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
3091 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
3092 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
3093 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
3094 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
3095 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
3096 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
3097 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
3098 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
3099 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
3100 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
3101 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
3102 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
3103 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
3104
3105
3106 Version 1.36.0 (2019-07-04)
3107 ==========================
3108
3109 Language
3110 --------
3111 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
3112 - [The order of traits in trait objects no longer affects the semantics of that
3113   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
3114   `dyn fmt::Debug + Send`, where this was previously not the case.
3115
3116 Libraries
3117 ---------
3118 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
3119 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
3120 - [`mem::needs_drop` is now available as a const fn.][60364]
3121 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
3122 - [`String` now implements `BorrowMut<str>`.][60404]
3123 - [`io::Cursor` now implements `Default`.][60234]
3124 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
3125 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
3126   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
3127   environment has access to heap memory allocation.
3128 - [`String` now implements `From<&String>`.][59825]
3129 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
3130   return a tuple of each argument when there is multiple arguments.
3131 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
3132   not used.][59648]
3133
3134 Stabilized APIs
3135 ---------------
3136 - [`VecDeque::rotate_left`]
3137 - [`VecDeque::rotate_right`]
3138 - [`Iterator::copied`]
3139 - [`io::IoSlice`]
3140 - [`io::IoSliceMut`]
3141 - [`Read::read_vectored`]
3142 - [`Write::write_vectored`]
3143 - [`str::as_mut_ptr`]
3144 - [`mem::MaybeUninit`]
3145 - [`pointer::align_offset`]
3146 - [`future::Future`]
3147 - [`task::Context`]
3148 - [`task::RawWaker`]
3149 - [`task::RawWakerVTable`]
3150 - [`task::Waker`]
3151 - [`task::Poll`]
3152
3153 Cargo
3154 -----
3155 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
3156 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
3157
3158 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
3159
3160 Clippy
3161 ------
3162 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
3163
3164 Misc
3165 ----
3166
3167 Compatibility Notes
3168 -------------------
3169 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
3170   longer recommended, and will be deprecated in 1.39.0.
3171
3172 [60318]: https://github.com/rust-lang/rust/pull/60318/
3173 [60364]: https://github.com/rust-lang/rust/pull/60364/
3174 [60370]: https://github.com/rust-lang/rust/pull/60370/
3175 [60404]: https://github.com/rust-lang/rust/pull/60404/
3176 [60234]: https://github.com/rust-lang/rust/pull/60234/
3177 [60244]: https://github.com/rust-lang/rust/pull/60244/
3178 [58623]: https://github.com/rust-lang/rust/pull/58623/
3179 [59648]: https://github.com/rust-lang/rust/pull/59648/
3180 [59675]: https://github.com/rust-lang/rust/pull/59675/
3181 [59825]: https://github.com/rust-lang/rust/pull/59825/
3182 [59826]: https://github.com/rust-lang/rust/pull/59826/
3183 [59445]: https://github.com/rust-lang/rust/pull/59445/
3184 [59114]: https://github.com/rust-lang/rust/pull/59114/
3185 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
3186 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
3187 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
3188 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
3189 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
3190 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
3191 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
3192 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
3193 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
3194 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
3195 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
3196 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
3197 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
3198 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
3199 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
3200 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
3201 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
3202 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
3203 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
3204 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
3205
3206
3207 Version 1.35.0 (2019-05-23)
3208 ==========================
3209
3210 Language
3211 --------
3212 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
3213   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
3214 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
3215   ```rust
3216   unsafe fn call_unsafe(func: unsafe fn()) {
3217       func()
3218   }
3219
3220   pub fn main() {
3221       unsafe { call_unsafe(|| {}); }
3222   }
3223   ```
3224
3225
3226 Compiler
3227 --------
3228 - [Added the `armv6-unknown-freebsd-gnueabihf` and
3229   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
3230 - [Added the `wasm32-unknown-wasi` target.][59464]
3231
3232
3233 Libraries
3234 ---------
3235 - [`Thread` will now show its ID in `Debug` output.][59460]
3236 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
3237 - [`alloc::System` now implements `Default`.][59451]
3238 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
3239   last field.][59076]
3240 - [`char::{ToLowercase, ToUppercase}` now
3241   implement `ExactSizeIterator`.][58778]
3242 - [All `NonZero` numeric types now implement `FromStr`.][58717]
3243 - [Removed the `Read` trait bounds
3244   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
3245 - [You can now call the `dbg!` macro without any parameters to print the file
3246   and line where it is called.][57847]
3247 - [In place ASCII case conversions are now up to 4× faster.][59283]
3248   e.g. `str::make_ascii_lowercase`
3249 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
3250   and `Send`.][58369]
3251
3252 Stabilized APIs
3253 ---------------
3254 - [`f32::copysign`]
3255 - [`f64::copysign`]
3256 - [`RefCell::replace_with`]
3257 - [`RefCell::map_split`]
3258 - [`ptr::hash`]
3259 - [`Range::contains`]
3260 - [`RangeFrom::contains`]
3261 - [`RangeTo::contains`]
3262 - [`RangeInclusive::contains`]
3263 - [`RangeToInclusive::contains`]
3264 - [`Option::copied`]
3265
3266 Cargo
3267 -----
3268 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
3269   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
3270   platform specific.
3271
3272 Misc
3273 ----
3274 - [The Rust toolchain is now available natively for musl based distros.][58575]
3275
3276 [59460]: https://github.com/rust-lang/rust/pull/59460/
3277 [59464]: https://github.com/rust-lang/rust/pull/59464/
3278 [59500]: https://github.com/rust-lang/rust/pull/59500/
3279 [59512]: https://github.com/rust-lang/rust/pull/59512/
3280 [59580]: https://github.com/rust-lang/rust/pull/59580/
3281 [59283]: https://github.com/rust-lang/rust/pull/59283/
3282 [59451]: https://github.com/rust-lang/rust/pull/59451/
3283 [59076]: https://github.com/rust-lang/rust/pull/59076/
3284 [58778]: https://github.com/rust-lang/rust/pull/58778/
3285 [58717]: https://github.com/rust-lang/rust/pull/58717/
3286 [58369]: https://github.com/rust-lang/rust/pull/58369/
3287 [58423]: https://github.com/rust-lang/rust/pull/58423/
3288 [58080]: https://github.com/rust-lang/rust/pull/58080/
3289 [57847]: https://github.com/rust-lang/rust/pull/57847/
3290 [58575]: https://github.com/rust-lang/rust/pull/58575
3291 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
3292 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
3293 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
3294 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
3295 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
3296 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
3297 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
3298 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
3299 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
3300 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
3301 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
3302 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
3303
3304 Version 1.34.2 (2019-05-14)
3305 ===========================
3306
3307 * [Destabilize the `Error::type_id` function due to a security
3308    vulnerability][60785] ([CVE-2019-12083])
3309
3310 [60785]: https://github.com/rust-lang/rust/pull/60785
3311 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
3312
3313 Version 1.34.1 (2019-04-25)
3314 ===========================
3315
3316 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
3317 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
3318 * [Fix Clippy panic when checking some macros][clippy/3805]
3319
3320 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
3321 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
3322 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
3323
3324 Version 1.34.0 (2019-04-11)
3325 ==========================
3326
3327 Language
3328 --------
3329 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
3330   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
3331   but had no effect.
3332 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
3333   `#[attr{}]` procedural macros.][57367]
3334 - [You can now write `extern crate self as foo;`][57407] to import your
3335   crate's root into the extern prelude.
3336
3337
3338 Compiler
3339 --------
3340 - [You can now target `riscv64imac-unknown-none-elf` and
3341   `riscv64gc-unknown-none-elf`.][58406]
3342 - [You can now enable linker plugin LTO optimisations with
3343   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
3344   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
3345   boundaries.
3346 - [You can now target `powerpc64-unknown-freebsd`.][57809]
3347
3348
3349 Libraries
3350 ---------
3351 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
3352   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
3353   the `Hash` trait to create an iterator.
3354 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
3355   methods.][58421] Most notably you no longer require the `Ord` trait to create
3356   an iterator.
3357 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
3358   for all numeric types.][58044]
3359 - [Indexing a `str` is now generic over all types that
3360   implement `SliceIndex<str>`.][57604]
3361 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
3362   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
3363   produce a warning if their returning type is unused.
3364 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
3365   `overflowing_pow` are now available for all numeric types.][57873] These are
3366   equivalent to methods such as `wrapping_add` for the `pow` operation.
3367
3368
3369 Stabilized APIs
3370 ---------------
3371
3372 #### std & core
3373 * [`Any::type_id`]
3374 * [`Error::type_id`]
3375 * [`atomic::AtomicI16`]
3376 * [`atomic::AtomicI32`]
3377 * [`atomic::AtomicI64`]
3378 * [`atomic::AtomicI8`]
3379 * [`atomic::AtomicU16`]
3380 * [`atomic::AtomicU32`]
3381 * [`atomic::AtomicU64`]
3382 * [`atomic::AtomicU8`]
3383 * [`convert::Infallible`]
3384 * [`convert::TryFrom`]
3385 * [`convert::TryInto`]
3386 * [`iter::from_fn`]
3387 * [`iter::successors`]
3388 * [`num::NonZeroI128`]
3389 * [`num::NonZeroI16`]
3390 * [`num::NonZeroI32`]
3391 * [`num::NonZeroI64`]
3392 * [`num::NonZeroI8`]
3393 * [`num::NonZeroIsize`]
3394 * [`slice::sort_by_cached_key`]
3395 * [`str::escape_debug`]
3396 * [`str::escape_default`]
3397 * [`str::escape_unicode`]
3398 * [`str::split_ascii_whitespace`]
3399
3400 #### std
3401 * [`Instant::checked_add`]
3402 * [`Instant::checked_sub`]
3403 * [`SystemTime::checked_add`]
3404 * [`SystemTime::checked_sub`]
3405
3406 Cargo
3407 -----
3408 - [You can now use alternative registries to crates.io.][cargo/6654]
3409
3410 Misc
3411 ----
3412 - [You can now use the `?` operator in your documentation tests without manually
3413   adding `fn main() -> Result<(), _> {}`.][56470]
3414
3415 Compatibility Notes
3416 -------------------
3417 - [`Command::before_exec` is being replaced by the unsafe method
3418   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
3419 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
3420   can now use `const` functions in `static` variables.
3421
3422 [58370]: https://github.com/rust-lang/rust/pull/58370/
3423 [58406]: https://github.com/rust-lang/rust/pull/58406/
3424 [58421]: https://github.com/rust-lang/rust/pull/58421/
3425 [58166]: https://github.com/rust-lang/rust/pull/58166/
3426 [58044]: https://github.com/rust-lang/rust/pull/58044/
3427 [58057]: https://github.com/rust-lang/rust/pull/58057/
3428 [58059]: https://github.com/rust-lang/rust/pull/58059/
3429 [57809]: https://github.com/rust-lang/rust/pull/57809/
3430 [57873]: https://github.com/rust-lang/rust/pull/57873/
3431 [57604]: https://github.com/rust-lang/rust/pull/57604/
3432 [57367]: https://github.com/rust-lang/rust/pull/57367/
3433 [57407]: https://github.com/rust-lang/rust/pull/57407/
3434 [57425]: https://github.com/rust-lang/rust/pull/57425/
3435 [57106]: https://github.com/rust-lang/rust/pull/57106/
3436 [56470]: https://github.com/rust-lang/rust/pull/56470/
3437 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
3438 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
3439 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
3440 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
3441 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
3442 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
3443 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
3444 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
3445 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
3446 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
3447 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
3448 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
3449 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
3450 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
3451 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
3452 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
3453 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
3454 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
3455 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
3456 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
3457 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
3458 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
3459 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
3460 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
3461 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
3462 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
3463 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
3464 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
3465 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
3466 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
3467 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
3468
3469
3470 Version 1.33.0 (2019-02-28)
3471 ==========================
3472
3473 Language
3474 --------
3475 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
3476   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
3477 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
3478   E.g. You can have match statement on a `u8` that covers `0..=255` and
3479   you would no longer be required to have a `_ => unreachable!()` case.
3480 - [You can now have multiple patterns in `if let` and `while let`
3481   expressions.][57532] You can do this with the same syntax as a `match`
3482   expression. E.g.
3483   ```rust
3484   enum Creature {
3485       Crab(String),
3486       Lobster(String),
3487       Person(String),
3488   }
3489
3490   fn main() {
3491       let state = Creature::Crab("Ferris");
3492
3493       if let Creature::Crab(name) | Creature::Person(name) = state {
3494           println!("This creature's name is: {}", name);
3495       }
3496   }
3497   ```
3498 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
3499   this feature will by default produce a warning as this behaviour can be
3500   unintuitive. E.g. `if let _ = 5 {}`
3501 - [You can now use `let` bindings, assignments, expression statements,
3502   and irrefutable pattern destructuring in const functions.][57175]
3503 - [You can now call unsafe const functions.][57067] E.g.
3504   ```rust
3505   const unsafe fn foo() -> i32 { 5 }
3506   const fn bar() -> i32 {
3507       unsafe { foo() }
3508   }
3509   ```
3510 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
3511   E.g. `#[cfg_attr(all(), must_use, optimize)]`
3512 - [You can now specify a specific alignment with the `#[repr(packed)]`
3513   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
3514   with an alignment of 2 bytes and a size of 6 bytes.
3515 - [You can now import an item from a module as an `_`.][56303] This allows you to
3516   import a trait's impls, and not have the name in the namespace. E.g.
3517   ```rust
3518   use std::io::Read as _;
3519
3520   // Allowed as there is only one `Read` in the module.
3521   pub trait Read {}
3522   ```
3523 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
3524
3525 Compiler
3526 --------
3527 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
3528   command line argument.][56351]
3529 - [The minimum required LLVM version has been bumped to 6.0.][56642]
3530 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
3531 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
3532   tier 2 support.][57130] Visit the [platform support][platform-support] page for
3533   information on Rust's platform support.
3534 - [Added support for the `thumbv7neon-linux-androideabi` and
3535   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
3536 - [Added support for the `x86_64-unknown-uefi` target.][56769]
3537
3538 Libraries
3539 ---------
3540 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
3541   functions for all numeric types.][57566]
3542 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
3543   are now `const` functions for all numeric types.][57105]
3544 - [The methods `is_positive` and `is_negative` are now `const` functions for
3545   all signed numeric types.][57105]
3546 - [The `get` method for all `NonZero` types is now `const`.][57167]
3547 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
3548   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
3549   numeric types.][57234]
3550 - [`Ipv4Addr::new` is now a `const` function][57234]
3551
3552 Stabilized APIs
3553 ---------------
3554 - [`unix::FileExt::read_exact_at`]
3555 - [`unix::FileExt::write_all_at`]
3556 - [`Option::transpose`]
3557 - [`Result::transpose`]
3558 - [`convert::identity`]
3559 - [`pin::Pin`]
3560 - [`marker::Unpin`]
3561 - [`marker::PhantomPinned`]
3562 - [`Vec::resize_with`]
3563 - [`VecDeque::resize_with`]
3564 - [`Duration::as_millis`]
3565 - [`Duration::as_micros`]
3566 - [`Duration::as_nanos`]
3567
3568
3569 Cargo
3570 -----
3571 - [You can now publish crates that require a feature flag to compile with
3572   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
3573 - [Cargo should now rebuild a crate if a file was modified during the initial
3574   build.][cargo/6484]
3575
3576 Compatibility Notes
3577 -------------------
3578 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
3579   are now deprecated in the standard library, and their usage will now produce a warning.
3580   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
3581   methods instead.
3582 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
3583   downcasting.
3584 - [Libtest no longer creates a new thread for each test when
3585   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
3586
3587 [56243]: https://github.com/rust-lang/rust/pull/56243
3588 [56303]: https://github.com/rust-lang/rust/pull/56303/
3589 [56351]: https://github.com/rust-lang/rust/pull/56351/
3590 [56362]: https://github.com/rust-lang/rust/pull/56362
3591 [56642]: https://github.com/rust-lang/rust/pull/56642/
3592 [56769]: https://github.com/rust-lang/rust/pull/56769/
3593 [56805]: https://github.com/rust-lang/rust/pull/56805
3594 [56947]: https://github.com/rust-lang/rust/pull/56947/
3595 [57049]: https://github.com/rust-lang/rust/pull/57049/
3596 [57067]: https://github.com/rust-lang/rust/pull/57067/
3597 [57105]: https://github.com/rust-lang/rust/pull/57105
3598 [57130]: https://github.com/rust-lang/rust/pull/57130/
3599 [57167]: https://github.com/rust-lang/rust/pull/57167/
3600 [57175]: https://github.com/rust-lang/rust/pull/57175/
3601 [57234]: https://github.com/rust-lang/rust/pull/57234/
3602 [57332]: https://github.com/rust-lang/rust/pull/57332/
3603 [57465]: https://github.com/rust-lang/rust/pull/57465/
3604 [57532]: https://github.com/rust-lang/rust/pull/57532/
3605 [57535]: https://github.com/rust-lang/rust/pull/57535/
3606 [57566]: https://github.com/rust-lang/rust/pull/57566/
3607 [57615]: https://github.com/rust-lang/rust/pull/57615/
3608 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
3609 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
3610 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
3611 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
3612 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
3613 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
3614 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
3615 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
3616 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
3617 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
3618 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
3619 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
3620 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
3621 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
3622 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
3623 [platform-support]: https://forge.rust-lang.org/platform-support.html
3624
3625 Version 1.32.0 (2019-01-17)
3626 ==========================
3627
3628 Language
3629 --------
3630 #### 2018 edition
3631 - [You can now use the `?` operator in macro definitions.][56245] The `?`
3632   operator allows you to specify zero or one repetitions similar to the `*` and
3633   `+` operators.
3634 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
3635   now always resolve to the item (`enum`, `struct`, etc.) available in the
3636   module if present, before resolving to a external crate or an item the prelude.][56759]
3637   E.g.
3638   ```rust
3639   enum Color { Red, Green, Blue }
3640
3641   use Color::*;
3642   ```
3643
3644 #### All editions
3645 - [You can now match against `PhantomData<T>` types.][55837]
3646 - [You can now match against literals in macros with the `literal`
3647   specifier.][56072] This will match against a literal of any type.
3648   E.g. `1`, `'A'`, `"Hello World"`
3649 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
3650   ```rust
3651   struct Point(i32, i32);
3652
3653   impl Point {
3654       pub fn new(x: i32, y: i32) -> Self {
3655           Self(x, y)
3656       }
3657
3658       pub fn is_origin(&self) -> bool {
3659           match self {
3660               Self(0, 0) => true,
3661               _ => false,
3662           }
3663       }
3664   }
3665   ```
3666 - [Self can also now be used in type definitions.][56366] E.g.
3667   ```rust
3668   enum List<T>
3669   where
3670       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
3671   {
3672       Nil,
3673       Cons(T, Box<Self>) // likewise here
3674   }
3675   ```
3676 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
3677   a `impl Trait` or `dyn Trait` is returned and unused in the program.
3678
3679 Compiler
3680 --------
3681 - [The default allocator has changed from jemalloc to the default allocator on
3682   your system.][55238] The compiler itself on Linux & macOS will still use
3683   jemalloc, but programs compiled with it will use the system allocator.
3684 - [Added the `aarch64-pc-windows-msvc` target.][55702]
3685
3686 Libraries
3687 ---------
3688 - [`PathBuf` now implements `FromStr`.][55148]
3689 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
3690 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
3691   easily debug expressions in your rust program. E.g.
3692   ```rust
3693   let a = 2;
3694   let b = dbg!(a * 2) + 1;
3695   //      ^-- prints: [src/main.rs:4] a * 2 = 4
3696   assert_eq!(b, 5);
3697   ```
3698
3699 The following APIs are now `const` functions and can be used in a
3700 `const` context.
3701
3702 - [`Cell::as_ptr`]
3703 - [`UnsafeCell::get`]
3704 - [`char::is_ascii`]
3705 - [`iter::empty`]
3706 - [`ManuallyDrop::new`]
3707 - [`ManuallyDrop::into_inner`]
3708 - [`RangeInclusive::start`]
3709 - [`RangeInclusive::end`]
3710 - [`NonNull::as_ptr`]
3711 - [`slice::as_ptr`]
3712 - [`str::as_ptr`]
3713 - [`Duration::as_secs`]
3714 - [`Duration::subsec_millis`]
3715 - [`Duration::subsec_micros`]
3716 - [`Duration::subsec_nanos`]
3717 - [`CStr::as_ptr`]
3718 - [`Ipv4Addr::is_unspecified`]
3719 - [`Ipv6Addr::new`]
3720 - [`Ipv6Addr::octets`]
3721
3722 Stabilized APIs
3723 ---------------
3724 - [`i8::to_be_bytes`]
3725 - [`i8::to_le_bytes`]
3726 - [`i8::to_ne_bytes`]
3727 - [`i8::from_be_bytes`]
3728 - [`i8::from_le_bytes`]
3729 - [`i8::from_ne_bytes`]
3730 - [`i16::to_be_bytes`]
3731 - [`i16::to_le_bytes`]
3732 - [`i16::to_ne_bytes`]
3733 - [`i16::from_be_bytes`]
3734 - [`i16::from_le_bytes`]
3735 - [`i16::from_ne_bytes`]
3736 - [`i32::to_be_bytes`]
3737 - [`i32::to_le_bytes`]
3738 - [`i32::to_ne_bytes`]
3739 - [`i32::from_be_bytes`]
3740 - [`i32::from_le_bytes`]
3741 - [`i32::from_ne_bytes`]
3742 - [`i64::to_be_bytes`]
3743 - [`i64::to_le_bytes`]
3744 - [`i64::to_ne_bytes`]
3745 - [`i64::from_be_bytes`]
3746 - [`i64::from_le_bytes`]
3747 - [`i64::from_ne_bytes`]
3748 - [`i128::to_be_bytes`]
3749 - [`i128::to_le_bytes`]
3750 - [`i128::to_ne_bytes`]
3751 - [`i128::from_be_bytes`]
3752 - [`i128::from_le_bytes`]
3753 - [`i128::from_ne_bytes`]
3754 - [`isize::to_be_bytes`]
3755 - [`isize::to_le_bytes`]
3756 - [`isize::to_ne_bytes`]
3757 - [`isize::from_be_bytes`]
3758 - [`isize::from_le_bytes`]
3759 - [`isize::from_ne_bytes`]
3760 - [`u8::to_be_bytes`]
3761 - [`u8::to_le_bytes`]
3762 - [`u8::to_ne_bytes`]
3763 - [`u8::from_be_bytes`]
3764 - [`u8::from_le_bytes`]
3765 - [`u8::from_ne_bytes`]
3766 - [`u16::to_be_bytes`]
3767 - [`u16::to_le_bytes`]
3768 - [`u16::to_ne_bytes`]
3769 - [`u16::from_be_bytes`]
3770 - [`u16::from_le_bytes`]
3771 - [`u16::from_ne_bytes`]
3772 - [`u32::to_be_bytes`]
3773 - [`u32::to_le_bytes`]
3774 - [`u32::to_ne_bytes`]
3775 - [`u32::from_be_bytes`]
3776 - [`u32::from_le_bytes`]
3777 - [`u32::from_ne_bytes`]
3778 - [`u64::to_be_bytes`]
3779 - [`u64::to_le_bytes`]
3780 - [`u64::to_ne_bytes`]
3781 - [`u64::from_be_bytes`]
3782 - [`u64::from_le_bytes`]
3783 - [`u64::from_ne_bytes`]
3784 - [`u128::to_be_bytes`]
3785 - [`u128::to_le_bytes`]
3786 - [`u128::to_ne_bytes`]
3787 - [`u128::from_be_bytes`]
3788 - [`u128::from_le_bytes`]
3789 - [`u128::from_ne_bytes`]
3790 - [`usize::to_be_bytes`]
3791 - [`usize::to_le_bytes`]
3792 - [`usize::to_ne_bytes`]
3793 - [`usize::from_be_bytes`]
3794 - [`usize::from_le_bytes`]
3795 - [`usize::from_ne_bytes`]
3796
3797 Cargo
3798 -----
3799 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
3800 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
3801
3802 Misc
3803 ----
3804 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
3805
3806 Compatibility Notes
3807 -------------------
3808 - [The argument types for AVX's
3809   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
3810   been changed from `*const` to `*mut` as the previous implementation
3811   was unsound.
3812
3813
3814 [55148]: https://github.com/rust-lang/rust/pull/55148/
3815 [55238]: https://github.com/rust-lang/rust/pull/55238/
3816 [55280]: https://github.com/rust-lang/rust/pull/55280/
3817 [55610]: https://github.com/rust-lang/rust/pull/55610/
3818 [55663]: https://github.com/rust-lang/rust/pull/55663/
3819 [55702]: https://github.com/rust-lang/rust/pull/55702/
3820 [55837]: https://github.com/rust-lang/rust/pull/55837/
3821 [55843]: https://github.com/rust-lang/rust/pull/55843/
3822 [56072]: https://github.com/rust-lang/rust/pull/56072/
3823 [56245]: https://github.com/rust-lang/rust/pull/56245/
3824 [56365]: https://github.com/rust-lang/rust/pull/56365/
3825 [56366]: https://github.com/rust-lang/rust/pull/56366/
3826 [56395]: https://github.com/rust-lang/rust/pull/56395/
3827 [56759]: https://github.com/rust-lang/rust/pull/56759/
3828 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
3829 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
3830 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
3831 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
3832 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
3833 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3834 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3835 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
3836 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
3837 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
3838 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
3839 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
3840 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
3841 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
3842 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
3843 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
3844 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
3845 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
3846 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
3847 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
3848 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
3849 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
3850 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
3851 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
3852 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
3853 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
3854 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
3855 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
3856 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
3857 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
3858 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
3859 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
3860 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
3861 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
3862 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
3863 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
3864 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
3865 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
3866 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
3867 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
3868 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
3869 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
3870 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
3871 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
3872 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
3873 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
3874 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
3875 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
3876 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
3877 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
3878 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
3879 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
3880 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
3881 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
3882 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
3883 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
3884 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
3885 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
3886 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
3887 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
3888 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
3889 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
3890 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
3891 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
3892 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
3893 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
3894 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
3895 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
3896 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
3897 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
3898 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
3899 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
3900 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
3901 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
3902 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
3903 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
3904 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
3905 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
3906 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
3907 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
3908 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
3909 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
3910 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
3911 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
3912 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
3913 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
3914 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
3915 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
3916 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
3917 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
3918 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
3919 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
3920 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
3921
3922
3923 Version 1.31.1 (2018-12-20)
3924 ===========================
3925
3926 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
3927 - [Fix broken go-to-definition in RLS][rls/1171]
3928 - [Fix infinite loop on hover in RLS][rls/1170]
3929
3930 [56562]: https://github.com/rust-lang/rust/pull/56562
3931 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
3932 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
3933
3934 Version 1.31.0 (2018-12-06)
3935 ==========================
3936
3937 Language
3938 --------
3939 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
3940 - [New lifetime elision rules now allow for eliding lifetimes in functions and
3941   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
3942   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
3943   in structs.
3944 - [You can now define and use `const` functions.][54835] These are currently
3945   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
3946   [language reference][const-reference] for what exactly is available.
3947 - [You can now use tool lints, which allow you to scope lints from external
3948   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
3949 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
3950   a crate, not just in exported functions.][54451]
3951 - [You can now use parentheses in pattern matches.][54497]
3952
3953 Compiler
3954 --------
3955 - [Updated musl to 1.1.20][54430]
3956
3957 Libraries
3958 ---------
3959 - [You can now convert `num::NonZero*` types to their raw equivalents using the
3960   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
3961 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
3962   into `Option<&mut T>` using the `From` trait.][53218]
3963 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
3964
3965
3966 Stabilized APIs
3967 ---------------
3968 - [`slice::align_to`]
3969 - [`slice::align_to_mut`]
3970 - [`slice::chunks_exact`]
3971 - [`slice::chunks_exact_mut`]
3972 - [`slice::rchunks`]
3973 - [`slice::rchunks_mut`]
3974 - [`slice::rchunks_exact`]
3975 - [`slice::rchunks_exact_mut`]
3976 - [`Option::replace`]
3977
3978 Cargo
3979 -----
3980 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
3981 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
3982   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
3983
3984 [52813]: https://github.com/rust-lang/rust/pull/52813/
3985 [53218]: https://github.com/rust-lang/rust/pull/53218/
3986 [54057]: https://github.com/rust-lang/rust/pull/54057/
3987 [54240]: https://github.com/rust-lang/rust/pull/54240/
3988 [54430]: https://github.com/rust-lang/rust/pull/54430/
3989 [54451]: https://github.com/rust-lang/rust/pull/54451/
3990 [54497]: https://github.com/rust-lang/rust/pull/54497/
3991 [54778]: https://github.com/rust-lang/rust/pull/54778/
3992 [54835]: https://github.com/rust-lang/rust/pull/54835/
3993 [54870]: https://github.com/rust-lang/rust/pull/54870/
3994 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
3995 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
3996 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
3997 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
3998 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
3999 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
4000 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
4001 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
4002 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
4003 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
4004 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
4005 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
4006 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
4007 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
4008
4009 Version 1.30.1 (2018-11-08)
4010 ===========================
4011
4012 - [Fixed overflow ICE in rustdoc][54199]
4013 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
4014
4015 [54199]: https://github.com/rust-lang/rust/pull/54199
4016 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
4017
4018 Version 1.30.0 (2018-10-25)
4019 ==========================
4020
4021 Language
4022 --------
4023 - [Procedural macros are now available.][52081] These kinds of macros allow for
4024   more powerful code generation. There is a [new chapter available][proc-macros]
4025   in the Rust Programming Language book that goes further in depth.
4026 - [You can now use keywords as identifiers using the raw identifiers
4027   syntax (`r#`),][53236] e.g. `let r#for = true;`
4028 - [Using anonymous parameters in traits is now deprecated with a warning and
4029   will be a hard error in the 2018 edition.][53272]
4030 - [You can now use `crate` in paths.][54404] This allows you to refer to the
4031   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
4032 - [Using a external crate no longer requires being prefixed with `::`.][54404]
4033   Previously, using a external crate in a module without a use statement
4034   required `let json = ::serde_json::from_str(foo);` but can now be written
4035   as `let json = serde_json::from_str(foo);`.
4036 - [You can now apply the `#[used]` attribute to static items to prevent the
4037   compiler from optimising them away, even if they appear to be unused,][51363]
4038   e.g. `#[used] static FOO: u32 = 1;`
4039 - [You can now import and reexport macros from other crates with the `use`
4040   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
4041   the root module of the crate. If your macro relies on calling other local
4042   macros, it is recommended to export with the
4043   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
4044   those macros.
4045 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
4046   using the `vis` specifier.][53370]
4047 - [Non-macro attributes now allow all forms of literals, not just
4048   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
4049   write `#[attr(true)]`.
4050 - [You can now specify a function to handle a panic in the Rust runtime with the
4051   `#[panic_handler]` attribute.][51366]
4052
4053 Compiler
4054 --------
4055 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
4056 - [Added the `aarch64-unknown-netbsd` target][53165]
4057 - [Upgraded to LLVM 8.][53611]
4058
4059 Libraries
4060 ---------
4061 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
4062
4063 Stabilized APIs
4064 ---------------
4065 - [`Ipv4Addr::BROADCAST`]
4066 - [`Ipv4Addr::LOCALHOST`]
4067 - [`Ipv4Addr::UNSPECIFIED`]
4068 - [`Ipv6Addr::LOCALHOST`]
4069 - [`Ipv6Addr::UNSPECIFIED`]
4070 - [`Iterator::find_map`]
4071
4072   The following methods are replacement methods for `trim_left`, `trim_right`,
4073   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
4074   in 1.33.0:
4075 - [`str::trim_end_matches`]
4076 - [`str::trim_end`]
4077 - [`str::trim_start_matches`]
4078 - [`str::trim_start`]
4079
4080 Cargo
4081 ----
4082 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
4083 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
4084   equivalent to calling `rustdoc --error-format=json`.
4085 - [Cargo will now provide a progress bar for builds.][cargo/5995]
4086
4087 Misc
4088 ----
4089 - [`rustdoc` allows you to specify what edition to treat your code as with the
4090   `--edition` option.][54057]
4091 - [`rustdoc` now has the `--color` (specify whether to output color) and
4092   `--error-format` (specify error format, e.g. `json`) options.][53003]
4093 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
4094   debug symbols.][53774]
4095 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
4096   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
4097
4098 [50911]: https://github.com/rust-lang/rust/pull/50911/
4099 [51363]: https://github.com/rust-lang/rust/pull/51363/
4100 [51366]: https://github.com/rust-lang/rust/pull/51366/
4101 [52081]: https://github.com/rust-lang/rust/pull/52081/
4102 [53003]: https://github.com/rust-lang/rust/pull/53003/
4103 [53033]: https://github.com/rust-lang/rust/pull/53033/
4104 [53044]: https://github.com/rust-lang/rust/pull/53044/
4105 [53165]: https://github.com/rust-lang/rust/pull/53165/
4106 [53611]: https://github.com/rust-lang/rust/pull/53611/
4107 [53236]: https://github.com/rust-lang/rust/pull/53236/
4108 [53272]: https://github.com/rust-lang/rust/pull/53272/
4109 [53370]: https://github.com/rust-lang/rust/pull/53370/
4110 [53459]: https://github.com/rust-lang/rust/pull/53459/
4111 [53774]: https://github.com/rust-lang/rust/pull/53774/
4112 [53822]: https://github.com/rust-lang/rust/pull/53822/
4113 [54057]: https://github.com/rust-lang/rust/pull/54057/
4114 [54404]: https://github.com/rust-lang/rust/pull/54404/
4115 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
4116 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
4117 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
4118 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
4119
4120 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
4121 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
4122 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
4123 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
4124 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
4125 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
4126 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
4127 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
4128 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
4129 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
4130
4131
4132 Version 1.29.2 (2018-10-11)
4133 ===========================
4134
4135 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
4136 - The `rls-preview` component on the windows-gnu targets has been restored.
4137
4138 [54639]: https://github.com/rust-lang/rust/pull/54639
4139
4140
4141 Version 1.29.1 (2018-09-25)
4142 ===========================
4143
4144 Security Notes
4145 --------------
4146
4147 - The standard library's `str::repeat` function contained an out of bounds write
4148   caused by an integer overflow. This has been fixed by deterministically
4149   panicking when an overflow happens.
4150
4151   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
4152   us.
4153
4154
4155 Version 1.29.0 (2018-09-13)
4156 ==========================
4157
4158 Compiler
4159 --------
4160 - [Bumped minimum LLVM version to 5.0.][51899]
4161 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
4162 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
4163 - [Upgraded to LLVM 7.][51966]
4164
4165 Libraries
4166 ---------
4167 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
4168 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
4169 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
4170 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
4171   for `&str`.][51178]
4172 - [`Cell<T>` now allows `T` to be unsized.][50494]
4173 - [`SocketAddr` is now stable on Redox.][52656]
4174
4175 Stabilized APIs
4176 ---------------
4177 - [`Arc::downcast`]
4178 - [`Iterator::flatten`]
4179 - [`Rc::downcast`]
4180
4181 Cargo
4182 -----
4183 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
4184   `--locked` to disable this behavior.
4185 - [`cargo-install` will now allow you to cross compile an install
4186   using `--target`.][cargo/5614]
4187 - [Added the `cargo-fix` subcommand to automatically move project code from
4188   2015 edition to 2018.][cargo/5723]
4189 - [`cargo doc` can now optionally document private types using the
4190   `--document-private-items` flag.][cargo/5543]
4191
4192 Misc
4193 ----
4194 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
4195   the specified level to that level.][52354] For example `--cap-lints warn`
4196   will demote `deny` and `forbid` lints to `warn`.
4197 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
4198   fails and `101` if there is a panic.][52197]
4199 - [A preview of clippy has been made available through rustup.][51122]
4200   You can install the preview with `rustup component add clippy-preview`.
4201
4202 Compatibility Notes
4203 -------------------
4204 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
4205   Use `str::get_unchecked(begin..end)` instead.
4206 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
4207   Consider using the `home_dir` function from
4208   https://crates.io/crates/dirs instead.
4209 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
4210 - [`cfg` attributes and `--cfg` command line flags are now more
4211   strictly validated.][53893]
4212
4213 [53893]: https://github.com/rust-lang/rust/pull/53893/
4214 [52861]: https://github.com/rust-lang/rust/pull/52861/
4215 [51966]: https://github.com/rust-lang/rust/pull/51966/
4216 [52656]: https://github.com/rust-lang/rust/pull/52656/
4217 [52239]: https://github.com/rust-lang/rust/pull/52239/
4218 [52330]: https://github.com/rust-lang/rust/pull/52330/
4219 [52354]: https://github.com/rust-lang/rust/pull/52354/
4220 [52402]: https://github.com/rust-lang/rust/pull/52402/
4221 [52197]: https://github.com/rust-lang/rust/pull/52197/
4222 [51807]: https://github.com/rust-lang/rust/pull/51807/
4223 [51899]: https://github.com/rust-lang/rust/pull/51899/
4224 [51912]: https://github.com/rust-lang/rust/pull/51912/
4225 [51619]: https://github.com/rust-lang/rust/pull/51619/
4226 [51656]: https://github.com/rust-lang/rust/pull/51656/
4227 [51178]: https://github.com/rust-lang/rust/pull/51178/
4228 [51122]: https://github.com/rust-lang/rust/pull/51122
4229 [50494]: https://github.com/rust-lang/rust/pull/50494/
4230 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
4231 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
4232 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
4233 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
4234 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
4235 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
4236 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
4237
4238
4239 Version 1.28.0 (2018-08-02)
4240 ===========================
4241
4242 Language
4243 --------
4244 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
4245   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
4246   the inner type across Foreign Function Interface (FFI) boundaries.
4247 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
4248   and can now be used as identifiers.][51196]
4249 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
4250   stable.][51241] This will allow users to specify a global allocator for
4251   their program.
4252 - [Unit test functions marked with the `#[test]` attribute can now return
4253   `Result<(), E: Debug>` in addition to `()`.][51298]
4254 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
4255   allows macros to easily target lifetimes.
4256
4257 Compiler
4258 --------
4259 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
4260   prioritise making smaller binary sizes. `z` is the same as `s` with the
4261   exception that it does not vectorise loops, which typically results in an even
4262   smaller binary.
4263 - [The short error format is now stable.][49546] Specified with
4264   `--error-format=short` this option will provide a more compressed output of
4265   rust error messages.
4266 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
4267 - [Reduced the number of allocations in the macro parser.][50855] This can
4268   improve compile times of macro heavy crates on average by 5%.
4269
4270 Libraries
4271 ---------
4272 - [Implemented `Default` for `&mut str`.][51306]
4273 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
4274 - [Implemented `Extend` for `()`.][50234]
4275 - [The `Debug` implementation of `time::Duration` should now be more easily
4276   human readable.][50364] Previously a `Duration` of one second would printed as
4277   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
4278 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
4279   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
4280   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
4281   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
4282   for `PathBuf`.][50170]
4283 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
4284   and `Wrapping<i128>`.][50465]
4285 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
4286   possible.][51050] This can provide up to a 40% speed increase.
4287 - [Improved error messages when using `format!`.][50610]
4288
4289 Stabilized APIs
4290 ---------------
4291 - [`Iterator::step_by`]
4292 - [`Path::ancestors`]
4293 - [`SystemTime::UNIX_EPOCH`]
4294 - [`alloc::GlobalAlloc`]
4295 - [`alloc::Layout`]
4296 - [`alloc::LayoutErr`]
4297 - [`alloc::System`]
4298 - [`alloc::alloc`]
4299 - [`alloc::alloc_zeroed`]
4300 - [`alloc::dealloc`]
4301 - [`alloc::realloc`]
4302 - [`alloc::handle_alloc_error`]
4303 - [`btree_map::Entry::or_default`]
4304 - [`fmt::Alignment`]
4305 - [`hash_map::Entry::or_default`]
4306 - [`iter::repeat_with`]
4307 - [`num::NonZeroUsize`]
4308 - [`num::NonZeroU128`]
4309 - [`num::NonZeroU16`]
4310 - [`num::NonZeroU32`]
4311 - [`num::NonZeroU64`]
4312 - [`num::NonZeroU8`]
4313 - [`ops::RangeBounds`]
4314 - [`slice::SliceIndex`]
4315 - [`slice::from_mut`]
4316 - [`slice::from_ref`]
4317 - [`{Any + Send + Sync}::downcast_mut`]
4318 - [`{Any + Send + Sync}::downcast_ref`]
4319 - [`{Any + Send + Sync}::is`]
4320
4321 Cargo
4322 -----
4323 - [Cargo will now no longer allow you to publish crates with build scripts that
4324   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
4325   considered to be immutable.
4326
4327 Misc
4328 ----
4329 - [The `suggestion_applicability` field in `rustc`'s json output is now
4330   stable.][50486] This will allow dev tools to check whether a code suggestion
4331   would apply to them.
4332
4333 Compatibility Notes
4334 -------------------
4335 - [Rust will consider trait objects with duplicated constraints to be the same
4336   type as without the duplicated constraint.][51276] For example the below code will
4337   now fail to compile.
4338   ```rust
4339   trait Trait {}
4340
4341   impl Trait + Send {
4342       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
4343   }
4344
4345   impl Trait + Send + Send {
4346       fn test(&self) { println!("two"); }
4347   }
4348   ```
4349
4350 [49546]: https://github.com/rust-lang/rust/pull/49546/
4351 [50143]: https://github.com/rust-lang/rust/pull/50143/
4352 [50170]: https://github.com/rust-lang/rust/pull/50170/
4353 [50234]: https://github.com/rust-lang/rust/pull/50234/
4354 [50265]: https://github.com/rust-lang/rust/pull/50265/
4355 [50364]: https://github.com/rust-lang/rust/pull/50364/
4356 [50385]: https://github.com/rust-lang/rust/pull/50385/
4357 [50465]: https://github.com/rust-lang/rust/pull/50465/
4358 [50486]: https://github.com/rust-lang/rust/pull/50486/
4359 [50554]: https://github.com/rust-lang/rust/pull/50554/
4360 [50610]: https://github.com/rust-lang/rust/pull/50610/
4361 [50855]: https://github.com/rust-lang/rust/pull/50855/
4362 [51050]: https://github.com/rust-lang/rust/pull/51050/
4363 [51196]: https://github.com/rust-lang/rust/pull/51196/
4364 [51241]: https://github.com/rust-lang/rust/pull/51241/
4365 [51276]: https://github.com/rust-lang/rust/pull/51276/
4366 [51298]: https://github.com/rust-lang/rust/pull/51298/
4367 [51306]: https://github.com/rust-lang/rust/pull/51306/
4368 [51562]: https://github.com/rust-lang/rust/pull/51562/
4369 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
4370 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
4371 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
4372 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
4373 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
4374 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
4375 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
4376 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
4377 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
4378 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
4379 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
4380 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
4381 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
4382 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
4383 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
4384 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
4385 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
4386 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
4387 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
4388 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
4389 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
4390 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
4391 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
4392 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
4393 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
4394 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
4395 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
4396 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
4397 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
4398 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
4399
4400 Version 1.27.2 (2018-07-20)
4401 ===========================
4402
4403 Compatibility Notes
4404 -------------------
4405
4406 - The borrow checker was fixed to avoid potential unsoundness when using
4407   match ergonomics: [#52213][52213].
4408
4409 [52213]: https://github.com/rust-lang/rust/issues/52213
4410
4411 Version 1.27.1 (2018-07-10)
4412 ===========================
4413
4414 Security Notes
4415 --------------
4416
4417 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
4418   when running, which enabled executing code as some other user on a
4419   given machine. This release fixes that vulnerability; you can read
4420   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
4421
4422   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
4423
4424 Compatibility Notes
4425 -------------------
4426
4427 - The borrow checker was fixed to avoid an additional potential unsoundness when using
4428   match ergonomics: [#51415][51415], [#49534][49534].
4429
4430 [51415]: https://github.com/rust-lang/rust/issues/51415
4431 [49534]: https://github.com/rust-lang/rust/issues/49534
4432 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
4433 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
4434
4435 Version 1.27.0 (2018-06-21)
4436 ==========================
4437
4438 Language
4439 --------
4440 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
4441   be used as an identifier.
4442 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
4443   bare `Trait` syntax, and should make it clearer when being used in tandem with
4444   `impl Trait` because it is equivalent to the following syntax:
4445   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
4446   `Box<Trait> == Box<dyn Trait>`.
4447 - [Attributes on generic parameters such as types and lifetimes are
4448   now stable.][48851] e.g.
4449   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
4450 - [The `#[must_use]` attribute can now also be used on functions as well as
4451   types.][48925] It provides a lint that by default warns users when the
4452   value returned by a function has not been used.
4453
4454 Compiler
4455 --------
4456 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
4457
4458 Libraries
4459 ---------
4460 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
4461   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
4462   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
4463   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
4464   the `cfg` attribute.
4465 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
4466   std are now available in core.][49896]
4467 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
4468   to `Self`.][49630]
4469 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
4470   that the operation isn't done in place.
4471 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
4472   the `#[must_use]` attribute][49533] to warn about unused potentially
4473   expensive allocations.
4474
4475 Stabilized APIs
4476 ---------------
4477 - [`DoubleEndedIterator::rfind`]
4478 - [`DoubleEndedIterator::rfold`]
4479 - [`DoubleEndedIterator::try_rfold`]
4480 - [`Duration::from_micros`]
4481 - [`Duration::from_nanos`]
4482 - [`Duration::subsec_micros`]
4483 - [`Duration::subsec_millis`]
4484 - [`HashMap::remove_entry`]
4485 - [`Iterator::try_fold`]
4486 - [`Iterator::try_for_each`]
4487 - [`NonNull::cast`]
4488 - [`Option::filter`]
4489 - [`String::replace_range`]
4490 - [`Take::set_limit`]
4491 - [`hint::unreachable_unchecked`]
4492 - [`os::unix::process::parent_id`]
4493 - [`ptr::swap_nonoverlapping`]
4494 - [`slice::rsplit_mut`]
4495 - [`slice::rsplit`]
4496 - [`slice::swap_with_slice`]
4497
4498 Cargo
4499 -----
4500 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
4501   `readme`, and `repository` fields.][cargo/5386]
4502 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
4503 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
4504   a different directory than `target` for placing compilation artifacts.
4505 - [Cargo will be adding automatic target inference for binaries, benchmarks,
4506   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
4507   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
4508   where cargo would infer a binary, Cargo will produce a warning. You can
4509   disable this feature ahead of time by setting any of the following to false:
4510   `autobins`, `autobenches`, `autoexamples`, `autotests`.
4511 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
4512   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
4513
4514 Misc
4515 ----
4516 - [Added “The Rustc book” into the official documentation.][49707]
4517   [“The Rustc book”] documents and teaches how to use the rustc compiler.
4518 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
4519
4520 Compatibility Notes
4521 -------------------
4522 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
4523   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
4524   compile, `"".is_empty()` will still compile.
4525 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
4526   will only print the inner type.][48553] E.g.
4527   `print!("{:?}", AtomicBool::new(true))` will print `true`,
4528   not `AtomicBool(true)`.
4529 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
4530   could enter higher numbers but they were not supported by LLVM. Up to 512MB
4531   alignment should cover all use cases.
4532 - The `.description()` method on the `std::error::Error` trait
4533   [has been soft-deprecated][50163]. It is no longer required to implement it.
4534
4535 [48553]: https://github.com/rust-lang/rust/pull/48553/
4536 [48851]: https://github.com/rust-lang/rust/pull/48851/
4537 [48925]: https://github.com/rust-lang/rust/pull/48925/
4538 [49533]: https://github.com/rust-lang/rust/pull/49533/
4539 [49623]: https://github.com/rust-lang/rust/pull/49623/
4540 [49630]: https://github.com/rust-lang/rust/pull/49630/
4541 [49664]: https://github.com/rust-lang/rust/pull/49664/
4542 [49699]: https://github.com/rust-lang/rust/pull/49699/
4543 [49707]: https://github.com/rust-lang/rust/pull/49707/
4544 [49896]: https://github.com/rust-lang/rust/pull/49896/
4545 [49968]: https://github.com/rust-lang/rust/pull/49968/
4546 [50163]: https://github.com/rust-lang/rust/pull/50163
4547 [50177]: https://github.com/rust-lang/rust/pull/50177/
4548 [50378]: https://github.com/rust-lang/rust/pull/50378/
4549 [50423]: https://github.com/rust-lang/rust/pull/50423/
4550 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
4551 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
4552 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
4553 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
4554 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
4555 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
4556 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
4557 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
4558 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
4559 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
4560 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
4561 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
4562 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
4563 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
4564 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
4565 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
4566 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
4567 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
4568 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
4569 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
4570 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
4571 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4572 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
4573 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
4574 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
4575 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
4576 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
4577 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
4578 [“The Rustc book”]: https://doc.rust-lang.org/rustc
4579
4580
4581 Version 1.26.2 (2018-06-05)
4582 ==========================
4583
4584 Compatibility Notes
4585 -------------------
4586
4587 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
4588
4589 [51117]: https://github.com/rust-lang/rust/issues/51117
4590
4591
4592 Version 1.26.1 (2018-05-29)
4593 ==========================
4594
4595 Tools
4596 -----
4597
4598 - [RLS now works on Windows.][50646]
4599 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
4600
4601
4602 Compatibility Notes
4603 --------
4604
4605 - [`fn main() -> impl Trait` no longer works for non-Termination
4606   trait.][50656]
4607   This reverts an accidental stabilization.
4608 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
4609 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
4610
4611 [50646]: https://github.com/rust-lang/rust/issues/50646
4612 [50656]: https://github.com/rust-lang/rust/pull/50656
4613 [50812]: https://github.com/rust-lang/rust/pull/50812
4614 [50950]: https://github.com/rust-lang/rust/issues/50950
4615 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
4616
4617 Version 1.26.0 (2018-05-10)
4618 ==========================
4619
4620 Language
4621 --------
4622 - [Closures now implement `Copy` and/or `Clone` if all captured variables
4623   implement either or both traits.][49299]
4624 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
4625 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
4626   lifetime can be elided.][49458]
4627 - [`impl Trait` is now stable allowing you to have abstract types in returns
4628    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
4629   `fn open(path: impl AsRef<Path>)`.
4630 - [Pattern matching will now automatically apply dereferences.][49394]
4631 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
4632 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
4633 - [A lot of operations are now available in a const context.][46882] E.g. You
4634   can now index into constant arrays, reference and dereference into constants,
4635   and use tuple struct constructors.
4636 - [Fixed entry slice patterns are now stable.][48516] E.g.
4637   ```rust
4638   let points = [1, 2, 3, 4];
4639   match points {
4640       [1, 2, 3, 4] => println!("All points were sequential."),
4641       _ => println!("Not all points were sequential."),
4642   }
4643   ```
4644
4645
4646 Compiler
4647 --------
4648 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
4649 - [Fixed exponential projection complexity on nested types.][48296]
4650   This can provide up to a ~12% reduction in compile times for certain crates.
4651 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
4652   to remap path prefixes outputted by the compiler.
4653 - [Added `powerpc-unknown-netbsd` target.][48281]
4654
4655 Libraries
4656 ---------
4657 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
4658 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
4659   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
4660 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
4661 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
4662 - [`ascii::escape_default` is now available in libcore.][48735]
4663 - [Trailing commas are now supported in std and core macros.][48056]
4664 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
4665 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
4666
4667 Stabilized APIs
4668 ---------------
4669 - [`*const T::add`]
4670 - [`*const T::copy_to_nonoverlapping`]
4671 - [`*const T::copy_to`]
4672 - [`*const T::read_unaligned`]
4673 - [`*const T::read_volatile`]
4674 - [`*const T::read`]
4675 - [`*const T::sub`]
4676 - [`*const T::wrapping_add`]
4677 - [`*const T::wrapping_sub`]
4678 - [`*mut T::add`]
4679 - [`*mut T::copy_to_nonoverlapping`]
4680 - [`*mut T::copy_to`]
4681 - [`*mut T::read_unaligned`]
4682 - [`*mut T::read_volatile`]
4683 - [`*mut T::read`]
4684 - [`*mut T::replace`]
4685 - [`*mut T::sub`]
4686 - [`*mut T::swap`]
4687 - [`*mut T::wrapping_add`]
4688 - [`*mut T::wrapping_sub`]
4689 - [`*mut T::write_bytes`]
4690 - [`*mut T::write_unaligned`]
4691 - [`*mut T::write_volatile`]
4692 - [`*mut T::write`]
4693 - [`Box::leak`]
4694 - [`FromUtf8Error::as_bytes`]
4695 - [`LocalKey::try_with`]
4696 - [`Option::cloned`]
4697 - [`btree_map::Entry::and_modify`]
4698 - [`fs::read_to_string`]
4699 - [`fs::read`]
4700 - [`fs::write`]
4701 - [`hash_map::Entry::and_modify`]
4702 - [`iter::FusedIterator`]
4703 - [`ops::RangeInclusive`]
4704 - [`ops::RangeToInclusive`]
4705 - [`process::id`]
4706 - [`slice::rotate_left`]
4707 - [`slice::rotate_right`]
4708 - [`String::retain`]
4709
4710
4711 Cargo
4712 -----
4713 - [Cargo will now output path to custom commands when `-v` is
4714   passed with `--list`][cargo/5041]
4715 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
4716
4717 Misc
4718 ----
4719 - [The second edition of "The Rust Programming Language" book is now recommended
4720   over the first.][48404]
4721
4722 Compatibility Notes
4723 -------------------
4724
4725 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
4726   syntax is now invalid.
4727   ```
4728   use std::ops::Fn as dyn;
4729   fn g(_: Box<dyn(std::fmt::Debug)>) {}
4730   ```
4731 - [The result of dereferences are no longer promoted to `'static`.][47408]
4732   e.g.
4733   ```rust
4734   fn main() {
4735       const PAIR: &(i32, i32) = &(0, 1);
4736       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
4737   }
4738   ```
4739 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
4740 - [`".e0"` will now no longer parse as `0.0` and will instead cause
4741   an error.][48235]
4742 - [Removed hoedown from rustdoc.][48274]
4743 - [Bounds on higher-kinded lifetimes a hard error.][48326]
4744
4745 [46882]: https://github.com/rust-lang/rust/pull/46882
4746 [47379]: https://github.com/rust-lang/rust/pull/47379
4747 [47408]: https://github.com/rust-lang/rust/pull/47408
4748 [47813]: https://github.com/rust-lang/rust/pull/47813
4749 [48056]: https://github.com/rust-lang/rust/pull/48056
4750 [48125]: https://github.com/rust-lang/rust/pull/48125
4751 [48235]: https://github.com/rust-lang/rust/pull/48235
4752 [48274]: https://github.com/rust-lang/rust/pull/48274
4753 [48281]: https://github.com/rust-lang/rust/pull/48281
4754 [48296]: https://github.com/rust-lang/rust/pull/48296
4755 [48326]: https://github.com/rust-lang/rust/pull/48326
4756 [48359]: https://github.com/rust-lang/rust/pull/48359
4757 [48404]: https://github.com/rust-lang/rust/pull/48404
4758 [48481]: https://github.com/rust-lang/rust/pull/48481
4759 [48516]: https://github.com/rust-lang/rust/pull/48516
4760 [48628]: https://github.com/rust-lang/rust/pull/48628
4761 [48629]: https://github.com/rust-lang/rust/pull/48629
4762 [48657]: https://github.com/rust-lang/rust/pull/48657
4763 [48735]: https://github.com/rust-lang/rust/pull/48735
4764 [48978]: https://github.com/rust-lang/rust/pull/48978
4765 [49101]: https://github.com/rust-lang/rust/pull/49101
4766 [49109]: https://github.com/rust-lang/rust/pull/49109
4767 [49162]: https://github.com/rust-lang/rust/pull/49162
4768 [49255]: https://github.com/rust-lang/rust/pull/49255
4769 [49299]: https://github.com/rust-lang/rust/pull/49299
4770 [49305]: https://github.com/rust-lang/rust/pull/49305
4771 [49394]: https://github.com/rust-lang/rust/pull/49394
4772 [49458]: https://github.com/rust-lang/rust/pull/49458
4773 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
4774 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
4775 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
4776 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
4777 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
4778 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
4779 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
4780 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
4781 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
4782 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
4783 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
4784 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
4785 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
4786 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
4787 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
4788 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
4789 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
4790 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
4791 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
4792 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
4793 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
4794 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
4795 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
4796 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
4797 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
4798 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
4799 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
4800 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
4801 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
4802 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
4803 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
4804 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
4805 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
4806 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
4807 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
4808 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
4809 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4810 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
4811 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
4812 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
4813 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
4814 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
4815
4816
4817 Version 1.25.0 (2018-03-29)
4818 ==========================
4819
4820 Language
4821 --------
4822 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
4823 - [You can now use nested groups of imports.][47948]
4824   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
4825 - [You can now have `|` at the start of a match arm.][47947] e.g.
4826 ```rust
4827 enum Foo { A, B, C }
4828
4829 fn main() {
4830     let x = Foo::A;
4831     match x {
4832         | Foo::A
4833         | Foo::B => println!("AB"),
4834         | Foo::C => println!("C"),
4835     }
4836 }
4837 ```
4838
4839 Compiler
4840 --------
4841 - [Upgraded to LLVM 6.][47828]
4842 - [Added `-C lto=val` option.][47521]
4843 - [Added `i586-unknown-linux-musl` target][47282]
4844
4845 Libraries
4846 ---------
4847 - [Impl Send for `process::Command` on Unix.][47760]
4848 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
4849 - [`UnsafeCell::into_inner` is now safe.][47204]
4850 - [Implement libstd for CloudABI.][47268]
4851 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
4852 - [Implement `AsRef<Path>` for Component][46985]
4853 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
4854 - [Moved `Duration` to libcore.][46666]
4855
4856 Stabilized APIs
4857 ---------------
4858 - [`Location::column`]
4859 - [`ptr::NonNull`]
4860
4861 The following functions can now be used in a constant expression.
4862 eg. `static MINUTE: Duration = Duration::from_secs(60);`
4863 - [`Duration::new`][47300]
4864 - [`Duration::from_secs`][47300]
4865 - [`Duration::from_millis`][47300]
4866
4867 Cargo
4868 -----
4869 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
4870 - [`cargo new` now defaults to creating a binary crate, instead of a
4871   library crate.][cargo/5029]
4872
4873 Misc
4874 ----
4875 - [Rust by example is now shipped with new releases][46196]
4876
4877 Compatibility Notes
4878 -------------------
4879 - [Deprecated `net::lookup_host`.][47510]
4880 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
4881 - The borrow checker was sometimes incorrectly permitting overlapping borrows
4882   around indexing operations (see [#47349][47349]). This has been fixed (which also
4883   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
4884 - [Removed deprecated unstable attribute `#[simd]`.][47251]
4885
4886 [33903]: https://github.com/rust-lang/rust/pull/33903
4887 [47947]: https://github.com/rust-lang/rust/pull/47947
4888 [47948]: https://github.com/rust-lang/rust/pull/47948
4889 [47760]: https://github.com/rust-lang/rust/pull/47760
4890 [47790]: https://github.com/rust-lang/rust/pull/47790
4891 [47828]: https://github.com/rust-lang/rust/pull/47828
4892 [47398]: https://github.com/rust-lang/rust/pull/47398
4893 [47510]: https://github.com/rust-lang/rust/pull/47510
4894 [47521]: https://github.com/rust-lang/rust/pull/47521
4895 [47204]: https://github.com/rust-lang/rust/pull/47204
4896 [47251]: https://github.com/rust-lang/rust/pull/47251
4897 [47268]: https://github.com/rust-lang/rust/pull/47268
4898 [47282]: https://github.com/rust-lang/rust/pull/47282
4899 [47300]: https://github.com/rust-lang/rust/pull/47300
4900 [47349]: https://github.com/rust-lang/rust/pull/47349
4901 [46931]: https://github.com/rust-lang/rust/pull/46931
4902 [46985]: https://github.com/rust-lang/rust/pull/46985
4903 [47006]: https://github.com/rust-lang/rust/pull/47006
4904 [46830]: https://github.com/rust-lang/rust/pull/46830
4905 [46095]: https://github.com/rust-lang/rust/pull/46095
4906 [46666]: https://github.com/rust-lang/rust/pull/46666
4907 [46196]: https://github.com/rust-lang/rust/pull/46196
4908 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
4909 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
4910 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
4911 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
4912 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
4913
4914
4915 Version 1.24.1 (2018-03-01)
4916 ==========================
4917
4918  - [Do not abort when unwinding through FFI][48251]
4919  - [Emit UTF-16 files for linker arguments on Windows][48318]
4920  - [Make the error index generator work again][48308]
4921  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
4922
4923 [48251]: https://github.com/rust-lang/rust/issues/48251
4924 [48308]: https://github.com/rust-lang/rust/issues/48308
4925 [48318]: https://github.com/rust-lang/rust/issues/48318
4926 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
4927
4928
4929 Version 1.24.0 (2018-02-15)
4930 ==========================
4931
4932 Language
4933 --------
4934 - [External `sysv64` ffi is now available.][46528]
4935   eg. `extern "sysv64" fn foo () {}`
4936
4937 Compiler
4938 --------
4939 - [rustc now uses 16 codegen units by default for release builds.][46910]
4940   For the fastest builds, utilize `codegen-units=1`.
4941 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
4942 - [Add `aarch64-unknown-openbsd` support][46760]
4943
4944 Libraries
4945 ---------
4946 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
4947   improvement in performance in the majority of cases.
4948 - [`OsStr`'s `Debug` implementation is now lossless and consistent
4949   with Windows.][46798]
4950 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
4951 - [impl `From<bool>` for `AtomicBool`][46293]
4952 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
4953 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
4954 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
4955 - [float::from_bits now just uses transmute.][46012] This provides
4956   some optimisations from LLVM.
4957 - [Copied `AsciiExt` methods onto `char`][46077]
4958 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
4959 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
4960 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
4961 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
4962
4963 Stabilized APIs
4964 ---------------
4965 - [`RefCell::replace`]
4966 - [`RefCell::swap`]
4967 - [`atomic::spin_loop_hint`]
4968
4969 The following functions can now be used in a constant expression.
4970 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
4971
4972 - [`AtomicBool::new`][46287]
4973 - [`AtomicUsize::new`][46287]
4974 - [`AtomicIsize::new`][46287]
4975 - [`AtomicPtr::new`][46287]
4976 - [`Cell::new`][46287]
4977 - [`{integer}::min_value`][46287]
4978 - [`{integer}::max_value`][46287]
4979 - [`mem::size_of`][46287]
4980 - [`mem::align_of`][46287]
4981 - [`ptr::null`][46287]
4982 - [`ptr::null_mut`][46287]
4983 - [`RefCell::new`][46287]
4984 - [`UnsafeCell::new`][46287]
4985
4986 Cargo
4987 -----
4988 - [Added a `workspace.default-members` config that
4989   overrides implied `--all` in virtual workspaces.][cargo/4743]
4990 - [Enable incremental by default on development builds.][cargo/4817] Also added
4991   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
4992   per-project or global basis respectively.
4993
4994 Misc
4995 ----
4996
4997 Compatibility Notes
4998 -------------------
4999 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
5000 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
5001   in accordance with IETF RFC 4291 §2.2.
5002 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
5003 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
5004   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
5005 - [Leading zeros in tuple struct members is now an error][47084]
5006 - [`column!()` macro is one-based instead of zero-based][46977]
5007 - [`fmt::Arguments` can no longer be shared across threads][45198]
5008 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
5009 - [Cargo sets a different working directory for the compiler][cargo/4788]
5010
5011 [44884]: https://github.com/rust-lang/rust/pull/44884
5012 [45198]: https://github.com/rust-lang/rust/pull/45198
5013 [45506]: https://github.com/rust-lang/rust/pull/45506
5014 [45990]: https://github.com/rust-lang/rust/pull/45990
5015 [46012]: https://github.com/rust-lang/rust/pull/46012
5016 [46077]: https://github.com/rust-lang/rust/pull/46077
5017 [46094]: https://github.com/rust-lang/rust/pull/46094
5018 [46284]: https://github.com/rust-lang/rust/pull/46284
5019 [46287]: https://github.com/rust-lang/rust/pull/46287
5020 [46293]: https://github.com/rust-lang/rust/pull/46293
5021 [46528]: https://github.com/rust-lang/rust/pull/46528
5022 [46671]: https://github.com/rust-lang/rust/pull/46671
5023 [46713]: https://github.com/rust-lang/rust/pull/46713
5024 [46735]: https://github.com/rust-lang/rust/pull/46735
5025 [46760]: https://github.com/rust-lang/rust/pull/46760
5026 [46798]: https://github.com/rust-lang/rust/pull/46798
5027 [46828]: https://github.com/rust-lang/rust/pull/46828
5028 [46831]: https://github.com/rust-lang/rust/pull/46831
5029 [46833]: https://github.com/rust-lang/rust/pull/46833
5030 [46910]: https://github.com/rust-lang/rust/pull/46910
5031 [46977]: https://github.com/rust-lang/rust/pull/46977
5032 [47018]: https://github.com/rust-lang/rust/pull/47018
5033 [47080]: https://github.com/rust-lang/rust/pull/47080
5034 [47084]: https://github.com/rust-lang/rust/pull/47084
5035 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
5036 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
5037 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
5038 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
5039 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
5040 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
5041
5042
5043 Version 1.23.0 (2018-01-04)
5044 ==========================
5045
5046 Language
5047 --------
5048 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
5049 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
5050   Which should fix some confusing errors in some operations.
5051
5052 Compiler
5053 --------
5054 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
5055   undefined behavior.][45920]
5056 - [rustc now suggests renaming import if names clash.][45660]
5057 - [Display errors/warnings correctly when there are zero-width or
5058   wide characters.][45711]
5059 - [rustc now avoids unnecessary copies of arguments that are
5060   simple bindings][45380] This should improve memory usage on average by 5-10%.
5061 - [Updated musl used to build musl rustc to 1.1.17][45393]
5062
5063 Libraries
5064 ---------
5065 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
5066 - [Implement Hash for raw pointers to unsized types][45483]
5067 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
5068 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
5069 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
5070 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
5071   and `<*mut T>::as_mut`][44932]
5072 - [Optimized `Thread::{park, unpark}` implementation][45524]
5073 - [Improved `SliceExt::binary_search` performance.][45333]
5074 - [impl `FromIterator<()>` for `()`][45379]
5075 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
5076   is now deprecated.
5077
5078 Stabilized APIs
5079 ---------------
5080
5081 Cargo
5082 -----
5083 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
5084   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
5085 - [Added unit test checking to `cargo check`][cargo/4592]
5086 - [Cargo now lets you install a specific version
5087   using `cargo install --version`][cargo/4637]
5088
5089 Misc
5090 ----
5091 - [Releases now ship with the Cargo book documentation.][45692]
5092 - [rustdoc now prints rendering warnings on every run.][45324]
5093
5094 Compatibility Notes
5095 -------------------
5096 - [Changes have been made to type equality to make it more correct,
5097   in rare cases this could break some code.][45853] [Tracking issue for
5098   further information][45852]
5099 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
5100 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
5101   Android 9, the minimum supported version is Android 14.
5102 - [Bumped the minimum LLVM to 3.9][45326]
5103
5104 [44042]: https://github.com/rust-lang/rust/pull/44042
5105 [44932]: https://github.com/rust-lang/rust/pull/44932
5106 [45267]: https://github.com/rust-lang/rust/pull/45267
5107 [45324]: https://github.com/rust-lang/rust/pull/45324
5108 [45326]: https://github.com/rust-lang/rust/pull/45326
5109 [45333]: https://github.com/rust-lang/rust/pull/45333
5110 [45379]: https://github.com/rust-lang/rust/pull/45379
5111 [45380]: https://github.com/rust-lang/rust/pull/45380
5112 [45393]: https://github.com/rust-lang/rust/pull/45393
5113 [45435]: https://github.com/rust-lang/rust/pull/45435
5114 [45483]: https://github.com/rust-lang/rust/pull/45483
5115 [45524]: https://github.com/rust-lang/rust/pull/45524
5116 [45571]: https://github.com/rust-lang/rust/pull/45571
5117 [45580]: https://github.com/rust-lang/rust/pull/45580
5118 [45610]: https://github.com/rust-lang/rust/pull/45610
5119 [45660]: https://github.com/rust-lang/rust/pull/45660
5120 [45692]: https://github.com/rust-lang/rust/pull/45692
5121 [45711]: https://github.com/rust-lang/rust/pull/45711
5122 [45772]: https://github.com/rust-lang/rust/pull/45772
5123 [45852]: https://github.com/rust-lang/rust/issues/45852
5124 [45853]: https://github.com/rust-lang/rust/pull/45853
5125 [45887]: https://github.com/rust-lang/rust/pull/45887
5126 [45920]: https://github.com/rust-lang/rust/pull/45920
5127 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
5128 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
5129 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
5130
5131
5132 Version 1.22.1 (2017-11-22)
5133 ==========================
5134
5135 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
5136
5137 [46183]: https://github.com/rust-lang/rust/pull/46183
5138
5139 Version 1.22.0 (2017-11-22)
5140 ==========================
5141
5142 Language
5143 --------
5144 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
5145 - [Now accepts underscores in unicode escapes][43716]
5146 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
5147 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
5148
5149 Compiler
5150 --------
5151 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
5152 - [rustc will no longer inline in codegen units when compiling for debug][45075]
5153   This should decrease compile times for debug builds.
5154 - [strict memory alignment now enabled on ARMv6][45094]
5155 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
5156
5157 Libraries
5158 ---------
5159 - [Allow atomic operations up to 32 bits
5160   on `armv5te_unknown_linux_gnueabi`][44978]
5161 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
5162 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
5163 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
5164 - [Properly detect overflow in `Instant += Duration`.][44220]
5165 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
5166 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
5167 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
5168
5169 Stabilized APIs
5170 ---------------
5171
5172 Cargo
5173 -----
5174 - [Cargo will now build multi file examples in subdirectories of the `examples`
5175   folder that have a `main.rs` file.][cargo/4496]
5176 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
5177   the old format will continue to work and can be updated with `cargo update`.
5178 - [Now supports vendoring git repositories][cargo/3992]
5179
5180 Misc
5181 ----
5182 - [`libbacktrace` is now available on Apple platforms.][44251]
5183 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
5184   This now lets you specify that a given code example will fail to compile.
5185
5186 Compatibility Notes
5187 -------------------
5188 - [The minimum Android version that rustc can build for has been bumped
5189   to `4.0` from `2.3`][45656]
5190 - [Allowing `T op= &T` for numeric types has broken some type
5191   inference cases][45480]
5192
5193
5194 [42526]: https://github.com/rust-lang/rust/pull/42526
5195 [43716]: https://github.com/rust-lang/rust/pull/43716
5196 [43949]: https://github.com/rust-lang/rust/pull/43949
5197 [44015]: https://github.com/rust-lang/rust/pull/44015
5198 [44220]: https://github.com/rust-lang/rust/pull/44220
5199 [44251]: https://github.com/rust-lang/rust/pull/44251
5200 [44287]: https://github.com/rust-lang/rust/pull/44287
5201 [44303]: https://github.com/rust-lang/rust/pull/44303
5202 [44456]: https://github.com/rust-lang/rust/pull/44456
5203 [44466]: https://github.com/rust-lang/rust/pull/44466
5204 [44895]: https://github.com/rust-lang/rust/pull/44895
5205 [44966]: https://github.com/rust-lang/rust/pull/44966
5206 [44978]: https://github.com/rust-lang/rust/pull/44978
5207 [45041]: https://github.com/rust-lang/rust/pull/45041
5208 [45064]: https://github.com/rust-lang/rust/pull/45064
5209 [45075]: https://github.com/rust-lang/rust/pull/45075
5210 [45094]: https://github.com/rust-lang/rust/pull/45094
5211 [45095]: https://github.com/rust-lang/rust/pull/45095
5212 [45480]: https://github.com/rust-lang/rust/issues/45480
5213 [45656]: https://github.com/rust-lang/rust/pull/45656
5214 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
5215 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
5216 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
5217
5218
5219
5220
5221
5222
5223 Version 1.21.0 (2017-10-12)
5224 ==========================
5225
5226 Language
5227 --------
5228 - [You can now use static references for literals.][43838]
5229   Example:
5230   ```rust
5231   fn main() {
5232       let x: &'static u32 = &0;
5233   }
5234   ```
5235 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
5236   Example:
5237   ```rust
5238   my_macro!(Vec<i32>::new); // Always worked
5239   my_macro!(Vec::<i32>::new); // Now works
5240   ```
5241
5242 Compiler
5243 --------
5244 - [Upgraded jemalloc to 4.5.0][43911]
5245 - [Enabled unwinding panics on Redox][43917]
5246 - [Now runs LLVM in parallel during translation phase.][43506]
5247   This should reduce peak memory usage.
5248
5249 Libraries
5250 ---------
5251 - [Generate builtin impls for `Clone` for all arrays and tuples that
5252   are `T: Clone`][43690]
5253 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
5254 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
5255   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
5256
5257 Stabilized APIs
5258 ---------------
5259
5260 [`std::mem::discriminant`]
5261
5262 Cargo
5263 -----
5264 - [You can now call `cargo install` with multiple package names][cargo/4216]
5265 - [Cargo commands inside a virtual workspace will now implicitly
5266   pass `--all`][cargo/4335]
5267 - [Added a `[patch]` section to `Cargo.toml` to handle
5268   prepublication dependencies][cargo/4123] [RFC 1969]
5269 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
5270   like patterns][cargo/4270]
5271 - [Added the `--all-targets` option][cargo/4400]
5272 - [Using required dependencies as a feature is now deprecated and emits
5273   a warning][cargo/4364]
5274
5275
5276 Misc
5277 ----
5278 - [Cargo docs are moving][43916]
5279   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
5280 - [The rustdoc book is now available][43863]
5281   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
5282 - [Added a preview of RLS has been made available through rustup][44204]
5283   Install with `rustup component add rls-preview`
5284 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
5285   Previously only showed `std::os::unix`.
5286
5287 Compatibility Notes
5288 -------------------
5289 - [Changes in method matching against higher-ranked types][43880] This may cause
5290   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
5291 - [rustc's JSON error output's byte position start at top of file.][42973]
5292   Was previously relative to the rustc's internal `CodeMap` struct which
5293   required the unstable library `libsyntax` to correctly use.
5294 - [`unused_results` lint no longer ignores booleans][43728]
5295
5296 [42565]: https://github.com/rust-lang/rust/pull/42565
5297 [42973]: https://github.com/rust-lang/rust/pull/42973
5298 [43348]: https://github.com/rust-lang/rust/pull/43348
5299 [43459]: https://github.com/rust-lang/rust/pull/43459
5300 [43506]: https://github.com/rust-lang/rust/pull/43506
5301 [43540]: https://github.com/rust-lang/rust/pull/43540
5302 [43690]: https://github.com/rust-lang/rust/pull/43690
5303 [43728]: https://github.com/rust-lang/rust/pull/43728
5304 [43838]: https://github.com/rust-lang/rust/pull/43838
5305 [43863]: https://github.com/rust-lang/rust/pull/43863
5306 [43880]: https://github.com/rust-lang/rust/pull/43880
5307 [43911]: https://github.com/rust-lang/rust/pull/43911
5308 [43916]: https://github.com/rust-lang/rust/pull/43916
5309 [43917]: https://github.com/rust-lang/rust/pull/43917
5310 [44204]: https://github.com/rust-lang/rust/pull/44204
5311 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
5312 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
5313 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5314 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
5315 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
5316 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
5317 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
5318 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
5319 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
5320
5321 Version 1.20.0 (2017-08-31)
5322 ===========================
5323
5324 Language
5325 --------
5326 - [Associated constants are now stabilised.][42809]
5327 - [A lot of macro bugs are now fixed.][42913]
5328
5329 Compiler
5330 --------
5331
5332 - [Struct fields are now properly coerced to the expected field type.][42807]
5333 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
5334   `wasm32-experimental-emscripten` target.
5335 - [Changed some of the error messages to be more helpful.][42033]
5336 - [Add support for RELRO(RELocation Read-Only) for platforms that support
5337   it.][43170]
5338 - [rustc now reports the total number of errors on compilation failure][43015]
5339   previously this was only the number of errors in the pass that failed.
5340 - [Expansion in rustc has been sped up 29x.][42533]
5341 - [added `msp430-none-elf` target.][43099]
5342 - [rustc will now suggest one-argument enum variant to fix type mismatch when
5343   applicable][43178]
5344 - [Fixes backtraces on Redox][43228]
5345 - [rustc now identifies different versions of same crate when absolute paths of
5346   different types match in an error message.][42826]
5347
5348 Libraries
5349 ---------
5350
5351
5352 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
5353 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
5354   tuples.][43011]
5355 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
5356   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
5357 - [Impl `Clone` for `DefaultHasher`.][42799]
5358 - [Impl `Sync` for `SyncSender`.][42397]
5359 - [Impl `FromStr` for `char`][42271]
5360 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
5361   NaN.][42431]
5362 - [allow messages in the `unimplemented!()` macro.][42155]
5363   ie. `unimplemented!("Waiting for 1.21 to be stable")`
5364 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
5365 - [Upgrade to Unicode 10.0.0][42999]
5366 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
5367 - [Skip the main thread's manual stack guard on Linux][43072]
5368 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in *O*(1) time][43077]
5369 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
5370   previously 2^15.
5371 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
5372
5373 Stabilized APIs
5374 ---------------
5375
5376 - [`CStr::into_c_string`]
5377 - [`CString::as_c_str`]
5378 - [`CString::into_boxed_c_str`]
5379 - [`Chain::get_mut`]
5380 - [`Chain::get_ref`]
5381 - [`Chain::into_inner`]
5382 - [`Option::get_or_insert_with`]
5383 - [`Option::get_or_insert`]
5384 - [`OsStr::into_os_string`]
5385 - [`OsString::into_boxed_os_str`]
5386 - [`Take::get_mut`]
5387 - [`Take::get_ref`]
5388 - [`Utf8Error::error_len`]
5389 - [`char::EscapeDebug`]
5390 - [`char::escape_debug`]
5391 - [`compile_error!`]
5392 - [`f32::from_bits`]
5393 - [`f32::to_bits`]
5394 - [`f64::from_bits`]
5395 - [`f64::to_bits`]
5396 - [`mem::ManuallyDrop`]
5397 - [`slice::sort_unstable_by_key`]
5398 - [`slice::sort_unstable_by`]
5399 - [`slice::sort_unstable`]
5400 - [`str::from_boxed_utf8_unchecked`]
5401 - [`str::as_bytes_mut`]
5402 - [`str::as_bytes_mut`]
5403 - [`str::from_utf8_mut`]
5404 - [`str::from_utf8_unchecked_mut`]
5405 - [`str::get_mut`]
5406 - [`str::get_unchecked_mut`]
5407 - [`str::get_unchecked`]
5408 - [`str::get`]
5409 - [`str::into_boxed_bytes`]
5410
5411
5412 Cargo
5413 -----
5414 - [Cargo API token location moved from `~/.cargo/config` to
5415   `~/.cargo/credentials`.][cargo/3978]
5416 - [Cargo will now build `main.rs` binaries that are in sub-directories of
5417   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
5418   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
5419 - [You can now specify version of a binary when installed through
5420   `cargo install` using `--vers`.][cargo/4229]
5421 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
5422   failure.][cargo/4248]
5423 - [Changed the convention around which file is the crate root.][cargo/4259]
5424 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
5425   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
5426
5427 Compatibility Notes
5428 -------------------
5429
5430 - [Functions with `'static` in their return types will now not be as usable as
5431   if they were using lifetime parameters instead.][42417]
5432 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
5433   takes the sign of NaN into account where previously didn't.][42430]
5434
5435 [42033]: https://github.com/rust-lang/rust/pull/42033
5436 [42155]: https://github.com/rust-lang/rust/pull/42155
5437 [42271]: https://github.com/rust-lang/rust/pull/42271
5438 [42397]: https://github.com/rust-lang/rust/pull/42397
5439 [42417]: https://github.com/rust-lang/rust/pull/42417
5440 [42430]: https://github.com/rust-lang/rust/pull/42430
5441 [42431]: https://github.com/rust-lang/rust/pull/42431
5442 [42533]: https://github.com/rust-lang/rust/pull/42533
5443 [42571]: https://github.com/rust-lang/rust/pull/42571
5444 [42613]: https://github.com/rust-lang/rust/pull/42613
5445 [42799]: https://github.com/rust-lang/rust/pull/42799
5446 [42807]: https://github.com/rust-lang/rust/pull/42807
5447 [42809]: https://github.com/rust-lang/rust/pull/42809
5448 [42822]: https://github.com/rust-lang/rust/pull/42822
5449 [42826]: https://github.com/rust-lang/rust/pull/42826
5450 [42854]: https://github.com/rust-lang/rust/pull/42854
5451 [42913]: https://github.com/rust-lang/rust/pull/42913
5452 [42999]: https://github.com/rust-lang/rust/pull/42999
5453 [43011]: https://github.com/rust-lang/rust/pull/43011
5454 [43015]: https://github.com/rust-lang/rust/pull/43015
5455 [43072]: https://github.com/rust-lang/rust/pull/43072
5456 [43077]: https://github.com/rust-lang/rust/pull/43077
5457 [43097]: https://github.com/rust-lang/rust/pull/43097
5458 [43099]: https://github.com/rust-lang/rust/pull/43099
5459 [43170]: https://github.com/rust-lang/rust/pull/43170
5460 [43178]: https://github.com/rust-lang/rust/pull/43178
5461 [43185]: https://github.com/rust-lang/rust/pull/43185
5462 [43228]: https://github.com/rust-lang/rust/pull/43228
5463 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
5464 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
5465 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
5466 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
5467 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
5468 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5469 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
5470 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
5471 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
5472 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
5473 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
5474 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
5475 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
5476 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
5477 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
5478 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
5479 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
5480 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
5481 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
5482 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
5483 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
5484 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
5485 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
5486 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
5487 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
5488 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
5489 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
5490 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
5491 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
5492 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
5493 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
5494 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
5495 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
5496 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
5497 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
5498 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
5499 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
5500 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
5501 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
5502
5503
5504 Version 1.19.0 (2017-07-20)
5505 ===========================
5506
5507 Language
5508 --------
5509
5510 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
5511   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
5512 - [Macro recursion limit increased to 1024 from 64.][41676]
5513 - [Added lint for detecting unused macros.][41907]
5514 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
5515   For example: `let x = loop { break 7; };`
5516 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
5517   contain `Copy` types and cannot have a `Drop` implementation.
5518   Example: `union Foo { bar: u8, baz: usize }`
5519 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
5520   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
5521
5522 Compiler
5523 --------
5524
5525 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
5526 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
5527   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
5528   you should use `--target armv7-linux-androideabi`.
5529 - [Fixed ICE when removing a source file between compilation sessions.][41873]
5530 - [Minor optimisation of string operations.][42037]
5531 - [Compiler error message is now `aborting due to previous error(s)` instead of
5532   `aborting due to N previous errors`][42150] This was previously inaccurate and
5533   would only count certain kinds of errors.
5534 - [The compiler now supports Visual Studio 2017][42225]
5535 - [The compiler is now built against LLVM 4.0.1 by default][42948]
5536 - [Added a lot][42264] of [new error codes][42302]
5537 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
5538   libraries with C Run-time Libraries(CRT) to be statically linked.
5539 - [Fixed various ARM codegen bugs][42740]
5540
5541 Libraries
5542 ---------
5543
5544 - [`String` now implements `FromIterator<Cow<'a, str>>` and
5545   `Extend<Cow<'a, str>>`][41449]
5546 - [`Vec` now implements `From<&mut [T]>`][41530]
5547 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
5548 - [`SplitWhitespace` now implements `Clone`][41659]
5549 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
5550   1.5x faster][41764]
5551 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
5552   macros, but for printing to stderr.
5553
5554 Stabilized APIs
5555 ---------------
5556
5557 - [`OsString::shrink_to_fit`]
5558 - [`cmp::Reverse`]
5559 - [`Command::envs`]
5560 - [`thread::ThreadId`]
5561
5562 Cargo
5563 -----
5564
5565 - [Build scripts can now add environment variables to the environment
5566   the crate is being compiled in.
5567   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
5568 - [Subcommands now replace the current process rather than spawning a new
5569   child process][cargo/3970]
5570 - [Workspace members can now accept glob file patterns][cargo/3979]
5571 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
5572   the members in a given workspace.][cargo/3988]
5573 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
5574 - [Target directory path is now in the cargo metadata][cargo/4022]
5575 - [Cargo no longer checks out a local working directory for the
5576   crates.io index][cargo/4026] This should provide smaller file size for the
5577   registry, and improve cloning times, especially on Windows machines.
5578 - [Added an `--exclude` option for excluding certain packages when using the
5579   `--all` option][cargo/4031]
5580 - [Cargo will now automatically retry when receiving a 5xx error
5581   from crates.io][cargo/4032]
5582 - [The `--features` option now accepts multiple comma or space
5583   delimited values.][cargo/4084]
5584 - [Added support for custom target specific runners][cargo/3954]
5585
5586 Misc
5587 ----
5588
5589 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
5590   Windows Debugger.
5591 - [Rust will now release XZ compressed packages][rust-installer/57]
5592 - [rustup will now prefer to download rust packages with
5593   XZ compression][rustup/1100] over GZip packages.
5594 - [Added the ability to escape `#` in rust documentation][41785] By adding
5595   additional `#`'s ie. `##` is now `#`
5596
5597 Compatibility Notes
5598 -------------------
5599
5600 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
5601 - [`-Z` flags are now no longer allowed to be used on the stable
5602   compiler.][41751] This has been a warning for a year previous to this.
5603 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
5604   longer works][42844]. Users should migrate to the built-in `check`
5605   command, which has been available since 1.16.
5606 - [Ending a float literal with `._` is now a hard error.
5607   Example: `42._` .][41946]
5608 - [Any use of a private `extern crate` outside of its module is now a
5609   hard error.][36886] This was previously a warning.
5610 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
5611   relative while the `::` prefix makes a path absolute, but was ignored and the
5612   path was relative regardless.
5613 - [Floating point constants in match patterns is now a hard error][36890]
5614   This was previously a warning.
5615 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
5616   match patterns is now a hard error][36891] This was previously a warning.
5617 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
5618   a warning.
5619 - [From the pound escape, lines consisting of multiple `#`s are
5620   now visible][41785]
5621 - [It is an error to re-export private enum variants][42460]. This is
5622   known to break a number of crates that depend on an older version of
5623   mustache.
5624 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
5625   to use it to find the linker, and the build will fail where it did
5626   not previously][42607]
5627
5628 [36886]: https://github.com/rust-lang/rust/issues/36886
5629 [36888]: https://github.com/rust-lang/rust/issues/36888
5630 [36890]: https://github.com/rust-lang/rust/issues/36890
5631 [36891]: https://github.com/rust-lang/rust/issues/36891
5632 [36892]: https://github.com/rust-lang/rust/issues/36892
5633 [37406]: https://github.com/rust-lang/rust/issues/37406
5634 [39983]: https://github.com/rust-lang/rust/pull/39983
5635 [41145]: https://github.com/rust-lang/rust/pull/41145
5636 [41192]: https://github.com/rust-lang/rust/pull/41192
5637 [41258]: https://github.com/rust-lang/rust/pull/41258
5638 [41370]: https://github.com/rust-lang/rust/pull/41370
5639 [41449]: https://github.com/rust-lang/rust/pull/41449
5640 [41530]: https://github.com/rust-lang/rust/pull/41530
5641 [41624]: https://github.com/rust-lang/rust/pull/41624
5642 [41656]: https://github.com/rust-lang/rust/pull/41656
5643 [41659]: https://github.com/rust-lang/rust/pull/41659
5644 [41676]: https://github.com/rust-lang/rust/pull/41676
5645 [41751]: https://github.com/rust-lang/rust/pull/41751
5646 [41764]: https://github.com/rust-lang/rust/pull/41764
5647 [41785]: https://github.com/rust-lang/rust/pull/41785
5648 [41873]: https://github.com/rust-lang/rust/pull/41873
5649 [41907]: https://github.com/rust-lang/rust/pull/41907
5650 [41946]: https://github.com/rust-lang/rust/pull/41946
5651 [42016]: https://github.com/rust-lang/rust/pull/42016
5652 [42037]: https://github.com/rust-lang/rust/pull/42037
5653 [42068]: https://github.com/rust-lang/rust/pull/42068
5654 [42150]: https://github.com/rust-lang/rust/pull/42150
5655 [42162]: https://github.com/rust-lang/rust/pull/42162
5656 [42225]: https://github.com/rust-lang/rust/pull/42225
5657 [42264]: https://github.com/rust-lang/rust/pull/42264
5658 [42302]: https://github.com/rust-lang/rust/pull/42302
5659 [42460]: https://github.com/rust-lang/rust/issues/42460
5660 [42607]: https://github.com/rust-lang/rust/issues/42607
5661 [42740]: https://github.com/rust-lang/rust/pull/42740
5662 [42844]: https://github.com/rust-lang/rust/issues/42844
5663 [42948]: https://github.com/rust-lang/rust/pull/42948
5664 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
5665 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
5666 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
5667 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
5668 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
5669 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
5670 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
5671 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
5672 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
5673 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
5674 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
5675 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
5676 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
5677 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
5678 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
5679 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
5680 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
5681 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
5682 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
5683 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
5684 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
5685 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
5686
5687
5688 Version 1.18.0 (2017-06-08)
5689 ===========================
5690
5691 Language
5692 --------
5693
5694 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
5695   make the item visible to just that module tree. Also accepts the keyword
5696   `crate` to make something public to the whole crate but not users of the
5697   library. Example: `pub(crate) mod utils;`. [RFC 1422].
5698 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
5699   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
5700 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
5701   types like `Write + Send`, trailing `+` are now supported in trait objects,
5702   and better error reporting for trait objects starting with `?Sized`.
5703 - [0e+10 is now a valid floating point literal][40589]
5704 - [Now warns if you bind a lifetime parameter to 'static][40734]
5705 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
5706   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
5707   representation in some cases.][40377]
5708
5709 Compiler
5710 --------
5711
5712 - [rustc can now emit mir with `--emit mir`][39891]
5713 - [Improved LLVM IR for trivial functions][40367]
5714 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
5715 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
5716   opportunities found through profiling
5717 - [Improved backtrace formatting when panicking][38165]
5718
5719 Libraries
5720 ---------
5721
5722 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
5723   iterator hasn't been advanced the original `Vec` is reassembled with no actual
5724   iteration or reallocation.
5725 - [Simplified HashMap Bucket interface][40561] provides performance
5726   improvements for iterating and cloning.
5727 - [Specialize Vec::from_elem to use calloc][40409]
5728 - [Fixed Race condition in fs::create_dir_all][39799]
5729 - [No longer caching stdio on Windows][40516]
5730 - [Optimized insertion sort in slice][40807] insertion sort in some cases
5731   2.50%~ faster and in one case now 12.50% faster.
5732 - [Optimized `AtomicBool::fetch_nand`][41143]
5733
5734 Stabilized APIs
5735 ---------------
5736
5737 - [`Child::try_wait`]
5738 - [`HashMap::retain`]
5739 - [`HashSet::retain`]
5740 - [`PeekMut::pop`]
5741 - [`TcpStream::peek`]
5742 - [`UdpSocket::peek`]
5743 - [`UdpSocket::peek_from`]
5744
5745 Cargo
5746 -----
5747
5748 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
5749   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
5750 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
5751 - [Added Android build support][cargo/3885]
5752 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
5753   of a certain type, for example `cargo build --bins` will build all
5754   binaries.
5755 - [Added support for haiku][cargo/3952]
5756
5757 Misc
5758 ----
5759
5760 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
5761 - [Added rust-windbg script for better debugging on Windows][39983]
5762 - [Rust now uses the official cross compiler for NetBSD][40612]
5763 - [rustdoc now accepts `#` at the start of files][40828]
5764 - [Fixed jemalloc support for musl][41168]
5765
5766 Compatibility Notes
5767 -------------------
5768
5769 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
5770   always placed after the sign if it exists and before the digits. With the `#`
5771   flag the zeroes are placed after the prefix and before the digits.
5772 - [Due to the struct field optimisation][40377], using `transmute` on structs
5773   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
5774   always been undefined behavior, but is now more likely to break in practice.
5775 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
5776   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
5777   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
5778 - [Overlapping inherent `impl`s are now a hard error][40728]
5779 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
5780 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
5781   `out.asm` and `out.ll` instead of only one of the filetypes.
5782 - [ calling a function that returns `Self` will no longer work][41805] when
5783   the size of `Self` cannot be statically determined.
5784 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
5785   this has caused a few regressions namely:
5786
5787   - Changed the link order of local static/dynamic libraries (respecting the
5788     order on given rather than having the compiler reorder).
5789   - Changed how MinGW is linked, native code linked to dynamic libraries
5790     may require manually linking to the gcc support library (for the native
5791     code itself)
5792
5793 [38165]: https://github.com/rust-lang/rust/pull/38165
5794 [39799]: https://github.com/rust-lang/rust/pull/39799
5795 [39891]: https://github.com/rust-lang/rust/pull/39891
5796 [39983]: https://github.com/rust-lang/rust/pull/39983
5797 [40043]: https://github.com/rust-lang/rust/pull/40043
5798 [40241]: https://github.com/rust-lang/rust/pull/40241
5799 [40338]: https://github.com/rust-lang/rust/pull/40338
5800 [40367]: https://github.com/rust-lang/rust/pull/40367
5801 [40377]: https://github.com/rust-lang/rust/pull/40377
5802 [40409]: https://github.com/rust-lang/rust/pull/40409
5803 [40516]: https://github.com/rust-lang/rust/pull/40516
5804 [40556]: https://github.com/rust-lang/rust/pull/40556
5805 [40561]: https://github.com/rust-lang/rust/pull/40561
5806 [40589]: https://github.com/rust-lang/rust/pull/40589
5807 [40612]: https://github.com/rust-lang/rust/pull/40612
5808 [40723]: https://github.com/rust-lang/rust/pull/40723
5809 [40728]: https://github.com/rust-lang/rust/pull/40728
5810 [40731]: https://github.com/rust-lang/rust/pull/40731
5811 [40734]: https://github.com/rust-lang/rust/pull/40734
5812 [40805]: https://github.com/rust-lang/rust/pull/40805
5813 [40807]: https://github.com/rust-lang/rust/pull/40807
5814 [40828]: https://github.com/rust-lang/rust/pull/40828
5815 [40870]: https://github.com/rust-lang/rust/pull/40870
5816 [41085]: https://github.com/rust-lang/rust/pull/41085
5817 [41143]: https://github.com/rust-lang/rust/pull/41143
5818 [41168]: https://github.com/rust-lang/rust/pull/41168
5819 [41270]: https://github.com/rust-lang/rust/issues/41270
5820 [41469]: https://github.com/rust-lang/rust/pull/41469
5821 [41805]: https://github.com/rust-lang/rust/issues/41805
5822 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
5823 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
5824 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
5825 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
5826 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
5827 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
5828 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
5829 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
5830 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
5831 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
5832 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
5833 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
5834 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
5835 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
5836
5837
5838 Version 1.17.0 (2017-04-27)
5839 ===========================
5840
5841 Language
5842 --------
5843
5844 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
5845 * [Fields of structs may be initialized without duplicating the field/variable
5846   names][39761]. [RFC 1682]
5847 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
5848 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5849   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
5850   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
5851   `'b`. Soundness fix.
5852 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
5853 * [Static variables may contain references to other statics][40027]
5854
5855 Compiler
5856 --------
5857
5858 * [Exit quickly on only `--emit dep-info`][40336]
5859 * [Make `-C relocation-model` more correctly determine whether the linker
5860   creates a position-independent executable][40245]
5861 * [Add `-C overflow-checks` to directly control whether integer overflow
5862   panics][40037]
5863 * [The rustc type checker now checks items on demand instead of in a single
5864   in-order pass][40008]. This is mostly an internal refactoring in support of
5865   future work, including incremental type checking, but also resolves [RFC
5866   1647], allowing `Self` to appear in `impl` `where` clauses.
5867 * [Optimize vtable loads][39995]
5868 * [Turn off vectorization for Emscripten targets][39990]
5869 * [Provide suggestions for unknown macros imported with `use`][39953]
5870 * [Fix ICEs in path resolution][39939]
5871 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
5872 * [Add clearer error message using `&str + &str`][39116]
5873
5874 Stabilized APIs
5875 ---------------
5876
5877 * [`Arc::into_raw`]
5878 * [`Arc::from_raw`]
5879 * [`Arc::ptr_eq`]
5880 * [`Rc::into_raw`]
5881 * [`Rc::from_raw`]
5882 * [`Rc::ptr_eq`]
5883 * [`Ordering::then`]
5884 * [`Ordering::then_with`]
5885 * [`BTreeMap::range`]
5886 * [`BTreeMap::range_mut`]
5887 * [`collections::Bound`]
5888 * [`process::abort`]
5889 * [`ptr::read_unaligned`]
5890 * [`ptr::write_unaligned`]
5891 * [`Result::expect_err`]
5892 * [`Cell::swap`]
5893 * [`Cell::replace`]
5894 * [`Cell::into_inner`]
5895 * [`Cell::take`]
5896
5897 Libraries
5898 ---------
5899
5900 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
5901 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
5902 * [`String` implements `FromIterator<&char>`][40028]
5903 * `Box` [implements][40009] a number of new conversions:
5904   `From<Box<str>> for String`,
5905   `From<Box<[T]>> for Vec<T>`,
5906   `From<Box<CStr>> for CString`,
5907   `From<Box<OsStr>> for OsString`,
5908   `From<Box<Path>> for PathBuf`,
5909   `Into<Box<str>> for String`,
5910   `Into<Box<[T]>> for Vec<T>`,
5911   `Into<Box<CStr>> for CString`,
5912   `Into<Box<OsStr>> for OsString`,
5913   `Into<Box<Path>> for PathBuf`,
5914   `Default for Box<str>`,
5915   `Default for Box<CStr>`,
5916   `Default for Box<OsStr>`,
5917   `From<&CStr> for Box<CStr>`,
5918   `From<&OsStr> for Box<OsStr>`,
5919   `From<&Path> for Box<Path>`
5920 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
5921 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
5922 * [Slightly optimize `slice::sort`][39538]
5923 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
5924 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
5925   `Box<str>` implements `From<&str>`][39438]
5926 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
5927   `From<(I, u16)> where I: Into<IpAddr>`][39372]
5928 * [`format!` estimates the needed capacity before writing a string][39356]
5929 * [Support unprivileged symlink creation in Windows][38921]
5930 * [`PathBuf` implements `Default`][38764]
5931 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
5932 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
5933   and poor hash functions.
5934
5935 Cargo
5936 -----
5937
5938 * [Add `cargo check --all`][cargo/3731]
5939 * [Add an option to ignore SSL revocation checking][cargo/3699]
5940 * [Add `cargo run --package`][cargo/3691]
5941 * [Add `required_features`][cargo/3667]
5942 * [Assume `build.rs` is a build script][cargo/3664]
5943 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
5944
5945 Misc
5946 ----
5947
5948 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
5949   `rustbook`][39633]
5950 * [The "Unstable Book" documents nightly-only features][ubook]
5951 * [Improve the style of the sidebar in rustdoc output][40265]
5952 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
5953 * [Fix MSP430 breakage due to `i128`][40257]
5954 * [Preliminary Solaris/SPARCv9 support][39903]
5955 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
5956   run without installing the MSVC runtime.
5957 * [`rustdoc --test` includes file names in test names][39788]
5958 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
5959   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
5960 * [Initial support for `aarch64-unknown-freebsd`][39491]
5961 * [Initial support for `i686-unknown-netbsd`][39426]
5962 * [This release no longer includes the old makefile build system][39431]. Rust
5963   is built with a custom build system, written in Rust, and with Cargo.
5964 * [Add Debug implementations for libcollection structs][39002]
5965 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
5966 * [`--test-threads=0` produces an error][38945]
5967 * [`rustup` installs documentation by default][40526]
5968 * [The Rust source includes NatVis visualizations][39843]. These can be used by
5969   WinDbg and Visual Studio to improve the debugging experience.
5970
5971 Compatibility Notes
5972 -------------------
5973
5974 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
5975   workaround, either use MSVC 2015 or run vcvars.bat.
5976 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5977   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
5978   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
5979   fix.
5980 * [`format!` and `Display::to_string` panic if an underlying formatting
5981   implementation returns an error][40117]. Previously the error was silently
5982   ignored. It is incorrect for `write_fmt` to return an error when writing
5983   to a string.
5984 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
5985   crates were marked stable and could be accessed from the stable toolchain.
5986 * [Rust git source no longer includes vendored crates][39728]. Those that need
5987   to build with vendored crates should build from release tarballs.
5988 * [Fix inert attributes from `proc_macro_derives`][39572]
5989 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
5990   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
5991   build system.
5992 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
5993   existing code generally ignores the type of dead-code unless a type-hint is
5994   provided; this can cause surprising inference interactions particularly around
5995   defaulting. The new code uniformly ignores the result type of dead-code.
5996 * [Tuple-struct constructors with private fields are no longer visible][38932]
5997 * [Lifetime parameters that do not appear in the arguments are now considered
5998   early-bound][38897], resolving a soundness bug (#[32330]). The
5999   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
6000   April of 2016.
6001 * [rustdoc: fix doctests with non-feature crate attributes][38161]
6002 * [Make transmuting from fn item types to pointer-sized types a hard
6003   error][34198]
6004
6005 [27787]: https://github.com/rust-lang/rust/issues/27787
6006 [32330]: https://github.com/rust-lang/rust/issues/32330
6007 [34198]: https://github.com/rust-lang/rust/pull/34198
6008 [38161]: https://github.com/rust-lang/rust/pull/38161
6009 [38368]: https://github.com/rust-lang/rust/pull/38368
6010 [38584]: https://github.com/rust-lang/rust/issues/38584
6011 [38661]: https://github.com/rust-lang/rust/pull/38661
6012 [38764]: https://github.com/rust-lang/rust/pull/38764
6013 [38864]: https://github.com/rust-lang/rust/issues/38864
6014 [38897]: https://github.com/rust-lang/rust/pull/38897
6015 [38921]: https://github.com/rust-lang/rust/pull/38921
6016 [38932]: https://github.com/rust-lang/rust/pull/38932
6017 [38945]: https://github.com/rust-lang/rust/pull/38945
6018 [38981]: https://github.com/rust-lang/rust/pull/38981
6019 [39002]: https://github.com/rust-lang/rust/pull/39002
6020 [39116]: https://github.com/rust-lang/rust/pull/39116
6021 [39193]: https://github.com/rust-lang/rust/pull/39193
6022 [39265]: https://github.com/rust-lang/rust/pull/39265
6023 [39356]: https://github.com/rust-lang/rust/pull/39356
6024 [39372]: https://github.com/rust-lang/rust/pull/39372
6025 [39426]: https://github.com/rust-lang/rust/pull/39426
6026 [39431]: https://github.com/rust-lang/rust/pull/39431
6027 [39438]: https://github.com/rust-lang/rust/pull/39438
6028 [39440]: https://github.com/rust-lang/rust/pull/39440
6029 [39485]: https://github.com/rust-lang/rust/pull/39485
6030 [39491]: https://github.com/rust-lang/rust/pull/39491
6031 [39518]: https://github.com/rust-lang/rust/pull/39518
6032 [39538]: https://github.com/rust-lang/rust/pull/39538
6033 [39572]: https://github.com/rust-lang/rust/pull/39572
6034 [39633]: https://github.com/rust-lang/rust/pull/39633
6035 [39642]: https://github.com/rust-lang/rust/pull/39642
6036 [39728]: https://github.com/rust-lang/rust/pull/39728
6037 [39761]: https://github.com/rust-lang/rust/pull/39761
6038 [39788]: https://github.com/rust-lang/rust/pull/39788
6039 [39793]: https://github.com/rust-lang/rust/pull/39793
6040 [39837]: https://github.com/rust-lang/rust/pull/39837
6041 [39843]: https://github.com/rust-lang/rust/pull/39843
6042 [39851]: https://github.com/rust-lang/rust/pull/39851
6043 [39903]: https://github.com/rust-lang/rust/pull/39903
6044 [39939]: https://github.com/rust-lang/rust/pull/39939
6045 [39953]: https://github.com/rust-lang/rust/pull/39953
6046 [39960]: https://github.com/rust-lang/rust/pull/39960
6047 [39990]: https://github.com/rust-lang/rust/pull/39990
6048 [39995]: https://github.com/rust-lang/rust/pull/39995
6049 [40008]: https://github.com/rust-lang/rust/pull/40008
6050 [40009]: https://github.com/rust-lang/rust/pull/40009
6051 [40027]: https://github.com/rust-lang/rust/pull/40027
6052 [40028]: https://github.com/rust-lang/rust/pull/40028
6053 [40037]: https://github.com/rust-lang/rust/pull/40037
6054 [40117]: https://github.com/rust-lang/rust/pull/40117
6055 [40166]: https://github.com/rust-lang/rust/pull/40166
6056 [40245]: https://github.com/rust-lang/rust/pull/40245
6057 [40257]: https://github.com/rust-lang/rust/pull/40257
6058 [40261]: https://github.com/rust-lang/rust/pull/40261
6059 [40265]: https://github.com/rust-lang/rust/pull/40265
6060 [40319]: https://github.com/rust-lang/rust/pull/40319
6061 [40336]: https://github.com/rust-lang/rust/pull/40336
6062 [40526]: https://github.com/rust-lang/rust/pull/40526
6063 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
6064 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
6065 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
6066 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
6067 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
6068 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
6069 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
6070 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
6071 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
6072 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
6073 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
6074 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
6075 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
6076 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
6077 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
6078 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
6079 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
6080 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
6081 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
6082 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
6083 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
6084 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
6085 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
6086 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
6087 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
6088 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
6089 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
6090 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
6091 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
6092 [ubook]: https://doc.rust-lang.org/unstable-book/
6093
6094
6095 Version 1.16.0 (2017-03-16)
6096 ===========================
6097
6098 Language
6099 --------
6100
6101 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6102 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6103   match patterns][38069]
6104 * [Clean up semantics of `self` in an import list][38313]
6105 * [`Self` may appear in `impl` headers][38920]
6106 * [`Self` may appear in struct expressions][39282]
6107
6108 Compiler
6109 --------
6110
6111 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
6112   a `.rmeta` file containing only crate metadata][38571]. This can be
6113   used by tools like the Rust Language Service to perform
6114   metadata-only builds.
6115 * [Levenshtein based typo suggestions now work in most places, while
6116   previously they worked only for fields and sometimes for local
6117   variables][38927]. Together with the overhaul of "no
6118   resolution"/"unexpected resolution" errors (#[38154]) they result in
6119   large and systematic improvement in resolution diagnostics.
6120 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
6121   `U`][38670]
6122 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
6123 * [`rustc` no longer attempts to provide "consider using an explicit
6124   lifetime" suggestions][37057]. They were inaccurate.
6125
6126 Stabilized APIs
6127 ---------------
6128
6129 * [`VecDeque::truncate`]
6130 * [`VecDeque::resize`]
6131 * [`String::insert_str`]
6132 * [`Duration::checked_add`]
6133 * [`Duration::checked_sub`]
6134 * [`Duration::checked_div`]
6135 * [`Duration::checked_mul`]
6136 * [`str::replacen`]
6137 * [`str::repeat`]
6138 * [`SocketAddr::is_ipv4`]
6139 * [`SocketAddr::is_ipv6`]
6140 * [`IpAddr::is_ipv4`]
6141 * [`IpAddr::is_ipv6`]
6142 * [`Vec::dedup_by`]
6143 * [`Vec::dedup_by_key`]
6144 * [`Result::unwrap_or_default`]
6145 * [`<*const T>::wrapping_offset`]
6146 * [`<*mut T>::wrapping_offset`]
6147 * `CommandExt::creation_flags`
6148 * [`File::set_permissions`]
6149 * [`String::split_off`]
6150
6151 Libraries
6152 ---------
6153
6154 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
6155   their argument by `Borrow` parameter][37761]
6156 * [All public types in std implement `Debug`][38006]
6157 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
6158 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
6159 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6160   Windows][38274]
6161 * [std: Fix partial writes in `LineWriter`][38062]
6162 * [std: Clamp max read/write sizes on Unix][38062]
6163 * [Use more specific panic message for `&str` slicing errors][38066]
6164 * [`TcpListener::set_only_v6` is deprecated][38304]. This
6165   functionality cannot be achieved in std currently.
6166 * [`writeln!`, like `println!`, now accepts a form with no string
6167   or formatting arguments, to just print a newline][38469]
6168 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
6169 * [Reduce the size of static data in `std_unicode::tables`][38781]
6170 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
6171   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
6172   `Display`][38909]
6173 * [`Duration` implements `Sum`][38712]
6174 * [`String` implements `ToSocketAddrs`][39048]
6175
6176 Cargo
6177 -----
6178
6179 * [The `cargo check` command does a type check of a project without
6180   building it][cargo/3296]
6181 * [crates.io will display CI badges from Travis and AppVeyor, if
6182   specified in Cargo.toml][cargo/3546]
6183 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
6184 * [Compilation profiles accept integer values for `debug`, in addition
6185   to `true` and `false`. These are passed to `rustc` as the value to
6186   `-C debuginfo`][cargo/3534]
6187 * [Implement `cargo --version --verbose`][cargo/3604]
6188 * [All builds now output 'dep-info' build dependencies compatible with
6189   make and ninja][cargo/3557]
6190 * [Build all workspace members with `build --all`][cargo/3511]
6191 * [Document all workspace members with `doc --all`][cargo/3515]
6192 * [Path deps outside workspace are not members][cargo/3443]
6193
6194 Misc
6195 ----
6196
6197 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
6198   the path to the Rust implementation][38589]
6199 * [The `armv7-linux-androideabi` target no longer enables NEON
6200   extensions, per Google's ABI guide][38413]
6201 * [The stock standard library can be compiled for Redox OS][38401]
6202 * [Rust has initial SPARC support][38726]. Tier 3. No builds
6203   available.
6204 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
6205   builds available.
6206 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
6207
6208 Compatibility Notes
6209 -------------------
6210
6211 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6212   match patterns][38069]
6213 * In this release, references to uninhabited types can not be
6214   pattern-matched. This was accidentally allowed in 1.15.
6215 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6216 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6217   Windows][38274]
6218 * [Clean up semantics of `self` in an import list][38313]
6219 * Reimplemented lifetime elision. This change was almost entirely compatible
6220   with existing code, but it did close a number of small bugs and loopholes,
6221   as well as being more accepting in some other [cases][41105].
6222
6223 [37057]: https://github.com/rust-lang/rust/pull/37057
6224 [37761]: https://github.com/rust-lang/rust/pull/37761
6225 [38006]: https://github.com/rust-lang/rust/pull/38006
6226 [38051]: https://github.com/rust-lang/rust/pull/38051
6227 [38062]: https://github.com/rust-lang/rust/pull/38062
6228 [38062]: https://github.com/rust-lang/rust/pull/38622
6229 [38066]: https://github.com/rust-lang/rust/pull/38066
6230 [38069]: https://github.com/rust-lang/rust/pull/38069
6231 [38131]: https://github.com/rust-lang/rust/pull/38131
6232 [38154]: https://github.com/rust-lang/rust/pull/38154
6233 [38274]: https://github.com/rust-lang/rust/pull/38274
6234 [38304]: https://github.com/rust-lang/rust/pull/38304
6235 [38313]: https://github.com/rust-lang/rust/pull/38313
6236 [38327]: https://github.com/rust-lang/rust/pull/38327
6237 [38401]: https://github.com/rust-lang/rust/pull/38401
6238 [38413]: https://github.com/rust-lang/rust/pull/38413
6239 [38469]: https://github.com/rust-lang/rust/pull/38469
6240 [38559]: https://github.com/rust-lang/rust/pull/38559
6241 [38571]: https://github.com/rust-lang/rust/pull/38571
6242 [38580]: https://github.com/rust-lang/rust/pull/38580
6243 [38589]: https://github.com/rust-lang/rust/pull/38589
6244 [38670]: https://github.com/rust-lang/rust/pull/38670
6245 [38712]: https://github.com/rust-lang/rust/pull/38712
6246 [38726]: https://github.com/rust-lang/rust/pull/38726
6247 [38781]: https://github.com/rust-lang/rust/pull/38781
6248 [38798]: https://github.com/rust-lang/rust/pull/38798
6249 [38909]: https://github.com/rust-lang/rust/pull/38909
6250 [38920]: https://github.com/rust-lang/rust/pull/38920
6251 [38927]: https://github.com/rust-lang/rust/pull/38927
6252 [39048]: https://github.com/rust-lang/rust/pull/39048
6253 [39282]: https://github.com/rust-lang/rust/pull/39282
6254 [39379]: https://github.com/rust-lang/rust/pull/39379
6255 [41105]: https://github.com/rust-lang/rust/issues/41105
6256 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6257 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6258 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
6259 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
6260 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
6261 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
6262 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
6263 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
6264 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
6265 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
6266 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
6267 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
6268 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
6269 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
6270 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
6271 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
6272 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
6273 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
6274 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
6275 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
6276 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
6277 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
6278 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
6279 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
6280 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
6281 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
6282 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
6283 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
6284 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
6285
6286
6287 Version 1.15.1 (2017-02-09)
6288 ===========================
6289
6290 * [Fix IntoIter::as_mut_slice's signature][39466]
6291 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
6292
6293 [39466]: https://github.com/rust-lang/rust/pull/39466
6294 [39523]: https://github.com/rust-lang/rust/pull/39523
6295
6296
6297 Version 1.15.0 (2017-02-02)
6298 ===========================
6299
6300 Language
6301 --------
6302
6303 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
6304   stable. This allows popular code-generating crates like Serde and Diesel to
6305   work ergonomically. [RFC 1681].
6306 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
6307   with curly braces][36868]. Part of [RFC 1506].
6308 * [A number of minor changes to name resolution have been activated][37127].
6309   They add up to more consistent semantics, allowing for future evolution of
6310   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6311   details of what is different. The breaking changes here have been transitioned
6312   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6313 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
6314   bounds][38279]
6315 * [`?Sized` can be used in `where` clauses][37791]
6316 * [There is now a limit on the size of monomorphized types and it can be
6317   modified with the `#![type_size_limit]` crate attribute, similarly to
6318   the `#![recursion_limit]` attribute][37789]
6319
6320 Compiler
6321 --------
6322
6323 * [On Windows, the compiler will apply dllimport attributes when linking to
6324   extern functions][37973]. Additional attributes and flags can control which
6325   library kind is linked and its name. [RFC 1717].
6326 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6327 * [The `--test` flag works with procedural macro crates][38107]
6328 * [Fix `extern "aapcs" fn` ABI][37814]
6329 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
6330 * [The `format!` expander recognizes incorrect `printf` and shell-style
6331   formatting directives and suggests the correct format][37613].
6332 * [Only report one error for all unused imports in an import list][37456]
6333
6334 Compiler Performance
6335 --------------------
6336
6337 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
6338 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
6339 * [Don't clone in `UnificationTable::probe`][37848]
6340 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
6341 * [Use small vectors in type walker][37760]
6342 * [Macro expansion performance was improved][37701]
6343 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
6344 * [Replace FNV with a faster hash function][37229]
6345
6346 Stabilized APIs
6347 ---------------
6348
6349 * [`std::iter::Iterator::min_by`]
6350 * [`std::iter::Iterator::max_by`]
6351 * [`std::os::*::fs::FileExt`]
6352 * [`std::sync::atomic::Atomic*::get_mut`]
6353 * [`std::sync::atomic::Atomic*::into_inner`]
6354 * [`std::vec::IntoIter::as_slice`]
6355 * [`std::vec::IntoIter::as_mut_slice`]
6356 * [`std::sync::mpsc::Receiver::try_iter`]
6357 * [`std::os::unix::process::CommandExt::before_exec`]
6358 * [`std::rc::Rc::strong_count`]
6359 * [`std::rc::Rc::weak_count`]
6360 * [`std::sync::Arc::strong_count`]
6361 * [`std::sync::Arc::weak_count`]
6362 * [`std::char::encode_utf8`]
6363 * [`std::char::encode_utf16`]
6364 * [`std::cell::Ref::clone`]
6365 * [`std::io::Take::into_inner`]
6366
6367 Libraries
6368 ---------
6369
6370 * [The standard sorting algorithm has been rewritten for dramatic performance
6371   improvements][38192]. It is a hybrid merge sort, drawing influences from
6372   Timsort. Previously it was a naive merge sort.
6373 * [`Iterator::nth` no longer has a `Sized` bound][38134]
6374 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
6375   performance.
6376 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
6377   and `char_indices().last()`][37882]
6378 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
6379 * [Chinese characters display correctly in `fmt::Debug`][37855]
6380 * [Derive `Default` for `Duration`][37699]
6381 * [Support creation of anonymous pipes on WinXP/2k][37677]
6382 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
6383 * [Don't pass overlapped handles to processes][38835]
6384
6385 Cargo
6386 -----
6387
6388 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6389   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6390   should instead check the variable at runtime with `std::env`. That the value
6391   was set at build time was a bug, and incorrect when cross-compiling. This
6392   change is known to cause breakage.
6393 * [Add `--all` flag to `cargo test`][cargo/3221]
6394 * [Compile statically against the MSVC CRT][cargo/3363]
6395 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
6396 * [Link OpenSSL statically on OSX][cargo/3311]
6397 * [Apply new fingerprinting to build dir outputs][cargo/3310]
6398 * [Test for bad path overrides with summaries][cargo/3336]
6399 * [Require `cargo install --vers` to take a semver version][cargo/3338]
6400 * [Fix retrying crate downloads for network errors][cargo/3348]
6401 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
6402 * [Emit more info on --message-format=json][cargo/3319]
6403 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
6404 * [Don't ignore errors in workspace manifest][cargo/3409]
6405 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
6406
6407 Tooling
6408 -------
6409
6410 * [Test runners (binaries built with `--test`) now support a `--list` argument
6411   that lists the tests it contains][38185]
6412 * [Test runners now support a `--exact` argument that makes the test filter
6413   match exactly, instead of matching only a substring of the test name][38181]
6414 * [rustdoc supports a `--playground-url` flag][37763]
6415 * [rustdoc provides more details about `#[should_panic]` errors][37749]
6416
6417 Misc
6418 ----
6419
6420 * [The Rust build system is now written in Rust][37817]. The Makefiles may
6421   continue to be used in this release by passing `--disable-rustbuild` to the
6422   configure script, but they will be deleted soon. Note that the new build
6423   system uses a different on-disk layout that will likely affect any scripts
6424   building Rust.
6425 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
6426   releases.
6427 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
6428 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
6429   releases.
6430
6431 Compatibility Notes
6432 -------------------
6433
6434 * [A number of minor changes to name resolution have been activated][37127].
6435   They add up to more consistent semantics, allowing for future evolution of
6436   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6437   details of what is different. The breaking changes here have been transitioned
6438   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6439 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6440   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6441   should instead check the variable at runtime with `std::env`. That the value
6442   was set at build time was a bug, and incorrect when cross-compiling. This
6443   change is known to cause breakage.
6444 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
6445   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
6446   1.10 and is now an error by default. It will become a hard error in the near
6447   future.
6448 * [The semantics relating modules to file system directories are changing in
6449   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
6450   lint, which is a warning in this release, and will become a hard error in the
6451   future.
6452 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6453 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
6454   the underlying iterator][37834]
6455
6456 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
6457 [33685]: https://github.com/rust-lang/rust/issues/33685
6458 [36868]: https://github.com/rust-lang/rust/pull/36868
6459 [37127]: https://github.com/rust-lang/rust/pull/37127
6460 [37229]: https://github.com/rust-lang/rust/pull/37229
6461 [37456]: https://github.com/rust-lang/rust/pull/37456
6462 [37527]: https://github.com/rust-lang/rust/pull/37527
6463 [37602]: https://github.com/rust-lang/rust/pull/37602
6464 [37613]: https://github.com/rust-lang/rust/pull/37613
6465 [37615]: https://github.com/rust-lang/rust/pull/37615
6466 [37636]: https://github.com/rust-lang/rust/pull/37636
6467 [37627]: https://github.com/rust-lang/rust/pull/37627
6468 [37642]: https://github.com/rust-lang/rust/pull/37642
6469 [37677]: https://github.com/rust-lang/rust/pull/37677
6470 [37699]: https://github.com/rust-lang/rust/pull/37699
6471 [37701]: https://github.com/rust-lang/rust/pull/37701
6472 [37705]: https://github.com/rust-lang/rust/pull/37705
6473 [37749]: https://github.com/rust-lang/rust/pull/37749
6474 [37760]: https://github.com/rust-lang/rust/pull/37760
6475 [37763]: https://github.com/rust-lang/rust/pull/37763
6476 [37764]: https://github.com/rust-lang/rust/pull/37764
6477 [37789]: https://github.com/rust-lang/rust/pull/37789
6478 [37791]: https://github.com/rust-lang/rust/pull/37791
6479 [37814]: https://github.com/rust-lang/rust/pull/37814
6480 [37817]: https://github.com/rust-lang/rust/pull/37817
6481 [37834]: https://github.com/rust-lang/rust/pull/37834
6482 [37848]: https://github.com/rust-lang/rust/pull/37848
6483 [37855]: https://github.com/rust-lang/rust/pull/37855
6484 [37882]: https://github.com/rust-lang/rust/pull/37882
6485 [37888]: https://github.com/rust-lang/rust/pull/37888
6486 [37973]: https://github.com/rust-lang/rust/pull/37973
6487 [37979]: https://github.com/rust-lang/rust/pull/37979
6488 [38086]: https://github.com/rust-lang/rust/pull/38086
6489 [38107]: https://github.com/rust-lang/rust/pull/38107
6490 [38117]: https://github.com/rust-lang/rust/pull/38117
6491 [38134]: https://github.com/rust-lang/rust/pull/38134
6492 [38146]: https://github.com/rust-lang/rust/pull/38146
6493 [38181]: https://github.com/rust-lang/rust/pull/38181
6494 [38182]: https://github.com/rust-lang/rust/pull/38182
6495 [38185]: https://github.com/rust-lang/rust/pull/38185
6496 [38192]: https://github.com/rust-lang/rust/pull/38192
6497 [38279]: https://github.com/rust-lang/rust/pull/38279
6498 [38835]: https://github.com/rust-lang/rust/pull/38835
6499 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6500 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
6501 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
6502 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
6503 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
6504 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
6505 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
6506 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
6507 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
6508 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
6509 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
6510 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
6511 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
6512 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
6513 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
6514 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
6515 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
6516 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
6517 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
6518 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
6519 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
6520 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
6521 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
6522 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
6523 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
6524 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
6525 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
6526 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
6527 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
6528 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
6529 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
6530 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
6531 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
6532 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
6533 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
6534 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
6535 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
6536
6537
6538 Version 1.14.0 (2016-12-22)
6539 ===========================
6540
6541 Language
6542 --------
6543
6544 * [`..` matches multiple tuple fields in enum variants, structs
6545   and tuples][36843]. [RFC 1492].
6546 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
6547 * [`use *` and `use ::*` both glob-import from the crate root][37367]
6548 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
6549   dereferencing][36822]
6550
6551 Compiler
6552 --------
6553
6554 * [Mark enums with non-zero discriminant as non-zero][37224]
6555 * [Lower-case `static mut` names are linted like other
6556   statics and consts][37162]
6557 * [Fix ICE on some macros in const integer positions
6558    (e.g. `[u8; m!()]`)][36819]
6559 * [Improve error message and snippet for "did you mean `x`"][36798]
6560 * [Add a panic-strategy field to the target specification][36794]
6561 * [Include LLVM version in `--version --verbose`][37200]
6562
6563 Compile-time Optimizations
6564 --------------------------
6565
6566 * [Improve macro expansion performance][37569]
6567 * [Shrink `Expr_::ExprInlineAsm`][37445]
6568 * [Replace all uses of SHA-256 with BLAKE2b][37439]
6569 * [Reduce the number of bytes hashed by `IchHasher`][37427]
6570 * [Avoid more allocations when compiling html5ever][37373]
6571 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
6572 * [Avoid some allocations in the macro parser][37318]
6573 * [Use a faster deflate setting][37298]
6574 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
6575   during interning of slices][37270]
6576 * [Optimize `write_metadata`][37267]
6577 * [Don't process obligation forest cycles when stalled][37231]
6578 * [Avoid many `CrateConfig` clones][37161]
6579 * [Optimize `Substs::super_fold_with`][37108]
6580 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
6581 * [Speed up `plug_leaks`][36917]
6582
6583 Libraries
6584 ---------
6585
6586 * [`println!()`, with no arguments, prints newline][36825].
6587   Previously, an empty string was required to achieve the same.
6588 * [`Wrapping` impls standard binary and unary operators, as well as
6589    the `Sum` and `Product` iterators][37356]
6590 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
6591   Vec<T>`][37326]
6592 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
6593   `VecDeque` iterators][37315]
6594 * [Improve `SipHasher` performance on small values][37312]
6595 * [Add Iterator trait TrustedLen to enable better FromIterator /
6596   Extend][37306]
6597 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
6598 * [`ReadDir` implements `Debug`][37221]
6599 * [Implement `RefUnwindSafe` for atomic types][37178]
6600 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
6601 * [Avoid allocations in `Decoder::read_str`][37064]
6602 * [`io::Error` implements `From<io::ErrorKind>`][37037]
6603 * [Impl `Debug` for raw pointers to unsized data][36880]
6604 * [Don't reuse `HashMap` random seeds][37470]
6605 * [The internal memory layout of `HashMap` is more cache-friendly, for
6606   significant improvements in some operations][36692]
6607 * [`HashMap` uses less memory on 32-bit architectures][36595]
6608 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
6609
6610 Cargo
6611 -----
6612
6613 * [Expose rustc cfg values to build scripts][cargo/3243]
6614 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
6615 * [Fix passing --features when testing multiple packages][cargo/3280]
6616 * [Use a single profile set per workspace][cargo/3249]
6617 * [Load `replace` sections from lock files][cargo/3220]
6618 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
6619
6620 Tooling
6621 -------
6622
6623 * [rustup is the recommended Rust installation method][1.14rustup]
6624 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
6625   S390x. These are [tier 2] platforms and may have major defects. Follow the
6626   instructions on the website to install, or add the targets to an existing
6627   installation with `rustup target add`. The new target triples are:
6628   - `mips-unknown-linux-gnu`
6629   - `mipsel-unknown-linux-gnu`
6630   - `mips64-unknown-linux-gnuabi64`
6631   - `mips64el-unknown-linux-gnuabi64 `
6632   - `powerpc-unknown-linux-gnu`
6633   - `powerpc64-unknown-linux-gnu`
6634   - `powerpc64le-unknown-linux-gnu`
6635   - `s390x-unknown-linux-gnu `
6636 * This release includes target (std) builds for ARM Linux running MUSL
6637   libc. These are [tier 2] platforms and may have major defects. Add the
6638   following triples to an existing rustup installation with `rustup target add`:
6639   - `arm-unknown-linux-musleabi`
6640   - `arm-unknown-linux-musleabihf`
6641   - `armv7-unknown-linux-musleabihf`
6642 * This release includes [experimental support for WebAssembly][1.14wasm], via
6643   the `wasm32-unknown-emscripten` target. This target is known to have major
6644   defects. Please test, report, and fix.
6645 * rustup no longer installs documentation by default. Run `rustup
6646   component add rust-docs` to install.
6647 * [Fix line stepping in debugger][37310]
6648 * [Enable line number debuginfo in releases][37280]
6649
6650 Misc
6651 ----
6652
6653 * [Disable jemalloc on aarch64/powerpc/mips][37392]
6654 * [Add support for Fuchsia OS][37313]
6655 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
6656
6657 Compatibility Notes
6658 -------------------
6659
6660 * [A number of forward-compatibility lints used by the compiler
6661   to gradually introduce language changes have been converted
6662   to deny by default][36894]:
6663   - ["use of inaccessible extern crate erroneously allowed"][36886]
6664   - ["type parameter default erroneously allowed in invalid location"][36887]
6665   - ["detects super or self keywords at the beginning of global path"][36888]
6666   - ["two overlapping inherent impls define an item with the same name
6667     were erroneously allowed"][36889]
6668   - ["floating-point constants cannot be used in patterns"][36890]
6669   - ["constants of struct or enum type can only be used in a pattern if
6670      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
6671   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
6672 * [Prohibit patterns in trait methods without bodies][37378]
6673 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
6674 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
6675 * [The `$crate` macro variable is accepted in fewer locations][37213]
6676 * [Impls specifying extra region requirements beyond the trait
6677   they implement are rejected][37167]
6678 * [Enums may not be unsized][37111]. Unsized enums are intended to
6679   work but never have. For now they are forbidden.
6680 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
6681
6682 [tier 2]: https://forge.rust-lang.org/platform-support.html
6683 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
6684 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
6685 [36430]: https://github.com/rust-lang/rust/pull/36430
6686 [36595]: https://github.com/rust-lang/rust/pull/36595
6687 [36692]: https://github.com/rust-lang/rust/pull/36692
6688 [36767]: https://github.com/rust-lang/rust/pull/36767
6689 [36794]: https://github.com/rust-lang/rust/pull/36794
6690 [36798]: https://github.com/rust-lang/rust/pull/36798
6691 [36819]: https://github.com/rust-lang/rust/pull/36819
6692 [36822]: https://github.com/rust-lang/rust/pull/36822
6693 [36825]: https://github.com/rust-lang/rust/pull/36825
6694 [36843]: https://github.com/rust-lang/rust/pull/36843
6695 [36880]: https://github.com/rust-lang/rust/pull/36880
6696 [36886]: https://github.com/rust-lang/rust/issues/36886
6697 [36887]: https://github.com/rust-lang/rust/issues/36887
6698 [36888]: https://github.com/rust-lang/rust/issues/36888
6699 [36889]: https://github.com/rust-lang/rust/issues/36889
6700 [36890]: https://github.com/rust-lang/rust/issues/36890
6701 [36891]: https://github.com/rust-lang/rust/issues/36891
6702 [36892]: https://github.com/rust-lang/rust/issues/36892
6703 [36894]: https://github.com/rust-lang/rust/pull/36894
6704 [36917]: https://github.com/rust-lang/rust/pull/36917
6705 [36993]: https://github.com/rust-lang/rust/pull/36993
6706 [37037]: https://github.com/rust-lang/rust/pull/37037
6707 [37064]: https://github.com/rust-lang/rust/pull/37064
6708 [37094]: https://github.com/rust-lang/rust/pull/37094
6709 [37108]: https://github.com/rust-lang/rust/pull/37108
6710 [37111]: https://github.com/rust-lang/rust/pull/37111
6711 [37161]: https://github.com/rust-lang/rust/pull/37161
6712 [37162]: https://github.com/rust-lang/rust/pull/37162
6713 [37167]: https://github.com/rust-lang/rust/pull/37167
6714 [37178]: https://github.com/rust-lang/rust/pull/37178
6715 [37200]: https://github.com/rust-lang/rust/pull/37200
6716 [37213]: https://github.com/rust-lang/rust/pull/37213
6717 [37221]: https://github.com/rust-lang/rust/pull/37221
6718 [37224]: https://github.com/rust-lang/rust/pull/37224
6719 [37230]: https://github.com/rust-lang/rust/pull/37230
6720 [37231]: https://github.com/rust-lang/rust/pull/37231
6721 [37247]: https://github.com/rust-lang/rust/pull/37247
6722 [37267]: https://github.com/rust-lang/rust/pull/37267
6723 [37270]: https://github.com/rust-lang/rust/pull/37270
6724 [37273]: https://github.com/rust-lang/rust/pull/37273
6725 [37280]: https://github.com/rust-lang/rust/pull/37280
6726 [37298]: https://github.com/rust-lang/rust/pull/37298
6727 [37306]: https://github.com/rust-lang/rust/pull/37306
6728 [37310]: https://github.com/rust-lang/rust/pull/37310
6729 [37312]: https://github.com/rust-lang/rust/pull/37312
6730 [37313]: https://github.com/rust-lang/rust/pull/37313
6731 [37315]: https://github.com/rust-lang/rust/pull/37315
6732 [37318]: https://github.com/rust-lang/rust/pull/37318
6733 [37322]: https://github.com/rust-lang/rust/pull/37322
6734 [37326]: https://github.com/rust-lang/rust/pull/37326
6735 [37351]: https://github.com/rust-lang/rust/pull/37351
6736 [37356]: https://github.com/rust-lang/rust/pull/37356
6737 [37367]: https://github.com/rust-lang/rust/pull/37367
6738 [37373]: https://github.com/rust-lang/rust/pull/37373
6739 [37378]: https://github.com/rust-lang/rust/pull/37378
6740 [37389]: https://github.com/rust-lang/rust/pull/37389
6741 [37392]: https://github.com/rust-lang/rust/pull/37392
6742 [37427]: https://github.com/rust-lang/rust/pull/37427
6743 [37439]: https://github.com/rust-lang/rust/pull/37439
6744 [37445]: https://github.com/rust-lang/rust/pull/37445
6745 [37470]: https://github.com/rust-lang/rust/pull/37470
6746 [37569]: https://github.com/rust-lang/rust/pull/37569
6747 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6748 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
6749 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
6750 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
6751 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
6752 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
6753 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
6754
6755
6756 Version 1.13.0 (2016-11-10)
6757 ===========================
6758
6759 Language
6760 --------
6761
6762 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
6763   errors, like the `try!` macro, described in [RFC 0243].
6764 * [Stabilize macros in type position][36014]. Described in [RFC 873].
6765 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
6766 * [Fix `#[derive]` for empty tuple structs/variants][35728]
6767 * [Fix lifetime rules for 'if' conditions][36029]
6768 * [Avoid loading and parsing unconfigured non-inline modules][36482]
6769
6770 Compiler
6771 --------
6772
6773 * [Add the `-C link-arg` argument][36574]
6774 * [Remove the old AST-based backend from rustc_trans][35764]
6775 * [Don't enable NEON by default on armv7 Linux][35814]
6776 * [Fix debug line number info for macro expansions][35238]
6777 * [Do not emit "class method" debuginfo for types that are not
6778   DICompositeType][36008]
6779 * [Warn about multiple conflicting #[repr] hints][34623]
6780 * [When sizing DST, don't double-count nested struct prefixes][36351]
6781 * [Default RUST_MIN_STACK to 16MiB for now][36505]
6782 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
6783 * [Reject macros with empty repetitions to avoid infinite loop][36721]
6784 * [Expand macros without recursing to avoid stack overflows][36214]
6785
6786 Diagnostics
6787 -----------
6788
6789 * [Replace macro backtraces with labeled local uses][35702]
6790 * [Improve error message for misplaced doc comments][33922]
6791 * [Buffer unix and lock windows to prevent message interleaving][35975]
6792 * [Update lifetime errors to specifically note temporaries][36171]
6793 * [Special case a few colors for Windows][36178]
6794 * [Suggest `use self` when such an import resolves][36289]
6795 * [Be more specific when type parameter shadows primitive type][36338]
6796 * Many minor improvements
6797
6798 Compile-time Optimizations
6799 --------------------------
6800
6801 * [Compute and cache HIR hashes at beginning][35854]
6802 * [Don't hash types in loan paths][36004]
6803 * [Cache projections in trans][35761]
6804 * [Optimize the parser's last token handling][36527]
6805 * [Only instantiate #[inline] functions in codegen units referencing
6806   them][36524]. This leads to big improvements in cases where crates export
6807   define many inline functions without using them directly.
6808 * [Lazily allocate TypedArena's first chunk][36592]
6809 * [Don't allocate during default HashSet creation][36734]
6810
6811 Stabilized APIs
6812 ---------------
6813
6814 * [`checked_abs`]
6815 * [`wrapping_abs`]
6816 * [`overflowing_abs`]
6817 * [`RefCell::try_borrow`]
6818 * [`RefCell::try_borrow_mut`]
6819
6820 Libraries
6821 ---------
6822
6823 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
6824 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
6825   covariant][35354]
6826 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
6827 * [Implement `Debug` for `std::vec::IntoIter`][35707]
6828 * [`CString`: avoid excessive growth just to 0-terminate][35871]
6829 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
6830 * [Use arc4rand on FreeBSD][35884]
6831 * [memrchr: Correct aligned offset computation][35969]
6832 * [Improve Demangling of Rust Symbols][36059]
6833 * [Use monotonic time in condition variables][35048]
6834 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
6835 * [Implement conversion traits for `char`][35755]
6836 * [Fix illegal instruction caused by overflow in channel cloning][36104]
6837 * [Zero first byte of CString on drop][36264]
6838 * [Inherit overflow checks for sum and product][36372]
6839 * [Add missing Eq implementations][36423]
6840 * [Implement `Debug` for `DirEntry`][36631]
6841 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
6842   `errno`][36754]
6843 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6844 * [Implement more traits for `std::io::ErrorKind`][35911]
6845 * [Optimize BinaryHeap bounds checking][36072]
6846 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
6847   `extend_with_element`][36355]
6848 * [Fix overflow checking in unsigned pow()][34942]
6849
6850 Cargo
6851 -----
6852
6853 * This release includes security fixes to both curl and OpenSSL.
6854 * [Fix transitive doctests when panic=abort][cargo/3021]
6855 * [Add --all-features flag to cargo][cargo/3038]
6856 * [Reject path-based dependencies in `cargo package`][cargo/3060]
6857 * [Don't parse the home directory more than once][cargo/3078]
6858 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
6859 * [Update OpenSSL to 1.0.2j][cargo/3121]
6860 * [Add license and license_file to cargo metadata output][cargo/3110]
6861 * [Make crates-io registry URL optional in config; ignore all changes to
6862   source.crates-io][cargo/3089]
6863 * [Don't download dependencies from other platforms][cargo/3123]
6864 * [Build transitive dev-dependencies when needed][cargo/3125]
6865 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
6866 * [Avoid updating registry when adding existing deps][cargo/3144]
6867 * [Warn about path overrides that won't work][cargo/3136]
6868 * [Use workspaces during `cargo install`][cargo/3146]
6869 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
6870 * [Add --message-format flag][cargo/3000]
6871 * [Pass target environment for rustdoc][cargo/3205]
6872 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
6873 * [Update curl and curl-sys][cargo/3241]
6874 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
6875
6876 Tooling
6877 -------
6878
6879 * [rustdoc: Add the `--sysroot` argument][36586]
6880 * [rustdoc: Fix a couple of issues with the search results][35655]
6881 * [rustdoc: remove the `!` from macro URLs and titles][35234]
6882 * [gdb: Fix pretty-printing special-cased Rust types][35585]
6883 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
6884
6885 Misc
6886 ----
6887
6888 * [Remove unmaintained style guide][35124]
6889 * [Add s390x support][36369]
6890 * [Initial work at Haiku OS support][36727]
6891 * [Add mips-uclibc targets][35734]
6892 * [Crate-ify compiler-rt into compiler-builtins][35021]
6893 * [Add rustc version info (git hash + date) to dist tarball][36213]
6894 * Many documentation improvements
6895
6896 Compatibility Notes
6897 -------------------
6898
6899 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6900 * [Deny (by default) transmuting from fn item types to pointer-sized
6901   types][34923]. Continuing the long transition to zero-sized fn items,
6902   per [RFC 401].
6903 * [Fix `#[derive]` for empty tuple structs/variants][35728].
6904   Part of [RFC 1506].
6905 * [Issue deprecation warnings for safe accesses to extern statics][36173]
6906 * [Fix lifetime rules for 'if' conditions][36029].
6907 * [Inherit overflow checks for sum and product][36372].
6908 * [Forbid user-defined macros named "macro_rules"][36730].
6909
6910 [33922]: https://github.com/rust-lang/rust/pull/33922
6911 [34623]: https://github.com/rust-lang/rust/pull/34623
6912 [34923]: https://github.com/rust-lang/rust/pull/34923
6913 [34942]: https://github.com/rust-lang/rust/pull/34942
6914 [35021]: https://github.com/rust-lang/rust/pull/35021
6915 [35048]: https://github.com/rust-lang/rust/pull/35048
6916 [35074]: https://github.com/rust-lang/rust/pull/35074
6917 [35124]: https://github.com/rust-lang/rust/pull/35124
6918 [35234]: https://github.com/rust-lang/rust/pull/35234
6919 [35238]: https://github.com/rust-lang/rust/pull/35238
6920 [35354]: https://github.com/rust-lang/rust/pull/35354
6921 [35559]: https://github.com/rust-lang/rust/pull/35559
6922 [35585]: https://github.com/rust-lang/rust/pull/35585
6923 [35627]: https://github.com/rust-lang/rust/pull/35627
6924 [35655]: https://github.com/rust-lang/rust/pull/35655
6925 [35702]: https://github.com/rust-lang/rust/pull/35702
6926 [35707]: https://github.com/rust-lang/rust/pull/35707
6927 [35728]: https://github.com/rust-lang/rust/pull/35728
6928 [35734]: https://github.com/rust-lang/rust/pull/35734
6929 [35755]: https://github.com/rust-lang/rust/pull/35755
6930 [35761]: https://github.com/rust-lang/rust/pull/35761
6931 [35764]: https://github.com/rust-lang/rust/pull/35764
6932 [35814]: https://github.com/rust-lang/rust/pull/35814
6933 [35854]: https://github.com/rust-lang/rust/pull/35854
6934 [35871]: https://github.com/rust-lang/rust/pull/35871
6935 [35884]: https://github.com/rust-lang/rust/pull/35884
6936 [35911]: https://github.com/rust-lang/rust/pull/35911
6937 [35969]: https://github.com/rust-lang/rust/pull/35969
6938 [35975]: https://github.com/rust-lang/rust/pull/35975
6939 [36004]: https://github.com/rust-lang/rust/pull/36004
6940 [36008]: https://github.com/rust-lang/rust/pull/36008
6941 [36014]: https://github.com/rust-lang/rust/pull/36014
6942 [36029]: https://github.com/rust-lang/rust/pull/36029
6943 [36059]: https://github.com/rust-lang/rust/pull/36059
6944 [36072]: https://github.com/rust-lang/rust/pull/36072
6945 [36101]: https://github.com/rust-lang/rust/pull/36101
6946 [36104]: https://github.com/rust-lang/rust/pull/36104
6947 [36171]: https://github.com/rust-lang/rust/pull/36171
6948 [36173]: https://github.com/rust-lang/rust/pull/36173
6949 [36178]: https://github.com/rust-lang/rust/pull/36178
6950 [36213]: https://github.com/rust-lang/rust/pull/36213
6951 [36214]: https://github.com/rust-lang/rust/pull/36214
6952 [36264]: https://github.com/rust-lang/rust/pull/36264
6953 [36266]: https://github.com/rust-lang/rust/pull/36266
6954 [36289]: https://github.com/rust-lang/rust/pull/36289
6955 [36338]: https://github.com/rust-lang/rust/pull/36338
6956 [36351]: https://github.com/rust-lang/rust/pull/36351
6957 [36355]: https://github.com/rust-lang/rust/pull/36355
6958 [36369]: https://github.com/rust-lang/rust/pull/36369
6959 [36372]: https://github.com/rust-lang/rust/pull/36372
6960 [36423]: https://github.com/rust-lang/rust/pull/36423
6961 [36482]: https://github.com/rust-lang/rust/pull/36482
6962 [36505]: https://github.com/rust-lang/rust/pull/36505
6963 [36524]: https://github.com/rust-lang/rust/pull/36524
6964 [36527]: https://github.com/rust-lang/rust/pull/36527
6965 [36551]: https://github.com/rust-lang/rust/pull/36551
6966 [36574]: https://github.com/rust-lang/rust/pull/36574
6967 [36586]: https://github.com/rust-lang/rust/pull/36586
6968 [36592]: https://github.com/rust-lang/rust/pull/36592
6969 [36631]: https://github.com/rust-lang/rust/pull/36631
6970 [36721]: https://github.com/rust-lang/rust/pull/36721
6971 [36727]: https://github.com/rust-lang/rust/pull/36727
6972 [36730]: https://github.com/rust-lang/rust/pull/36730
6973 [36734]: https://github.com/rust-lang/rust/pull/36734
6974 [36754]: https://github.com/rust-lang/rust/pull/36754
6975 [36995]: https://github.com/rust-lang/rust/pull/36995
6976 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
6977 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
6978 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6979 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
6980 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
6981 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
6982 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
6983 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
6984 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
6985 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
6986 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
6987 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
6988 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
6989 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
6990 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
6991 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
6992 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
6993 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
6994 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
6995 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
6996 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
6997 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
6998 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
6999 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
7000 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
7001 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
7002 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
7003 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
7004 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
7005 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
7006 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
7007 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
7008
7009
7010 Version 1.12.1 (2016-10-20)
7011 ===========================
7012
7013 Regression Fixes
7014 ----------------
7015
7016 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
7017 * [Confusion with double negation and booleans][36856]
7018 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
7019 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
7020 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
7021 * [Corrupted memory after updated to 1.12][36936]
7022 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
7023 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
7024 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
7025
7026 [36381]: https://github.com/rust-lang/rust/issues/36381
7027 [36856]: https://github.com/rust-lang/rust/issues/36856
7028 [36875]: https://github.com/rust-lang/rust/issues/36875
7029 [36924]: https://github.com/rust-lang/rust/issues/36924
7030 [36926]: https://github.com/rust-lang/rust/issues/36926
7031 [36936]: https://github.com/rust-lang/rust/issues/36936
7032 [37026]: https://github.com/rust-lang/rust/issues/37026
7033 [37112]: https://github.com/rust-lang/rust/issues/37112
7034 [37153]: https://github.com/rust-lang/rust/issues/37153
7035
7036
7037 Version 1.12.0 (2016-09-29)
7038 ===========================
7039
7040 Highlights
7041 ----------
7042
7043 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
7044   This translation pass is far simpler than the previous AST->LLVM pass, and
7045   creates opportunities to perform new optimizations directly on the MIR. It
7046   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
7047 * [`rustc` presents a new, more readable error format, along with
7048   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
7049   Most common editors supporting Rust have been updated to work with it. It was
7050   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
7051
7052 Compiler
7053 --------
7054
7055 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
7056   This translation pass is far simpler than the previous AST->LLVM pass, and
7057   creates opportunities to perform new optimizations directly on the MIR. It
7058   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
7059 * [Print the Rust target name, not the LLVM target name, with
7060   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
7061 * [The computation of `TypeId` is correct in some cases where it was previously
7062   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
7063 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
7064 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
7065   `--print relocation-models`, and `--print code-models` print the available
7066   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
7067   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
7068 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
7069   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
7070   These targets produce statically-linked binaries. There are no binary release
7071   builds yet though.
7072
7073 Diagnostics
7074 -----------
7075
7076 * [`rustc` presents a new, more readable error format, along with
7077   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
7078   Most common editors supporting Rust have been updated to work with it. It was
7079   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
7080 * [In error descriptions, references are now described in plain English,
7081   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
7082 * [In error type descriptions, unknown numeric types are named `{integer}` or
7083   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
7084 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
7085
7086 Language
7087 --------
7088
7089 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
7090 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
7091 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
7092   useful](https://github.com/rust-lang/rust/pull/34908)
7093 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
7094   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
7095 * [Semicolons are properly required as statement delimiters inside
7096   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
7097 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
7098
7099 Stabilized APIs
7100 ---------------
7101
7102 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
7103 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
7104 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
7105 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
7106 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
7107 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
7108 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
7109 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
7110 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
7111 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
7112   Both on Unix and Windows.
7113 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
7114 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
7115 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
7116 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
7117 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
7118 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
7119 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
7120 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
7121
7122 Libraries
7123 ---------
7124
7125 * [The `format!` macro and friends now allow a single argument to be formatted
7126   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
7127 * [The lifetime bounds on `[T]::binary_search_by` and
7128   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
7129 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
7130 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
7131 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
7132 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
7133 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
7134 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
7135 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
7136 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
7137   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
7138 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
7139   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
7140 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
7141 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
7142   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
7143 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
7144 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
7145 * [`mpsc::sync_channel` `Receiver`s return any available message before
7146   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
7147 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
7148 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
7149
7150 Cargo
7151 -----
7152
7153 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
7154 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
7155 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
7156 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
7157 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
7158 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
7159 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
7160 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
7161 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
7162 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
7163 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
7164 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
7165 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
7166 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
7167 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
7168 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
7169
7170 Performance
7171 -----------
7172
7173 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
7174 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
7175
7176 Tooling
7177 -------
7178
7179 * [Test binaries now support a `--test-threads` argument to specify the number
7180   of threads used to run tests, and which acts the same as the
7181   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
7182 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
7183 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
7184 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7185 * [Rust releases now come with source packages that can be installed by rustup
7186   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
7187   The resulting source code can be used by tools and IDES, located in the
7188   sysroot under `lib/rustlib/src`.
7189
7190 Misc
7191 ----
7192
7193 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
7194 * Many minor improvements to the documentation.
7195 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
7196
7197 Compatibility Notes
7198 -------------------
7199
7200 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
7201   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
7202 * [When formatting strings, if "precision" is specified, the "fill",
7203   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
7204 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
7205
7206
7207 Version 1.11.0 (2016-08-18)
7208 ===========================
7209
7210 Language
7211 --------
7212
7213 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
7214 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
7215 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
7216 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
7217
7218 Stabilized APIs
7219 ---------------
7220
7221 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
7222 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
7223 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
7224 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
7225 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
7226 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
7227   (in libcore - previously stabilized in libstd)
7228 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
7229   (in libcore - previously stabilized in libstd)
7230 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
7231   (in libcore - previously stabilized in libstd)
7232 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
7233   (in libcore - previously stabilized in libstd)
7234 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7235 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7236 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
7237 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
7238
7239 Libraries
7240 ---------
7241
7242 * [The `thread_local!` macro supports multiple definitions in a single
7243    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
7244 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
7245 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
7246   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
7247 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
7248 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
7249 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
7250 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
7251
7252 Cargo
7253 -----
7254
7255 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
7256 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
7257 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
7258 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
7259 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
7260   and `-vv` prints warnings for all crates.
7261 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
7262 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
7263   This provides room for expansion by arbitrary tools.
7264 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
7265 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
7266 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
7267 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
7268 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
7269 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
7270 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
7271
7272 Performance
7273 -----------
7274
7275 * [Caching projections speeds up type check dramatically for some
7276   workloads](https://github.com/rust-lang/rust/pull/33816)
7277 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
7278   This hasher is faster, but is believed to provide sufficient
7279   protection from collision attacks.
7280 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
7281
7282 Rustdoc
7283 -------
7284
7285 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
7286 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
7287 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
7288 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
7289 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
7290
7291 Tooling
7292 -------
7293
7294 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
7295 * [When emitting debug info, rustc emits frame pointers for closures,
7296   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
7297 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7298 * Many more errors have been given error codes and extended
7299   explanations
7300 * API documentation continues to be improved, with many new examples
7301
7302 Misc
7303 ----
7304
7305 * [rustc no longer hangs when dependencies recursively re-export
7306   submodules](https://github.com/rust-lang/rust/pull/34542)
7307 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
7308 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
7309   rewritten](https://github.com/rust-lang/rust/pull/33895)
7310 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
7311   No targets use this yet, but it works toward AVR support.
7312
7313 Compatibility Notes
7314 -------------------
7315
7316 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
7317 * [The new follow-set rules that place restrictions on `macro_rules!`
7318   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
7319   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
7320   and has been a warning since 1.10.
7321 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
7322   This causes breakage in some corner cases.
7323
7324
7325 Version 1.10.0 (2016-07-07)
7326 ===========================
7327
7328 Language
7329 --------
7330
7331 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
7332   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
7333 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
7334 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
7335 * [`panic!` can be converted to a runtime abort with the
7336   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
7337   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7338 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
7339   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
7340   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
7341   Note that Cargo does not yet directly support cdylibs.
7342
7343 Stabilized APIs
7344 ---------------
7345
7346 * `os::windows::fs::OpenOptionsExt::access_mode`
7347 * `os::windows::fs::OpenOptionsExt::share_mode`
7348 * `os::windows::fs::OpenOptionsExt::custom_flags`
7349 * `os::windows::fs::OpenOptionsExt::attributes`
7350 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
7351 * `os::unix::fs::OpenOptionsExt::custom_flags`
7352 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
7353 * `Default for sync::Weak`
7354 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
7355 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
7356 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
7357 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
7358 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
7359 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
7360 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
7361 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
7362 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
7363 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
7364 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
7365 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
7366 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
7367 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
7368 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
7369 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
7370 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
7371 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
7372 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
7373 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
7374 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
7375 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
7376 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
7377 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
7378 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
7379 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7380 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7381 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7382 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7383 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
7384 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
7385 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
7386 * Read/Write/RawFd impls for `UnixStream`
7387 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
7388 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
7389 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
7390 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
7391 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
7392 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
7393 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
7394 * RawFd impls for `UnixListener`
7395 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
7396 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
7397 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
7398 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
7399 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
7400 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
7401 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
7402 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
7403 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
7404 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
7405 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
7406 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
7407 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
7408 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
7409 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
7410 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
7411 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
7412 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
7413 * RawFd impls for `UnixDatagram`
7414 * `{BTree,Hash}Map::values_mut`
7415 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
7416
7417 Libraries
7418 ---------
7419
7420 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
7421   The semantics of this minor method are subtle and probably not what
7422   most people want.
7423 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
7424 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
7425   will fall back to `/dev/urandom` temporarily to avoid blocking
7426   during early boot](https://github.com/rust-lang/rust/pull/33086).
7427 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
7428 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
7429 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
7430 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
7431 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
7432 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
7433   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
7434
7435 Cargo
7436 -----
7437 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
7438   This controls the runtime behavior of the `panic!` macro
7439   and can be either "unwind" (the default), or "abort".
7440   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7441 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
7442 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
7443 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
7444   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
7445 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
7446 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
7447 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
7448   By default they are retried twice, which can be customized with the
7449   `net.retry` value in `.cargo/config`.
7450 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
7451 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
7452 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
7453 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
7454   Makes it possible to install multiple crates in parallel.
7455 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
7456 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
7457 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
7458 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
7459 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
7460 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
7461
7462 Performance
7463 -----------
7464
7465 * [rustc memory usage was reduced by refactoring the context used for
7466   type checking](https://github.com/rust-lang/rust/pull/33425).
7467 * [Speed up creation of `HashMap`s by caching the random keys used
7468   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
7469 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
7470 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
7471 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
7472   10x faster than the previous lookup tables.
7473 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
7474
7475 Usability
7476 ---------
7477
7478 * Many incremental improvements to documentation and rustdoc.
7479 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
7480 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
7481 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
7482 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
7483 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
7484 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
7485 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
7486
7487 Misc
7488 ----
7489
7490 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
7491 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
7492 * [`std` no longer prints backtraces on platforms where the running
7493   module must be loaded with `env::current_exe`, which can't be relied
7494   on](https://github.com/rust-lang/rust/pull/33554).
7495 * This release includes std binaries for the i586-unknown-linux-gnu,
7496   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
7497   i586 target is for old x86 hardware without SSE2, and the armv7
7498   target is for Android running on modern ARM architectures.
7499 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
7500   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
7501 * [On Unix the runtime aborts by calling `libc::abort` instead of
7502   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
7503 * [Rust is now bootstrapped from the previous release of Rust,
7504   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
7505
7506 Compatibility Notes
7507 -------------------
7508
7509 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
7510 * [`target_env` for Linux ARM targets is just `gnu`, not
7511   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
7512 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
7513 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
7514 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
7515   Affects how macros are parsed.
7516 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
7517 * [Feature-gated attributes on macro-generated macro invocations are
7518   now rejected](https://github.com/rust-lang/rust/pull/32791).
7519 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
7520   This caused some minor changes to type inference.
7521
7522
7523 Version 1.9.0 (2016-05-26)
7524 ==========================
7525
7526 Language
7527 --------
7528
7529 * The `#[deprecated]` attribute when applied to an API will generate
7530   warnings when used. The warnings may be suppressed with
7531   `#[allow(deprecated)]`. [RFC 1270].
7532 * [`fn` item types are zero sized, and each `fn` names a unique
7533   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7534   `transmute` on a `fn` type will generate a warning for a few cycles,
7535   then will be converted to an error.
7536 * [Field and method resolution understand visibility, so private
7537   fields and methods cannot prevent the proper use of public fields
7538   and methods][1.9fv].
7539 * [The parser considers unicode codepoints in the
7540   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
7541
7542 Stabilized APIs
7543 ---------------
7544
7545 * [`std::panic`]
7546 * [`std::panic::catch_unwind`] (renamed from `recover`)
7547 * [`std::panic::resume_unwind`] (renamed from `propagate`)
7548 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
7549 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
7550 * [`str::is_char_boundary`]
7551 * [`<*const T>::as_ref`]
7552 * [`<*mut T>::as_ref`]
7553 * [`<*mut T>::as_mut`]
7554 * [`AsciiExt::make_ascii_uppercase`]
7555 * [`AsciiExt::make_ascii_lowercase`]
7556 * [`char::decode_utf16`]
7557 * [`char::DecodeUtf16`]
7558 * [`char::DecodeUtf16Error`]
7559 * [`char::DecodeUtf16Error::unpaired_surrogate`]
7560 * [`BTreeSet::take`]
7561 * [`BTreeSet::replace`]
7562 * [`BTreeSet::get`]
7563 * [`HashSet::take`]
7564 * [`HashSet::replace`]
7565 * [`HashSet::get`]
7566 * [`OsString::with_capacity`]
7567 * [`OsString::clear`]
7568 * [`OsString::capacity`]
7569 * [`OsString::reserve`]
7570 * [`OsString::reserve_exact`]
7571 * [`OsStr::is_empty`]
7572 * [`OsStr::len`]
7573 * [`std::os::unix::thread`]
7574 * [`RawPthread`]
7575 * [`JoinHandleExt`]
7576 * [`JoinHandleExt::as_pthread_t`]
7577 * [`JoinHandleExt::into_pthread_t`]
7578 * [`HashSet::hasher`]
7579 * [`HashMap::hasher`]
7580 * [`CommandExt::exec`]
7581 * [`File::try_clone`]
7582 * [`SocketAddr::set_ip`]
7583 * [`SocketAddr::set_port`]
7584 * [`SocketAddrV4::set_ip`]
7585 * [`SocketAddrV4::set_port`]
7586 * [`SocketAddrV6::set_ip`]
7587 * [`SocketAddrV6::set_port`]
7588 * [`SocketAddrV6::set_flowinfo`]
7589 * [`SocketAddrV6::set_scope_id`]
7590 * [`slice::copy_from_slice`]
7591 * [`ptr::read_volatile`]
7592 * [`ptr::write_volatile`]
7593 * [`OpenOptions::create_new`]
7594 * [`TcpStream::set_nodelay`]
7595 * [`TcpStream::nodelay`]
7596 * [`TcpStream::set_ttl`]
7597 * [`TcpStream::ttl`]
7598 * [`TcpStream::set_only_v6`]
7599 * [`TcpStream::only_v6`]
7600 * [`TcpStream::take_error`]
7601 * [`TcpStream::set_nonblocking`]
7602 * [`TcpListener::set_ttl`]
7603 * [`TcpListener::ttl`]
7604 * [`TcpListener::set_only_v6`]
7605 * [`TcpListener::only_v6`]
7606 * [`TcpListener::take_error`]
7607 * [`TcpListener::set_nonblocking`]
7608 * [`UdpSocket::set_broadcast`]
7609 * [`UdpSocket::broadcast`]
7610 * [`UdpSocket::set_multicast_loop_v4`]
7611 * [`UdpSocket::multicast_loop_v4`]
7612 * [`UdpSocket::set_multicast_ttl_v4`]
7613 * [`UdpSocket::multicast_ttl_v4`]
7614 * [`UdpSocket::set_multicast_loop_v6`]
7615 * [`UdpSocket::multicast_loop_v6`]
7616 * [`UdpSocket::set_multicast_ttl_v6`]
7617 * [`UdpSocket::multicast_ttl_v6`]
7618 * [`UdpSocket::set_ttl`]
7619 * [`UdpSocket::ttl`]
7620 * [`UdpSocket::set_only_v6`]
7621 * [`UdpSocket::only_v6`]
7622 * [`UdpSocket::join_multicast_v4`]
7623 * [`UdpSocket::join_multicast_v6`]
7624 * [`UdpSocket::leave_multicast_v4`]
7625 * [`UdpSocket::leave_multicast_v6`]
7626 * [`UdpSocket::take_error`]
7627 * [`UdpSocket::connect`]
7628 * [`UdpSocket::send`]
7629 * [`UdpSocket::recv`]
7630 * [`UdpSocket::set_nonblocking`]
7631
7632 Libraries
7633 ---------
7634
7635 * [`std::sync::Once` is poisoned if its initialization function
7636   fails][1.9o].
7637 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
7638 * [Most types implement `fmt::Debug`][1.9db].
7639 * [The default buffer size used by `BufReader` and `BufWriter` was
7640   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
7641   used by other languages.
7642 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
7643   `Duration` additionally implements `*=` and `/=`][1.9ta].
7644 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
7645 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
7646 * [`Chain` implements `BufRead`][1.9ch].
7647 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
7648
7649 Cargo
7650 -----
7651
7652 * [Cargo can now run concurrently][1.9cc].
7653 * [Top-level overrides allow specific revisions of crates to be
7654   overridden through the entire crate graph][1.9ct].  This is intended
7655   to make upgrades easier for large projects, by allowing crates to be
7656   forked temporarily until they've been upgraded and republished.
7657 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
7658 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
7659   on the commandline][1.9cf]. `rustc` arguments can also be specified
7660   in the `build.rustflags` configuration key.
7661
7662 Performance
7663 -----------
7664
7665 * [The time complexity of comparing variables for equivalence during type
7666   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
7667   to major compilation time improvement in some scenarios.
7668 * [`ToString` is specialized for `str`, giving it the same performance
7669   as `to_owned`][1.9ts].
7670 * [Spawning processes with `Command::output` no longer creates extra
7671   threads][1.9sp].
7672 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
7673   for C-like enums][1.9cl].
7674
7675 Misc
7676 ----
7677
7678 * [Passing the `--quiet` flag to a test runner will produce
7679   much-abbreviated output][1.9q].
7680 * The Rust Project now publishes std binaries for the
7681   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
7682   `i586-pc-windows-msvc` targets.
7683
7684 Compatibility Notes
7685 -------------------
7686
7687 * [`std::sync::Once` is poisoned if its initialization function
7688   fails][1.9o].
7689 * [It is illegal to define methods with the same name in overlapping
7690   inherent `impl` blocks][1.9sn].
7691 * [`fn` item types are zero sized, and each `fn` names a unique
7692   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7693   `transmute` on a `fn` type will generate a warning for a few cycles,
7694   then will be converted to an error.
7695 * [Improvements to const evaluation may trigger new errors when integer
7696   literals are out of range][1.9ce].
7697
7698
7699 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
7700 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
7701 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
7702 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
7703 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
7704 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
7705 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
7706 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
7707 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
7708 [1.9db]: https://github.com/rust-lang/rust/pull/32054
7709 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
7710 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
7711 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
7712 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
7713 [1.9o]: https://github.com/rust-lang/rust/pull/32325
7714 [1.9q]: https://github.com/rust-lang/rust/pull/31887
7715 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
7716 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
7717 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
7718 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
7719 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
7720 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
7721 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
7722 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
7723 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7724 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
7725 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7726 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
7727 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
7728 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
7729 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
7730 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
7731 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
7732 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
7733 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
7734 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
7735 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
7736 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
7737 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
7738 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
7739 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
7740 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
7741 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
7742 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
7743 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
7744 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
7745 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
7746 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
7747 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
7748 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
7749 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
7750 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
7751 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
7752 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
7753 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
7754 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
7755 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
7756 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
7757 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
7758 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
7759 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7760 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7761 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7762 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7763 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7764 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7765 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
7766 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7767 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
7768 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7769 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7770 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7771 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7772 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7773 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
7774 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
7775 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
7776 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
7777 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
7778 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
7779 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
7780 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
7781 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
7782 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
7783 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
7784 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
7785 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
7786 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
7787 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
7788 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
7789 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
7790 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
7791 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
7792 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
7793 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
7794 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
7795 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
7796 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
7797 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
7798 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
7799 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
7800 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
7801 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
7802 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
7803 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
7804 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
7805 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
7806 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
7807 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
7808 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
7809
7810
7811 Version 1.8.0 (2016-04-14)
7812 ==========================
7813
7814 Language
7815 --------
7816
7817 * Rust supports overloading of compound assignment statements like
7818   `+=` by implementing the [`AddAssign`], [`SubAssign`],
7819   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
7820   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
7821   traits. [RFC 953].
7822 * Empty structs can be defined with braces, as in `struct Foo { }`, in
7823   addition to the non-braced form, `struct Foo;`. [RFC 218].
7824
7825 Libraries
7826 ---------
7827
7828 * Stabilized APIs:
7829   * [`str::encode_utf16`] (renamed from `utf16_units`)
7830   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
7831   * [`Ref::map`]
7832   * [`RefMut::map`]
7833   * [`ptr::drop_in_place`]
7834   * [`time::Instant`]
7835   * [`time::SystemTime`]
7836   * [`Instant::now`]
7837   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
7838   * [`Instant::elapsed`]
7839   * [`SystemTime::now`]
7840   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
7841   * [`SystemTime::elapsed`]
7842   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
7843   * [`SystemTimeError`]
7844   * [`SystemTimeError::duration`]
7845   * Various impls for `SystemTimeError`
7846   * [`UNIX_EPOCH`]
7847   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
7848     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
7849     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
7850 * [The `write!` and `writeln!` macros correctly emit errors if any of
7851   their arguments can't be formatted][1.8w].
7852 * [Various I/O functions support large files on 32-bit Linux][1.8l].
7853 * [The Unix-specific `raw` modules, which contain a number of
7854   redefined C types are deprecated][1.8r], including `os::raw::unix`,
7855   `os::raw::macos`, and `os::raw::linux`. These modules defined types
7856   such as `ino_t` and `dev_t`. The inconsistency of these definitions
7857   across platforms was making it difficult to implement `std`
7858   correctly. Those that need these definitions should use the `libc`
7859   crate. [RFC 1415].
7860 * The Unix-specific `MetadataExt` traits, including
7861   `os::unix::fs::MetadataExt`, which expose values such as inode
7862   numbers [no longer return platform-specific types][1.8r], but
7863   instead return widened integers. [RFC 1415].
7864 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
7865 * [Atomic loads and stores are not volatile][1.8a].
7866 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
7867
7868 Performance
7869 -----------
7870
7871 * [Inlining hash functions lead to a 3% compile-time improvement in
7872   some workloads][1.8h].
7873 * When using jemalloc, its symbols are [unprefixed so that it
7874   overrides the libc malloc implementation][1.8h]. This means that for
7875   rustc, LLVM is now using jemalloc, which results in a 6%
7876   compile-time improvement on a specific workload.
7877 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
7878
7879 Misc
7880 ----
7881
7882 * [32-bit MSVC builds finally implement unwinding][1.8ms].
7883   i686-pc-windows-msvc is now considered a tier-1 platform.
7884 * [The `--print targets` flag prints a list of supported targets][1.8t].
7885 * [The `--print cfg` flag prints the `cfg`s defined for the current
7886   target][1.8cf].
7887 * [`rustc` can be built with an new Cargo-based build system, written
7888   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
7889   build system. To enable it configure with `configure --rustbuild`.
7890 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
7891   variants while also indicating the total number of missing variants
7892   if more than 3][1.8m].
7893 * [Executable stacks are disabled on Linux and BSD][1.8nx].
7894 * The Rust Project now publishes binary releases of the standard
7895   library for a number of tier-2 targets:
7896   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
7897   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
7898   `x86_64-rumprun-netbsd`. These can be installed with
7899   tools such as [multirust][1.8mr].
7900
7901 Cargo
7902 -----
7903
7904 * [`cargo init` creates a new Cargo project in the current
7905   directory][1.8ci].  It is otherwise like `cargo new`.
7906 * [Cargo has configuration keys for `-v` and
7907   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
7908   `[term]` section of `.cargo/config`.
7909 * [Configuration keys that evaluate to strings or integers can be set
7910   via environment variables][1.8ce]. For example the `build.jobs` key
7911   can be set via `CARGO_BUILD_JOBS`. Environment variables take
7912   precedence over config files.
7913 * [Target-specific dependencies support Rust `cfg` syntax for
7914   describing targets][1.8cfg] so that dependencies for multiple
7915   targets can be specified together. [RFC 1361].
7916 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
7917   `RUSTDOC` take precedence over the `build.target-dir`,
7918   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
7919 * [The child process tree is killed on Windows when Cargo is
7920   killed][1.8ck].
7921 * [The `build.target` configuration value sets the target platform,
7922   like `--target`][1.8ct].
7923
7924 Compatibility Notes
7925 -------------------
7926
7927 * [Unstable compiler flags have been further restricted][1.8u]. Since
7928   1.0 `-Z` flags have been considered unstable, and other flags that
7929   were considered unstable additionally required passing `-Z
7930   unstable-options` to access. Unlike unstable language and library
7931   features though, these options have been accessible on the stable
7932   release channel. Going forward, *new unstable flags will not be
7933   available on the stable release channel*, and old unstable flags
7934   will warn about their usage. In the future, all unstable flags will
7935   be unavailable on the stable release channel.
7936 * [It is no longer possible to `match` on empty enum variants using
7937   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
7938 * The Unix-specific `MetadataExt` traits, including
7939   `os::unix::fs::MetadataExt`, which expose values such as inode
7940   numbers [no longer return platform-specific types][1.8r], but
7941   instead return widened integers. [RFC 1415].
7942 * [Modules sourced from the filesystem cannot appear within arbitrary
7943   blocks, but only within other modules][1.8mf].
7944 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
7945 * On Unix, [stack overflow triggers a runtime abort instead of a
7946   SIGSEGV][1.8so].
7947 * [`Command::spawn` and its equivalents return an error if any of
7948   its command-line arguments contain interior `NUL`s][1.8n].
7949 * [Tuple and unit enum variants from other crates are in the type
7950   namespace][1.8tn].
7951 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
7952   type instead of `.a` files][1.8st]. Additionally, for the MSVC
7953   toolchain, `rustc` emits import libraries named `foo.dll.lib`
7954   instead of `foo.lib`.
7955
7956
7957 [1.8a]: https://github.com/rust-lang/rust/pull/30962
7958 [1.8b]: https://github.com/rust-lang/rust/pull/31123
7959 [1.8c]: https://github.com/rust-lang/rust/pull/31530
7960 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
7961 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
7962 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
7963 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
7964 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
7965 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
7966 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
7967 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
7968 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
7969 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
7970 [1.8h]: https://github.com/rust-lang/rust/pull/31460
7971 [1.8l]: https://github.com/rust-lang/rust/pull/31668
7972 [1.8m]: https://github.com/rust-lang/rust/pull/31020
7973 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
7974 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
7975 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
7976 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
7977 [1.8n]: https://github.com/rust-lang/rust/pull/31056
7978 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
7979 [1.8r]: https://github.com/rust-lang/rust/pull/31551
7980 [1.8so]: https://github.com/rust-lang/rust/pull/31333
7981 [1.8st]: https://github.com/rust-lang/rust/pull/29520
7982 [1.8t]: https://github.com/rust-lang/rust/pull/31358
7983 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
7984 [1.8u]: https://github.com/rust-lang/rust/pull/31793
7985 [1.8v]: https://github.com/rust-lang/rust/pull/31757
7986 [1.8w]: https://github.com/rust-lang/rust/pull/31904
7987 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
7988 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
7989 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
7990 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
7991 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
7992 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
7993 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
7994 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
7995 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
7996 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
7997 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
7998 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
7999 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
8000 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
8001 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
8002 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
8003 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
8004 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
8005 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
8006 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
8007 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
8008 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
8009 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
8010 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
8011 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
8012 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
8013 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
8014 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
8015 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
8016 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
8017
8018
8019 Version 1.7.0 (2016-03-03)
8020 ==========================
8021
8022 Libraries
8023 ---------
8024
8025 * Stabilized APIs
8026   * `Path`
8027     * [`Path::strip_prefix`] (renamed from relative_from)
8028     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
8029   * `Ipv4Addr`
8030     * [`Ipv4Addr::is_loopback`]
8031     * [`Ipv4Addr::is_private`]
8032     * [`Ipv4Addr::is_link_local`]
8033     * [`Ipv4Addr::is_multicast`]
8034     * [`Ipv4Addr::is_broadcast`]
8035     * [`Ipv4Addr::is_documentation`]
8036   * `Ipv6Addr`
8037     * [`Ipv6Addr::is_unspecified`]
8038     * [`Ipv6Addr::is_loopback`]
8039     * [`Ipv6Addr::is_multicast`]
8040   * `Vec`
8041     * [`Vec::as_slice`]
8042     * [`Vec::as_mut_slice`]
8043   * `String`
8044     * [`String::as_str`]
8045     * [`String::as_mut_str`]
8046   * Slices
8047     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
8048     be the same length
8049     * `<[T]>::`[`sort_by_key`]
8050   * checked, saturated, and overflowing operations
8051     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
8052     * [`i32::saturating_mul`]
8053     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
8054     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
8055     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
8056     * [`u32::saturating_mul`]
8057     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
8058     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
8059     * and checked, saturated, and overflowing operations for other primitive types
8060   * FFI
8061     * [`ffi::IntoStringError`]
8062     * [`CString::into_string`]
8063     * [`CString::into_bytes`]
8064     * [`CString::into_bytes_with_nul`]
8065     * `From<CString> for Vec<u8>`
8066   * `IntoStringError`
8067     * [`IntoStringError::into_cstring`]
8068     * [`IntoStringError::utf8_error`]
8069     * `Error for IntoStringError`
8070   * Hashing
8071     * [`std::hash::BuildHasher`]
8072     * [`BuildHasher::Hasher`]
8073     * [`BuildHasher::build_hasher`]
8074     * [`std::hash::BuildHasherDefault`]
8075     * [`HashMap::with_hasher`]
8076     * [`HashMap::with_capacity_and_hasher`]
8077     * [`HashSet::with_hasher`]
8078     * [`HashSet::with_capacity_and_hasher`]
8079     * [`std::collections::hash_map::RandomState`]
8080     * [`RandomState::new`]
8081 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
8082   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
8083   from bytes is faster.
8084 * [The performance of `LineWriter` (and thus `io::stdout`) was
8085   improved by using `memchr` to search for newlines][1.7m].
8086 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
8087   `f64` variants were stabilized previously.
8088 * [`BTreeMap` was rewritten to use less memory and improve the performance
8089   of insertion and iteration, the latter by as much as 5x][1.7bm].
8090 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
8091   covariant over their contained type][1.7bt].
8092 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
8093   over their contained type][1.7ll].
8094 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
8095   searching methods.
8096 * [`Any` is implemented for unsized types][1.7a].
8097 * [`Hash` is implemented for `Duration`][1.7h].
8098
8099 Misc
8100 ----
8101
8102 * [When running tests with `--test`, rustdoc will pass `--cfg`
8103   arguments to the compiler][1.7dt].
8104 * [The compiler is built with RPATH information by default][1.7rpa].
8105   This means that it will be possible to run `rustc` when installed in
8106   unusual configurations without configuring the dynamic linker search
8107   path explicitly.
8108 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
8109   any RPATH entries (emitted with `-C rpath`) *not* take precedence
8110   over `LD_LIBRARY_PATH`.
8111
8112 Cargo
8113 -----
8114
8115 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
8116   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
8117 * [The `rerun-if-changed` build script directive no longer causes the
8118   build script to incorrectly run twice in certain scenarios][1.7rr].
8119
8120 Compatibility Notes
8121 -------------------
8122
8123 * Soundness fixes to the interactions between associated types and
8124   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
8125   code that violates the new rules. This is a significant change that
8126   is known to break existing code, so it has emitted warnings for the
8127   new error cases since 1.4 to give crate authors time to adapt. The
8128   details of what is changing are subtle; read the RFC for more.
8129 * [Several bugs in the compiler's visibility calculations were
8130   fixed][1.7v]. Since this was found to break significant amounts of
8131   code, the new errors will be emitted as warnings for several release
8132   cycles, under the `private_in_public` lint.
8133 * Defaulted type parameters were accidentally accepted in positions
8134   that were not intended. In this release, [defaulted type parameters
8135   appearing outside of type definitions will generate a
8136   warning][1.7d], which will become an error in future releases.
8137 * [Parsing "." as a float results in an error instead of 0][1.7p].
8138   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
8139 * [Borrows of closure parameters may not outlive the closure][1.7bc].
8140
8141 [1.7a]: https://github.com/rust-lang/rust/pull/30928
8142 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
8143 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
8144 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
8145 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
8146 [1.7d]: https://github.com/rust-lang/rust/pull/30724
8147 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
8148 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
8149 [1.7f]: https://github.com/rust-lang/rust/pull/30672
8150 [1.7h]: https://github.com/rust-lang/rust/pull/30818
8151 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
8152 [1.7m]: https://github.com/rust-lang/rust/pull/30381
8153 [1.7p]: https://github.com/rust-lang/rust/pull/30681
8154 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
8155 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
8156 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
8157 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
8158 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
8159 [1.7v]: https://github.com/rust-lang/rust/pull/29973
8160 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8161 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8162 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
8163 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
8164 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
8165 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
8166 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
8167 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
8168 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
8169 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
8170 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
8171 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
8172 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
8173 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
8174 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
8175 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
8176 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
8177 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
8178 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
8179 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
8180 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
8181 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
8182 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
8183 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
8184 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
8185 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
8186 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
8187 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
8188 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
8189 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
8190 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
8191 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
8192 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
8193 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
8194 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
8195 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
8196 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
8197 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
8198 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
8199 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
8200 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
8201 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
8202 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
8203 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
8204 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
8205 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
8206 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
8207 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8208 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
8209 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8210 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
8211 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
8212 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
8213 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
8214 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
8215 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
8216 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
8217 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
8218 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
8219 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
8220
8221
8222 Version 1.6.0 (2016-01-21)
8223 ==========================
8224
8225 Language
8226 --------
8227
8228 * The `#![no_std]` attribute causes a crate to not be linked to the
8229   standard library, but only the [core library][1.6co], as described
8230   in [RFC 1184]. The core library defines common types and traits but
8231   has no platform dependencies whatsoever, and is the basis for Rust
8232   software in environments that cannot support a full port of the
8233   standard library, such as operating systems. Most of the core
8234   library is now stable.
8235
8236 Libraries
8237 ---------
8238
8239 * Stabilized APIs:
8240   [`Read::read_exact`],
8241   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
8242   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
8243   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
8244   [`os::unix::fs::DirBuilderExt`],
8245   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
8246   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
8247   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
8248   [`collections::hash_map::Drain`],
8249   [`collections::hash_map::HashMap::drain`],
8250   [`collections::hash_set::Drain`],
8251   [`collections::hash_set::HashSet::drain`],
8252   [`collections::binary_heap::Drain`],
8253   [`collections::binary_heap::BinaryHeap::drain`],
8254   [`Vec::extend_from_slice`] (renamed from `push_all`),
8255   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
8256   [`RwLock::into_inner`],
8257   [`Iterator::min_by_key`] (renamed from `min_by`),
8258   [`Iterator::max_by_key`] (renamed from `max_by`).
8259 * The [core library][1.6co] is stable, as are most of its APIs.
8260 * [The `assert_eq!` macro supports arguments that don't implement
8261   `Sized`][1.6ae], such as arrays. In this way it behaves more like
8262   `assert!`.
8263 * Several timer functions that take duration in milliseconds [are
8264   deprecated in favor of those that take `Duration`][1.6ms]. These
8265   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
8266   `thread::park_timeout_ms`.
8267 * The algorithm by which `Vec` reserves additional elements was
8268   [tweaked to not allocate excessive space][1.6a] while still growing
8269   exponentially.
8270 * `From` conversions are [implemented from integers to floats][1.6f]
8271   in cases where the conversion is lossless. Thus they are not
8272   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
8273   or `f64`. They are also not implemented for `isize` and `usize`
8274   because the implementations would be platform-specific. `From` is
8275   also implemented from `f32` to `f64`.
8276 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
8277 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
8278 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
8279 * [`BinaryHeap` was refactored][1.6bh] for modest performance
8280   improvements.
8281 * Sorting slices that are already sorted [is 50% faster in some
8282   cases][1.6s].
8283
8284 Cargo
8285 -----
8286
8287 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
8288 * Cargo build scripts can specify their dependencies by emitting the
8289   [`rerun-if-changed`][1.6rr] key.
8290 * crates.io will reject publication of crates with dependencies that
8291   have a wildcard version constraint. Crates with wildcard
8292   dependencies were seen to cause a variety of problems, as described
8293   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
8294   warning.
8295 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
8296   release folder.  A variety of artifacts that Cargo failed to clean
8297   are now correctly deleted.
8298
8299 Misc
8300 ----
8301
8302 * The `unreachable_code` lint [warns when a function call's argument
8303   diverges][1.6dv].
8304 * The parser indicates [failures that may be caused by
8305   confusingly-similar Unicode characters][1.6uc]
8306 * Certain macro errors [are reported at definition time][1.6m], not
8307   expansion.
8308
8309 Compatibility Notes
8310 -------------------
8311
8312 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
8313   environment variable when locating crates. This was a pre-cargo
8314   feature for integrating with the package manager that was
8315   accidentally never removed.
8316 * [A number of bugs were fixed in the privacy checker][1.6p] that
8317   could cause previously-accepted code to break.
8318 * [Modules and unit/tuple structs may not share the same name][1.6ts].
8319 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
8320   struct pattern syntax (`Foo(..)`) can no longer be used to match
8321   unit structs. This is a warning now, but will become an error in
8322   future releases. Patterns that share the same name as a const are
8323   now an error.
8324 * A bug was fixed that causes [rustc not to apply default type
8325   parameters][1.6xc] when resolving certain method implementations of
8326   traits defined in other crates.
8327
8328 [1.6a]: https://github.com/rust-lang/rust/pull/29454
8329 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
8330 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
8331 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
8332 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
8333 [1.6co]: http://doc.rust-lang.org/core/index.html
8334 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
8335 [1.6f]: https://github.com/rust-lang/rust/pull/29129
8336 [1.6m]: https://github.com/rust-lang/rust/pull/29828
8337 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
8338 [1.6p]: https://github.com/rust-lang/rust/pull/29726
8339 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
8340 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
8341 [1.6s]: https://github.com/rust-lang/rust/pull/29675
8342 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
8343 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
8344 [1.6us]: https://github.com/rust-lang/rust/pull/29383
8345 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
8346 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
8347 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8348 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
8349 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
8350 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
8351 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
8352 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
8353 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
8354 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
8355 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
8356 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
8357 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
8358 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
8359 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
8360 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
8361 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
8362 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
8363 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
8364 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
8365 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
8366 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
8367 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
8368 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
8369 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
8370 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
8371 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
8372 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
8373 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
8374 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
8375
8376
8377 Version 1.5.0 (2015-12-10)
8378 ==========================
8379
8380 * ~700 changes, numerous bugfixes
8381
8382 Highlights
8383 ----------
8384
8385 * Stabilized APIs:
8386   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
8387   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
8388   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
8389   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
8390   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
8391   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
8392   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
8393   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
8394   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
8395   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
8396   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
8397   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
8398   [`Path::read_link`], [`Path::symlink_metadata`],
8399   [`Utf8Error::valid_up_to`], [`Vec::resize`],
8400   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
8401   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
8402   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
8403   [`slice::split_first_mut`], [`slice::split_first`],
8404   [`slice::split_last_mut`], [`slice::split_last`],
8405   [`char::from_u32_unchecked`], [`fs::canonicalize`],
8406   [`str::MatchIndices`], [`str::RMatchIndices`],
8407   [`str::match_indices`], [`str::rmatch_indices`],
8408   [`str::slice_mut_unchecked`], [`string::ParseError`].
8409 * Rust applications hosted on crates.io can be installed locally to
8410   `~/.cargo/bin` with the [`cargo install`] command. Among other
8411   things this makes it easier to augment Cargo with new subcommands:
8412   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
8413   invoked as `cargo foo`.
8414 * Crates with wildcard (`*`) dependencies will [emit warnings when
8415   published][1.5w]. In 1.6 it will no longer be possible to publish
8416   crates with wildcard dependencies.
8417
8418 Breaking Changes
8419 ----------------
8420
8421 * The rules determining when a particular lifetime must outlive
8422   a particular value (known as '[dropck]') have been [modified
8423   to not rely on parametricity][1.5p].
8424 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
8425   and `Arc`][1.5a]. Because these smart pointer types implement
8426   `Deref`, this causes breakage in cases where the interior type
8427   contains methods of the same name.
8428 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
8429   that they could drop their content. Soundness fix.
8430 * All method invocations are [properly checked][1.5wf1] for
8431   [well-formedness][1.5wf2]. Soundness fix.
8432 * Traits whose supertraits contain `Self` are [not object
8433   safe][1.5o]. Soundness fix.
8434 * Target specifications support a [`no_default_libraries`][1.5nd]
8435   setting that controls whether `-nodefaultlibs` is passed to the
8436   linker, and in turn the `is_like_windows` setting no longer affects
8437   the `-nodefaultlibs` flag.
8438 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
8439 * The `#[inline]` and `#[repr]` attributes [can only appear
8440   in valid locations][1.5at].
8441 * Native libraries linked from the local crate are [passed to
8442   the linker before native libraries from upstream crates][1.5nl].
8443 * Two rarely-used attributes, `#[no_debug]` and
8444   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
8445 * Negation of unsigned integers, which has been a warning for
8446   several releases, [is now behind a feature gate and will
8447   generate errors][1.5nu].
8448 * The parser accidentally accepted visibility modifiers on
8449   enum variants, a bug [which has been fixed][1.5ev].
8450 * [A bug was fixed that allowed `use` statements to import unstable
8451   features][1.5use].
8452
8453 Language
8454 --------
8455
8456 * When evaluating expressions at compile-time that are not
8457   compile-time constants (const-evaluating expressions in non-const
8458   contexts), incorrect code such as overlong bitshifts and arithmetic
8459   overflow will [generate a warning instead of an error][1.5ce],
8460   delaying the error until runtime. This will allow the
8461   const-evaluator to be expanded in the future backwards-compatibly.
8462 * The `improper_ctypes` lint [no longer warns about using `isize` and
8463   `usize` in FFI][1.5ict].
8464
8465 Libraries
8466 ---------
8467
8468 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
8469   invariant][1.5c].
8470 * `Default` is [implemented for mutable slices][1.5d].
8471 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
8472 * There are now `From` conversions [between floating point
8473   types][1.5f] where the conversions are lossless.
8474 * There are now `From` conversions [between integer types][1.5i] where
8475   the conversions are lossless.
8476 * [`fs::Metadata` implements `Clone`][1.5fs].
8477 * The `parse` method [accepts a leading "+" when parsing
8478   integers][1.5pi].
8479 * [`AsMut` is implemented for `Vec`][1.5am].
8480 * The `clone_from` implementations for `String` and `BinaryHeap` [have
8481   been optimized][1.5cf] and no longer rely on the default impl.
8482 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
8483   `unsafe extern "C"` function types now [implement `Clone`,
8484   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
8485   `fmt::Debug` for up to 12 arguments][1.5fp].
8486 * [Dropping `Vec`s is much faster in unoptimized builds when the
8487   element types don't implement `Drop`][1.5dv].
8488 * A bug that caused in incorrect behavior when [combining `VecDeque`
8489   with zero-sized types][1.5vdz] was resolved.
8490 * [`PartialOrd` for slices is faster][1.5po].
8491
8492 Miscellaneous
8493 -------------
8494
8495 * [Crate metadata size was reduced by 20%][1.5md].
8496 * [Improvements to code generation reduced the size of libcore by 3.3
8497   MB and rustc's memory usage by 18MB][1.5m].
8498 * [Improvements to deref translation increased performance in
8499   unoptimized builds][1.5dr].
8500 * Various errors in trait resolution [are deduplicated to only be
8501   reported once][1.5te].
8502 * Rust has preliminary [support for rumprun kernels][1.5rr].
8503 * Rust has preliminary [support for NetBSD on amd64][1.5na].
8504
8505 [1.5use]: https://github.com/rust-lang/rust/pull/28364
8506 [1.5po]: https://github.com/rust-lang/rust/pull/28436
8507 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
8508 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
8509 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
8510 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
8511 [1.5md]: https://github.com/rust-lang/rust/pull/28521
8512 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
8513 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
8514 [1.5na]: https://github.com/rust-lang/rust/pull/28543
8515 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
8516 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
8517 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
8518 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
8519 [1.5te]: https://github.com/rust-lang/rust/pull/28645
8520 [1.5at]: https://github.com/rust-lang/rust/pull/28650
8521 [1.5am]: https://github.com/rust-lang/rust/pull/28663
8522 [1.5m]: https://github.com/rust-lang/rust/pull/28778
8523 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
8524 [1.5a]: https://github.com/rust-lang/rust/pull/28811
8525 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
8526 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
8527 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
8528 [1.5i]: https://github.com/rust-lang/rust/pull/28921
8529 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
8530 [1.5f]: https://github.com/rust-lang/rust/pull/29129
8531 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
8532 [1.5s]: https://github.com/rust-lang/rust/pull/29190
8533 [1.5d]: https://github.com/rust-lang/rust/pull/29245
8534 [1.5o]: https://github.com/rust-lang/rust/pull/29259
8535 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
8536 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8537 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
8538 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
8539 [1.5c]: https://github.com/rust-lang/rust/pull/29110
8540 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8541 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
8542 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
8543 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
8544 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
8545 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
8546 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
8547 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
8548 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
8549 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
8550 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
8551 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
8552 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
8553 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
8554 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
8555 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
8556 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
8557 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
8558 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
8559 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
8560 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
8561 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
8562 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
8563 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
8564 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
8565 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
8566 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
8567 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
8568 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
8569 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
8570 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
8571 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
8572 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
8573 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
8574 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
8575 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
8576 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
8577 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
8578 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
8579 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
8580 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
8581 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
8582 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
8583 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
8584 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
8585 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
8586 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
8587 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
8588 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
8589 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
8590 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
8591 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
8592 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
8593 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
8594
8595 Version 1.4.0 (2015-10-29)
8596 ==========================
8597
8598 * ~1200 changes, numerous bugfixes
8599
8600 Highlights
8601 ----------
8602
8603 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
8604   GNU) are now supported and recommended for use.
8605
8606 Breaking Changes
8607 ----------------
8608
8609 * [Several changes have been made to fix type soundness and improve
8610   the behavior of associated types][sound]. See [RFC 1214]. Although
8611   we have mostly introduced these changes as warnings this release, to
8612   become errors next release, there are still some scenarios that will
8613   see immediate breakage.
8614 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
8615   line breaks in addition to `\n`][crlf].
8616 * [Loans of `'static` lifetime extend to the end of a function][stat].
8617 * [`str::parse` no longer introduces avoidable rounding error when
8618   parsing floating point numbers. Together with earlier changes to
8619   float formatting/output, "round trips" like f.to_string().parse()
8620   now preserve the value of f exactly. Additionally, leading plus
8621   signs are now accepted][fp3].
8622
8623
8624 Language
8625 --------
8626
8627 * `use` statements that import multiple items [can now rename
8628   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
8629 * [Binops work correctly on fat pointers][binfat].
8630 * `pub extern crate`, which does not behave as expected, [issues a
8631   warning][pec] until a better solution is found.
8632
8633 Libraries
8634 ---------
8635
8636 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
8637   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
8638   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
8639   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
8640   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
8641   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
8642   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
8643   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
8644   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
8645   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
8646   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
8647   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
8648   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
8649   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
8650   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
8651   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
8652   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
8653   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
8654   [`thread::sleep`].
8655 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
8656   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
8657   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
8658   `f64::from_str_radix`.
8659 * [Reverse-searching strings is faster with the 'two-way'
8660   algorithm][s].
8661 * [`std::io::copy` allows `?Sized` arguments][cc].
8662 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
8663   [override `count`, `nth` and `last` with an *O*(1)
8664   implementation][it].
8665 * [`Default` is implemented for arrays up to `[T; 32]`][d].
8666 * [`IntoRawFd` has been added to the Unix-specific prelude,
8667   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
8668   prelude][pr].
8669 * [`Extend<String>` and `FromIterator<String` are both implemented for
8670   `String`][es].
8671 * [`IntoIterator` is implemented for references to `Option` and
8672   `Result`][into2].
8673 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
8674   Copy`][ext] as part of [RFC 839]. This will cause type inference
8675   breakage in rare situations.
8676 * [`BinaryHeap` implements `Debug`][bh2].
8677 * [`Borrow` and `BorrowMut` are implemented for fixed-size
8678   arrays][bm].
8679 * [`extern fn`s with the "Rust" and "C" ABIs implement common
8680   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
8681 * [String comparison is faster][faststr].
8682 * `&mut T` where `T: std::fmt::Write` [also implements
8683   `std::fmt::Write`][mutw].
8684 * [A stable regression in `VecDeque::push_back` and other
8685   capacity-altering methods that caused panics for zero-sized types
8686   was fixed][vd].
8687 * [Function pointers implement traits for up to 12 parameters][fp2].
8688
8689 Miscellaneous
8690 -------------
8691
8692 * The compiler [no longer uses the 'morestack' feature to prevent
8693   stack overflow][mm]. Instead it uses guard pages and stack
8694   probes (though stack probes are not yet implemented on any platform
8695   but Windows).
8696 * [The compiler matches traits faster when projections are involved][p].
8697 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
8698   `usize`][ffi].
8699 * [Cargo now displays useful information about what its doing during
8700   `cargo update`][cu].
8701
8702 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
8703 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
8704 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
8705 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
8706 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
8707 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
8708 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
8709 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
8710 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
8711 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
8712 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
8713 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
8714 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
8715 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
8716 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
8717 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
8718 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
8719 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
8720 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8721 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8722 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8723 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8724 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8725 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8726 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8727 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8728 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
8729 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
8730 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
8731 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
8732 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
8733 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
8734 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
8735 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
8736 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
8737 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
8738 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
8739 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
8740 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
8741 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
8742 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
8743 [bh2]: https://github.com/rust-lang/rust/pull/28156
8744 [binfat]: https://github.com/rust-lang/rust/pull/28270
8745 [bm]: https://github.com/rust-lang/rust/pull/28197
8746 [cc]: https://github.com/rust-lang/rust/pull/27531
8747 [crlf]: https://github.com/rust-lang/rust/pull/28034
8748 [cu]: https://github.com/rust-lang/cargo/pull/1931
8749 [d]: https://github.com/rust-lang/rust/pull/27825
8750 [dep]: https://github.com/rust-lang/rust/pull/28339
8751 [es]: https://github.com/rust-lang/rust/pull/27956
8752 [ext]: https://github.com/rust-lang/rust/pull/28094
8753 [faststr]: https://github.com/rust-lang/rust/pull/28338
8754 [ffi]: https://github.com/rust-lang/rust/pull/28779
8755 [fp]: https://github.com/rust-lang/rust/pull/28268
8756 [fp2]: https://github.com/rust-lang/rust/pull/28560
8757 [fp3]: https://github.com/rust-lang/rust/pull/27307
8758 [i]: https://github.com/rust-lang/rust/pull/27451
8759 [into2]: https://github.com/rust-lang/rust/pull/28039
8760 [it]: https://github.com/rust-lang/rust/pull/27652
8761 [mm]: https://github.com/rust-lang/rust/pull/27338
8762 [mutw]: https://github.com/rust-lang/rust/pull/28368
8763 [sound]: https://github.com/rust-lang/rust/pull/27641
8764 [p]: https://github.com/rust-lang/rust/pull/27866
8765 [pec]: https://github.com/rust-lang/rust/pull/28486
8766 [pr]: https://github.com/rust-lang/rust/pull/27896
8767 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8768 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8769 [s]: https://github.com/rust-lang/rust/pull/27474
8770 [stab]: https://github.com/rust-lang/rust/pull/28339
8771 [stat]: https://github.com/rust-lang/rust/pull/28321
8772 [vd]: https://github.com/rust-lang/rust/pull/28494
8773
8774 Version 1.3.0 (2015-09-17)
8775 ==============================
8776
8777 * ~900 changes, numerous bugfixes
8778
8779 Highlights
8780 ----------
8781
8782 * The [new object lifetime defaults][nold] have been [turned
8783   on][nold2] after a cycle of warnings about the change. Now types
8784   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
8785   being interpreted as `&'a Box<Trait+'a>` to `&'a
8786   Box<Trait+'static>`.
8787 * [The Rustonomicon][nom] is a new book in the official documentation
8788   that dives into writing unsafe Rust.
8789 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
8790   timekeeping is employed by other std APIs, as well as out-of-tree
8791   time crates.
8792
8793 Breaking Changes
8794 ----------------
8795
8796 * The [new object lifetime defaults][nold] have been [turned
8797   on][nold2] after a cycle of warnings about the change.
8798 * There is a known [regression][lr] in how object lifetime elision is
8799   interpreted, the proper solution for which is undetermined.
8800 * The `#[prelude_import]` attribute, an internal implementation
8801   detail, was accidentally stabilized previously. [It has been put
8802   behind the `prelude_import` feature gate][pi]. This change is
8803   believed to break no existing code.
8804 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8805   [more sane for dynamically sized types][dst3]. Code that relied on
8806   the previous behavior is thought to be broken.
8807 * The `dropck` rules, which checks that destructors can't access
8808   destroyed values, [have been updated][dropck] to match the
8809   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
8810   cause some previously-compiling code to no longer build.
8811
8812 Language
8813 --------
8814
8815 * The [new object lifetime defaults][nold] have been [turned
8816   on][nold2] after a cycle of warnings about the change.
8817 * Semicolons may [now follow types and paths in
8818   macros](https://github.com/rust-lang/rust/pull/27000).
8819 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8820   [more sane for dynamically sized types][dst3]. Code that relied on
8821   the previous behavior is not known to exist, and suspected to be
8822   broken.
8823 * `'static` variables [may now be recursive][st].
8824 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
8825   implementations correctly.
8826 * The `dropck` rules, which checks that destructors can't access
8827   destroyed values, [have been updated][dropck] to match the
8828   [RFC][dropckrfc].
8829
8830 Libraries
8831 ---------
8832
8833 * The [`Duration`] API, [has been stabilized][ds], as well as the
8834   `std::time` module, which presently contains only `Duration`.
8835 * `Box<str>` and `Box<[T]>` both implement `Clone`.
8836 * The owned C string, [`CString`], implements [`Borrow`] and the
8837   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
8838   these allow C strings to be borrowed and cloned in generic code.
8839 * [`CStr`] implements [`Debug`].
8840 * [`AtomicPtr`] implements [`Debug`].
8841 * [`Error`] trait objects [can be downcast to their concrete types][e]
8842   in many common configurations, using the [`is`], [`downcast`],
8843   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
8844   [`Any`] trait.
8845 * Searching for substrings now [employs the two-way algorithm][search]
8846   instead of doing a naive search. This gives major speedups to a
8847   number of methods, including [`contains`][sc], [`find`][sf],
8848   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
8849   [`ends_with`][sew] are also faster.
8850 * The performance of `PartialEq` for slices is [much faster][ps].
8851 * The [`Hash`] trait offers the default method, [`hash_slice`], which
8852   is overridden and optimized by the implementations for scalars.
8853 * The [`Hasher`] trait now has a number of specialized `write_*`
8854   methods for primitive types, for efficiency.
8855 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
8856   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
8857   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
8858   of [`std::error::Error::cause`][iec] also delegates to the inner
8859   error.
8860 * [`process::Child`][pc] gained the [`id`] method, which returns a
8861   `u32` representing the platform-specific process identifier.
8862 * The [`connect`] method on slices is deprecated, replaced by the new
8863   [`join`] method (note that both of these are on the *unstable*
8864   [`SliceConcatExt`] trait, but through the magic of the prelude are
8865   available to stable code anyway).
8866 * The [`Div`] operator is implemented for [`Wrapping`] types.
8867 * [`DerefMut` is implemented for `String`][dms].
8868 * Performance of SipHash (the default hasher for `HashMap`) is
8869   [better for long data][sh].
8870 * [`AtomicPtr`] implements [`Send`].
8871 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
8872   are now [specialized to use uninitialized buffers for increased
8873   performance][rte].
8874 * Lifetime parameters of foreign functions [are now resolved
8875   properly][f].
8876
8877 Misc
8878 ----
8879
8880 * Rust can now, with some coercion, [produce programs that run on
8881   Windows XP][xp], though XP is not considered a supported platform.
8882 * Porting Rust on Windows from the GNU toolchain to MSVC continues
8883   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
8884   recommended for use in 1.3, though should be fully-functional
8885   in the [64-bit 1.4 beta][b14].
8886 * On Fedora-based systems installation will [properly configure the
8887   dynamic linker][fl].
8888 * The compiler gained many new extended error descriptions, which can
8889   be accessed with the `--explain` flag.
8890 * The `dropck` pass, which checks that destructors can't access
8891   destroyed values, [has been rewritten][dropck]. This fixes some
8892   soundness holes, and as such will cause some previously-compiling
8893   code to no longer build.
8894 * `rustc` now uses [LLVM to write archive files where possible][ar].
8895   Eventually this will eliminate the compiler's dependency on the ar
8896   utility.
8897 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
8898   supported FreeBSD on x86_64).
8899 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
8900   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
8901   more strict.
8902 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
8903   will kill the process instead of leaking][nlp].
8904
8905 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
8906 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
8907 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
8908 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
8909 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
8910 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8911 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8912 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
8913 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
8914 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
8915 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
8916 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
8917 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
8918 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8919 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
8920 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
8921 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
8922 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
8923 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8924 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
8925 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
8926 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
8927 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
8928 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8929 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
8930 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
8931 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
8932 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
8933 [ar]: https://github.com/rust-lang/rust/pull/26926
8934 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
8935 [dms]: https://github.com/rust-lang/rust/pull/26241
8936 [dropck]: https://github.com/rust-lang/rust/pull/27261
8937 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8938 [ds]: https://github.com/rust-lang/rust/pull/26818
8939 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
8940 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
8941 [dst3]: https://github.com/rust-lang/rust/pull/27351
8942 [e]: https://github.com/rust-lang/rust/pull/24793
8943 [f]: https://github.com/rust-lang/rust/pull/26588
8944 [fb]: https://github.com/rust-lang/rust/pull/26959
8945 [fl]: https://github.com/rust-lang/rust-installer/pull/41
8946 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
8947 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
8948 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
8949 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
8950 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
8951 [lic]: https://github.com/rust-lang/rust/pull/26583
8952 [lnu]: https://github.com/rust-lang/rust/pull/27026
8953 [lr]: https://github.com/rust-lang/rust/issues/27248
8954 [lum]: https://github.com/rust-lang/rust/pull/26378
8955 [lur]: https://github.com/rust-lang/rust/pull/26783
8956 [nlp]: https://github.com/rust-lang/rust/pull/27176
8957 [nold2]: https://github.com/rust-lang/rust/pull/27045
8958 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
8959 [nom]: http://doc.rust-lang.org/nightly/nomicon/
8960 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
8961 [pi]: https://github.com/rust-lang/rust/pull/26699
8962 [ps]: https://github.com/rust-lang/rust/pull/26884
8963 [rte]: https://github.com/rust-lang/rust/pull/26950
8964 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
8965 [search]: https://github.com/rust-lang/rust/pull/26327
8966 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
8967 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
8968 [sh]: https://github.com/rust-lang/rust/pull/27280
8969 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
8970 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
8971 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
8972 [st]: https://github.com/rust-lang/rust/pull/26630
8973 [win1]: https://github.com/rust-lang/rust/pull/26569
8974 [win2]: https://github.com/rust-lang/rust/pull/26741
8975 [win3]: https://github.com/rust-lang/rust/pull/26741
8976 [win4]: https://github.com/rust-lang/rust/pull/27210
8977 [xp]: https://github.com/rust-lang/rust/pull/26569
8978
8979 Version 1.2.0 (2015-08-07)
8980 ==========================
8981
8982 * ~1200 changes, numerous bugfixes
8983
8984 Highlights
8985 ----------
8986
8987 * [Dynamically-sized-type coercions][dst] allow smart pointer types
8988   like `Rc` to contain types without a fixed size, arrays and trait
8989   objects, finally enabling use of `Rc<[T]>` and completing the
8990   implementation of DST.
8991 * [Parallel codegen][parcodegen] is now working again, which can
8992   substantially speed up large builds in debug mode; It also gets
8993   another ~33% speedup when bootstrapping on a 4 core machine (using 8
8994   jobs). It's not enabled by default, but will be "in the near
8995   future". It can be activated with the `-C codegen-units=N` flag to
8996   `rustc`.
8997 * This is the first release with [experimental support for linking
8998   with the MSVC linker and lib C on Windows (instead of using the GNU
8999   variants via MinGW)][win]. It is yet recommended only for the most
9000   intrepid Rustaceans.
9001 * Benchmark compilations are showing a 30% improvement in
9002   bootstrapping over 1.1.
9003
9004 Breaking Changes
9005 ----------------
9006
9007 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
9008   unicode case mapping, which is a previously-planned change in
9009   behavior and considered a bugfix.
9010 * [`mem::align_of`] now specifies [the *minimum alignment* for
9011   T][align], which is usually the alignment programs are interested
9012   in, and the same value reported by clang's
9013   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
9014   break real code.
9015 * [The `#[packed]` attribute is no longer silently accepted by the
9016   compiler][packed]. This attribute did nothing and code that
9017   mentioned it likely did not work as intended.
9018 * Associated type defaults are [now behind the
9019   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
9020   defaults *did not work*, but could be mentioned syntactically. As
9021   such this breakage has minimal impact.
9022
9023 Language
9024 --------
9025
9026 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
9027   matching against dereferenceable values.
9028
9029 Libraries
9030 ---------
9031
9032 * The [`Extend`] trait, which grows a collection from an iterator, is
9033   implemented over iterators of references, for `String`, `Vec`,
9034   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
9035   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
9036 * The [`iter::once`] function returns an iterator that yields a single
9037   element, and [`iter::empty`] returns an iterator that yields no
9038   elements.
9039 * The [`matches`] and [`rmatches`] methods on `str` return iterators
9040   over substring matches.
9041 * [`Cell`] and [`RefCell`] both implement `Eq`.
9042 * A number of methods for wrapping arithmetic are added to the
9043   integral types, [`wrapping_div`], [`wrapping_rem`],
9044   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
9045   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
9046   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
9047   type.. It is illegal for the default arithmetic operations in Rust
9048   to overflow; the desire to wrap must be explicit.
9049 * The `{:#?}` formatting specifier [displays the alternate,
9050   pretty-printed][debugfmt] form of the `Debug` formatter. This
9051   feature was actually introduced prior to 1.0 with little
9052   fanfare.
9053 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
9054   for writing data to formatted strings, similar to [`io::Write`].
9055 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
9056   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
9057   are used by code generators to emit implementations of [`Debug`].
9058 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
9059   methods that convert case, following Unicode case mapping.
9060 * It is now easier to handle poisoned locks. The [`PoisonError`]
9061   type, returned by failing lock operations, exposes `into_inner`,
9062   `get_ref`, and `get_mut`, which all give access to the inner lock
9063   guard, and allow the poisoned lock to continue to operate. The
9064   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
9065   poisoned lock without attempting to take the lock.
9066 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
9067   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
9068   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
9069   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
9070   `ChildStderr`.
9071 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
9072   malformed input.
9073
9074 Misc
9075 ----
9076
9077 * `rustc` employs smarter heuristics for guessing at [typos].
9078 * `rustc` emits more efficient code for [no-op conversions between
9079   unsafe pointers][nop].
9080 * Fat pointers are now [passed in pairs of immediate arguments][fat],
9081   resulting in faster compile times and smaller code.
9082
9083 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
9084 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
9085 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
9086 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
9087 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
9088 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
9089 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
9090 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
9091 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
9092 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
9093 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
9094 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
9095 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
9096 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
9097 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
9098 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
9099 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
9100 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
9101 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
9102 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
9103 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
9104 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
9105 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
9106 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
9107 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
9108 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
9109 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
9110 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
9111 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
9112 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
9113 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
9114 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
9115 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
9116 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9117 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9118 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
9119 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
9120 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
9121 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
9122 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
9123 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
9124 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
9125 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
9126 [align]: https://github.com/rust-lang/rust/pull/25646
9127 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
9128 [typos]: https://github.com/rust-lang/rust/pull/26087
9129 [nop]: https://github.com/rust-lang/rust/pull/26336
9130 [fat]: https://github.com/rust-lang/rust/pull/26411
9131 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
9132 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
9133 [packed]: https://github.com/rust-lang/rust/pull/25541
9134 [ad]: https://github.com/rust-lang/rust/pull/27382
9135 [win]: https://github.com/rust-lang/rust/pull/25350
9136
9137 Version 1.1.0 (2015-06-25)
9138 =========================
9139
9140 * ~850 changes, numerous bugfixes
9141
9142 Highlights
9143 ----------
9144
9145 * The [`std::fs` module has been expanded][fs] to expand the set of
9146   functionality exposed:
9147   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
9148     don't incur a syscall on some platforms.
9149   * A `symlink_metadata` function has been added.
9150   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
9151     access to all underlying information.
9152 * The compiler now contains extended explanations of many errors. When an error
9153   with an explanation occurs the compiler suggests using the `--explain` flag
9154   to read the explanation. Error explanations are also [available online][err-index].
9155 * Thanks to multiple [improvements][sk] to [type checking][pre], as
9156   well as other work, the time to bootstrap the compiler decreased by
9157   32%.
9158
9159 Libraries
9160 ---------
9161
9162 * The [`str::split_whitespace`] method splits a string on unicode
9163   whitespace boundaries.
9164 * On both Windows and Unix, new extension traits provide conversion of
9165   I/O types to and from the underlying system handles. On Unix, these
9166   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
9167   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
9168   `TcpListener`, and `UpdSocket`. Further implementations for
9169   `std::process` will be stabilized later.
9170 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
9171   Windows, symlinks can be created with
9172   `std::os::windows::symlink_dir` and
9173   `std::os::windows::symlink_file`.
9174 * The `mpsc::Receiver` type can now be converted into an iterator with
9175   `into_iter` on the [`IntoIterator`] trait.
9176 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
9177   implementation of the [`From`] trait.
9178 * The `Debug` implementation for `RangeFull` [creates output that is
9179   more consistent with other implementations][rf].
9180 * [`Debug` is implemented for `File`][file].
9181 * The `Default` implementation for `Arc` [no longer requires `Sync +
9182   Send`][arc].
9183 * [The `Iterator` methods `count`, `nth`, and `last` have been
9184   overridden for slices to have *O*(1) performance instead of *O*(*n*)][si].
9185 * Incorrect handling of paths on Windows has been improved in both the
9186   compiler and the standard library.
9187 * [`AtomicPtr` gained a `Default` implementation][ap].
9188 * In accordance with Rust's policy on arithmetic overflow `abs` now
9189   [panics on overflow when debug assertions are enabled][abs].
9190 * The [`Cloned`] iterator, which was accidentally left unstable for
9191   1.0 [has been stabilized][c].
9192 * The [`Incoming`] iterator, which iterates over incoming TCP
9193   connections, and which was accidentally unnamable in 1.0, [is now
9194   properly exported][inc].
9195 * [`BinaryHeap`] no longer corrupts itself [when functions called by
9196   `sift_up` or `sift_down` panic][bh].
9197 * The [`split_off`] method of `LinkedList` [no longer corrupts
9198   the list in certain scenarios][ll].
9199
9200 Misc
9201 ----
9202
9203 * Type checking performance [has improved notably][sk] with
9204   [multiple improvements][pre].
9205 * The compiler [suggests code changes][ch] for more errors.
9206 * rustc and it's build system have experimental support for [building
9207   toolchains against MUSL][m] instead of glibc on Linux.
9208 * The compiler defines the `target_env` cfg value, which is used for
9209   distinguishing toolchains that are otherwise for the same
9210   platform. Presently this is set to `gnu` for common GNU Linux
9211   targets and for MinGW targets, and `musl` for MUSL Linux targets.
9212 * The [`cargo rustc`][crc] command invokes a build with custom flags
9213   to rustc.
9214 * [Android executables are always position independent][pie].
9215 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
9216   with `Drop`][drop].
9217
9218 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
9219 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9220 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9221 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
9222 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
9223 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
9224 [rf]: https://github.com/rust-lang/rust/pull/24491
9225 [err-index]: https://doc.rust-lang.org/error-index.html
9226 [sk]: https://github.com/rust-lang/rust/pull/24615
9227 [pre]: https://github.com/rust-lang/rust/pull/25323
9228 [file]: https://github.com/rust-lang/rust/pull/24598
9229 [ch]: https://github.com/rust-lang/rust/pull/24683
9230 [arc]: https://github.com/rust-lang/rust/pull/24695
9231 [si]: https://github.com/rust-lang/rust/pull/24701
9232 [ap]: https://github.com/rust-lang/rust/pull/24834
9233 [m]: https://github.com/rust-lang/rust/pull/24777
9234 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
9235 [crc]: https://github.com/rust-lang/cargo/pull/1568
9236 [pie]: https://github.com/rust-lang/rust/pull/24953
9237 [abs]: https://github.com/rust-lang/rust/pull/25441
9238 [c]: https://github.com/rust-lang/rust/pull/25496
9239 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
9240 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
9241 [inc]: https://github.com/rust-lang/rust/pull/25522
9242 [bh]: https://github.com/rust-lang/rust/pull/25856
9243 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
9244 [ll]: https://github.com/rust-lang/rust/pull/26022
9245 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
9246 [drop]: https://github.com/rust-lang/rust/pull/24935
9247
9248 Version 1.0.0 (2015-05-15)
9249 ========================
9250
9251 * ~1500 changes, numerous bugfixes
9252
9253 Highlights
9254 ----------
9255
9256 * The vast majority of the standard library is now `#[stable]`. It is
9257   no longer possible to use unstable features with a stable build of
9258   the compiler.
9259 * Many popular crates on [crates.io] now work on the stable release
9260   channel.
9261 * Arithmetic on basic integer types now [checks for overflow in debug
9262   builds][overflow].
9263
9264 Language
9265 --------
9266
9267 * Several [restrictions have been added to trait coherence][coh] in
9268   order to make it easier for upstream authors to change traits
9269   without breaking downstream code.
9270 * Digits of binary and octal literals are [lexed more eagerly][lex] to
9271   improve error messages and macro behavior. For example, `0b1234` is
9272   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
9273 * Trait bounds [are always invariant][inv], eliminating the need for
9274   the `PhantomFn` and `MarkerTrait` lang items, which have been
9275   removed.
9276 * ["-" is no longer a valid character in crate names][cr], the `extern crate
9277   "foo" as bar` syntax has been replaced with `extern crate foo as
9278   bar`, and Cargo now automatically translates "-" in *package* names
9279   to underscore for the crate name.
9280 * [Lifetime shadowing is an error][lt].
9281 * [`Send` no longer implies `'static`][send-rfc].
9282 * [UFCS now supports trait-less associated paths][moar-ufcs] like
9283   `MyType::default()`.
9284 * Primitive types [now have inherent methods][prim-inherent],
9285   obviating the need for extension traits like `SliceExt`.
9286 * Methods with `Self: Sized` in their `where` clause are [considered
9287   object-safe][self-sized], allowing many extension traits like
9288   `IteratorExt` to be merged into the traits they extended.
9289 * You can now [refer to associated types][assoc-where] whose
9290   corresponding trait bounds appear only in a `where` clause.
9291 * The final bits of [OIBIT landed][oibit-final], meaning that traits
9292   like `Send` and `Sync` are now library-defined.
9293 * A [Reflect trait][reflect] was introduced, which means that
9294   downcasting via the `Any` trait is effectively limited to concrete
9295   types. This helps retain the potentially-important "parametricity"
9296   property: generic code cannot behave differently for different type
9297   arguments except in minor ways.
9298 * The `unsafe_destructor` feature is now deprecated in favor of the
9299   [new `dropck`][dropck]. This change is a major reduction in unsafe
9300   code.
9301
9302 Libraries
9303 ---------
9304
9305 * The `thread_local` module [has been renamed to `std::thread`][th].
9306 * The methods of `IteratorExt` [have been moved to the `Iterator`
9307   trait itself][ie].
9308 * Several traits that implement Rust's conventions for type
9309   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
9310   [centralized in the `std::convert` module][con].
9311 * The `FromError` trait [was removed in favor of `From`][fe].
9312 * The basic sleep function [has moved to
9313   `std::thread::sleep_ms`][slp].
9314 * The `splitn` function now takes an `n` parameter that represents the
9315   number of items yielded by the returned iterator [instead of the
9316   number of 'splits'][spl].
9317 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
9318 * [Derived implementations of `PartialOrd` now order enums according
9319   to their explicitly-assigned discriminants][po].
9320 * [Methods for searching strings are generic over `Pattern`s][pat],
9321   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
9322   some others.
9323 * [In method resolution, object methods are resolved before inherent
9324   methods][meth].
9325 * [`String::from_str` has been deprecated in favor of the `From` impl,
9326   `String::from`][sf].
9327 * [`io::Error` implements `Sync`][ios].
9328 * [The `words` method on `&str` has been replaced with
9329   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
9330   a word?'
9331 * The new path and IO modules are complete and `#[stable]`. This
9332   was the major library focus for this cycle.
9333 * The path API was [revised][path-normalize] to normalize `.`,
9334   adjusting the tradeoffs in favor of the most common usage.
9335 * A large number of remaining APIs in `std` were also stabilized
9336   during this cycle; about 75% of the non-deprecated API surface
9337   is now stable.
9338 * The new [string pattern API][string-pattern] landed, which makes
9339   the string slice API much more internally consistent and flexible.
9340 * A new set of [generic conversion traits][conversion] replaced
9341   many existing ad hoc traits.
9342 * Generic numeric traits were [completely removed][num-traits]. This
9343   was made possible thanks to inherent methods for primitive types,
9344   and the removal gives maximal flexibility for designing a numeric
9345   hierarchy in the future.
9346 * The `Fn` traits are now related via [inheritance][fn-inherit]
9347   and provide ergonomic [blanket implementations][fn-blanket].
9348 * The `Index` and `IndexMut` traits were changed to
9349   [take the index by value][index-value], enabling code like
9350   `hash_map["string"]` to work.
9351 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
9352   `Copy` data is known to be `Clone` as well.
9353
9354 Misc
9355 ----
9356
9357 * Many errors now have extended explanations that can be accessed with
9358   the `--explain` flag to `rustc`.
9359 * Many new examples have been added to the standard library
9360   documentation.
9361 * rustdoc has received a number of improvements focused on completion
9362   and polish.
9363 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
9364 * Much headway was made on ecosystem-wide CI, making it possible
9365   to [compare builds for breakage][ci-compare].
9366
9367
9368 [crates.io]: http://crates.io
9369 [clo]: https://github.com/rust-lang/rust/pull/24034
9370 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
9371 [con]: https://github.com/rust-lang/rust/pull/23875
9372 [cr]: https://github.com/rust-lang/rust/pull/23419
9373 [fe]: https://github.com/rust-lang/rust/pull/23879
9374 [ie]: https://github.com/rust-lang/rust/pull/23300
9375 [inv]: https://github.com/rust-lang/rust/pull/23938
9376 [ios]: https://github.com/rust-lang/rust/pull/24133
9377 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
9378 [lt]: https://github.com/rust-lang/rust/pull/24057
9379 [meth]: https://github.com/rust-lang/rust/pull/24056
9380 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
9381 [po]: https://github.com/rust-lang/rust/pull/24270
9382 [sf]: https://github.com/rust-lang/rust/pull/24517
9383 [slp]: https://github.com/rust-lang/rust/pull/23949
9384 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
9385 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
9386 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
9387 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
9388 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
9389 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
9390 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
9391 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
9392 [self-sized]: https://github.com/rust-lang/rust/pull/22301
9393 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
9394 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
9395 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
9396 [reflect]: https://github.com/rust-lang/rust/pull/23712
9397 [conversion]: https://github.com/rust-lang/rfcs/pull/529
9398 [num-traits]: https://github.com/rust-lang/rust/pull/23549
9399 [index-value]: https://github.com/rust-lang/rust/pull/23601
9400 [dropck]: https://github.com/rust-lang/rfcs/pull/769
9401 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
9402 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
9403 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
9404 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
9405 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
9406
9407
9408 Version 1.0.0-alpha.2 (2015-02-20)
9409 =====================================
9410
9411 * ~1300 changes, numerous bugfixes
9412
9413 * Highlights
9414
9415     * The various I/O modules were [overhauled][io-rfc] to reduce
9416       unnecessary abstractions and provide better interoperation with
9417       the underlying platform. The old `io` module remains temporarily
9418       at `std::old_io`.
9419     * The standard library now [participates in feature gating][feat],
9420       so use of unstable libraries now requires a `#![feature(...)]`
9421       attribute. The impact of this change is [described on the
9422       forum][feat-forum]. [RFC][feat-rfc].
9423
9424 * Language
9425
9426     * `for` loops [now operate on the `IntoIterator` trait][into],
9427       which eliminates the need to call `.iter()`, etc. to iterate
9428       over collections. There are some new subtleties to remember
9429       though regarding what sort of iterators various types yield, in
9430       particular that `for foo in bar { }` yields values from a move
9431       iterator, destroying the original collection. [RFC][into-rfc].
9432     * Objects now have [default lifetime bounds][obj], so you don't
9433       have to write `Box<Trait+'static>` when you don't care about
9434       storing references. [RFC][obj-rfc].
9435     * In types that implement `Drop`, [lifetimes must outlive the
9436       value][drop]. This will soon make it possible to safely
9437       implement `Drop` for types where `#[unsafe_destructor]` is now
9438       required. Read the [gorgeous RFC][drop-rfc] for details.
9439     * The fully qualified <T as Trait>::X syntax lets you set the Self
9440       type for a trait method or associated type. [RFC][ufcs-rfc].
9441     * References to types that implement `Deref<U>` now [automatically
9442       coerce to references][deref] to the dereferenced type `U`,
9443       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
9444       should eliminate many unsightly uses of `&*`, as when converting
9445       from references to vectors into references to
9446       slices. [RFC][deref-rfc].
9447     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
9448       `|:|`) is obsolete and closure kind is inferred from context.
9449     * [`Self` is a keyword][Self].
9450
9451 * Libraries
9452
9453     * The `Show` and `String` formatting traits [have been
9454       renamed][fmt] to `Debug` and `Display` to more clearly reflect
9455       their related purposes. Automatically getting a string
9456       conversion to use with `format!("{:?}", something_to_debug)` is
9457       now written `#[derive(Debug)]`.
9458     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
9459       OsStr}`, provide strings in platform-specific encodings for easier
9460       interop with system APIs. [RFC][osstr-rfc].
9461     * The `boxed::into_raw` and `Box::from_raw` functions [convert
9462       between `Box<T>` and `*mut T`][boxraw], a common pattern for
9463       creating raw pointers.
9464
9465 * Tooling
9466
9467     * Certain long error messages of the form 'expected foo found bar'
9468       are now [split neatly across multiple
9469       lines][multiline]. Examples in the PR.
9470     * On Unix Rust can be [uninstalled][un] by running
9471       `/usr/local/lib/rustlib/uninstall.sh`.
9472     * The `#[rustc_on_unimplemented]` attribute, requiring the
9473       'on_unimplemented' feature, lets rustc [display custom error
9474       messages when a trait is expected to be implemented for a type
9475       but is not][onun].
9476
9477 * Misc
9478
9479     * Rust is tested against a [LALR grammar][lalr], which parses
9480       almost all the Rust files that rustc does.
9481
9482 [boxraw]: https://github.com/rust-lang/rust/pull/21318
9483 [close]: https://github.com/rust-lang/rust/pull/21843
9484 [deref]: https://github.com/rust-lang/rust/pull/21351
9485 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
9486 [drop]: https://github.com/rust-lang/rust/pull/21972
9487 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
9488 [feat]: https://github.com/rust-lang/rust/pull/21248
9489 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
9490 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
9491 [fmt]: https://github.com/rust-lang/rust/pull/21457
9492 [into]: https://github.com/rust-lang/rust/pull/20790
9493 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
9494 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9495 [lalr]: https://github.com/rust-lang/rust/pull/21452
9496 [multiline]: https://github.com/rust-lang/rust/pull/19870
9497 [obj]: https://github.com/rust-lang/rust/pull/22230
9498 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
9499 [onun]: https://github.com/rust-lang/rust/pull/20889
9500 [osstr]: https://github.com/rust-lang/rust/pull/21488
9501 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9502 [Self]: https://github.com/rust-lang/rust/pull/22158
9503 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
9504 [un]: https://github.com/rust-lang/rust/pull/22256
9505
9506
9507 Version 1.0.0-alpha (2015-01-09)
9508 ==================================
9509
9510   * ~2400 changes, numerous bugfixes
9511
9512   * Highlights
9513
9514     * The language itself is considered feature complete for 1.0,
9515       though there will be many usability improvements and bugfixes
9516       before the final release.
9517     * Nearly 50% of the public API surface of the standard library has
9518       been declared 'stable'. Those interfaces are unlikely to change
9519       before 1.0.
9520     * The long-running debate over integer types has been
9521       [settled][ints]: Rust will ship with types named `isize` and
9522       `usize`, rather than `int` and `uint`, for pointer-sized
9523       integers. Guidelines will be rolled out during the alpha cycle.
9524     * Most crates that are not `std` have been moved out of the Rust
9525       distribution into the Cargo ecosystem so they can evolve
9526       separately and don't need to be stabilized as quickly, including
9527       'time', 'getopts', 'num', 'regex', and 'term'.
9528     * Documentation continues to be expanded with more API coverage, more
9529       examples, and more in-depth explanations. The guides have been
9530       consolidated into [The Rust Programming Language][trpl].
9531     * "[Rust By Example][rbe]" is now maintained by the Rust team.
9532     * All official Rust binary installers now come with [Cargo], the
9533       Rust package manager.
9534
9535 * Language
9536
9537     * Closures have been [completely redesigned][unboxed] to be
9538       implemented in terms of traits, can now be used as generic type
9539       bounds and thus monomorphized and inlined, or via an opaque
9540       pointer (boxed) as in the old system. The new system is often
9541       referred to as 'unboxed' closures.
9542     * Traits now support [associated types][assoc], allowing families
9543       of related types to be defined together and used generically in
9544       powerful ways.
9545     * Enum variants are [namespaced by their type names][enum].
9546     * [`where` clauses][where] provide a more versatile and attractive
9547       syntax for specifying generic bounds, though the previous syntax
9548       remains valid.
9549     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
9550       numeric types.
9551     * Rust [no longer has a runtime][rt] of any description, and only
9552       supports OS threads, not green threads.
9553     * At long last, Rust has been overhauled for 'dynamically-sized
9554       types' ([DST]), which integrates 'fat pointers' (object types,
9555       arrays, and `str`) more deeply into the type system, making it
9556       more consistent.
9557     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
9558       `..j` that produce range types and which, when combined with the
9559       `Index` operator and multidispatch, leads to a convenient slice
9560       notation, `[i..j]`.
9561     * The new range syntax revealed an ambiguity in the fixed-length
9562       array syntax, so now fixed length arrays [are written `[T;
9563       N]`][arrays].
9564     * The `Copy` trait is no longer implemented automatically. Unsafe
9565       pointers no longer implement `Sync` and `Send` so types
9566       containing them don't automatically either. `Sync` and `Send`
9567       are now 'unsafe traits' so one can "forcibly" implement them via
9568       `unsafe impl` if a type confirms to the requirements for them
9569       even though the internals do not (e.g. structs containing unsafe
9570       pointers like `Arc`). These changes are intended to prevent some
9571       footguns and are collectively known as [opt-in built-in
9572       traits][oibit] (though `Sync` and `Send` will soon become pure
9573       library types unknown to the compiler).
9574     * Operator traits now take their operands [by value][ops], and
9575       comparison traits can use multidispatch to compare one type
9576       against multiple other types, allowing e.g. `String` to be
9577       compared with `&str`.
9578     * `if let` and `while let` are no longer feature-gated.
9579     * Rust has adopted a more [uniform syntax for escaping unicode
9580       characters][unicode].
9581     * `macro_rules!` [has been declared stable][mac]. Though it is a
9582       flawed system it is sufficiently popular that it must be usable
9583       for 1.0. Effort has gone into [future-proofing][mac-future] it
9584       in ways that will allow other macro systems to be developed in
9585       parallel, and won't otherwise impact the evolution of the
9586       language.
9587     * The prelude has been [pared back significantly][prelude] such
9588       that it is the minimum necessary to support the most pervasive
9589       code patterns, and through [generalized where clauses][where]
9590       many of the prelude extension traits have been consolidated.
9591     * Rust's rudimentary reflection [has been removed][refl], as it
9592       incurred too much code generation for little benefit.
9593     * [Struct variants][structvars] are no longer feature-gated.
9594     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
9595       known as 'higher-ranked trait bounds', this crucially allows
9596       unboxed closures to work.
9597     * Macros invocations surrounded by parens or square brackets and
9598       not terminated by a semicolon are [parsed as
9599       expressions][macros], which makes expressions like `vec![1i32,
9600       2, 3].len()` work as expected.
9601     * Trait objects now implement their traits automatically, and
9602       traits that can be coerced to objects now must be [object
9603       safe][objsafe].
9604     * Automatically deriving traits is now done with `#[derive(...)]`
9605       not `#[deriving(...)]` for [consistency with other naming
9606       conventions][derive].
9607     * Importing the containing module or enum at the same time as
9608       items or variants they contain is [now done with `self` instead
9609       of `mod`][self], as in use `foo::{self, bar}`
9610     * Glob imports are no longer feature-gated.
9611     * The `box` operator and `box` patterns have been feature-gated
9612       pending a redesign. For now unique boxes should be allocated
9613       like other containers, with `Box::new`.
9614
9615 * Libraries
9616
9617     * A [series][coll1] of [efforts][coll2] to establish
9618       [conventions][coll3] for collections types has resulted in API
9619       improvements throughout the standard library.
9620     * New [APIs for error handling][err] provide ergonomic interop
9621       between error types, and [new conventions][err-conv] describe
9622       more clearly the recommended error handling strategies in Rust.
9623     * The `fail!` macro has been renamed to [`panic!`][panic] so that
9624       it is easier to discuss failure in the context of error handling
9625       without making clarifications as to whether you are referring to
9626       the 'fail' macro or failure more generally.
9627     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
9628       syscall when available.
9629     * The 'serialize' crate has been renamed 'rustc-serialize' and
9630       moved out of the distribution to Cargo. Although it is widely
9631       used now, it is expected to be superseded in the near future.
9632     * The `Show` formatter, typically implemented with
9633       `#[derive(Show)]` is [now requested with the `{:?}`
9634       specifier][show] and is intended for use by all types, for uses
9635       such as `println!` debugging. The new `String` formatter must be
9636       implemented by hand, uses the `{}` specifier, and is intended
9637       for full-fidelity conversions of things that can logically be
9638       represented as strings.
9639
9640 * Tooling
9641
9642     * [Flexible target specification][flex] allows rustc's code
9643       generation to be configured to support otherwise-unsupported
9644       platforms.
9645     * Rust comes with rust-gdb and rust-lldb scripts that launch their
9646       respective debuggers with Rust-appropriate pretty-printing.
9647     * The Windows installation of Rust is distributed with the
9648       MinGW components currently required to link binaries on that
9649       platform.
9650
9651 * Misc
9652
9653     * Nullable enum optimizations have been extended to more types so
9654       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
9655       space than the inner types themselves.
9656     * Work has begun on supporting AArch64.
9657
9658 [Cargo]: https://crates.io
9659 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
9660 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
9661 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
9662 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
9663 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
9664 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
9665 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
9666 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
9667 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
9668 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
9669 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
9670 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
9671 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
9672 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
9673 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
9674 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
9675 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
9676 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
9677 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
9678 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
9679 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
9680 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
9681 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
9682 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
9683 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
9684 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
9685 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
9686 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
9687 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
9688 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
9689 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
9690 [trpl]: https://doc.rust-lang.org/book/index.html
9691 [rbe]: http://rustbyexample.com/
9692
9693
9694 Version 0.12.0 (2014-10-09)
9695 =============================
9696
9697   * ~1900 changes, numerous bugfixes
9698
9699   * Highlights
9700
9701     * The introductory documentation (now called The Rust Guide) has
9702       been completely rewritten, as have a number of supplementary
9703       guides.
9704     * Rust's package manager, Cargo, continues to improve and is
9705       sometimes considered to be quite awesome.
9706     * Many API's in `std` have been reviewed and updated for
9707       consistency with the in-development Rust coding
9708       guidelines. The standard library documentation tracks
9709       stabilization progress.
9710     * Minor libraries have been moved out-of-tree to the rust-lang org
9711       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
9712       be installed with Cargo.
9713     * Lifetime elision allows lifetime annotations to be left off of
9714       function declarations in many common scenarios.
9715     * Rust now works on 64-bit Windows.
9716
9717   * Language
9718     * Indexing can be overloaded with the `Index` and `IndexMut`
9719       traits.
9720     * The `if let` construct takes a branch only if the `let` pattern
9721       matches, currently behind the 'if_let' feature gate.
9722     * 'where clauses', a more flexible syntax for specifying trait
9723       bounds that is more aesthetic, have been added for traits and
9724       free functions. Where clauses will in the future make it
9725       possible to constrain associated types, which would be
9726       impossible with the existing syntax.
9727     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
9728       the 'slicing_syntax' feature gate, and can be overloaded with
9729       the `Slice` or `SliceMut` traits.
9730     * The syntax for matching of sub-slices has been changed to use a
9731       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
9732       consistency with other uses of `..` and to future-proof
9733       potential additional uses of the syntax.
9734     * The syntax for matching inclusive ranges in patterns has changed
9735       from `0..3` to `0...4` to be consistent with the exclusive range
9736       syntax for slicing.
9737     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
9738       c]`) has been put behind the 'advanced_slice_patterns' feature
9739       gate and may be removed in the future.
9740     * Components of tuples and tuple structs can be extracted using
9741       the `value.0` syntax, currently behind the `tuple_indexing`
9742       feature gate.
9743     * The `#[crate_id]` attribute is no longer supported; versioning
9744       is handled by the package manager.
9745     * Renaming crate imports are now written `extern crate foo as bar`
9746       instead of `extern crate bar = foo`.
9747     * Renaming use statements are now written `use foo as bar` instead
9748       of `use bar = foo`.
9749     * `let` and `match` bindings and argument names in macros are now
9750       hygienic.
9751     * The new, more efficient, closure types ('unboxed closures') have
9752       been added under a feature gate, 'unboxed_closures'. These will
9753       soon replace the existing closure types, once higher-ranked
9754       trait lifetimes are added to the language.
9755     * `move` has been added as a keyword, for indicating closures
9756       that capture by value.
9757     * Mutation and assignment is no longer allowed in pattern guards.
9758     * Generic structs and enums can now have trait bounds.
9759     * The `Share` trait is now called `Sync` to free up the term
9760       'shared' to refer to 'shared reference' (the default reference
9761       type.
9762     * Dynamically-sized types have been mostly implemented,
9763       unifying the behavior of fat-pointer types with the rest of the
9764       type system.
9765     * As part of dynamically-sized types, the `Sized` trait has been
9766       introduced, which qualifying types implement by default, and
9767       which type parameters expect by default. To specify that a type
9768       parameter does not need to be sized, write `<Sized? T>`. Most
9769       types are `Sized`, notable exceptions being unsized arrays
9770       (`[T]`) and trait types.
9771     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
9772     * Lifetime bounds can now be applied to type parameters and object
9773       types.
9774     * The old, reference counted GC type, `Gc<T>` which was once
9775       denoted by the `@` sigil, has finally been removed. GC will be
9776       revisited in the future.
9777
9778   * Libraries
9779     * Library documentation has been improved for a number of modules.
9780     * Bit-vectors, collections::bitv has been modernized.
9781     * The url crate is deprecated in favor of
9782       http://github.com/servo/rust-url, which can be installed with
9783       Cargo.
9784     * Most I/O stream types can be cloned and subsequently closed from
9785       a different thread.
9786     * A `std::time::Duration` type has been added for use in I/O
9787       methods that rely on timers, as well as in the 'time' crate's
9788       `Timespec` arithmetic.
9789     * The runtime I/O abstraction layer that enabled the green thread
9790       scheduler to do non-thread-blocking I/O has been removed, along
9791       with the libuv-based implementation employed by the green thread
9792       scheduler. This will greatly simplify the future I/O work.
9793     * `collections::btree` has been rewritten to have a more
9794       idiomatic and efficient design.
9795
9796   * Tooling
9797     * rustdoc output now indicates the stability levels of API's.
9798     * The `--crate-name` flag can specify the name of the crate
9799       being compiled, like `#[crate_name]`.
9800     * The `-C metadata` specifies additional metadata to hash into
9801       symbol names, and `-C extra-filename` specifies additional
9802       information to put into the output filename, for use by the
9803       package manager for versioning.
9804     * debug info generation has continued to improve and should be
9805       more reliable under both gdb and lldb.
9806     * rustc has experimental support for compiling in parallel
9807       using the `-C codegen-units` flag.
9808     * rustc no longer encodes rpath information into binaries by
9809       default.
9810
9811   * Misc
9812     * Stack usage has been optimized with LLVM lifetime annotations.
9813     * Official Rust binaries on Linux are more compatible with older
9814       kernels and distributions, built on CentOS 5.10.
9815
9816
9817 Version 0.11.0 (2014-07-02)
9818 ==========================
9819
9820   * ~1700 changes, numerous bugfixes
9821
9822   * Language
9823     * ~[T] has been removed from the language. This type is superseded by
9824       the Vec<T> type.
9825     * ~str has been removed from the language. This type is superseded by
9826       the String type.
9827     * ~T has been removed from the language. This type is superseded by the
9828       Box<T> type.
9829     * @T has been removed from the language. This type is superseded by the
9830       standard library's std::gc::Gc<T> type.
9831     * Struct fields are now all private by default.
9832     * Vector indices and shift amounts are both required to be a `uint`
9833       instead of any integral type.
9834     * Byte character, byte string, and raw byte string literals are now all
9835       supported by prefixing the normal literal with a `b`.
9836     * Multiple ABIs are no longer allowed in an ABI string
9837     * The syntax for lifetimes on closures/procedures has been tweaked
9838       slightly: `<'a>|A, B|: 'b + K -> T`
9839     * Floating point modulus has been removed from the language; however it
9840       is still provided by a library implementation.
9841     * Private enum variants are now disallowed.
9842     * The `priv` keyword has been removed from the language.
9843     * A closure can no longer be invoked through a &-pointer.
9844     * The `use foo, bar, baz;` syntax has been removed from the language.
9845     * The transmute intrinsic no longer works on type parameters.
9846     * Statics now allow blocks/items in their definition.
9847     * Trait bounds are separated from objects with + instead of : now.
9848     * Objects can no longer be read while they are mutably borrowed.
9849     * The address of a static is now marked as insignificant unless the
9850       #[inline(never)] attribute is placed it.
9851     * The #[unsafe_destructor] attribute is now behind a feature gate.
9852     * Struct literals are no longer allowed in ambiguous positions such as
9853       if, while, match, and for..in.
9854     * Declaration of lang items and intrinsics are now feature-gated by
9855       default.
9856     * Integral literals no longer default to `int`, and floating point
9857       literals no longer default to `f64`. Literals must be suffixed with an
9858       appropriate type if inference cannot determine the type of the
9859       literal.
9860     * The Box<T> type is no longer implicitly borrowed to &mut T.
9861     * Procedures are now required to not capture borrowed references.
9862
9863   * Libraries
9864     * The standard library is now a "facade" over a number of underlying
9865       libraries. This means that development on the standard library should
9866       be speedier due to smaller crates, as well as a clearer line between
9867       all dependencies.
9868     * A new library, libcore, lives under the standard library's facade
9869       which is Rust's "0-assumption" library, suitable for embedded and
9870       kernel development for example.
9871     * A regex crate has been added to the standard distribution. This crate
9872       includes statically compiled regular expressions.
9873     * The unwrap/unwrap_err methods on Result require a Show bound for
9874       better error messages.
9875     * The return types of the std::comm primitives have been centralized
9876       around the Result type.
9877     * A number of I/O primitives have gained the ability to time out their
9878       operations.
9879     * A number of I/O primitives have gained the ability to close their
9880       reading/writing halves to cancel pending operations.
9881     * Reverse iterator methods have been removed in favor of `rev()` on
9882       their forward-iteration counterparts.
9883     * A bitflags! macro has been added to enable easy interop with C and
9884       management of bit flags.
9885     * A debug_assert! macro is now provided which is disabled when
9886       `--cfg ndebug` is passed to the compiler.
9887     * A graphviz crate has been added for creating .dot files.
9888     * The std::cast module has been migrated into std::mem.
9889     * The std::local_data api has been migrated from freestanding functions
9890       to being based on methods.
9891     * The Pod trait has been renamed to Copy.
9892     * jemalloc has been added as the default allocator for types.
9893     * The API for allocating memory has been changed to use proper alignment
9894       and sized deallocation
9895     * Connecting a TcpStream or binding a TcpListener is now based on a
9896       string address and a u16 port. This allows connecting to a hostname as
9897       opposed to an IP.
9898     * The Reader trait now contains a core method, read_at_least(), which
9899       correctly handles many repeated 0-length reads.
9900     * The process-spawning API is now centered around a builder-style
9901       Command struct.
9902     * The :? printing qualifier has been moved from the standard library to
9903       an external libdebug crate.
9904     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
9905       have been renamed to Eq/Ord.
9906     * The select/plural methods have been removed from format!. The escapes
9907       for { and } have also changed from \{ and \} to {{ and }},
9908       respectively.
9909     * The TaskBuilder API has been re-worked to be a true builder, and
9910       extension traits for spawning native/green tasks have been added.
9911
9912   * Tooling
9913     * All breaking changes to the language or libraries now have their
9914       commit message annotated with `[breaking-change]` to allow for easy
9915       discovery of breaking changes.
9916     * The compiler will now try to suggest how to annotate lifetimes if a
9917       lifetime-related error occurs.
9918     * Debug info continues to be improved greatly with general bug fixes and
9919       better support for situations like link time optimization (LTO).
9920     * Usage of syntax extensions when cross-compiling has been fixed.
9921     * Functionality equivalent to GCC & Clang's -ffunction-sections,
9922       -fdata-sections and --gc-sections has been enabled by default
9923     * The compiler is now stricter about where it will load module files
9924       from when a module is declared via `mod foo;`.
9925     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
9926       Syntax extensions are now discovered via a "plugin registrar" type
9927       which will be extended in the future to other various plugins.
9928     * Lints have been restructured to allow for dynamically loadable lints.
9929     * A number of rustdoc improvements:
9930       * The HTML output has been visually redesigned.
9931       * Markdown is now powered by hoedown instead of sundown.
9932       * Searching heuristics have been greatly improved.
9933       * The search index has been reduced in size by a great amount.
9934       * Cross-crate documentation via `pub use` has been greatly improved.
9935       * Primitive types are now hyperlinked and documented.
9936     * Documentation has been moved from static.rust-lang.org/doc to
9937       doc.rust-lang.org
9938     * A new sandbox, play.rust-lang.org, is available for running and
9939       sharing rust code examples on-line.
9940     * Unused attributes are now more robustly warned about.
9941     * The dead_code lint now warns about unused struct fields.
9942     * Cross-compiling to iOS is now supported.
9943     * Cross-compiling to mipsel is now supported.
9944     * Stability attributes are now inherited by default and no longer apply
9945       to intra-crate usage, only inter-crate usage.
9946     * Error message related to non-exhaustive match expressions have been
9947       greatly improved.
9948
9949
9950 Version 0.10 (2014-04-03)
9951 =========================
9952
9953   * ~1500 changes, numerous bugfixes
9954
9955   * Language
9956     * A new RFC process is now in place for modifying the language.
9957     * Patterns with `@`-pointers have been removed from the language.
9958     * Patterns with unique vectors (`~[T]`) have been removed from the
9959       language.
9960     * Patterns with unique strings (`~str`) have been removed from the
9961       language.
9962     * `@str` has been removed from the language.
9963     * `@[T]` has been removed from the language.
9964     * `@self` has been removed from the language.
9965     * `@Trait` has been removed from the language.
9966     * Headers on `~` allocations which contain `@` boxes inside the type for
9967       reference counting have been removed.
9968     * The semantics around the lifetimes of temporary expressions have changed,
9969       see #3511 and #11585 for more information.
9970     * Cross-crate syntax extensions are now possible, but feature gated. See
9971       #11151 for more information. This includes both `macro_rules!` macros as
9972       well as syntax extensions such as `format!`.
9973     * New lint modes have been added, and older ones have been turned on to be
9974       warn-by-default.
9975       * Unnecessary parentheses
9976       * Uppercase statics
9977       * Camel Case types
9978       * Uppercase variables
9979       * Publicly visible private types
9980       * `#[deriving]` with raw pointers
9981     * Unsafe functions can no longer be coerced to closures.
9982     * Various obscure macros such as `log_syntax!` are now behind feature gates.
9983     * The `#[simd]` attribute is now behind a feature gate.
9984     * Visibility is no longer allowed on `extern crate` statements, and
9985       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
9986     * Trailing commas are now allowed in argument lists and tuple patterns.
9987     * The `do` keyword has been removed, it is now a reserved keyword.
9988     * Default type parameters have been implemented, but are feature gated.
9989     * Borrowed variables through captures in closures are now considered soundly.
9990     * `extern mod` is now `extern crate`
9991     * The `Freeze` trait has been removed.
9992     * The `Share` trait has been added for types that can be shared among
9993       threads.
9994     * Labels in macros are now hygienic.
9995     * Expression/statement macro invocations can be delimited with `{}` now.
9996     * Treatment of types allowed in `static mut` locations has been tweaked.
9997     * The `*` and `.` operators are now overloadable through the `Deref` and
9998       `DerefMut` traits.
9999     * `~Trait` and `proc` no longer have `Send` bounds by default.
10000     * Partial type hints are now supported with the `_` type marker.
10001     * An `Unsafe` type was introduced for interior mutability. It is now
10002       considered undefined to transmute from `&T` to `&mut T` without using the
10003       `Unsafe` type.
10004     * The #[linkage] attribute was implemented for extern statics/functions.
10005     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
10006     * `Pod` was renamed to `Copy`.
10007
10008   * Libraries
10009     * The `libextra` library has been removed. It has now been decomposed into
10010       component libraries with smaller and more focused nuggets of
10011       functionality. The full list of libraries can be found on the
10012       documentation index page.
10013     * std: `std::condition` has been removed. All I/O errors are now propagated
10014       through the `Result` type. In order to assist with error handling, a
10015       `try!` macro for unwrapping errors with an early return and a lint for
10016       unused results has been added. See #12039 for more information.
10017     * std: The `vec` module has been renamed to `slice`.
10018     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
10019       This will become the only growable vector in the future.
10020     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
10021       are now found at `std::io::BufferedReader` instead of
10022       `std::io::buffered::BufferedReader`.
10023     * std: `print` and `println` are no longer in the prelude, the `print!` and
10024       `println!` macros are intended to be used instead.
10025     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
10026       attempts to statically prevent cycles.
10027     * std: The standard distribution is adopting the policy of pushing failure
10028       to the user rather than failing in libraries. Many functions (such as
10029       `slice::last()`) now return `Option<T>` instead of `T` + failing.
10030     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
10031       deriving mode: `#[deriving(Show)]`.
10032     * std: `ToStr` is now implemented for all types implementing `Show`.
10033     * std: The formatting trait methods now take `&self` instead of `&T`
10034     * std: The `invert()` method on iterators has been renamed to `rev()`
10035     * std: `std::num` has seen a reduction in the genericity of its traits,
10036       consolidating functionality into a few core traits.
10037     * std: Backtraces are now printed on task failure if the environment
10038       variable `RUST_BACKTRACE` is present.
10039     * std: Naming conventions for iterators have been standardized. More details
10040       can be found on the wiki's style guide.
10041     * std: `eof()` has been removed from the `Reader` trait. Specific types may
10042       still implement the function.
10043     * std: Networking types are now cloneable to allow simultaneous reads/writes.
10044     * std: `assert_approx_eq!` has been removed
10045     * std: The `e` and `E` formatting specifiers for floats have been added to
10046       print them in exponential notation.
10047     * std: The `Times` trait has been removed
10048     * std: Indications of variance and opting out of builtin bounds is done
10049       through marker types in `std::kinds::marker` now
10050     * std: `hash` has been rewritten, `IterBytes` has been removed, and
10051       `#[deriving(Hash)]` is now possible.
10052     * std: `SharedChan` has been removed, `Sender` is now cloneable.
10053     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
10054     * std: `Chan::new` is now `channel()`.
10055     * std: A new synchronous channel type has been implemented.
10056     * std: A `select!` macro is now provided for selecting over `Receiver`s.
10057     * std: `hashmap` and `trie` have been moved to `libcollections`
10058     * std: `run` has been rolled into `io::process`
10059     * std: `assert_eq!` now uses `{}` instead of `{:?}`
10060     * std: The equality and comparison traits have seen some reorganization.
10061     * std: `rand` has moved to `librand`.
10062     * std: `to_{lower,upper}case` has been implemented for `char`.
10063     * std: Logging has been moved to `liblog`.
10064     * collections: `HashMap` has been rewritten for higher performance and less
10065       memory usage.
10066     * native: The default runtime is now `libnative`. If `libgreen` is desired,
10067       it can be booted manually. The runtime guide has more information and
10068       examples.
10069     * native: All I/O functionality except signals has been implemented.
10070     * green: Task spawning with `libgreen` has been optimized with stack caching
10071       and various trimming of code.
10072     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
10073     * sync: The `extra::sync` module has been updated to modern rust (and moved
10074       to the `sync` library), tweaking and improving various interfaces while
10075       dropping redundant functionality.
10076     * sync: A new `Barrier` type has been added to the `sync` library.
10077     * sync: An efficient mutex for native and green tasks has been implemented.
10078     * serialize: The `base64` module has seen some improvement. It treats
10079       newlines better, has non-string error values, and has seen general
10080       cleanup.
10081     * fourcc: A `fourcc!` macro was introduced
10082     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
10083       hexadecimal literal.
10084
10085   * Tooling
10086     * `rustpkg` has been deprecated and removed from the main repository. Its
10087       replacement, `cargo`, is under development.
10088     * Nightly builds of rust are now available
10089     * The memory usage of rustc has been improved many times throughout this
10090       release cycle.
10091     * The build process supports disabling rpath support for the rustc binary
10092       itself.
10093     * Code generation has improved in some cases, giving more information to the
10094       LLVM optimization passes to enable more extensive optimizations.
10095     * Debuginfo compatibility with lldb on OSX has been restored.
10096     * The master branch is now gated on an android bot, making building for
10097       android much more reliable.
10098     * Output flags have been centralized into one `--emit` flag.
10099     * Crate type flags have been centralized into one `--crate-type` flag.
10100     * Codegen flags have been consolidated behind a `-C` flag.
10101     * Linking against outdated crates now has improved error messages.
10102     * Error messages with lifetimes will often suggest how to annotate the
10103       function to fix the error.
10104     * Many more types are documented in the standard library, and new guides
10105       were written.
10106     * Many `rustdoc` improvements:
10107       * code blocks are syntax highlighted.
10108       * render standalone markdown files.
10109       * the --test flag tests all code blocks by default.
10110       * exported macros are displayed.
10111       * re-exported types have their documentation inlined at the location of the
10112         first re-export.
10113       * search works across crates that have been rendered to the same output
10114         directory.
10115
10116
10117 Version 0.9 (2014-01-09)
10118 ==========================
10119
10120    * ~1800 changes, numerous bugfixes
10121
10122    * Language
10123       * The `float` type has been removed. Use `f32` or `f64` instead.
10124       * A new facility for enabling experimental features (feature gating) has
10125         been added, using the crate-level `#[feature(foo)]` attribute.
10126       * Managed boxes (@) are now behind a feature gate
10127         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
10128         standard library's `Gc` or `Rc` types instead.
10129       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
10130       * Jumping back to the top of a loop is now done with `continue` instead of
10131         `loop`.
10132       * Strings can no longer be mutated through index assignment.
10133       * Raw strings can be created via the basic `r"foo"` syntax or with matched
10134         hash delimiters, as in `r###"foo"###`.
10135       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
10136         called once.
10137       * The `&fn` type is now written `|args| -> ret` to match the literal form.
10138       * `@fn`s have been removed.
10139       * `do` only works with procs in order to make it obvious what the cost
10140         of `do` is.
10141       * Single-element tuple-like structs can no longer be dereferenced to
10142         obtain the inner value. A more comprehensive solution for overloading
10143         the dereference operator will be provided in the future.
10144       * The `#[link(...)]` attribute has been replaced with
10145         `#[crate_id = "name#vers"]`.
10146       * Empty `impl`s must be terminated with empty braces and may not be
10147         terminated with a semicolon.
10148       * Keywords are no longer allowed as lifetime names; the `self` lifetime
10149         no longer has any special meaning.
10150       * The old `fmt!` string formatting macro has been removed.
10151       * `printf!` and `printfln!` (old-style formatting) removed in favor of
10152         `print!` and `println!`.
10153       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
10154       * The `extern mod foo (name = "bar")` syntax has been removed. Use
10155         `extern mod foo = "bar"` instead.
10156       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
10157       * Macros can have attributes.
10158       * Macros can expand to items with attributes.
10159       * Macros can expand to multiple items.
10160       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
10161       * Comments may be nested.
10162       * Values automatically coerce to trait objects they implement, without
10163         an explicit `as`.
10164       * Enum discriminants are no longer an entire word but as small as needed to
10165         contain all the variants. The `repr` attribute can be used to override
10166         the discriminant size, as in `#[repr(int)]` for integer-sized, and
10167         `#[repr(C)]` to match C enums.
10168       * Non-string literals are not allowed in attributes (they never worked).
10169       * The FFI now supports variadic functions.
10170       * Octal numeric literals, as in `0o7777`.
10171       * The `concat!` syntax extension performs compile-time string concatenation.
10172       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
10173         removed as Rust no longer uses segmented stacks.
10174       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
10175       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
10176         not `*`; ignoring remaining fields of a struct is also done with `..`,
10177         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
10178       * `rustc` supports the "win64" calling convention via `extern "win64"`.
10179       * `rustc` supports the "system" calling convention, which defaults to the
10180         preferred convention for the target platform, "stdcall" on 32-bit Windows,
10181         "C" elsewhere.
10182       * The `type_overflow` lint (default: warn) checks literals for overflow.
10183       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
10184       * The `attribute_usage` lint (default: warn) warns about unknown
10185         attributes.
10186       * The `unknown_features` lint (default: warn) warns about unknown
10187         feature gates.
10188       * The `dead_code` lint (default: warn) checks for dead code.
10189       * Rust libraries can be linked statically to one another
10190       * `#[link_args]` is behind the `link_args` feature gate.
10191       * Native libraries are now linked with `#[link(name = "foo")]`
10192       * Native libraries can be statically linked to a rust crate
10193         (`#[link(name = "foo", kind = "static")]`).
10194       * Native OS X frameworks are now officially supported
10195         (`#[link(name = "foo", kind = "framework")]`).
10196       * The `#[thread_local]` attribute creates thread-local (not task-local)
10197         variables. Currently behind the `thread_local` feature gate.
10198       * The `return` keyword may be used in closures.
10199       * Types that can be copied via a memcpy implement the `Pod` kind.
10200       * The `cfg` attribute can now be used on struct fields and enum variants.
10201
10202    * Libraries
10203       * std: The `option` and `result` API's have been overhauled to make them
10204         simpler, more consistent, and more composable.
10205       * std: The entire `std::io` module has been replaced with one that is
10206         more comprehensive and that properly interfaces with the underlying
10207         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
10208         implemented.
10209       * std: `io::util` contains a number of useful implementations of
10210         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
10211         `ZeroReader`, `TeeReader`.
10212       * std: The reference counted pointer type `extra::rc` moved into std.
10213       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
10214         just a wrapper around it).
10215       * std: The `Either` type has been removed.
10216       * std: `fmt::Default` can be implemented for any type to provide default
10217         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
10218       * std: The `rand` API continues to be tweaked.
10219       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
10220         on failure in gdb, is now named `rust_fail`.
10221       * std: The `each_key` and `each_value` methods on `HashMap` have been
10222         replaced by the `keys` and `values` iterators.
10223       * std: Functions dealing with type size and alignment have moved from the
10224         `sys` module to the `mem` module.
10225       * std: The `path` module was written and API changed.
10226       * std: `str::from_utf8` has been changed to cast instead of allocate.
10227       * std: `starts_with` and `ends_with` methods added to vectors via the
10228         `ImmutableEqVector` trait, which is in the prelude.
10229       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
10230         if the index is out of bounds.
10231       * std: Task failure no longer propagates between tasks, as the model was
10232         complex, expensive, and incompatible with thread-based tasks.
10233       * std: The `Any` type can be used for dynamic typing.
10234       * std: `~Any` can be passed to the `fail!` macro and retrieved via
10235         `task::try`.
10236       * std: Methods that produce iterators generally do not have an `_iter`
10237         suffix now.
10238       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
10239         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
10240       * std: `util::ignore` renamed to `prelude::drop`.
10241       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
10242         trait.
10243       * std: `vec::raw` has seen a lot of cleanup and API changes.
10244       * std: The standard library no longer includes any C++ code, and very
10245         minimal C, eliminating the dependency on libstdc++.
10246       * std: Runtime scheduling and I/O functionality has been factored out into
10247         extensible interfaces and is now implemented by two different crates:
10248         libnative, for native threading and I/O; and libgreen, for green threading
10249         and I/O. This paves the way for using the standard library in more limited
10250         embedded environments.
10251       * std: The `comm` module has been rewritten to be much faster, have a
10252         simpler, more consistent API, and to work for both native and green
10253         threading.
10254       * std: All libuv dependencies have been moved into the rustuv crate.
10255       * native: New implementations of runtime scheduling on top of OS threads.
10256       * native: New native implementations of TCP, UDP, file I/O, process spawning,
10257         and other I/O.
10258       * green: The green thread scheduler and message passing types are almost
10259         entirely lock-free.
10260       * extra: The `flatpipes` module had bitrotted and was removed.
10261       * extra: All crypto functions have been removed and Rust now has a policy of
10262         not reimplementing crypto in the standard library. In the future crypto
10263         will be provided by external crates with bindings to established libraries.
10264       * extra: `c_vec` has been modernized.
10265       * extra: The `sort` module has been removed. Use the `sort` method on
10266         mutable slices.
10267
10268    * Tooling
10269       * The `rust` and `rusti` commands have been removed, due to lack of
10270         maintenance.
10271       * `rustdoc` was completely rewritten.
10272       * `rustdoc` can test code examples in documentation.
10273       * `rustpkg` can test packages with the argument, 'test'.
10274       * `rustpkg` supports arbitrary dependencies, including C libraries.
10275       * `rustc`'s support for generating debug info is improved again.
10276       * `rustc` has better error reporting for unbalanced delimiters.
10277       * `rustc`'s JIT support was removed due to bitrot.
10278       * Executables and static libraries can be built with LTO (-Z lto)
10279       * `rustc` adds a `--dep-info` flag for communicating dependencies to
10280         build tools.
10281
10282
10283 Version 0.8 (2013-09-26)
10284 ============================
10285
10286    * ~2200 changes, numerous bugfixes
10287
10288    * Language
10289       * The `for` loop syntax has changed to work with the `Iterator` trait.
10290       * At long last, unwinding works on Windows.
10291       * Default methods are ready for use.
10292       * Many trait inheritance bugs fixed.
10293       * Owned and borrowed trait objects work more reliably.
10294       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
10295       * rustc can omit emission of code for the `debug!` macro if it is passed
10296         `--cfg ndebug`
10297       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
10298         for foo.rs, then foo/mod.rs, and will generate an error when both are
10299         present.
10300       * Strings no longer contain trailing nulls. The new `std::c_str` module
10301         provides new mechanisms for converting to C strings.
10302       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
10303       * The FFI has been overhauled such that foreign functions are called directly,
10304         instead of through a stack-switching wrapper.
10305       * Calling a foreign function must be done through a Rust function with the
10306         `#[fixed_stack_segment]` attribute.
10307       * The `externfn!` macro can be used to declare both a foreign function and
10308         a `#[fixed_stack_segment]` wrapper at once.
10309       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
10310       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
10311       * `priv` is disallowed everywhere except for struct fields and enum variants.
10312       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
10313       * `ref` bindings in irrefutable patterns work correctly now.
10314       * `char` is now prevented from containing invalid code points.
10315       * Casting to `bool` is no longer allowed.
10316       * `\0` is now accepted as an escape in chars and strings.
10317       * `yield` is a reserved keyword.
10318       * `typeof` is a reserved keyword.
10319       * Crates may be imported by URL with `extern mod foo = "url";`.
10320       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
10321       * Static vectors can be initialized with repeating elements,
10322         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
10323       * Static structs can be initialized with functional record update,
10324         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
10325       * `cfg!` can be used to conditionally execute code based on the crate
10326         configuration, similarly to `#[cfg(...)]`.
10327       * The `unnecessary_qualification` lint detects unneeded module
10328         prefixes (default: allow).
10329       * Arithmetic operations have been implemented on the SIMD types in
10330         `std::unstable::simd`.
10331       * Exchange allocation headers were removed, reducing memory usage.
10332       * `format!` implements a completely new, extensible, and higher-performance
10333         string formatting system. It will replace `fmt!`.
10334       * `print!` and `println!` write formatted strings (using the `format!`
10335         extension) to stdout.
10336       * `write!` and `writeln!` write formatted strings (using the `format!`
10337         extension) to the new Writers in `std::rt::io`.
10338       * The library section in which a function or static is placed may
10339         be specified with `#[link_section = "..."]`.
10340       * The `proto!` syntax extension for defining bounded message protocols
10341         was removed.
10342       * `macro_rules!` is hygienic for `let` declarations.
10343       * The `#[export_name]` attribute specifies the name of a symbol.
10344       * `unreachable!` can be used to indicate unreachable code, and fails
10345         if executed.
10346
10347    * Libraries
10348       * std: Transitioned to the new runtime, written in Rust.
10349       * std: Added an experimental I/O library, `rt::io`, based on the new
10350         runtime.
10351       * std: A new generic `range` function was added to the prelude, replacing
10352         `uint::range` and friends.
10353       * std: `range_rev` no longer exists. Since range is an iterator it can be
10354         reversed with `range(lo, hi).invert()`.
10355       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
10356         renamed to `unwrap_or`.
10357       * std: The `iterator` module was renamed to `iter`.
10358       * std: Integral types now support the `checked_add`, `checked_sub`, and
10359         `checked_mul` operations for detecting overflow.
10360       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
10361         consistency.
10362       * std: Methods are standardizing on conventions for casting methods:
10363         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
10364         and cheap casts.
10365       * std: The `CString` type in `c_str` provides new ways to convert to and
10366         from C strings.
10367       * std: `DoubleEndedIterator` can yield elements in two directions.
10368       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
10369         two splices.
10370       * std: `str::from_bytes` renamed to `str::from_utf8`.
10371       * std: `pop_opt` and `shift_opt` methods added to vectors.
10372       * std: The task-local data interface no longer uses @, and keys are
10373         no longer function pointers.
10374       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
10375       * std: Added `SharedPort` to `comm`.
10376       * std: `Eq` has a default method for `ne`; only `eq` is required
10377         in implementations.
10378       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
10379         is required in implementations.
10380       * std: `is_utf8` performance is improved, impacting many string functions.
10381       * std: `os::MemoryMap` provides cross-platform mmap.
10382       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
10383         are not 'in-bounds' are considered undefined.
10384       * std: Many freestanding functions in `vec` removed in favor of methods.
10385       * std: Many freestanding functions on scalar types removed in favor of
10386         methods.
10387       * std: Many options to task builders were removed since they don't make
10388         sense in the new scheduler design.
10389       * std: More containers implement `FromIterator` so can be created by the
10390         `collect` method.
10391       * std: More complete atomic types in `unstable::atomics`.
10392       * std: `comm::PortSet` removed.
10393       * std: Mutating methods in the `Set` and `Map` traits have been moved into
10394         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
10395         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
10396         default implementations.
10397       * std: Various `from_str` functions were removed in favor of a generic
10398         `from_str` which is available in the prelude.
10399       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
10400       * extra: `dlist`, the doubly-linked list was modernized.
10401       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
10402       * extra: Added `glob` module, replacing `std::os::glob`.
10403       * extra: `rope` was removed.
10404       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
10405       * extra: `net`, and `timer` were removed. The experimental replacements
10406         are `std::rt::io::net` and `std::rt::io::timer`.
10407       * extra: Iterators implemented for `SmallIntMap`.
10408       * extra: Iterators implemented for `Bitv` and `BitvSet`.
10409       * extra: `SmallIntSet` removed. Use `BitvSet`.
10410       * extra: Performance of JSON parsing greatly improved.
10411       * extra: `semver` updated to SemVer 2.0.0.
10412       * extra: `term` handles more terminals correctly.
10413       * extra: `dbg` module removed.
10414       * extra: `par` module removed.
10415       * extra: `future` was cleaned up, with some method renames.
10416       * extra: Most free functions in `getopts` were converted to methods.
10417
10418    * Other
10419       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
10420       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
10421         similarly to gcc's `--march` flag.
10422       * rustc's performance compiling small crates is much better.
10423       * rustpkg has received many improvements.
10424       * rustpkg supports git tags as package IDs.
10425       * rustpkg builds into target-specific directories so it can be used for
10426         cross-compiling.
10427       * The number of concurrent test tasks is controlled by the environment
10428         variable RUST_TEST_TASKS.
10429       * The test harness can now report metrics for benchmarks.
10430       * All tools have man pages.
10431       * Programs compiled with `--test` now support the `-h` and `--help` flags.
10432       * The runtime uses jemalloc for allocations.
10433       * Segmented stacks are temporarily disabled as part of the transition to
10434         the new runtime. Stack overflows are possible!
10435       * A new documentation backend, rustdoc_ng, is available for use. It is
10436         still invoked through the normal `rustdoc` command.
10437
10438
10439 Version 0.7 (2013-07-03)
10440 =======================
10441
10442    * ~2000 changes, numerous bugfixes
10443
10444    * Language
10445       * `impl`s no longer accept a visibility qualifier. Put them on methods
10446         instead.
10447       * The borrow checker has been rewritten with flow-sensitivity, fixing
10448         many bugs and inconveniences.
10449       * The `self` parameter no longer implicitly means `&'self self`,
10450         and can be explicitly marked with a lifetime.
10451       * Overloadable compound operators (`+=`, etc.) have been temporarily
10452         removed due to bugs.
10453       * The `for` loop protocol now requires `for`-iterators to return `bool`
10454         so they compose better.
10455       * The `Durable` trait is replaced with the `'static` bounds.
10456       * Trait default methods work more often.
10457       * Structs with the `#[packed]` attribute have byte alignment and
10458         no padding between fields.
10459       * Type parameters bound by `Copy` must now be copied explicitly with
10460         the `copy` keyword.
10461       * It is now illegal to move out of a dereferenced unsafe pointer.
10462       * `Option<~T>` is now represented as a nullable pointer.
10463       * `@mut` does dynamic borrow checks correctly.
10464       * The `main` function is only detected at the topmost level of the crate.
10465         The `#[main]` attribute is still valid anywhere.
10466       * Struct fields may no longer be mutable. Use inherited mutability.
10467       * The `#[no_send]` attribute makes a type that would otherwise be
10468         `Send`, not.
10469       * The `#[no_freeze]` attribute makes a type that would otherwise be
10470         `Freeze`, not.
10471       * Unbounded recursion will abort the process after reaching the limit
10472         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
10473       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
10474         are never implicitly copyable.
10475       * `#[static_assert]` makes compile-time assertions about static bools.
10476       * At long last, 'argument modes' no longer exist.
10477       * The rarely used `use mod` statement no longer exists.
10478
10479    * Syntax extensions
10480       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
10481         argument list.
10482       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
10483         `Rand`, `Zero` and `ToStr` can all be automatically derived with
10484         `#[deriving(...)]`.
10485       * The `bytes!` macro returns a vector of bytes for string, u8, char,
10486         and unsuffixed integer literals.
10487
10488    * Libraries
10489       * The `core` crate was renamed to `std`.
10490       * The `std` crate was renamed to `extra`.
10491       * More and improved documentation.
10492       * std: `iterator` module for external iterator objects.
10493       * Many old-style (internal, higher-order function) iterators replaced by
10494         implementations of `Iterator`.
10495       * std: Many old internal vector and string iterators,
10496         incl. `any`, `all`. removed.
10497       * std: The `finalize` method of `Drop` renamed to `drop`.
10498       * std: The `drop` method now takes `&mut self` instead of `&self`.
10499       * std: The prelude no longer re-exports any modules, only types and traits.
10500       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
10501         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
10502       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
10503         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
10504       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
10505         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
10506       * std: Many types implement `Clone`.
10507       * std: `path` type renamed to `Path`.
10508       * std: `mut` module and `Mut` type removed.
10509       * std: Many standalone functions removed in favor of methods and iterators
10510         in `vec`, `str`. In the future methods will also work as functions.
10511       * std: `reinterpret_cast` removed. Use `transmute`.
10512       * std: ascii string handling in `std::ascii`.
10513       * std: `Rand` is implemented for ~/@.
10514       * std: `run` module for spawning processes overhauled.
10515       * std: Various atomic types added to `unstable::atomic`.
10516       * std: Various types implement `Zero`.
10517       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
10518       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
10519       * std: Added `os::mkdir_recursive`.
10520       * std: Added `os::glob` function performs filesystems globs.
10521       * std: `FuzzyEq` renamed to `ApproxEq`.
10522       * std: `Map` now defines `pop` and `swap` methods.
10523       * std: `Cell` constructors converted to static methods.
10524       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
10525       * extra: `flate` module moved from `std` to `extra`.
10526       * extra: `fileinput` module for iterating over a series of files.
10527       * extra: `Complex` number type and `complex` module.
10528       * extra: `Rational` number type and `rational` module.
10529       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
10530       * extra: `term` uses terminfo now, is more correct.
10531       * extra: `arc` functions converted to methods.
10532       * extra: Implementation of fixed output size variations of SHA-2.
10533
10534    * Tooling
10535       * `unused_variables` lint mode for unused variables (default: warn).
10536       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
10537         (default: warn).
10538       * `unused_mut` lint mode for identifying unused `mut` qualifiers
10539         (default: warn).
10540       * `dead_assignment` lint mode for unread variables (default: warn).
10541       * `unnecessary_allocation` lint mode detects some heap allocations that are
10542         immediately borrowed so could be written without allocating (default: warn).
10543       * `missing_doc` lint mode (default: allow).
10544       * `unreachable_code` lint mode (default: warn).
10545       * The `rusti` command has been rewritten and a number of bugs addressed.
10546       * rustc outputs in color on more terminals.
10547       * rustc accepts a `--link-args` flag to pass arguments to the linker.
10548       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
10549       * Compiling with `-g` will make the binary record information about
10550         dynamic borrowcheck failures for debugging.
10551       * rustdoc has a nicer stylesheet.
10552       * Various improvements to rustdoc.
10553       * Improvements to rustpkg (see the detailed release notes).
10554
10555
10556 Version 0.6 (2013-04-03)
10557 ========================
10558
10559    * ~2100 changes, numerous bugfixes
10560
10561    * Syntax changes
10562       * The self type parameter in traits is now spelled `Self`
10563       * The `self` parameter in trait and impl methods must now be explicitly
10564         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
10565       * Static methods no longer require the `static` keyword and instead
10566         are distinguished by the lack of a `self` parameter
10567       * Replaced the `Durable` trait with the `'static` lifetime
10568       * The old closure type syntax with the trailing sigil has been
10569         removed in favor of the more consistent leading sigil
10570       * `super` is a keyword, and may be prefixed to paths
10571       * Trait bounds are separated with `+` instead of whitespace
10572       * Traits are implemented with `impl Trait for Type`
10573         instead of `impl Type: Trait`
10574       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
10575       * The `export` keyword has finally been removed
10576       * The `move` keyword has been removed (see "Semantic changes")
10577       * The interior mutability qualifier on vectors, `[mut T]`, has been
10578         removed. Use `&mut [T]`, etc.
10579       * `mut` is no longer valid in `~mut T`. Use inherited mutability
10580       * `fail` is no longer a keyword. Use `fail!()`
10581       * `assert` is no longer a keyword. Use `assert!()`
10582       * `log` is no longer a keyword. use `debug!`, etc.
10583       * 1-tuples may be represented as `(T,)`
10584       * Struct fields may no longer be `mut`. Use inherited mutability,
10585         `@mut T`, `core::mut` or `core::cell`
10586       * `extern mod { ... }` is no longer valid syntax for foreign
10587         function modules. Use extern blocks: `extern { ... }`
10588       * Newtype enums removed. Use tuple-structs.
10589       * Trait implementations no longer support visibility modifiers
10590       * Pattern matching over vectors improved and expanded
10591       * `const` renamed to `static` to correspond to lifetime name,
10592         and make room for future `static mut` unsafe mutable globals.
10593       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
10594       * `Clone` implementations can be automatically generated with
10595         `#[deriving(Clone)]`
10596       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
10597         instead of `foo as Bar`.
10598       * Fixed length vector types are now written as `[int, .. 3]`
10599         instead of `[int * 3]`.
10600       * Fixed length vector types can express the length as a constant
10601         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
10602
10603    * Semantic changes
10604       * Types with owned pointers or custom destructors move by default,
10605         eliminating the `move` keyword
10606       * All foreign functions are considered unsafe
10607       * &mut is now unaliasable
10608       * Writes to borrowed @mut pointers are prevented dynamically
10609       * () has size 0
10610       * The name of the main function can be customized using #[main]
10611       * The default type of an inferred closure is &fn instead of @fn
10612       * `use` statements may no longer be "chained" - they cannot import
10613         identifiers imported by previous `use` statements
10614       * `use` statements are crate relative, importing from the "top"
10615         of the crate by default. Paths may be prefixed with `super::`
10616         or `self::` to change the search behavior.
10617       * Method visibility is inherited from the implementation declaration
10618       * Structural records have been removed
10619       * Many more types can be used in static items, including enums
10620         'static-lifetime pointers and vectors
10621       * Pattern matching over vectors improved and expanded
10622       * Typechecking of closure types has been overhauled to
10623         improve inference and eliminate unsoundness
10624       * Macros leave scope at the end of modules, unless that module is
10625         tagged with #[macro_escape]
10626
10627    * Libraries
10628       * Added big integers to `std::bigint`
10629       * Removed `core::oldcomm` module
10630       * Added pipe-based `core::comm` module
10631       * Numeric traits have been reorganized under `core::num`
10632       * `vec::slice` finally returns a slice
10633       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
10634       * Containers reorganized around traits in `core::container`
10635       * `core::dvec` removed, `~[T]` is a drop-in replacement
10636       * `core::send_map` renamed to `core::hashmap`
10637       * `std::map` removed; replaced with `core::hashmap`
10638       * `std::treemap` reimplemented as an owned balanced tree
10639       * `std::deque` and `std::smallintmap` reimplemented as owned containers
10640       * `core::trie` added as a fast ordered map for integer keys
10641       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
10642       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
10643         overload the comparison operators, whereas `TotalOrd` is used
10644         by certain container types
10645
10646    * Other
10647       * Replaced the 'cargo' package manager with 'rustpkg'
10648       * Added all-purpose 'rust' tool
10649       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
10650       * rustc now *attempts* to offer spelling suggestions
10651       * Improved support for ARM and Android
10652       * Preliminary MIPS backend
10653       * Improved foreign function ABI implementation for x86, x86_64
10654       * Various memory usage improvements
10655       * Rust code may be embedded in foreign code under limited circumstances
10656       * Inline assembler supported by new asm!() syntax extension.
10657
10658
10659 Version 0.5 (2012-12-21)
10660 ===========================
10661
10662    * ~900 changes, numerous bugfixes
10663
10664    * Syntax changes
10665       * Removed `<-` move operator
10666       * Completed the transition from the `#fmt` extension syntax to `fmt!`
10667       * Removed old fixed length vector syntax - `[T]/N`
10668       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
10669       * Macros may now expand to items and statements
10670       * `a.b()` is always parsed as a method call, never as a field projection
10671       * `Eq` and `IterBytes` implementations can be automatically generated
10672         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
10673       * Removed the special crate language for `.rc` files
10674       * Function arguments may consist of any irrefutable pattern
10675
10676    * Semantic changes
10677       * `&` and `~` pointers may point to objects
10678       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
10679       * Enum variants may be structs
10680       * Destructors can be added to all nominal types with the Drop trait
10681       * Structs and nullary enum variants may be constants
10682       * Values that cannot be implicitly copied are now automatically moved
10683         without writing `move` explicitly
10684       * `&T` may now be coerced to `*T`
10685       * Coercions happen in `let` statements as well as function calls
10686       * `use` statements now take crate-relative paths
10687       * The module and type namespaces have been merged so that static
10688         method names can be resolved under the trait in which they are
10689         declared
10690
10691    * Improved support for language features
10692       * Trait inheritance works in many scenarios
10693       * More support for explicit self arguments in methods - `self`, `&self`
10694         `@self`, and `~self` all generally work as expected
10695       * Static methods work in more situations
10696       * Experimental: Traits may declare default methods for the implementations
10697         to use
10698
10699    * Libraries
10700       * New condition handling system in `core::condition`
10701       * Timsort added to `std::sort`
10702       * New priority queue, `std::priority_queue`
10703       * Pipes for serializable types, `std::flatpipes'
10704       * Serialization overhauled to be trait-based
10705       * Expanded `getopts` definitions
10706       * Moved futures to `std`
10707       * More functions are pure now
10708       * `core::comm` renamed to `oldcomm`. Still deprecated
10709       * `rustdoc` and `cargo` are libraries now
10710
10711    * Misc
10712       * Added a preliminary REPL, `rusti`
10713       * License changed from MIT to dual MIT/APL2
10714
10715
10716 Version 0.4 (2012-10-15)
10717 ==========================
10718
10719    * ~2000 changes, numerous bugfixes
10720
10721    * Syntax
10722       * All keywords are now strict and may not be used as identifiers anywhere
10723       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
10724         'of', 'with', 'to', 'class'.
10725       * Classes are replaced with simpler structs
10726       * Explicit method self types
10727       * `ret` became `return` and `alt` became `match`
10728       * `import` is now `use`; `use is now `extern mod`
10729       * `extern mod { ... }` is now `extern { ... }`
10730       * `use mod` is the recommended way to import modules
10731       * `pub` and `priv` replace deprecated export lists
10732       * The syntax of `match` pattern arms now uses fat arrow (=>)
10733       * `main` no longer accepts an args vector; use `os::args` instead
10734
10735    * Semantics
10736       * Trait implementations are now coherent, ala Haskell typeclasses
10737       * Trait methods may be static
10738       * Argument modes are deprecated
10739       * Borrowed pointers are much more mature and recommended for use
10740       * Strings and vectors in the static region are stored in constant memory
10741       * Typestate was removed
10742       * Resolution rewritten to be more reliable
10743       * Support for 'dual-mode' data structures (freezing and thawing)
10744
10745    * Libraries
10746       * Most binary operators can now be overloaded via the traits in
10747         `core::ops'
10748       * `std::net::url` for representing URLs
10749       * Sendable hash maps in `core::send_map`
10750       * `core::task' gained a (currently unsafe) task-local storage API
10751
10752    * Concurrency
10753       * An efficient new intertask communication primitive called the pipe,
10754         along with a number of higher-level channel types, in `core::pipes`
10755       * `std::arc`, an atomically reference counted, immutable, shared memory
10756         type
10757       * `std::sync`, various exotic synchronization tools based on arcs and pipes
10758       * Futures are now based on pipes and sendable
10759       * More robust linked task failure
10760       * Improved task builder API
10761
10762    * Other
10763       * Improved error reporting
10764       * Preliminary JIT support
10765       * Preliminary work on precise GC
10766       * Extensive architectural improvements to rustc
10767       * Begun a transition away from buggy C++-based reflection (shape) code to
10768         Rust-based (visitor) code
10769       * All hash functions and tables converted to secure, randomized SipHash
10770
10771
10772 Version 0.3  (2012-07-12)
10773 ========================
10774
10775    * ~1900 changes, numerous bugfixes
10776
10777    * New coding conveniences
10778       * Integer-literal suffix inference
10779       * Per-item control over warnings, errors
10780       * #[cfg(windows)] and #[cfg(unix)] attributes
10781       * Documentation comments
10782       * More compact closure syntax
10783       * 'do' expressions for treating higher-order functions as
10784         control structures
10785       * *-patterns (wildcard extended to all constructor fields)
10786
10787    * Semantic cleanup
10788       * Name resolution pass and exhaustiveness checker rewritten
10789       * Region pointers and borrow checking supersede alias
10790         analysis
10791       * Init-ness checking is now provided by a region-based liveness
10792         pass instead of the typestate pass; same for last-use analysis
10793       * Extensive work on region pointers
10794
10795    * Experimental new language features
10796       * Slices and fixed-size, interior-allocated vectors
10797       * #!-comments for lang versioning, shell execution
10798       * Destructors and iface implementation for classes;
10799         type-parameterized classes and class methods
10800       * 'const' type kind for types that can be used to implement
10801         shared-memory concurrency patterns
10802
10803    * Type reflection
10804
10805    * Removal of various obsolete features
10806       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
10807                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
10808
10809       * Constructs: do-while loops ('do' repurposed), fn binding,
10810                     resources (replaced by destructors)
10811
10812    * Compiler reorganization
10813       * Syntax-layer of compiler split into separate crate
10814       * Clang (from LLVM project) integrated into build
10815       * Typechecker split into sub-modules
10816
10817    * New library code
10818       * New time functions
10819       * Extension methods for many built-in types
10820       * Arc: atomic-refcount read-only / exclusive-use shared cells
10821       * Par: parallel map and search routines
10822       * Extensive work on libuv interface
10823       * Much vector code moved to libraries
10824       * Syntax extensions: #line, #col, #file, #mod, #stringify,
10825         #include, #include_str, #include_bin
10826
10827    * Tool improvements
10828       * Cargo automatically resolves dependencies
10829
10830
10831 Version 0.2  (2012-03-29)
10832 =========================
10833
10834    * >1500 changes, numerous bugfixes
10835
10836    * New docs and doc tooling
10837
10838    * New port: FreeBSD x86_64
10839
10840    * Compilation model enhancements
10841       * Generics now specialized, multiply instantiated
10842       * Functions now inlined across separate crates
10843
10844    * Scheduling, stack and threading fixes
10845       * Noticeably improved message-passing performance
10846       * Explicit schedulers
10847       * Callbacks from C
10848       * Helgrind clean
10849
10850    * Experimental new language features
10851       * Operator overloading
10852       * Region pointers
10853       * Classes
10854
10855    * Various language extensions
10856       * C-callback function types: 'crust fn ...'
10857       * Infinite-loop construct: 'loop { ... }'
10858       * Shorten 'mutable' to 'mut'
10859       * Required mutable-local qualifier: 'let mut ...'
10860       * Basic glob-exporting: 'export foo::*;'
10861       * Alt now exhaustive, 'alt check' for runtime-checked
10862       * Block-function form of 'for' loop, with 'break' and 'ret'.
10863
10864    * New library code
10865       * AST quasi-quote syntax extension
10866       * Revived libuv interface
10867       * New modules: core::{future, iter}, std::arena
10868       * Merged per-platform std::{os*, fs*} to core::{libc, os}
10869       * Extensive cleanup, regularization in libstd, libcore
10870
10871
10872 Version 0.1  (2012-01-20)
10873 ===============================
10874
10875    * Most language features work, including:
10876       * Unique pointers, unique closures, move semantics
10877       * Interface-constrained generics
10878       * Static interface dispatch
10879       * Stack growth
10880       * Multithread task scheduling
10881       * Typestate predicates
10882       * Failure unwinding, destructors
10883       * Pattern matching and destructuring assignment
10884       * Lightweight block-lambda syntax
10885       * Preliminary macro-by-example
10886
10887    * Compiler works with the following configurations:
10888       * Linux: x86 and x86_64 hosts and targets
10889       * macOS: x86 and x86_64 hosts and targets
10890       * Windows: x86 hosts and targets
10891
10892    * Cross compilation / multi-target configuration supported.
10893
10894    * Preliminary API-documentation and package-management tools included.
10895
10896 Known issues:
10897
10898    * Documentation is incomplete.
10899
10900    * Performance is below intended target.
10901
10902    * Standard library APIs are subject to extensive change, reorganization.
10903
10904    * Language-level versioning is not yet operational - future code will
10905      break unexpectedly.